[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-sui-deepbook-predict":3,"mdc-e640br-key":36,"related-repo-sui-deepbook-predict":804,"related-org-sui-deepbook-predict":892},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":31,"sourceUrl":34,"mdContent":35},"deepbook-predict","build prediction market applications on Sui","DeepBook Predict — expiry-based prediction market protocol on Sui. Use when building prediction market applications, minting binary or vertical range positions, understanding oracle lifecycle, working with PredictManager accounts, or integrating vault liquidity (PLP). Also use when the user asks about DeepBook binary options, range positions, DUSDC, OracleSVI, or settlement.\nNote: DeepBook Predict is currently on Testnet only. Smart contracts may change before Mainnet deployment.\nFor spot trading, see the `deepbook-sdk` skill. For margin trading, see the `deepbook-margin` skill. For DeepBook architecture, see the `deepbook-overview` skill.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"sui","Sui (Mysten Labs)","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fsui.png","MystenLabs",[13,16,19,22],{"name":14,"slug":8,"type":15},"Sui","tag",{"name":17,"slug":18,"type":15},"Finance","finance",{"name":20,"slug":21,"type":15},"Web3","web3",{"name":23,"slug":24,"type":15},"Trading","trading",9,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fskills","2026-08-24T03:57:04.953545",null,2,[],{"repoUrl":26,"stars":25,"forks":29,"topics":32,"description":33},[],"Sui development skills maintained by Mysten Labs","https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fskills\u002Ftree\u002FHEAD\u002Fdeepbook-predict","---\nname: deepbook-predict\ndescription: >\n  DeepBook Predict — expiry-based prediction market protocol on Sui. Use when\n  building prediction market applications, minting binary or vertical range\n  positions, understanding oracle lifecycle, working with PredictManager accounts,\n  or integrating vault liquidity (PLP). Also use when the user asks about\n  DeepBook binary options, range positions, DUSDC, OracleSVI, or settlement.\n\n  Note: DeepBook Predict is currently on Testnet only. Smart contracts may change\n  before Mainnet deployment.\n\n  For spot trading, see the `deepbook-sdk` skill.\n  For margin trading, see the `deepbook-margin` skill.\n  For DeepBook architecture, see the `deepbook-overview` skill.\n---\n\n# DeepBook Predict\n\n> **MCP tool:** When available in your environment, also query the Sui documentation MCP server (`https:\u002F\u002Fsui.mcp.kapa.ai`) for up-to-date answers. Use it for verification and for details not covered by these reference files.\n\n> **Source constraint:** All information in this skill is sourced exclusively from [docs.sui.io](https:\u002F\u002Fdocs.sui.io\u002Fonchain-finance\u002Fdeepbook\u002Fdeepbook-predict), the [deepbookv3 repository](https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fdeepbookv3) (`predict-testnet-4-16` branch), and the [`@mysten\u002Fdeepbook-predict` npm package](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@mysten\u002Fdeepbook-predict). When extending or updating this skill, only pull from these sources. Do not use third-party blogs, tutorials, or unofficial documentation.\n\nDeepBook Predict is an expiry-based prediction market protocol on Sui where applications establish markets and users take binary or vertical range positions priced against oracle data. The `@mysten\u002Fdeepbook-predict` npm package (v0.2.1) provides a dedicated TypeScript SDK for interacting with the protocol; alternatively, developers can build transactions directly using the Sui TypeScript SDK (`@mysten\u002Fsui`). Common mistakes include treating Predict as a perpetual market (it is expiry-based), minting and depositing in the same transaction as PredictManager creation (the manager must be shared first), and using hardcoded testnet IDs as permanent addresses. Smart contracts are currently on Testnet and may change before Mainnet deployment.\n\nThis skill routes to focused reference files. Load only the ones relevant to the current task.\n\nAll patterns in this skill are derived from:\n  https:\u002F\u002Fdocs.sui.io\u002Fonchain-finance\u002Fdeepbook\u002Fdeepbook-predict\n  https:\u002F\u002Fdocs.sui.io\u002Fonchain-finance\u002Fdeepbook\u002Fdeepbook-predict\u002Fdesign\n  https:\u002F\u002Fdocs.sui.io\u002Fonchain-finance\u002Fdeepbook\u002Fdeepbook-predict\u002Ftutorial\n  https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fdeepbookv3\u002Ftree\u002Fmain\u002Fpackages\u002Fpredict\n\nIf unsure about any API or parameter, fetch the relevant page before answering.\nDo not guess or extrapolate from other prediction market protocols.\n\n---\n\n## Reference files\n\n### positions-and-oracles — Position Types, Oracle Lifecycle, and Pricing\n**Path:** `positions-and-oracles.md`\n**Load when:** the user asks about binary positions, vertical range positions, how oracles work, oracle states, settlement mechanics, pricing, or the vault\u002FPLP model.\n**Covers:** binary position keys and payoff, vertical range position keys and payoff, oracle lifecycle (inactive → active → pending settlement → settled), settlement mechanics, vault and PLP liquidity model, pricing and exposure.\n\n### workflow — Testnet Integration Workflow\n**Path:** `workflow.md`\n**Load when:** the user wants to mint positions, redeem positions, create a PredictManager, supply or withdraw PLP, or build transactions against the Predict protocol.\n**Covers:** SDK setup, configuration, PredictManager creation, depositing DUSDC, minting binary positions, minting vertical range positions, redemption (live and settled), LP operations (supply and withdraw PLP), verification steps, key constraints.\n\n### contract-info — Testnet Contract Addresses\n**Path:** `contract-info.md`\n**Load when:** the user needs testnet package IDs, the Predict object ID, DUSDC type address, the public server URL, or oracle event types.\n**Covers:** testnet package ID, registry ID, Predict object ID, DUSDC specifications, PLP coin type, public server endpoint, oracle event types.\n\n---\n\n## Routing guide\n\n| Task | Load |\n|------|------|\n| Understanding binary vs range positions | positions-and-oracles |\n| Understanding oracle lifecycle and settlement | positions-and-oracles |\n| Understanding the vault and PLP model | positions-and-oracles |\n| Minting a binary position | workflow |\n| Minting a vertical range position | workflow |\n| Redeeming a position | workflow |\n| Creating a PredictManager | workflow |\n| Supplying or withdrawing PLP | workflow |\n| Looking up testnet addresses | contract-info |\n| Finding the public server endpoint | contract-info |\n| Building a prediction market app | **all reference files** |\n| Full Predict integration | **all reference files** |\n\n---\n\n## Skill Content\n\n### Key concepts\n\n- **Expiry-based protocol.** Predict is not a perpetual market. Every position has an expiry timestamp. After expiry, positions settle against the oracle's recorded price at that timestamp.\n\n- **Binary positions.** Pay fixed notional if the settlement price is above (up) or at\u002Fbelow (down) the strike price. Key structure: `(oracle_id, expiry, strike, is_up)`.\n\n- **Vertical range positions.** Pay fixed notional if the settlement price falls within a band between two strikes. Key structure: `(oracle_id, expiry, lower_strike, higher_strike)`. The lower strike must be less than the higher strike.\n\n- **PredictManager.** A shared account wrapping a DeepBook BalanceManager. Holds DUSDC quote balances and tracks position quantities. Must be created and shared in a separate transaction before depositing or minting.\n\n- **OracleSVI.** Market state container for a specific asset and expiry. Stores spot\u002Fforward prices, SVI parameters, activation status, and settlement data. Transitions through four states: inactive → active → pending settlement → settled.\n\n- **Vault and PLP.** The vault takes the opposite side of every trade. Liquidity providers deposit DUSDC to receive PLP (Predict LP) tokens. The vault enforces exposure limits against total mark-to-market liability.\n\n- **DUSDC.** The quote asset used for all Predict operations. Obtained via the testnet token request form.\n\n- **Dedicated SDK available.** The `@mysten\u002Fdeepbook-predict` npm package (v0.2.1) provides a dedicated TypeScript SDK for interacting with DeepBook Predict. Install via `npm install @mysten\u002Fdeepbook-predict`. You can also build transactions directly using `@mysten\u002Fsui` if you prefer lower-level control.\n\n### Rules\n\n1. **Create PredictManager in a separate transaction.** Because `create_manager` shares the manager during the transaction, you deposit into it and mint from it in a later transaction, not the same one.\n2. **Fetch oracle data from the public server** (`https:\u002F\u002Fpredict-server.testnet.mystenlabs.com`), not hardcoded values. Oracle IDs, expiries, and strikes are dynamic.\n3. **All testnet IDs are provisional.** Smart contracts may change before Mainnet. Do not treat current package IDs or object layouts as permanent.\n4. **Minting requires an active oracle.** The oracle must be in the \"active\" state. Inactive, pending settlement, and settled oracles do not accept new mints.\n5. **Redemption works against both live and settled oracles.** Before settlement, payouts reflect current bid values. After settlement, binary positions yield fixed fair value; ranges pay full notional if in-band, zero otherwise.\n6. **LP withdrawals are constrained.** Withdrawals require sufficient available liquidity after covering maximum payout obligations, and a rate limiter may throttle large withdrawals.\n\n### Common mistakes\n\n- **Minting and depositing in the same transaction as manager creation.** The PredictManager must be shared first (transaction 1), then deposits and mints happen in subsequent transactions.\n- **Hardcoding testnet addresses.** These will change at Mainnet launch. Fetch configuration dynamically or maintain a config file.\n- **Assuming perpetual positions.** All positions expire. After expiry, the oracle enters pending settlement and then settled state. Unresolved positions must be redeemed post-settlement.\n- **Not validating oracle state before minting.** The mint succeeds only when the oracle is live, the quote asset is accepted, the market key matches the oracle, and the manager holds enough deposited DUSDC.\n- **Not knowing which SDK to use.** The `@mysten\u002Fdeepbook-predict` package (v0.2.1) provides high-level helpers for Predict operations. For lower-level control, build transactions directly with `@mysten\u002Fsui`. Both approaches work — choose based on how much control you need.\n- **Using wrong strike ordering for ranges.** Vertical range keys require `lower_strike \u003C higher_strike`. Reversed strikes cause the mint to fail.\n",{"data":37,"body":38},{"name":4,"description":6},{"type":39,"children":40},"root",[41,49,74,130,150,155,183,188,192,199,206,236,242,268,274,300,303,309,491,494,500,506,629,635,714,720],{"type":42,"tag":43,"props":44,"children":45},"element","h1",{"id":4},[46],{"type":47,"value":48},"text","DeepBook Predict",{"type":42,"tag":50,"props":51,"children":52},"blockquote",{},[53],{"type":42,"tag":54,"props":55,"children":56},"p",{},[57,63,65,72],{"type":42,"tag":58,"props":59,"children":60},"strong",{},[61],{"type":47,"value":62},"MCP tool:",{"type":47,"value":64}," When available in your environment, also query the Sui documentation MCP server (",{"type":42,"tag":66,"props":67,"children":69},"code",{"className":68},[],[70],{"type":47,"value":71},"https:\u002F\u002Fsui.mcp.kapa.ai",{"type":47,"value":73},") for up-to-date answers. Use it for verification and for details not covered by these reference files.",{"type":42,"tag":50,"props":75,"children":76},{},[77],{"type":42,"tag":54,"props":78,"children":79},{},[80,85,87,96,98,105,107,113,115,128],{"type":42,"tag":58,"props":81,"children":82},{},[83],{"type":47,"value":84},"Source constraint:",{"type":47,"value":86}," All information in this skill is sourced exclusively from ",{"type":42,"tag":88,"props":89,"children":93},"a",{"href":90,"rel":91},"https:\u002F\u002Fdocs.sui.io\u002Fonchain-finance\u002Fdeepbook\u002Fdeepbook-predict",[92],"nofollow",[94],{"type":47,"value":95},"docs.sui.io",{"type":47,"value":97},", the ",{"type":42,"tag":88,"props":99,"children":102},{"href":100,"rel":101},"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fdeepbookv3",[92],[103],{"type":47,"value":104},"deepbookv3 repository",{"type":47,"value":106}," (",{"type":42,"tag":66,"props":108,"children":110},{"className":109},[],[111],{"type":47,"value":112},"predict-testnet-4-16",{"type":47,"value":114}," branch), and the ",{"type":42,"tag":88,"props":116,"children":119},{"href":117,"rel":118},"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@mysten\u002Fdeepbook-predict",[92],[120,126],{"type":42,"tag":66,"props":121,"children":123},{"className":122},[],[124],{"type":47,"value":125},"@mysten\u002Fdeepbook-predict",{"type":47,"value":127}," npm package",{"type":47,"value":129},". When extending or updating this skill, only pull from these sources. Do not use third-party blogs, tutorials, or unofficial documentation.",{"type":42,"tag":54,"props":131,"children":132},{},[133,135,140,142,148],{"type":47,"value":134},"DeepBook Predict is an expiry-based prediction market protocol on Sui where applications establish markets and users take binary or vertical range positions priced against oracle data. The ",{"type":42,"tag":66,"props":136,"children":138},{"className":137},[],[139],{"type":47,"value":125},{"type":47,"value":141}," npm package (v0.2.1) provides a dedicated TypeScript SDK for interacting with the protocol; alternatively, developers can build transactions directly using the Sui TypeScript SDK (",{"type":42,"tag":66,"props":143,"children":145},{"className":144},[],[146],{"type":47,"value":147},"@mysten\u002Fsui",{"type":47,"value":149},"). Common mistakes include treating Predict as a perpetual market (it is expiry-based), minting and depositing in the same transaction as PredictManager creation (the manager must be shared first), and using hardcoded testnet IDs as permanent addresses. Smart contracts are currently on Testnet and may change before Mainnet deployment.",{"type":42,"tag":54,"props":151,"children":152},{},[153],{"type":47,"value":154},"This skill routes to focused reference files. Load only the ones relevant to the current task.",{"type":42,"tag":54,"props":156,"children":157},{},[158,160,165,171,177],{"type":47,"value":159},"All patterns in this skill are derived from:\n",{"type":42,"tag":88,"props":161,"children":163},{"href":90,"rel":162},[92],[164],{"type":47,"value":90},{"type":42,"tag":88,"props":166,"children":169},{"href":167,"rel":168},"https:\u002F\u002Fdocs.sui.io\u002Fonchain-finance\u002Fdeepbook\u002Fdeepbook-predict\u002Fdesign",[92],[170],{"type":47,"value":167},{"type":42,"tag":88,"props":172,"children":175},{"href":173,"rel":174},"https:\u002F\u002Fdocs.sui.io\u002Fonchain-finance\u002Fdeepbook\u002Fdeepbook-predict\u002Ftutorial",[92],[176],{"type":47,"value":173},{"type":42,"tag":88,"props":178,"children":181},{"href":179,"rel":180},"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fdeepbookv3\u002Ftree\u002Fmain\u002Fpackages\u002Fpredict",[92],[182],{"type":47,"value":179},{"type":42,"tag":54,"props":184,"children":185},{},[186],{"type":47,"value":187},"If unsure about any API or parameter, fetch the relevant page before answering.\nDo not guess or extrapolate from other prediction market protocols.",{"type":42,"tag":189,"props":190,"children":191},"hr",{},[],{"type":42,"tag":193,"props":194,"children":196},"h2",{"id":195},"reference-files",[197],{"type":47,"value":198},"Reference files",{"type":42,"tag":200,"props":201,"children":203},"h3",{"id":202},"positions-and-oracles-position-types-oracle-lifecycle-and-pricing",[204],{"type":47,"value":205},"positions-and-oracles — Position Types, Oracle Lifecycle, and Pricing",{"type":42,"tag":54,"props":207,"children":208},{},[209,214,216,222,227,229,234],{"type":42,"tag":58,"props":210,"children":211},{},[212],{"type":47,"value":213},"Path:",{"type":47,"value":215}," ",{"type":42,"tag":66,"props":217,"children":219},{"className":218},[],[220],{"type":47,"value":221},"positions-and-oracles.md",{"type":42,"tag":58,"props":223,"children":224},{},[225],{"type":47,"value":226},"Load when:",{"type":47,"value":228}," the user asks about binary positions, vertical range positions, how oracles work, oracle states, settlement mechanics, pricing, or the vault\u002FPLP model.\n",{"type":42,"tag":58,"props":230,"children":231},{},[232],{"type":47,"value":233},"Covers:",{"type":47,"value":235}," binary position keys and payoff, vertical range position keys and payoff, oracle lifecycle (inactive → active → pending settlement → settled), settlement mechanics, vault and PLP liquidity model, pricing and exposure.",{"type":42,"tag":200,"props":237,"children":239},{"id":238},"workflow-testnet-integration-workflow",[240],{"type":47,"value":241},"workflow — Testnet Integration Workflow",{"type":42,"tag":54,"props":243,"children":244},{},[245,249,250,256,260,262,266],{"type":42,"tag":58,"props":246,"children":247},{},[248],{"type":47,"value":213},{"type":47,"value":215},{"type":42,"tag":66,"props":251,"children":253},{"className":252},[],[254],{"type":47,"value":255},"workflow.md",{"type":42,"tag":58,"props":257,"children":258},{},[259],{"type":47,"value":226},{"type":47,"value":261}," the user wants to mint positions, redeem positions, create a PredictManager, supply or withdraw PLP, or build transactions against the Predict protocol.\n",{"type":42,"tag":58,"props":263,"children":264},{},[265],{"type":47,"value":233},{"type":47,"value":267}," SDK setup, configuration, PredictManager creation, depositing DUSDC, minting binary positions, minting vertical range positions, redemption (live and settled), LP operations (supply and withdraw PLP), verification steps, key constraints.",{"type":42,"tag":200,"props":269,"children":271},{"id":270},"contract-info-testnet-contract-addresses",[272],{"type":47,"value":273},"contract-info — Testnet Contract Addresses",{"type":42,"tag":54,"props":275,"children":276},{},[277,281,282,288,292,294,298],{"type":42,"tag":58,"props":278,"children":279},{},[280],{"type":47,"value":213},{"type":47,"value":215},{"type":42,"tag":66,"props":283,"children":285},{"className":284},[],[286],{"type":47,"value":287},"contract-info.md",{"type":42,"tag":58,"props":289,"children":290},{},[291],{"type":47,"value":226},{"type":47,"value":293}," the user needs testnet package IDs, the Predict object ID, DUSDC type address, the public server URL, or oracle event types.\n",{"type":42,"tag":58,"props":295,"children":296},{},[297],{"type":47,"value":233},{"type":47,"value":299}," testnet package ID, registry ID, Predict object ID, DUSDC specifications, PLP coin type, public server endpoint, oracle event types.",{"type":42,"tag":189,"props":301,"children":302},{},[],{"type":42,"tag":193,"props":304,"children":306},{"id":305},"routing-guide",[307],{"type":47,"value":308},"Routing guide",{"type":42,"tag":310,"props":311,"children":312},"table",{},[313,332],{"type":42,"tag":314,"props":315,"children":316},"thead",{},[317],{"type":42,"tag":318,"props":319,"children":320},"tr",{},[321,327],{"type":42,"tag":322,"props":323,"children":324},"th",{},[325],{"type":47,"value":326},"Task",{"type":42,"tag":322,"props":328,"children":329},{},[330],{"type":47,"value":331},"Load",{"type":42,"tag":333,"props":334,"children":335},"tbody",{},[336,350,362,374,387,399,411,423,435,448,460,476],{"type":42,"tag":318,"props":337,"children":338},{},[339,345],{"type":42,"tag":340,"props":341,"children":342},"td",{},[343],{"type":47,"value":344},"Understanding binary vs range positions",{"type":42,"tag":340,"props":346,"children":347},{},[348],{"type":47,"value":349},"positions-and-oracles",{"type":42,"tag":318,"props":351,"children":352},{},[353,358],{"type":42,"tag":340,"props":354,"children":355},{},[356],{"type":47,"value":357},"Understanding oracle lifecycle and settlement",{"type":42,"tag":340,"props":359,"children":360},{},[361],{"type":47,"value":349},{"type":42,"tag":318,"props":363,"children":364},{},[365,370],{"type":42,"tag":340,"props":366,"children":367},{},[368],{"type":47,"value":369},"Understanding the vault and PLP model",{"type":42,"tag":340,"props":371,"children":372},{},[373],{"type":47,"value":349},{"type":42,"tag":318,"props":375,"children":376},{},[377,382],{"type":42,"tag":340,"props":378,"children":379},{},[380],{"type":47,"value":381},"Minting a binary position",{"type":42,"tag":340,"props":383,"children":384},{},[385],{"type":47,"value":386},"workflow",{"type":42,"tag":318,"props":388,"children":389},{},[390,395],{"type":42,"tag":340,"props":391,"children":392},{},[393],{"type":47,"value":394},"Minting a vertical range position",{"type":42,"tag":340,"props":396,"children":397},{},[398],{"type":47,"value":386},{"type":42,"tag":318,"props":400,"children":401},{},[402,407],{"type":42,"tag":340,"props":403,"children":404},{},[405],{"type":47,"value":406},"Redeeming a position",{"type":42,"tag":340,"props":408,"children":409},{},[410],{"type":47,"value":386},{"type":42,"tag":318,"props":412,"children":413},{},[414,419],{"type":42,"tag":340,"props":415,"children":416},{},[417],{"type":47,"value":418},"Creating a PredictManager",{"type":42,"tag":340,"props":420,"children":421},{},[422],{"type":47,"value":386},{"type":42,"tag":318,"props":424,"children":425},{},[426,431],{"type":42,"tag":340,"props":427,"children":428},{},[429],{"type":47,"value":430},"Supplying or withdrawing PLP",{"type":42,"tag":340,"props":432,"children":433},{},[434],{"type":47,"value":386},{"type":42,"tag":318,"props":436,"children":437},{},[438,443],{"type":42,"tag":340,"props":439,"children":440},{},[441],{"type":47,"value":442},"Looking up testnet addresses",{"type":42,"tag":340,"props":444,"children":445},{},[446],{"type":47,"value":447},"contract-info",{"type":42,"tag":318,"props":449,"children":450},{},[451,456],{"type":42,"tag":340,"props":452,"children":453},{},[454],{"type":47,"value":455},"Finding the public server endpoint",{"type":42,"tag":340,"props":457,"children":458},{},[459],{"type":47,"value":447},{"type":42,"tag":318,"props":461,"children":462},{},[463,468],{"type":42,"tag":340,"props":464,"children":465},{},[466],{"type":47,"value":467},"Building a prediction market app",{"type":42,"tag":340,"props":469,"children":470},{},[471],{"type":42,"tag":58,"props":472,"children":473},{},[474],{"type":47,"value":475},"all reference files",{"type":42,"tag":318,"props":477,"children":478},{},[479,484],{"type":42,"tag":340,"props":480,"children":481},{},[482],{"type":47,"value":483},"Full Predict integration",{"type":42,"tag":340,"props":485,"children":486},{},[487],{"type":42,"tag":58,"props":488,"children":489},{},[490],{"type":47,"value":475},{"type":42,"tag":189,"props":492,"children":493},{},[],{"type":42,"tag":193,"props":495,"children":497},{"id":496},"skill-content",[498],{"type":47,"value":499},"Skill Content",{"type":42,"tag":200,"props":501,"children":503},{"id":502},"key-concepts",[504],{"type":47,"value":505},"Key concepts",{"type":42,"tag":507,"props":508,"children":509},"ul",{},[510,521,539,557,567,577,587,597],{"type":42,"tag":511,"props":512,"children":513},"li",{},[514,519],{"type":42,"tag":58,"props":515,"children":516},{},[517],{"type":47,"value":518},"Expiry-based protocol.",{"type":47,"value":520}," Predict is not a perpetual market. Every position has an expiry timestamp. After expiry, positions settle against the oracle's recorded price at that timestamp.",{"type":42,"tag":511,"props":522,"children":523},{},[524,529,531,537],{"type":42,"tag":58,"props":525,"children":526},{},[527],{"type":47,"value":528},"Binary positions.",{"type":47,"value":530}," Pay fixed notional if the settlement price is above (up) or at\u002Fbelow (down) the strike price. Key structure: ",{"type":42,"tag":66,"props":532,"children":534},{"className":533},[],[535],{"type":47,"value":536},"(oracle_id, expiry, strike, is_up)",{"type":47,"value":538},".",{"type":42,"tag":511,"props":540,"children":541},{},[542,547,549,555],{"type":42,"tag":58,"props":543,"children":544},{},[545],{"type":47,"value":546},"Vertical range positions.",{"type":47,"value":548}," Pay fixed notional if the settlement price falls within a band between two strikes. Key structure: ",{"type":42,"tag":66,"props":550,"children":552},{"className":551},[],[553],{"type":47,"value":554},"(oracle_id, expiry, lower_strike, higher_strike)",{"type":47,"value":556},". The lower strike must be less than the higher strike.",{"type":42,"tag":511,"props":558,"children":559},{},[560,565],{"type":42,"tag":58,"props":561,"children":562},{},[563],{"type":47,"value":564},"PredictManager.",{"type":47,"value":566}," A shared account wrapping a DeepBook BalanceManager. Holds DUSDC quote balances and tracks position quantities. Must be created and shared in a separate transaction before depositing or minting.",{"type":42,"tag":511,"props":568,"children":569},{},[570,575],{"type":42,"tag":58,"props":571,"children":572},{},[573],{"type":47,"value":574},"OracleSVI.",{"type":47,"value":576}," Market state container for a specific asset and expiry. Stores spot\u002Fforward prices, SVI parameters, activation status, and settlement data. Transitions through four states: inactive → active → pending settlement → settled.",{"type":42,"tag":511,"props":578,"children":579},{},[580,585],{"type":42,"tag":58,"props":581,"children":582},{},[583],{"type":47,"value":584},"Vault and PLP.",{"type":47,"value":586}," The vault takes the opposite side of every trade. Liquidity providers deposit DUSDC to receive PLP (Predict LP) tokens. The vault enforces exposure limits against total mark-to-market liability.",{"type":42,"tag":511,"props":588,"children":589},{},[590,595],{"type":42,"tag":58,"props":591,"children":592},{},[593],{"type":47,"value":594},"DUSDC.",{"type":47,"value":596}," The quote asset used for all Predict operations. Obtained via the testnet token request form.",{"type":42,"tag":511,"props":598,"children":599},{},[600,605,607,612,614,620,622,627],{"type":42,"tag":58,"props":601,"children":602},{},[603],{"type":47,"value":604},"Dedicated SDK available.",{"type":47,"value":606}," The ",{"type":42,"tag":66,"props":608,"children":610},{"className":609},[],[611],{"type":47,"value":125},{"type":47,"value":613}," npm package (v0.2.1) provides a dedicated TypeScript SDK for interacting with DeepBook Predict. Install via ",{"type":42,"tag":66,"props":615,"children":617},{"className":616},[],[618],{"type":47,"value":619},"npm install @mysten\u002Fdeepbook-predict",{"type":47,"value":621},". You can also build transactions directly using ",{"type":42,"tag":66,"props":623,"children":625},{"className":624},[],[626],{"type":47,"value":147},{"type":47,"value":628}," if you prefer lower-level control.",{"type":42,"tag":200,"props":630,"children":632},{"id":631},"rules",[633],{"type":47,"value":634},"Rules",{"type":42,"tag":636,"props":637,"children":638},"ol",{},[639,657,674,684,694,704],{"type":42,"tag":511,"props":640,"children":641},{},[642,647,649,655],{"type":42,"tag":58,"props":643,"children":644},{},[645],{"type":47,"value":646},"Create PredictManager in a separate transaction.",{"type":47,"value":648}," Because ",{"type":42,"tag":66,"props":650,"children":652},{"className":651},[],[653],{"type":47,"value":654},"create_manager",{"type":47,"value":656}," shares the manager during the transaction, you deposit into it and mint from it in a later transaction, not the same one.",{"type":42,"tag":511,"props":658,"children":659},{},[660,665,666,672],{"type":42,"tag":58,"props":661,"children":662},{},[663],{"type":47,"value":664},"Fetch oracle data from the public server",{"type":47,"value":106},{"type":42,"tag":66,"props":667,"children":669},{"className":668},[],[670],{"type":47,"value":671},"https:\u002F\u002Fpredict-server.testnet.mystenlabs.com",{"type":47,"value":673},"), not hardcoded values. Oracle IDs, expiries, and strikes are dynamic.",{"type":42,"tag":511,"props":675,"children":676},{},[677,682],{"type":42,"tag":58,"props":678,"children":679},{},[680],{"type":47,"value":681},"All testnet IDs are provisional.",{"type":47,"value":683}," Smart contracts may change before Mainnet. Do not treat current package IDs or object layouts as permanent.",{"type":42,"tag":511,"props":685,"children":686},{},[687,692],{"type":42,"tag":58,"props":688,"children":689},{},[690],{"type":47,"value":691},"Minting requires an active oracle.",{"type":47,"value":693}," The oracle must be in the \"active\" state. Inactive, pending settlement, and settled oracles do not accept new mints.",{"type":42,"tag":511,"props":695,"children":696},{},[697,702],{"type":42,"tag":58,"props":698,"children":699},{},[700],{"type":47,"value":701},"Redemption works against both live and settled oracles.",{"type":47,"value":703}," Before settlement, payouts reflect current bid values. After settlement, binary positions yield fixed fair value; ranges pay full notional if in-band, zero otherwise.",{"type":42,"tag":511,"props":705,"children":706},{},[707,712],{"type":42,"tag":58,"props":708,"children":709},{},[710],{"type":47,"value":711},"LP withdrawals are constrained.",{"type":47,"value":713}," Withdrawals require sufficient available liquidity after covering maximum payout obligations, and a rate limiter may throttle large withdrawals.",{"type":42,"tag":200,"props":715,"children":717},{"id":716},"common-mistakes",[718],{"type":47,"value":719},"Common mistakes",{"type":42,"tag":507,"props":721,"children":722},{},[723,733,743,753,763,786],{"type":42,"tag":511,"props":724,"children":725},{},[726,731],{"type":42,"tag":58,"props":727,"children":728},{},[729],{"type":47,"value":730},"Minting and depositing in the same transaction as manager creation.",{"type":47,"value":732}," The PredictManager must be shared first (transaction 1), then deposits and mints happen in subsequent transactions.",{"type":42,"tag":511,"props":734,"children":735},{},[736,741],{"type":42,"tag":58,"props":737,"children":738},{},[739],{"type":47,"value":740},"Hardcoding testnet addresses.",{"type":47,"value":742}," These will change at Mainnet launch. Fetch configuration dynamically or maintain a config file.",{"type":42,"tag":511,"props":744,"children":745},{},[746,751],{"type":42,"tag":58,"props":747,"children":748},{},[749],{"type":47,"value":750},"Assuming perpetual positions.",{"type":47,"value":752}," All positions expire. After expiry, the oracle enters pending settlement and then settled state. Unresolved positions must be redeemed post-settlement.",{"type":42,"tag":511,"props":754,"children":755},{},[756,761],{"type":42,"tag":58,"props":757,"children":758},{},[759],{"type":47,"value":760},"Not validating oracle state before minting.",{"type":47,"value":762}," The mint succeeds only when the oracle is live, the quote asset is accepted, the market key matches the oracle, and the manager holds enough deposited DUSDC.",{"type":42,"tag":511,"props":764,"children":765},{},[766,771,772,777,779,784],{"type":42,"tag":58,"props":767,"children":768},{},[769],{"type":47,"value":770},"Not knowing which SDK to use.",{"type":47,"value":606},{"type":42,"tag":66,"props":773,"children":775},{"className":774},[],[776],{"type":47,"value":125},{"type":47,"value":778}," package (v0.2.1) provides high-level helpers for Predict operations. For lower-level control, build transactions directly with ",{"type":42,"tag":66,"props":780,"children":782},{"className":781},[],[783],{"type":47,"value":147},{"type":47,"value":785},". Both approaches work — choose based on how much control you need.",{"type":42,"tag":511,"props":787,"children":788},{},[789,794,796,802],{"type":42,"tag":58,"props":790,"children":791},{},[792],{"type":47,"value":793},"Using wrong strike ordering for ranges.",{"type":47,"value":795}," Vertical range keys require ",{"type":42,"tag":66,"props":797,"children":799},{"className":798},[],[800],{"type":47,"value":801},"lower_strike \u003C higher_strike",{"type":47,"value":803},". Reversed strikes cause the mint to fail.",{"items":805,"total":891},[806,818,833,844,855,868,875],{"slug":807,"name":807,"fn":808,"description":809,"org":810,"tags":811,"stars":25,"repoUrl":26,"updatedAt":817},"accessing-data","read data from the Sui network","How to read data from the Sui network. Use when choosing or implementing a data access strategy — queries for on-chain state, indexing pipelines, historical lookups, event subscriptions, cross-chain reads, or off-chain blob storage. Covers the two live Sui APIs (gRPC and GraphQL RPC), the Archival Store, the General-Purpose Indexer, the `sui-indexer-alt` custom indexing framework, and Walrus for off-chain blobs.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[812,815,816],{"name":813,"slug":814,"type":15},"Data Analysis","data-analysis",{"name":14,"slug":8,"type":15},{"name":20,"slug":21,"type":15},"2026-08-01T05:44:32.775598",{"slug":819,"name":819,"fn":820,"description":821,"org":822,"tags":823,"stars":25,"repoUrl":26,"updatedAt":832},"composable-move-functions","design composable Sui Move functions","Use when writing Move functions on Sui, especially public APIs. Applies to function visibility (public vs entry), parameter ordering, and return patterns. Use whenever designing function signatures or deciding whether functions should transfer objects or return them.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[824,827,830,831],{"name":825,"slug":826,"type":15},"API Development","api-development",{"name":828,"slug":829,"type":15},"Smart Contracts","smart-contracts",{"name":14,"slug":8,"type":15},{"name":20,"slug":21,"type":15},"2026-07-16T06:02:49.198495",{"slug":834,"name":834,"fn":835,"description":836,"org":837,"tags":838,"stars":25,"repoUrl":26,"updatedAt":843},"deepbook-margin","build margin trading applications on Sui","DeepBook Margin leveraged trading on Sui. Use when building margin trading applications, understanding leveraged positions, risk ratios, liquidation mechanics, interest rate models, MarginManager lifecycle, or integrating margin trading into a protocol. Also use when the user asks about borrowing against collateral on DeepBook, margin pool parameters, or the differences between spot and margin trading.\nFor spot trading and the DeepBook SDK, see the `deepbook-sdk` skill. For DeepBook architecture and contract addresses, see the `deepbook-overview` skill. For Move smart contract integration, see the `deepbook-move` skill.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[839,840,841,842],{"name":17,"slug":18,"type":15},{"name":14,"slug":8,"type":15},{"name":23,"slug":24,"type":15},{"name":20,"slug":21,"type":15},"2026-08-24T03:57:04.577326",{"slug":845,"name":845,"fn":846,"description":847,"org":848,"tags":849,"stars":25,"repoUrl":26,"updatedAt":854},"deepbook-move","integrate DeepBook pools into Move contracts","DeepBook V3 Move smart contract integration. Use when writing, reviewing, or debugging Move code that integrates with DeepBook pools — placing orders from on-chain contracts, creating pools, using flash loans, accessing BalanceManager from Move, or composing DeepBook operations in programmable transaction blocks.\nFor DeepBook architecture and contract addresses, see the `deepbook-overview` skill. For TypeScript SDK usage, see the `deepbook-sdk` skill.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[850,851,852,853],{"name":828,"slug":829,"type":15},{"name":14,"slug":8,"type":15},{"name":23,"slug":24,"type":15},{"name":20,"slug":21,"type":15},"2026-08-24T03:57:01.149367",{"slug":856,"name":856,"fn":857,"description":858,"org":859,"tags":860,"stars":25,"repoUrl":26,"updatedAt":867},"deepbook-overview","explain DeepBook V3 architecture and concepts","High-level overview of DeepBook V3 on Sui — architecture, key concepts, integration models, contract addresses, supported coins, and pool information. Use when explaining DeepBook to someone new, comparing integration approaches (Move vs SDK vs read-only), looking up mainnet\u002Ftestnet contract addresses, or understanding the Pool\u002FBook\u002FState\u002FVault design.\nFor TypeScript SDK usage and trading, see the `deepbook-sdk` skill. For Move smart contract integration, see the `deepbook-move` skill.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[861,864,865,866],{"name":862,"slug":863,"type":15},"Documentation","documentation",{"name":14,"slug":8,"type":15},{"name":23,"slug":24,"type":15},{"name":20,"slug":21,"type":15},"2026-08-24T03:57:01.535714",{"slug":4,"name":4,"fn":5,"description":6,"org":869,"tags":870,"stars":25,"repoUrl":26,"updatedAt":27},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[871,872,873,874],{"name":17,"slug":18,"type":15},{"name":14,"slug":8,"type":15},{"name":23,"slug":24,"type":15},{"name":20,"slug":21,"type":15},{"slug":876,"name":876,"fn":877,"description":878,"org":879,"tags":880,"stars":25,"repoUrl":26,"updatedAt":890},"deepbook-sdk","build trading applications with DeepBook SDK","DeepBook V3 TypeScript SDK integration. Use when building trading applications, bots, or scripts that interact with DeepBook pools using the @mysten\u002Fdeepbook-v3 SDK. Covers client setup, BalanceManager lifecycle, placing limit and market orders, swaps, querying order books, order management, and fee handling.\nFor DeepBook architecture and contract addresses, see the `deepbook-overview` skill. For Move smart contract integration, see the `deepbook-move` skill.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[881,884,885,886,889],{"name":882,"slug":883,"type":15},"SDK","sdk",{"name":14,"slug":8,"type":15},{"name":23,"slug":24,"type":15},{"name":887,"slug":888,"type":15},"TypeScript","typescript",{"name":20,"slug":21,"type":15},"2026-08-24T03:57:02.735676",25,{"items":893,"total":1009},[894,910,919,929,944,960,966,973,980,987,994,1001],{"slug":895,"name":895,"fn":896,"description":897,"org":898,"tags":899,"stars":907,"repoUrl":908,"updatedAt":909},"move-bytecode-comprehension","analyze and disassemble Move bytecode","Use when reading or reasoning about compiled Move bytecode or `sui move disassemble` output. Mental model for the binary format, what survives compilation (and what's lost), and how to read disassembly soundly. Trigger on \"what does this package do?\", \"read this .mv module\", \"interpret this disassembly\", or whenever an analysis needs to interpret bytecode faithfully.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[900,903,906],{"name":901,"slug":902,"type":15},"Code Analysis","code-analysis",{"name":904,"slug":905,"type":15},"Engineering","engineering",{"name":14,"slug":8,"type":15},7724,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui","2026-07-16T05:59:32.904886",{"slug":911,"name":911,"fn":912,"description":913,"org":914,"tags":915,"stars":907,"repoUrl":908,"updatedAt":918},"official-sui-skills","access official Sui development resources","Pointer to the official Mysten Labs skills for building on Sui — language fundamentals, object model, PTBs, SDKs, publishing, upgrades, frontend integration, accessing on-chain data. Maintained upstream at github.com\u002FMystenLabs\u002Fskills; pinned to the same ref the audit catalog derives from (see maintenance\u002FUPSTREAMS.md). Trigger on \"build a contract\", \"publish a package\", \"upgrade a module or package\", \"use the TypeScript SDK\", \"write a PTB\", \"set up a Sui client\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[916,917],{"name":862,"slug":863,"type":15},{"name":14,"slug":8,"type":15},"2026-07-16T06:00:59.641382",{"slug":920,"name":920,"fn":921,"description":922,"org":923,"tags":924,"stars":907,"repoUrl":908,"updatedAt":928},"sui-and-move-tools","disassemble Sui Move bytecode","Use to get bytecode for a deployed Sui package and produce a disassembled working view. One GraphQL call fetches every module's raw bytecode bytes; `sui move disassemble` (already on the system, running `sui prompt`) produces `.asm` files for analysis. Trigger on \"fetch this package's bytecode\", \"get me the .mv for package X\", \"disassemble this package\", or \"I need to read a deployed Sui package\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[925,926,927],{"name":901,"slug":902,"type":15},{"name":904,"slug":905,"type":15},{"name":14,"slug":8,"type":15},"2026-07-16T06:02:25.3633",{"slug":930,"name":930,"fn":931,"description":932,"org":933,"tags":934,"stars":907,"repoUrl":908,"updatedAt":943},"sui-move-security-review","audit Sui Move smart contracts","Use when auditing, reviewing, or hunting for vulnerabilities in Move code on Sui. Applies equally to source code (.move files) and to disassembly of compiled bytecode (on-chain packages). A checklist of invariants whose VIOLATION causes exploitable bugs: access control & capabilities, struct abilities & type safety, object lifecycle & ownership, shared-object and PTB attack surface, dynamic fields & collections, arithmetic & coins, init\u002FOTW\u002Fpackage upgrades, hot-potato composability, time & on-chain randomness, and test-only code leakage. Trigger on \"audit this Move code\", \"find vulnerabilities in this Sui contract\", \"security review\", \"is this package safe?\", \"I suspect there's a bug in X\", \"something is wrong with this contract\", or when reasoning about whether a Move function can be abused.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[935,938,941,942],{"name":936,"slug":937,"type":15},"Code Review","code-review",{"name":939,"slug":940,"type":15},"Security","security",{"name":828,"slug":829,"type":15},{"name":14,"slug":8,"type":15},"2026-07-16T06:02:55.691149",{"slug":945,"name":945,"fn":946,"description":947,"org":948,"tags":949,"stars":957,"repoUrl":958,"updatedAt":959},"memwal","integrate Walrus Memory SDK","Walrus Memory SDK — portable agent memory that works across apps, sessions, and workflows.\n\nUse when users say:\n- \"add memory to my app\"\n- \"portable agent memory\"\n- \"integrate Walrus Memory\"\n- \"AI agent memory\"\n- \"memory across agents\"\n- \"Walrus memory storage\"\n- \"setup Walrus Memory\"\n- \"recall memories\"\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[950,953,956],{"name":951,"slug":952,"type":15},"Agents","agents",{"name":954,"slug":955,"type":15},"Memory","memory",{"name":882,"slug":883,"type":15},57,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002FMemWal","2026-08-20T03:29:22.543459",{"slug":807,"name":807,"fn":808,"description":809,"org":961,"tags":962,"stars":25,"repoUrl":26,"updatedAt":817},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[963,964,965],{"name":813,"slug":814,"type":15},{"name":14,"slug":8,"type":15},{"name":20,"slug":21,"type":15},{"slug":819,"name":819,"fn":820,"description":821,"org":967,"tags":968,"stars":25,"repoUrl":26,"updatedAt":832},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[969,970,971,972],{"name":825,"slug":826,"type":15},{"name":828,"slug":829,"type":15},{"name":14,"slug":8,"type":15},{"name":20,"slug":21,"type":15},{"slug":834,"name":834,"fn":835,"description":836,"org":974,"tags":975,"stars":25,"repoUrl":26,"updatedAt":843},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[976,977,978,979],{"name":17,"slug":18,"type":15},{"name":14,"slug":8,"type":15},{"name":23,"slug":24,"type":15},{"name":20,"slug":21,"type":15},{"slug":845,"name":845,"fn":846,"description":847,"org":981,"tags":982,"stars":25,"repoUrl":26,"updatedAt":854},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[983,984,985,986],{"name":828,"slug":829,"type":15},{"name":14,"slug":8,"type":15},{"name":23,"slug":24,"type":15},{"name":20,"slug":21,"type":15},{"slug":856,"name":856,"fn":857,"description":858,"org":988,"tags":989,"stars":25,"repoUrl":26,"updatedAt":867},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[990,991,992,993],{"name":862,"slug":863,"type":15},{"name":14,"slug":8,"type":15},{"name":23,"slug":24,"type":15},{"name":20,"slug":21,"type":15},{"slug":4,"name":4,"fn":5,"description":6,"org":995,"tags":996,"stars":25,"repoUrl":26,"updatedAt":27},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[997,998,999,1000],{"name":17,"slug":18,"type":15},{"name":14,"slug":8,"type":15},{"name":23,"slug":24,"type":15},{"name":20,"slug":21,"type":15},{"slug":876,"name":876,"fn":877,"description":878,"org":1002,"tags":1003,"stars":25,"repoUrl":26,"updatedAt":890},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1004,1005,1006,1007,1008],{"name":882,"slug":883,"type":15},{"name":14,"slug":8,"type":15},{"name":23,"slug":24,"type":15},{"name":887,"slug":888,"type":15},{"name":20,"slug":21,"type":15},42]