Operational Drillbook

This drillbook records the minimum manual exercises operators should perform before a production cutover.

It does not replace the on-chain tests. It complements them with operational rehearsal.

Drill 1: Wallet Runtime Validation

Scenario: Verify that supported wallets can connect, report capabilities, and sign or send in real browser environments.

Expected safe outcome:

• supported providers are detected correctly
• disconnected state is handled cleanly
• capability reporting matches runtime behavior
• failed wallet paths do not corrupt UI state

Primary surfaces:

• `https://x-pact.github.io/PrivateDAO/diagnostics/`
• `docs/wallet-runtime.md`

Drill 2: Review Surface Rebuild

Scenario: Rebuild all generated artifacts and confirm the proof surface remains coherent.

Expected safe outcome:

• generated artifacts rebuild without drift
• manifest hashes stay aligned
• review links remain intact
• zk attestations and readiness reports remain current

Primary command:

npm run verify:all

Drill 3: ZK Artifact Verification

Scenario: Re-run the zk verification stack and tamper-rejection checks.

Expected safe outcome:

• stored proofs verify
• recomputed public signals remain consistent
• tampered proof or public-signal payloads are rejected

Primary commands:

npm run zk:all
npm run verify:zk-consistency
npm run verify:zk-negative

Drill 4: Mainnet Gate Rehearsal

Scenario: Run the full mainnet readiness gate before any release-candidate announcement.

Expected safe outcome:

• program builds
• Rust unit tests pass
• review surface passes
• readiness report and deployment attestation rebuild cleanly

Primary command:

bash scripts/check-mainnet-readiness.sh

Drill 5: Incident Routing Review

Scenario: Confirm that signer compromise, treasury anomalies, and RPC degradation paths are documented and assigned.

Expected safe outcome:

• operator ownership is explicit
• monitoring and alert channels are known
• pause, cutover, and investigation procedures are reachable

Primary references:

• `docs/incident-response.md`
• `docs/monitoring-alerts.md`
• `docs/mainnet-cutover-runbook.md`
• `docs/risk-register.md`

Honest Boundary

This drillbook improves operational discipline inside the repository.

It does not prove:

• external audit completion
• live mainnet rollout
• wallet behavior across every client or browser variant without real runtime testing