The Council is the committee of members that holds the Council key as -of- threshold shares. It has two duties: it releases the Ledger data key to each enclave the Registry admits, and it runs the Escape, where its members re-encrypt each owner’s last committed balance to that owner’s escape key, with a proof the program checks for every share.
Size and threshold#
| Members | Threshold | Colluding members who learn nothing | Offline members an Escape tolerates |
|---|---|---|---|
| 9 | 5 | up to 4 | up to 4 |
The nine members run as nine separate services, each holding its own key share.
These are the mainnet Council’s figures. CouncilConfig has room for nine members, and the program accepts a Council only with . With , any two sets of members share at least one member, and the key generation below runs in the honest-majority setting in which it is proven secure. Trust lists the live members and their verification keys.
What CouncilConfig holds#
CouncilConfig is the program account that records the Council:
- The Council key , a twisted ElGamal key on ristretto255. Its secret exists only as the members’ shares . No party ever holds it whole.
- One verification key per member, . Every share a member posts is checked against its .
- One signing key per member, the Ed25519 key that signs every message the member posts to the Council’s transcript.
- The member count , the threshold and the Council epoch: 0 at installation, one more at each rotation.
Its layout and seeds are in Accounts.
Two things are encrypted under the Council key:
- The wrapped Ledger data key (below).
- The Council handle that every Ledger leaf carries beside its commitment . Together they form a ciphertext of the balance that decrypts as . The handle is the Escape’s only path to a balance. Trading, Commits and disclosure never use it.
Key generation#
The key comes from distributed key generation by the protocol of Gennaro, Jarecki, Krawczyk and Rabin, run among the members’ nodes:
| Step | What members do |
|---|---|
| Deal | Each member shares a random secret by Pedersen verifiable secret sharing: it posts hiding commitments and one share pair per member, each sealed with HPKE to that member’s key. |
| Complain | Each member checks every pair addressed to it against the dealer’s commitments and posts a complaint for each failure. A dealer answers by posting that pair in the clear. Dealers with an unanswered or failed complaint drop out, and the rest form the qualified set. |
| Reveal | Each qualified dealer posts Feldman commitments. A share that fails them is posted as proof of the fault, and that dealer’s commitments are rebuilt in public from the members’ shares. The public key is fixed only after the qualified set is, so no member can bias it. |
| Output | is the sum of the qualified dealers’ secrets, and each member’s is the sum of the shares it received. |
| Twist | Two further sharings, a mask on base and a sharing of zero, run once at genesis with all members. Each member posts its masked product with a proof; the products interpolate to , which turns into without revealing . Each member then posts with a proof that it uses the same . |
Every message of the run is signed by its member and posted on chain through council_log under the Council’s address, the run’s broadcast channel: the transcript is public and ordered, and each step ends at a slot deadline. A node signs a step only before its deadline and takes as input only what every member posted for the step before. council_log names the Council’s address whether or not CouncilConfig exists there yet, so the whole run is on chain before the Council is installed.
Installation#
Installing the result is a separate instruction, sent once key generation has finished in the transcript. initialize_council, signed by the Pool’s admin, creates CouncilConfig once with Council epoch 0, the Council key , the nine verification keys in member order, the nine members’ signing keys and . The program accepts them only with , distinct signing keys and verification keys that form one -of- sharing of (A check from the account alone).
The installed values are the transcript’s output: each member’s installed message states the Council as that member computed it, and anyone can recompute the Council key and every verification key from the transcript itself and compare them with the account (Checking the key generation transcript).
Rotation#
rotate_council installs a new sharing of the Council secret, with its members’ verification and signing keys, under the same Council key. The program accepts a rotation only if:
- it is signed by at least of the current members’ signing keys, each a signer of the transaction; neither the admin nor the upgrade authority takes part;
- no Escape has been triggered (otherwise it fails with
EscapeActive), so every Escape share is checked against the Council the Escape recorded; - the new Council epoch is the current one plus one, and the Council key is the current ;
- the new verification keys, signing keys, and pass the checks of installation: up to nine members, , distinct signing keys and one -of- sharing of .
The Council key is unchanged and the new verification keys interpolate to again, so the new shares are shares of the same secret (Section 6.6). Every leaf’s Council handle and the wrapped Ledger data key stay valid with nothing re-encrypted. Each rotation’s keys are in its instruction data, so the Council’s whole history reads back from the chain (Checking a rotation).
The Ledger data key#
The Ledger data key decrypts every trader record and the enclave ciphertext of every leaf (Ledger). Outside an enclave it exists only wrapped under the Council key: a handle , and sealed with AES-256-GCM under SHA256( ‖ ), bound to the program, the Council epoch it was made under and .
- Wrap. The first admitted enclave generates before the first Commit and posts the wrapper through
council_log, signed with its Registry signing key. It is the Pool’s one wrapper: readers accept the first valid wrapper on chain and no different one after it. - Release. An enclave asks the members for under its
EnclaveKeyrecord, with a fresh challenge. Each member checks on chain that the record is admitted, that the Registry holds its keys as an admitted key whose interval contains the current slot, and that the wrapper is the one anchored. It then re-encrypts toward the record’s , with the proof an Escape share carries, and posts the share to the transcript. - Open. The enclave verifies each share against its member’s , combines of them into , and computes , which opens the wrapper. Each new key epoch’s key receives the same the same way.
is the key the enclave’s attestation bound (Attestation), so reaches only code whose measurement the Registry admitted.
What the Council does#
The Council’s only operation is re-encryption, toward a key the chain has verified: the data key toward an admitted enclave, and in the Escape a leaf’s handle toward an owner’s escape key , so the balance never appears in plaintext on chain. For the Escape, with a fresh random , member posts
with a proof that and are formed this way from the share behind its registered . The program checks each proof in escape_share and rejects an invalid share on its own, so every other member’s share still counts. At the -th valid share it combines them by Lagrange interpolation into one pair , from which only the holder of recovers .
Each member’s node watches for open EscapeRequest accounts and posts its share to each in an escape_share transaction of its own. Escape gives the whole sequence, from trigger_escape to the payout.
What no set of members can do#
| Guarantee | Holds against | Rests on |
|---|---|---|
| Learn or any balance | any members | perfect secrecy of Shamir sharing, hiding of Pedersen commitments, DDH in ristretto255 |
| Pay an Escape to anyone but the owner, pay more than the committed balance, or pay a leaf twice | all members | the Merkle path to the frozen root, soundness of the share and claim proofs, Commit authenticity |
| Sign a Commit or move a vault token outside the Escape | all members | the program, which accepts Commits only under an enclave key the Registry admitted |
Corrupt members choose their masks but not their shares , so a combined pair always decrypts, for the owner, to the leaf’s committed balance. The owner’s claim proof then binds the payout to a destination only the owner chose. Completing the Escape for every owner rests on members landing their share transactions on chain.