Skip to content

deploy: cutover-fleet-chain22.sh + rehearsal (chain 21 → 22 on v0.8.7, constraint set 11) - #197

Merged
dendisuhubdy merged 1 commit into
mainfrom
feat/cutover-chain22
Nov 19, 2026
Merged

dendisuhubdy merged 1 commit into
mainfrom
feat/cutover-chain22

Conversation

@dendisuhubdy

Copy link
Copy Markdown
Member

Adds deploy/cutover-fleet-chain22.sh and its rehearsal, deploy/rehearse-cutover-fleet-chain22.sh (run with SELFTEST=1). Both are modelled on the chain-21 pair. Nothing else is touched. Do not merge yet. The base is feat/cs11-revendor (#194).

Operator sequence

Run each phase alone. Every phase supports DRY_RUN=1.

INVENTORY=configuration/fleet/inventory.tsv   # required, no hard-coded addresses
preflight                       # read-only: 25 hosts on v0.8.6, chain 21's blob, disk, datadirs
stage                           # 7 files from the signed v0.8.7 SHA256SUMS + check-beacon-seed.sh
beacon-init                     # rand-node beacon init on each validator (seed stays on its host, 0600)
beacon-collect                  # commitments -> BEACON_TSV (read-only on the hosts)
bridge-stop                     # 6 guardians + relayer (RELAYER_HOST or RELAYER_HANDLED=yes)
snapshot <dir> / balances <dir> # cut-chain22-genesis.sh with PRUNED_SCAN_OK=1, CHAIN21_RPC tunnel
cut                             # cut-chain22-genesis.sh with BEACON_TSV
push <genesis>                  # constraint set (LOCAL_NODE/tree/zkVM = 11), second rebuild or waiver
CONFIRM_HALT_CHAIN21=halt-chain-21-for-<P> stop <genesis>   # the halt guard, gated on every host ready
switch <genesis>                # back up v0.8.6 + chain 21's msauth blob as *.pre-c22; install; init; seed; unit
start                           # bootstraps c d, then the other 21 (23 >= quorum 17); e, obs1 held back
check-limits <genesis>          # cut script against the first node
start-archives                  # e, obs1
wait <genesis>                  # genesis/health/msauth/perps keys (4) on 25 hosts + beacon --rpc
BRIDGE_ON_CHAIN22=yes bridge-start
verify <genesis>                # needs the CHAIN_CONSTRAINT_SETS (22, hash, 11) row

Rollback is halt (only if chain 22 runs), then rollback, start, wait21. archive2 is never contacted: it is filtered at inventory load, and its name and address are refused by every ssh/scp.

Tests

  • SELFTEST=1 deploy/cutover-fleet-chain22.sh: 210 passed, 0 failed. It runs against 25 fake TEST-NET hosts behind a fake ssh, stub rand-node builds, the real key files, and the real check-beacon-seed.sh and check-constraint-set.sh. It covers:
    • the halt guard
    • beacon init, collect and reuse
    • 25 validators, with archive2's address never requested (asserted from the fake ssh log)
    • the perps and msauth files beside the binary
    • constraint-set markers
    • rollback and re-cut paths
    • the roll record holds names only
  • SELFTEST=1 deploy/cut-chain22-genesis.sh: 474 passed, 0 failed.
  • bash -n and shellcheck -x pass on both scripts.

🤖 Generated with Claude Code

https://claude.ai/code/session_01YGaYNLS2uLR7w6m2JtejVo

@codecov

codecov Bot commented Nov 19, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Base automatically changed from feat/cs11-revendor to main November 19, 2026 21:34
…chain 22 (v0.8.7, constraint set 11)

Modelled on cutover-fleet-chain21.sh, with chain 22's differences:
- beacon-init / beacon-collect: `rand-node beacon init` on each of the 25
  validators over SSH into a per-host staging dir (0600, never copied off the
  host); the commitments are collected into BEACON_TSV for the cut, and
  check-beacon-seed.sh runs at stop, switch, start and wait.
- the seven release files: v0.8.7 rand-node + rand, the set-11 msauth blob
  (168d79a8…) and the four perp-vk-production-t18 files beside the binary,
  all from the signed SHA256SUMS and re-checked on every host.
- chain 21's msauth blob is backed up with the binaries as *.pre-c22, because
  v0.8.6 reads it, so rollback restores a working chain 21.
- the constraint-set check: LOCAL_NODE / tree / vendored zkVM must agree at 11,
  every new datadir's marker must be 11, and verify needs the
  CHAIN_CONSTRAINT_SETS row.
- the halt guard: stop refuses before contacting any host unless
  CONFIRM_HALT_CHAIN21=halt-chain-21-for-<genesis prefix>.
- the inventory comes from configuration/fleet/inventory.tsv (no hard-coded
  addresses). archive2 is dropped at load, and its name and address are
  refused by every ssh/scp. e and obs1 start after check-limits passes against
  the first node (start-archives).
- the bridge: bridge-stop / bridge-start (guardians + relayer). snapshot,
  balances and cut call cut-chain22-genesis.sh with PRUNED_SCAN_OK=1.
- a roll record under deploy/roll-records/ (names only).

rehearse-cutover-fleet-chain22.sh (SELFTEST=1) runs every phase against 25
fake TEST-NET hosts with stub rand-node builds and the real key files:
210 passed, 0 failed. SELFTEST=1 cut-chain22-genesis.sh: 474 passed, 0 failed.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01YGaYNLS2uLR7w6m2JtejVo
@dendisuhubdy
dendisuhubdy merged commit e79070a into main Nov 19, 2026
23 checks passed
@dendisuhubdy
dendisuhubdy deleted the feat/cutover-chain22 branch November 19, 2026 22:28
dendisuhubdy added a commit that referenced this pull request Nov 20, 2026
…t 11)

- Workspace version 0.8.7: Cargo.toml, the seven workspace crates in
  Cargo.lock (cargo update -w on the build droplet; offline failed on the
  rand-zkvm-cuda git dependency), the rand_getVersion test.
- CHANGELOG: Unreleased becomes v0.8.7 (tag date a PLACEHOLDER), with a row
  for #197's cutover-fleet-chain22.sh and the asset list.
- docs/releases/v0.8.7.md: the set-11 gas change as a governance record
  (bundle 20 479 -> 22 527, auth 1 279 -> 1 407, msauth 436 159 -> 355 775;
  the per-row weights), the chain-22 cut, the operator upgrade steps and the
  rollback. The chain-22 genesis hash and the CHAIN_CONSTRAINT_SETS row are
  PLACEHOLDER-... until the cut.
- README release table: v0.8.7. AGENTS.md: #194 is merged.

Not tagged, not signed, not published.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01YGaYNLS2uLR7w6m2JtejVo
dendisuhubdy added a commit that referenced this pull request Nov 20, 2026
…t 11) (#198)

* v0.8.7: version, changelog and release notes (chain 22, constraint set 11)

- Workspace version 0.8.7: Cargo.toml, the seven workspace crates in
  Cargo.lock (cargo update -w on the build droplet; offline failed on the
  rand-zkvm-cuda git dependency), the rand_getVersion test.
- CHANGELOG: Unreleased becomes v0.8.7 (tag date a PLACEHOLDER), with a row
  for #197's cutover-fleet-chain22.sh and the asset list.
- docs/releases/v0.8.7.md: the set-11 gas change as a governance record
  (bundle 20 479 -> 22 527, auth 1 279 -> 1 407, msauth 436 159 -> 355 775;
  the per-row weights), the chain-22 cut, the operator upgrade steps and the
  rollback. The chain-22 genesis hash and the CHAIN_CONSTRAINT_SETS row are
  PLACEHOLDER-... until the cut.
- README release table: v0.8.7. AGENTS.md: #194 is merged.

Not tagged, not signed, not published.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01YGaYNLS2uLR7w6m2JtejVo

* v0.8.7 notes: the set-11 address re-derivation (#199) and WALLET22

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01YGaYNLS2uLR7w6m2JtejVo

---------

Co-authored-by: Claude Opus 5.5 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant