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
22 changes: 22 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,28 @@ invariants, and known traps.

## Project memory (state as of 2026-11-08)

### The chain-22 treasury is 5 of 6 with its RAND carried; perps carried empty (2026-11-19, branch `feat/chain22-treasury-carry`; deploy only)

Owner's decisions of 2026-11-19 in `deploy/cut-chain22-genesis.sh` (OPEN 1–4 of its header;
`docs/deploy.md` "The next cut: chain 22").

- **Treasury**: `TREASURY_SIGNERS=6`, `TREASURY_THRESHOLD=5` (fixed; a multisig is always 5 of 6).
Six distinct keys, none of chain 21's treasury signers (genesis or the snapshot's live set),
validators', guardians' or the pause key. `balance` must equal the snapshot's
`rand_getSupply.multisig_rand_held` (py_treasury and py_splice); it is a carry, not issuance —
and the genesis must not seed more RAND than chain 21's `total_supply` (the no-double-count bound).
- **Overrides**: `MULTISIG_NOT_CARRIED_OK` only for a vault token or RAND in other register
accounts; `PERPS_STATE_NOT_CARRIED_OK` only for a non-empty exchange (now also the supply's
`perps_collateral_held` / `perps_rand_held`). Each is **refused when set with nothing to drop**.
`PROGRAM_VAULTS_DROPPED_OK` unchanged (durian's AMM is redeployed).
- **Record**: `carries:` must name the treasury (not `reason:` alone) and, without the perps
override, perps.
- Fixture signers are SHAKE-256 of fixed labels, 2624 hex. SELFTEST 404 → 426. DRY_RUN and the
real cut not exercised (no rand-node binary on the machine that made the change).
- The owner chose `PERPS_MAX_WINDOW_HEIGHTS` 256 and `MULTISIG_MAX_ACCOUNTS` 65 536: still inputs
with no default. rand-archive-2 is abandoned; chain 21's history on record starts at 187 556
(e, obs1) — `balances` refuses a `prune_floor` above 0, so check those hosts first.

### The chain-22 cut script carries block context and the beacon (2026-11-18, branch `feat/chain22-beacon-cut` stacked on `feat/randomness-beacon`, NOT pushed; deploy only)

The owner decided on 2026-11-18 that chain 22 launches with `program_state.reference_block_window`
Expand Down
14 changes: 14 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,20 @@ Deploy (no node change):
name, one distinct 64-hex commitment each; field-probed, read back by check-limits
(`rand_getBeacon`, `rand_getBlockContext`), written to the cut record with the operator seed
procedure. New `deploy/check-beacon-seed.sh`, run on each validator host before its node starts.
- **The chain-22 treasury is 5 of 6 with its balance carried; perps is carried empty** (owner's
decisions of 2026-11-19, `deploy/cut-chain22-genesis.sh`). `TREASURY` must list exactly six
distinct signers, `threshold 5`, none of them chain 21's (genesis or rotated); its `balance`
must equal chain 21's `rand_getSupply.multisig_rand_held` at the snapshot (100 000 RAND) —
carried from the register, not new issuance — and the genesis may not seed more RAND than chain
21's `total_supply`. `TREASURY_SIGNERS_CHANGED` / `TREASURY_ROTATED` are gone;
`MULTISIG_NOT_CARRIED_OK` covers only a vault token or another account's RAND, and
`PERPS_STATE_NOT_CARRIED_OK` only a non-empty exchange (each refused when there is nothing to
drop). An empty exchange is carried with its genesis root asserted equal; program vaults stay
dropped (`PROGRAM_VAULTS_DROPPED_OK`). The cut record's `carries:` names the treasury and perps.
`docs/multisig.md` now advises 5 of 6; `docs/deploy.md` records the owner's 256 / 65 536 for
`PERPS_MAX_WINDOW_HEIGHTS` / `MULTISIG_MAX_ACCOUNTS` (still inputs) and that rand-archive-2 is
abandoned, chain 21's history on record starting at height 187 556 (e, obs1). SELFTEST 404 →
426.

Node (issue #166, ZKVM-201; node-only, no wire, genesis or consensus change):

Expand Down
Loading
Loading