#vrf #commonware #blockchain #lazy-evaluation #corrupt #commonware-vrf #arbiter #forger

app commonware-vrf

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

35 releases

new 0.0.50 May 3, 2025
0.0.48 Apr 28, 2025
0.0.43 Mar 16, 2025
0.0.14 Dec 15, 2024
0.0.12 Nov 5, 2024

#2 in Magic Beans

Download history 31/week @ 2025-01-08 204/week @ 2025-01-15 14/week @ 2025-01-22 248/week @ 2025-02-05 324/week @ 2025-02-12 3/week @ 2025-02-19 177/week @ 2025-02-26 513/week @ 2025-03-05 416/week @ 2025-03-12 22/week @ 2025-03-19 139/week @ 2025-04-09 94/week @ 2025-04-16 333/week @ 2025-04-23

566 downloads per month

MIT/Apache

1MB
21K 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.

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

~27–40MB
~712K SLoC