Skip to content

docs: add mainnet deploy & role rotation runbook - #22

Open
RunTimeAdmin wants to merge 1 commit into
masterfrom
cursor/mainnet-deploy-runbook-7bb0
Open

docs: add mainnet deploy & role rotation runbook#22
RunTimeAdmin wants to merge 1 commit into
masterfrom
cursor/mainnet-deploy-runbook-7bb0

Conversation

@RunTimeAdmin

Copy link
Copy Markdown
Owner

Summary

Adds a comprehensive mainnet deployment runbook as documentation, covering the full production deployment and role-hardening sequence for Robinhood Chain mainnet (4663).

Critical Script Split

The runbook documents the distinction between two deployment scripts:

Script What It Deploys When to Use
script/Deploy.s.sol Protocol: Identity + Reputation + Staking + faucet CSIGToken Testnet. Needs a mainnet variant (no faucet; bond = WETH/USDC)
script/DeployMainnet.s.sol TGE only: Timelock + Treasury/Team vesting + fixed-supply CSIG Token launch. Does not deploy Identity/Reputation/Staking

Per the oracle-first strategy, protocol livenet can ship without TGE. Bond tokens should be an established asset (WETH/USDC) — never the faucet token.

What's Added

docs/mainnet-deploy.md

  • Pre-flight checklist (people/keys, decisions to lock, code gaps)
  • Recommended deployment sequence (A–H phases)
  • Testnet rehearsal instructions
  • Role rotation procedures with cast examples
  • Post-rotation assertion checklist
  • Oracle & ops cutover steps
  • Risk register with mitigations
  • Suggested engineering work items

Cross-links

  • README Documentation table: new row for operators/mainnet audience
  • docs/robinhood-chain.md §6: pointer to the detailed runbook

What's Not Changed

  • No Solidity or script implementation
  • No changes to existing contracts or deployment scripts
  • Docs-only PR as specified
Open in Web Open in Cursor 

- Create docs/mainnet-deploy.md with production deployment sequence
- Cover Deploy.s.sol vs DeployMainnet.s.sol script split
- Document pre-flight checklist, role rotation phases, risk register
- Add link to README Documentation table (audience: operators)
- Add pointer in docs/robinhood-chain.md Production section

Docs-only change; no Solidity/script implementation.
@RunTimeAdmin
RunTimeAdmin marked this pull request as ready for review September 9, 2026 05:44
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.

2 participants