deepbook-overview

DeepBook V3 の概要

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

情報源の制約： このスキルの情報は、docs.sui.io と deepbookv3 GitHub リポジトリのみを情報源としています。このスキルを拡張または更新する場合は、これらの情報源のみを参照してください。サードパーティのブログ、チュートリアル、非公式ドキュメントは使用しないでください。

DeepBook V3 は、Sui 上に構築された次世代の分散型中央注文板（CLOB）であり、オンチェーンで高いパフォーマンスと低レイテンシを実現する取引所を提供します。このスキルでは、アーキテクチャの概要と主要な概念を扱います。よくある誤解には、DeepBook を AMM と混同すること（DeepBook は注文板です）、手数料の支払いにおける DEEP トークンの役割を誤解すること、適切な統合モデルを把握していないことなどがあります。

このスキルでは、目的に応じた参照ファイルを案内します。現在のタスクに関連するものだけを読み込んでください。

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

詳細に確信が持てない場合は、回答する前に該当するページを取得してください。推測や外挿はしないでください。

---

参照ファイル

design — アーキテクチャと設計

パス： design.md 読み込む場合： DeepBook の内部動作、Pool／Book／State／Vault のアーキテクチャ、注文の配置フロー、BigVector、ガバナンスの仕組み、または手数料の計算方法についてユーザーが尋ねた場合。 内容： Pool の 3 部構造（Book、State、Vault）、注文のマッチングと挿入、ガバナンスと投票、History とエポックの追跡、BigVector の実装、注文配置の全ワークフロー。

contract-info — コントラクトアドレス、コイン、プール

パス： contract-info.md 読み込む場合： ユーザーがメインネットのパッケージ ID、プールのオブジェクト ID、対応するコインの種類と小数桁数、プールの手数料設定、またはレジストリアドレスを必要としている場合。 内容： 現在および過去のパッケージバージョン、型アドレスと小数桁数を含むすべての対応トークン、手数料階層別に整理したメインネットの全 23 取引プールと ID。

---

ルーティングガイド

タスク	読み込む内容
DeepBook の概要を説明する	スキル本文のみ
統合モデル（Move、SDK、読み取り専用）を選ぶ	スキル本文のみ
Pool／Book／State／Vault のアーキテクチャを理解する	design
注文の配置フローを理解する	design
ガバナンスと手数料投票を理解する	design
コントラクトアドレスまたはプール ID を調べる	contract-info
対応コインの型アドレスまたは小数桁数を調べる	contract-info
DeepBook を徹底的に調べる	すべての参照ファイル

---

スキルの内容

主要な概念

• 中央指値注文板（CLOB）。 DeepBook は AMM ではありません。買い注文と売り注文を備えた完全な注文板を維持し、価格と時間の優先順位に基づいて注文をマッチングします。これにより、指値注文、成行注文、正確な価格発見が可能になります。

• プール。 DEEP/SUI などの単一の市場を表す共有オブジェクトです。各プールには、Book（注文の保管とマッチング）、State（アカウント、ガバナンス、履歴）、Vault（資産の決済）の 3 つのコンポーネントがあります。

• BalanceManager。 すべてのプールにわたるユーザーの残高を保持する共有オブジェクトです（直接スワップを除く）すべての取引操作で必要です。TradeCap、DepositCap、WithdrawCap を介した委任アクセスをサポートします。

• DEEP トークン。 プロトコルのガバナンスおよび手数料トークンです。ユーザーは DEEP をステークすると、テイカー手数料が割引されます（ステーク量と取引量のしきい値を満たすと、テイカー手数料が半額になる場合があります）。また、プールのパラメーター（テイカー／メーカー手数料、ステーク要件）の提案や投票ができます。手数料は DEEP（デフォルト）または入力トークン（25％の割増料金）で支払えます。

• ホワイトリスト登録済みプール。 DEEP/SUI プールと DEEP/USDC プールでは、テイカー手数料とメーカー手数料が 0％で、DEEP トークンのゲートウェイ流動性を提供します。

• フラッシュローン。 プールはホットポテトパターンを介した無担保フラッシュローンに対応しています。同じ PTB 内で借り入れと返済を行います。

• DeepBook にはエンドユーザー向けインターフェースがありません。 取引アプリケーション、ボット、プロトコルがその上に構築するインフラストラクチャです。

統合モデル

モデル	ユースケース	依存関係
Move パッケージ	オンチェーンロジックの保証とコンポーザビリティを必要とするプロトコル	deepbook = { mvr = "@deepbook/core" }
SDK と PTB	TypeScript 経由で取引を送信するアプリ、ボット、ウォレット	npm install @mysten/deepbook-v3
読み取り専用データ	インデクサーまたは RPC 経由での価格／注文板のクエリ	依存関係なし — エンドポイントに直接クエリ

ルール

1. TypeScript SDK を使用して構築する場合は、ハードコードされたオンチェーン ID ではなく、常に SDK のプールキー／コインキーを使用してください。SDK はネットワークごとにキーを正しいアドレスへマッピングします。
2. 手数料パラメーターはハードコードせず、オンチェーンで読み取ってください。ガバナンスにより、テイカー／メーカー手数料やステーク要件がいつでも変更される可能性があります。
3. BalanceManager を再利用してください。トランザクションごとに新しいものを作成すると、ガスを浪費し、孤立した共有オブジェクトが作られます。

よくある間違い

• DeepBook を AMM のように扱う。 DeepBook は、離散的な価格水準（ティックサイズ）と数量単位（ロットサイズ）を持つ中央指値注文板を使用します。注文はこれらのパラメーターに従う必要があり、従わない場合は拒否されます。
• 手数料用の DEEP を忘れる。 ほとんどのプールでは、取引手数料の支払いに DEEP トークンが必要です。BalanceManager に DEEP がないと、取引は失敗します。ホワイトリスト登録済みプール（DEEP/SUI、DEEP/USDC）は例外です。
• ティックサイズとロットサイズを無視する。 各プールには、特定のティックサイズ（最小価格増分）とロットサイズ（最小数量増分）があります。これらに合致しない注文は拒否されます。