deepbook-margin

DeepBook Margin

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

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

DeepBook Margin は、ユーザーが担保を預け入れ、レンディングプールから借り入れ、借りた資金を現物注文板で取引できるようにすることで、レバレッジ取引を可能にします。このスキルでは、マージンシステムのアーキテクチャ、リスクモデル、SDK 統合について説明します。よくある誤りには、借入ポジションで利息が継続的に発生することを無視すること、清算が近づいていないかリスク比率を監視しないこと、既存の MarginManager を再利用せずセッションごとに新しい MarginManager を作成することなどがあります。

このスキルは、用途ごとに分かれた参考ファイルを案内します。現在のタスクに関連するファイルだけを読み込んでください。

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

API やパラメーターについて不明な点がある場合は、回答する前に該当するページを取得してください。 他のレバレッジプロトコルを参考に推測したり、情報を外挿したりしないでください。

---

参考ファイル

risk-model — リスク比率、金利、清算

パス： risk-model.md 読み込むタイミング： ユーザーがリスク比率、レバレッジの計算、清算しきい値、金利の計算式、折れ線型の利用率モデル、またはマージンのリスクについて質問した場合。 内容： リスク比率の計算式、4 つのリスクしきい値、レバレッジ計算表、計算式とプールごとのパラメーターを含む折れ線型の金利モデル、清算の仕組みと報酬、オラクルに関する考慮事項、包括的なリスク分類。

trading-workflow — レバレッジポジションのライフサイクル

パス： trading-workflow.md 読み込むタイミング： ユーザーがレバレッジポジションの開始、監視、または決済、MarginManager の作成、担保の預け入れ、資金の借り入れ、マージン注文の発注、または出金を希望する場合。 内容： SDK のセットアップ、MarginManager の作成と再利用、リスクパラメーターの読み取り、借入可能な流動性の確認、担保の預け入れ、借り入れ、マージン注文の発注、リスク状態の監視、ポジションの決済（reduce-only と返済）、担保の出金、トラブルシューティング。

contract-info — コントラクトアドレスとプールパラメーター

パス： contract-info.md 読み込むタイミング： ユーザーがマージンパッケージ ID、サポート対象資産、マージンプール ID と供給上限、取引ペアのリスクパラメーター、または現物とマージンの比較表を必要としている場合。 内容： 現在のパッケージバージョン、レジストリ ID、サポート対象トークン、マージンプールの設定、取引ペアのリスクパラメーターとレバレッジレベル、現物とマージンの構造上の比較。

ルーティングガイド

タスク	読み込むもの
証拠金リスクと清算について理解する	risk-model
レバレッジまたはリスク比率を計算する	risk-model
金利について理解する	risk-model
レバレッジポジションを開く	trading-workflow
MarginManagerを作成または再利用する	trading-workflow
担保を預け入れて借り入れる	trading-workflow
ポジションの健全性を監視する	trading-workflow
ポジションを閉じて出金する	trading-workflow
証拠金コントラクトのアドレスを調べる	contract-info
現物と証拠金の統合を比較する	contract-info
証拠金取引アプリケーションを構築する	すべてのリファレンスファイル
証拠金をプロトコルに統合する	すべてのリファレンスファイル

---

スキルの内容

主な概念

• MarginManager。 DeepBook BalanceManagerをラップし、担保を保持して借り入れを追跡する共有オブジェクトです。各MarginManagerはDeepBookのプール1つだけに紐付けられます（クロスプールではなく、分離型証拠金です）。

• リスク比率。 中心的な指標で、total_assets / total_debt です。この単一の数値によって、許可される操作が決まります。市場価格の変動や利息の発生に伴って変化します。

• 4つのリスクしきい値。 すべてMarginRegistryにプールごとに保存され、ガバナンスによって設定されます。

  • 最小出金リスク比率 — これを下回ると出金がブロックされます（通常は2.0）
  • 最小借入リスク比率 — これを下回ると借り入れがブロックされます。最大レバレッジを定めます
  • 目標清算リスク比率 — 清算によってポジションがこの水準まで回復します
  • 清算リスク比率 — この値以下になると、誰でも清算できるようになります

• 折れ線型金利モデル。 借入金利は、最適利用率（通常は80％）を下回る間は緩やかに上昇し、それを超えると急激に上昇します。利息は継続的ではなく、イベント駆動型の間隔（プールの状態が変化するたび）で発生します。ただし、価格が安定していても、時間の経過とともに負債は増加します。

• 誰でも実行できる清算。 リスク比率が清算しきい値に達すると、誰でもポジションを清算できます。猶予期間はありません。清算者は担保報酬（通常は2％）を受け取り、プールは追加報酬（通常は3％）を受け取ります。

ルール

1. リスクパラメーターをオンチェーンで読み取ります。 すべてのしきい値はガバナンスによって設定され、変更される可能性があります。ハードコードしないでください。
2. 証拠金注文には _v2 関数（place_limit_order_v2、place_market_order_v2）を使います。 接尾辞のない元の関数は非推奨です。
3. すべての証拠金操作には、Pythの PriceInfoObject 引数が必要です。 現物取引とは異なり、証拠金ではすべての操作（借り入れ、出金、リスクの読み取り、取引）にオラクルへの依存があります。
4. MarginManagerを再利用します。 セッションごとに新しく作成すると、担保が孤立した共有オブジェクトに分散します。レジストリを使って既存のマネージャーを見つけてください。
5. 試行錯誤ではなく、リスクパラメーターに基づいて借入額を決めます。 最小借入リスク比率によって、担保1単位あたりの最大レバレッジが定まります。
6. clientOrderId は数値文字列（u64としてエンコード）でなければなりません。 現物と同じです。

よくある間違い

• 利息の発生を無視する。 負債はイベント駆動型の間隔（借り入れ、返済、清算など、プールの状態が変化するたび）で増加します。価格が安定していても、利息の蓄積だけでポジションが清算に近づくことがあります。
• リスク比率を監視しない。 清算までの猶予期間はありません。統合する側は、リスク比率と清算しきい値までの余裕をユーザーに提示する必要があります。
• 実行のたびにMarginManagerを新しく作成する。 これでは担保が分散します。新しく作成する前に findMarginManagerId を使って既存のマネージャーを見つけてください。
• オラクルの鮮度を確認せず、同じプールで借り入れと取引を行う。 Pythの価格情報がプールの最大経過時間を超えると、操作はリバートされます。
• 証拠金注文の発注を現物と混同する。 証拠金注文は、直接的な現物注文エントリーポイントではなく、リスクチェックを備えたプールプロキシを経由します。