#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

#697 in Magic Beans

Download history 17/week @ 2024-09-30 336/week @ 2024-10-07 44/week @ 2024-10-14 123/week @ 2024-10-28 143/week @ 2024-11-04 3/week @ 2024-11-11 4/week @ 2024-11-18 287/week @ 2024-12-09 28/week @ 2024-12-16 131/week @ 2025-01-06 106/week @ 2025-01-13

237 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
~596K SLoC