deepbook-predict

DeepBook Predict

MCP ツール： お使いの環境で利用できる場合は、最新の回答を得るために Sui ドキュメント MCP サーバー（https://sui.mcp.kapa.ai）にも問い合わせてください。回答の検証や、これらのリファレンスファイルに記載されていない詳細の確認に使用してください。

ソースに関する制約： このスキルの情報はすべて、docs.sui.io、deepbookv3 repository（predict-testnet-4-16 ブランチ）、および @mysten/deepbook-predict npm package のみに基づいています。このスキルを拡張または更新する場合は、これらのソースのみを参照してください。サードパーティのブログ、チュートリアル、非公式ドキュメントは使用しないでください。

DeepBook Predict は、Sui 上の満期ベースの予測市場プロトコルです。アプリケーションが市場を構築し、ユーザーはオラクルデータに基づく価格でバイナリーまたは垂直レンジのポジションを取ります。@mysten/deepbook-predict npm パッケージ（v0.2.1）は、このプロトコルを操作するための専用 TypeScript SDK を提供します。開発者は、Sui TypeScript SDK（@mysten/sui）を使用して直接トランザクションを構築することもできます。よくある間違いとして、Predict を無期限市場として扱うこと（実際は満期ベースです）、PredictManager の作成と同じトランザクション内でミントと預け入れを行うこと（先にマネージャーを共有する必要があります）、テストネットの ID を永続的なアドレスとしてハードコードすることが挙げられます。スマートコントラクトは現在 Testnet 上にあり、Mainnet のデプロイ前に変更される可能性があります。

このスキルは、用途に応じたリファレンスファイルを案内します。現在のタスクに関連するファイルのみを読み込んでください。

このスキルのすべてのパターンは、以下の情報に基づいています。 https://docs.sui.io/onchain-finance/deepbook/deepbook-predict https://docs.sui.io/onchain-finance/deepbook/deepbook-predict/design https://docs.sui.io/onchain-finance/deepbook/deepbook-predict/tutorial https://github.com/MystenLabs/deepbookv3/tree/main/packages/predict

API やパラメーターに確信が持てない場合は、回答する前に該当するページを取得してください。 他の予測市場プロトコルを参考にして推測したり、情報を外挿したりしないでください。

---

Reference files

positions-and-oracles — ポジションの種類、オラクルのライフサイクル、価格設定

Path: positions-and-oracles.md Load when: ユーザーがバイナリーポジション、垂直レンジポジション、オラクルの仕組み、オラクルの状態、決済の仕組み、価格設定、またはボールト／PLP モデルについて尋ねた場合に読み込みます。 Covers: バイナリーポジションのキーとペイオフ、垂直レンジポジションのキーとペイオフ、オラクルのライフサイクル（inactive → active → pending settlement → settled）、決済の仕組み、ボールトと PLP の流動性モデル、価格設定とエクスポージャー。

workflow — Testnet 統合ワークフロー

Path: workflow.md Load when: ユーザーがポジションのミントや償還、PredictManager の作成、PLP の供給や引き出し、または Predict プロトコルを操作するトランザクションの構築を希望する場合に読み込みます。 Covers: SDK のセットアップ、設定、PredictManager の作成、DUSDC の入金、バイナリーポジションのミント、垂直レンジポジションのミント（ライブ時および決済後）、LP 操作（PLP の供給と引き出し）、検証手順、主な制約。

contract-info — Testnet コントラクトアドレス

Path: contract-info.md Load when: ユーザーが Testnet のパッケージ ID、Predict オブジェクト ID、DUSDC の型アドレス、パブリックサーバー URL、またはオラクルのイベント型を必要とする場合に読み込みます。 Covers: Testnet のパッケージ ID、レジストリ ID、Predict オブジェクト ID、DUSDC の仕様、PLP コイン型、パブリックサーバーのエンドポイント、オラクルのイベント型。

ルーティングガイド

タスク	読み込むファイル
バイナリポジションとレンジポジションの違いを理解する	positions-and-oracles
オラクルのライフサイクルと決済を理解する	positions-and-oracles
Vault と PLP のモデルを理解する	positions-and-oracles
バイナリポジションをミントする	workflow
縦型レンジポジションをミントする	workflow
ポジションを償還する	workflow
PredictManager を作成する	workflow
PLP を預け入れる、または引き出す	workflow
テストネットのアドレスを確認する	contract-info
公開サーバーのエンドポイントを確認する	contract-info
予測市場アプリを構築する	すべてのリファレンスファイル
Predict を完全に統合する	すべてのリファレンスファイル

---

スキルの内容

主な概念

• 有効期限ベースのプロトコルです。 Predict は無期限の市場ではありません。すべてのポジションには有効期限のタイムスタンプがあります。有効期限後、ポジションはそのタイムスタンプにおけるオラクルの記録価格に基づいて決済されます。

• バイナリポジションです。 決済価格が権利行使価格を上回る（上昇）場合、または同価格以下（下落）の場合に、固定額の想定元本が支払われます。主な構造は (oracle_id, expiry, strike, is_up) です。

• 縦型レンジポジションです。 決済価格が2つの権利行使価格の間のレンジ内に収まった場合に、固定額の想定元本が支払われます。主な構造は (oracle_id, expiry, lower_strike, higher_strike) です。下限の権利行使価格は上限の権利行使価格より小さくなければなりません。

• PredictManager です。 DeepBook BalanceManager をラップする共有アカウントです。DUSDC のクオート残高を保持し、ポジション数量を追跡します。入金またはミントの前に、別のトランザクションで作成して共有する必要があります。

• OracleSVI です。 特定の資産と有効期限に対応する市場状態のコンテナです。スポット価格／フォワード価格、SVI パラメーター、有効化ステータス、決済データを保存します。非アクティブ → アクティブ → 決済保留中 → 決済済みの4つの状態を遷移します。

• Vault と PLP です。 Vault はすべての取引の反対側を引き受けます。流動性プロバイダーは DUSDC を預け入れて PLP（Predict LP）トークンを受け取ります。Vault は時価評価された負債総額に対するエクスポージャー制限を適用します。

• DUSDC です。 Predict のすべての操作で使用されるクオート資産です。テストネットのトークンリクエストフォームから入手できます。

• 専用 SDK を利用できます。 @mysten/deepbook-predict npm パッケージ（v0.2.1）は、DeepBook Predict と連携する専用の TypeScript SDK を提供します。npm install @mysten/deepbook-predict でインストールできます。より低レベルで制御したい場合は、@mysten/sui を使ってトランザクションを直接構築することもできます。

ルール

1. PredictManager は別のトランザクションで作成します。 create_manager はトランザクション中にマネージャーを共有するため、入金とミントは同じトランザクションではなく、後続のトランザクションで行います。
2. オラクルデータはハードコードせず、公開サーバーから取得します（https://predict-server.testnet.mystenlabs.com）。オラクル ID、有効期限、権利行使価格は動的に変化します。
3. すべてのテストネット ID は暫定的なものです。 Mainnet の前にスマートコントラクトが変更される可能性があります。現在のパッケージ ID やオブジェクトのレイアウトを恒久的なものとして扱わないでください。
4. ミントにはアクティブなオラクルが必要です。 オラクルは「active」状態でなければなりません。非アクティブ、決済保留中、決済済みのオラクルでは、新しいポジションをミントできません。
5. 償還は稼働中と決済済みの両方のオラクルに対して行えます。 決済前の払い戻し額には現在の買い気配値が反映されます。決済後、バイナリポジションは固定の公正価値を受け取り、レンジポジションはレンジ内なら想定元本の全額、それ以外ならゼロを受け取ります。
6. LP の引き出しには制限があります。 最大支払義務をカバーした後に十分な利用可能流動性がある場合にのみ引き出せます。また、レート制限により大口の引き出しが抑制される場合があります。

よくある間違い

• マネージャーの作成と同じトランザクションでミントと入金を行うこと。 まず PredictManager を共有し（トランザクション 1）、その後のトランザクションで入金とミントを行う必要があります。
• テストネットのアドレスをハードコードすること。 これらのアドレスはメインネットのローンチ時に変更されます。設定を動的に取得するか、設定ファイルを用意してください。
• ポジションが無期限だと思い込むこと。 すべてのポジションには有効期限があります。有効期限が過ぎると、オラクルは決済待ち状態に移行し、その後、決済済み状態になります。未解決のポジションは決済後に償還する必要があります。
• ミント前にオラクルの状態を検証しないこと。 オラクルが稼働中であること、クォート資産が受け入れられていること、市場キーがオラクルと一致すること、マネージャーが十分な DUSDC を入金済みであることを満たす場合にのみ、ミントは成功します。
• どの SDK を使うべきか把握していないこと。 @mysten/deepbook-predict パッケージ（v0.2.1）は、Predict 操作のための高水準ヘルパーを提供します。より細かく制御するには、@mysten/sui を使ってトランザクションを直接構築してください。どちらの方法も利用できます。必要な制御の程度に応じて選択してください。
• レンジの権利行使価格の順序を間違えること。 バーティカルレンジキーでは、lower_strike < higher_strike が必要です。権利行使価格の順序が逆だと、ミントは失敗します。