deepbook-overview

DeepBook V3 概览

**MCP 工具：**如果你的环境中有可用的 Sui 文档 MCP 服务，也请查询它（https://sui.mcp.kapa.ai），以获取最新答案。使用它来核实信息，并了解这些参考文件中未涵盖的内容。

**来源限制：**本技能中的所有信息仅来源于 docs.sui.io 和 deepbookv3 GitHub 仓库。扩展或更新本技能时，只能使用这些来源。不要使用第三方博客、教程或非官方文档。

DeepBook V3 是构建于 Sui 之上的新一代去中心化中央限价订单簿（CLOB），可在链上提供高性能、低延迟的交易所。本技能介绍其高级架构和关键概念。常见错误包括将 DeepBook 误认为 AMM（它是订单簿）、误解 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 的三部分结构（Book、State、Vault）、订单撮合与注入、治理与投票、History 和 epoch 跟踪、BigVector 实现、完整下单工作流。

contract-info — 合约地址、代币与交易池

路径： contract-info.md 加载时机： 用户需要主网 package ID、交易池对象 ID、支持的代币类型与小数位数、交易池手续费配置或注册表地址时。 涵盖内容： 当前及历史 package 版本、所有支持的代币及其类型地址和小数位数、全部 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（资产结算）。

• 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 构建时，始终使用 SDK 池/代币键，而不要硬编码链上 ID。SDK 会将键映射到各网络上的正确地址。
2. 从链上读取手续费参数，不要硬编码。治理可以随时更改吃单/挂单手续费和质押要求。
3. 重复使用 BalanceManager。 每笔交易都创建新的 BalanceManager 会浪费 gas，并产生孤立的共享对象。

常见错误

• 把 DeepBook 当作 AMM。 DeepBook 使用中央限价订单簿，具有离散的价格档位（最小变动价位）和数量增量（最小交易量）。订单必须符合这些参数，否则会被拒绝。
• 忘记准备支付手续费的 DEEP。 大多数池都需要 DEEP 代币来支付交易手续费。如果 BalanceManager 中没有 DEEP，交易就会失败。白名单池（DEEP/SUI、DEEP/USDC）除外。
• 忽略最小变动价位和最小交易量。 每个池都有特定的最小变动价位（最低价格增量）和最小交易量（最低数量增量）。不符合这些要求的订单会被拒绝。