Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions cocktail-dkg/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,41 @@ The test vectors are generated from a SHA256 hash of the spec co-maintainers' na
Each of these assume a 2-of-3 threshold.

These are current as of v0.1.0 of the cocktail-dkg spec.

## Test Vector Types

Each JSON file contains multiple test vectors:

1. **2-of-3 basic**: Standard 2-of-3 DKG with empty extension
2. **3-of-5 basic**: Standard 3-of-5 DKG with empty extension
3. **7-of-14 basic**: Standard 7-of-14 DKG with empty extension
4. **2-of-3 with payload extension**: 2-of-3 DKG where each participant includes a seed-derived payload, and the
extension is a hash of all payloads

## JSON Structur

Each vector includes:

- `name`: Descriptive name for the test case
- `n`: Total number of participants
- `t`: Threshold
- `context`: Context string (hex-encoded)
- `extension`: Application-specific extension (hex-encoded, empty string if none)
- `payloads`: (Optional) Array of hex-encoded payloads for each participant
- `config`: Static keys for all participants
- `round1`: Ephemeral keys, VSS commitments, PoPs, and encrypted shares
- `round2`: Secret shares and verification shares
- `round3`: Transcript hash and signatures
- `group_public_key`: Final group public key

## Ciphersuites

| File | Ciphersuite |
|-----------------------------------------|----------------------------------|
| `cocktail-dkg-ristretto255-sha512.json` | COCKTAIL(Ristretto255, SHA-512) |
| `cocktail-dkg-ed25519-sha512.json` | COCKTAIL(Ed25519, SHA-512) |
| `cocktail-dkg-p256-sha256.json` | COCKTAIL(P-256, SHA-256) |
| `cocktail-dkg-secp256k1-sha256.json` | COCKTAIL(secp256k1, SHA-256) |
| `cocktail-dkg-ed448-shake256.json` | COCKTAIL(Ed448, SHAKE256) |
| `cocktail-dkg-jubjub-blake2b512.json` | COCKTAIL(JubJub, BLAKE2b-512) |
| `cocktail-dkg-pallas-blake2b512.json` | COCKTAIL(Pallas, BLAKE2b-512) |
983 changes: 944 additions & 39 deletions cocktail-dkg/cocktail-dkg-ed25519-sha512.json

Large diffs are not rendered by default.

983 changes: 944 additions & 39 deletions cocktail-dkg/cocktail-dkg-ed448-shake256.json

Large diffs are not rendered by default.

983 changes: 944 additions & 39 deletions cocktail-dkg/cocktail-dkg-jubjub-blake2b512.json

Large diffs are not rendered by default.

983 changes: 944 additions & 39 deletions cocktail-dkg/cocktail-dkg-p256-sha256.json

Large diffs are not rendered by default.

983 changes: 944 additions & 39 deletions cocktail-dkg/cocktail-dkg-pallas-blake2b512.json

Large diffs are not rendered by default.

983 changes: 944 additions & 39 deletions cocktail-dkg/cocktail-dkg-ristretto255-sha512.json

Large diffs are not rendered by default.

983 changes: 944 additions & 39 deletions cocktail-dkg/cocktail-dkg-secp256k1-sha256.json

Large diffs are not rendered by default.