#contributors #randomness #untrusted #consensus #commonware #bias-resistant #commonware-cryptography

app commonware-vrf

Generate bias-resistant randomness with untrusted contributors using commonware-cryptography and commonware-p2p

25 releases

new 0.0.40 Mar 9, 2025
0.0.22 Feb 26, 2025
0.0.14 Dec 15, 2024
0.0.12 Nov 5, 2024

#308 in Magic Beans

Download history 4/week @ 2024-11-17 166/week @ 2024-12-08 149/week @ 2024-12-15 127/week @ 2025-01-05 107/week @ 2025-01-12 119/week @ 2025-01-19 4/week @ 2025-01-26 138/week @ 2025-02-02 375/week @ 2025-02-09 62/week @ 2025-02-16 137/week @ 2025-02-23 279/week @ 2025-03-02

902 downloads per month

MIT/Apache

750KB
16K SLoC

commonware-vrf

Crates.io Docs.rs

Generate bias-resistant randomness with untrusted contributors using commonware-cryptography and commonware-p2p.

Usage (3 of 4 Threshold)

To run this example, you must first install Rust and protoc.

Arbiter

cargo run --release -- --me 0@3000 --participants 0,1,2,3,4 --contributors 1,2,3,4

Contributor 1

cargo run --release -- --bootstrappers 0@127.0.0.1:3000 --me 1@3001 --participants 0,1,2,3,4  --arbiter 0 --contributors 1,2,3,4

Contributor 2

cargo run --release -- --bootstrappers 0@127.0.0.1:3000 --me 2@3002 --participants 0,1,2,3,4  --arbiter 0 --contributors 1,2,3,4

Contributor 3

cargo run --release -- --bootstrappers 0@127.0.0.1:3000 --me 3@3003 --participants 0,1,2,3,4  --arbiter 0 --contributors 1,2,3,4

Contributor 4 (Corrupt)

Send invalid dealings to contributors.

cargo run --release -- --corrupt --bootstrappers 0@127.0.0.1:3000 --me 4@3004 --participants 0,1,2,3,4 --arbiter 0 --contributors 1,2,3,4

Contributor 4 (Lazy)

Only send 2f dealings to contributors (force reveal f).

cargo run --release -- --lazy --bootstrappers 0@127.0.0.1:3000 --me 4@3004 --participants 0,1,2,3,4 --arbiter 0 --contributors 1,2,3,4

Contributor 4 (Forger)

Forge acknowledgements from contributors.

cargo run --release -- --forger --bootstrappers 0@127.0.0.1:3000 --me 4@3004 --participants 0,1,2,3,4 --arbiter 0 --contributors 1,2,3,4

Dependencies

~20–32MB
~581K SLoC