Skip to content

MAINNET-RUNBOOK.md

Latest commit

 

History

History
39 lines (30 loc) · 2.56 KB

MAINNET-RUNBOOK.md

File metadata and controls

39 lines (30 loc) · 2.56 KB

CapletFi Mainnet Runbook

CapletFi is submitted on Sui testnet because DeepBook Predict is testnet-only during the Sui Overflow 2026 submission window. Do not fake a mainnet deployment or route around Predict. The mainnet path starts when DeepBook Predict exposes a supported mainnet deployment.

Mainnet Entry Criteria

  • DeepBook Predict mainnet package, DUSDC-equivalent asset, oracle objects, and PLP path are published and documented.
  • CapletFi V3 mint invariants still match the mainnet Predict API: downside-only binary, active oracle, expiry match, strike below spot, and binary budget <= declared hedge budget.
  • Settlement semantics are unchanged: the keeper may settle the shared note, direct PLP payout routes to the recorded holder, and binary proceeds or unspent hedge budget remain holder-claimable in the holder-owned PredictManager.
  • The narrative guard and public verifier pass against mainnet receipts.
  • A security review covers the Move package, keeper, frontend transaction builders, and proof scripts.

Mainnet Deployment Steps

  1. Pin the supported DeepBook Predict mainnet package ids, oracle ids, DUSDC-equivalent type, and PLP objects in web/lib/caplet.ts and keeper environment config.
  2. Build and test the Move packages locally with npm run verify:contracts.
  3. Deploy or upgrade the CapletFi package, preserving the current V3 invariant set.
  4. Mint a small mainnet note with a holder-owned PredictManager and record the mint digest.
  5. Confirm the CapletRiskBudgetEnforced event shows the declared budget and actual binary budget.
  6. Wait for oracle settlement, then settle from a non-holder keeper wallet.
  7. Publish the Walrus term sheet and settlement summary for the mainnet receipt.
  8. Replay npm run verify:receipts, npm run verify:public, and npm run verify:narrative against the mainnet proof data.
  9. Update README, /api/proof, llms.txt, and docs/PROOF_SURFACE.md with mainnet ids only after the proof replay passes.

Required Mainnet Proof

  • Valid V3 mint digest.
  • Over-budget mint rejection dry-run or transaction fixture.
  • Non-holder settlement digest.
  • Holder-owned manager credit claim path.
  • Walrus term sheet blob.
  • Walrus settlement summary blob.
  • Clean-clone replay command.

Boundaries

  • Testnet receipts remain submission evidence until DeepBook Predict supports mainnet.
  • CapletFi enforces the hedge budget at mint. It does not enforce realized outcomes, a fixed principal floor, fixed yield, or risk-free returns.
  • The existing V1.1 Strata namespace is retained only so historical testnet receipts continue to build and verify.