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

app commonware-vrf

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

16 releases

new 0.0.17 Jan 20, 2025
0.0.16 Jan 16, 2025
0.0.14 Dec 15, 2024
0.0.12 Nov 5, 2024
0.0.5 Aug 31, 2024

#859 in Magic Beans

Download history 321/week @ 2024-10-06 58/week @ 2024-10-13 1/week @ 2024-10-20 119/week @ 2024-10-27 140/week @ 2024-11-03 10/week @ 2024-11-10 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 113/week @ 2025-01-19

347 downloads per month

MIT/Apache

690KB
14K 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

~22–33MB
~598K SLoC