ch00 DeepBook 是什么
本章目标
本章先建立官方口径和读者直觉。官方文档把 DeepBookV3 定位为 Sui 上的去中心化中央限价订单簿，而不是一个面向终端用户的交易前端；它提供的是可被 DEX、钱包、做市系统和其他应用调用的链上交易基础设施。本书从这个定位出发，再把 Margin、Predict、SDK、Indexer 和 Server 放进同一张工程地图。
读完本章后，读者应该能回答三个问题：DeepBook 的核心产品边界是什么；Spot、Margin、Predict 分别解决哪类问题；如果要开发应用，应该从 SDK、直接 PTB、Indexer、Server 还是源码精读开始。
官方文档基线
| 方向 | 官方定位 | 本书展开方式 |
|---|---|---|
| DeepBookV3 | Sui 上的 CLOB，提供限价单、市价单、SDK、Indexer、DEEP tokenomics、staking 和治理能力；本身不是交易 UI。 | 先讲订单簿和账户模型，再精读 Pool -> Book -> State -> Vault，最后落到 SDK 和数据系统。 |
| DeepBook Margin | 在 DeepBookV3 上扩展杠杆交易，核心是借贷、抵押、利息、风险率和清算。 | 先讲用户风险，再读 MarginPool、MarginManager、MarginRegistry、oracle 和 liquidation。 |
| DeepBook Predict | 基于 expiry 的预测市场协议，支持 binary positions、vertical ranges、oracle pricing、Vault liquidity 和 PLP。当前官方描述为 Testnet integration surface。 | 先标注网络和版本边界，再讲 oracle、range key、vault、LP 和 public server 数据模型。 |
出版旁白：官方文档回答“当前能怎么集成”，本书回答“为什么这样设计，以及如何用源码和工程实践把它做对”。后续每章都会同时给出官方边界、关键源码定义和应用落地判断。
本章学习阶梯
- L1 先回答“DeepBook 到底是什么”，不用读源码。
- L2 用功能地图区分 Spot、Margin、Predict、SDK、Indexer 和 Server。
- L3 找到每个功能背后的源码入口，但暂时只建立边界。
- L4 根据自己的目标选择后续阅读路线。
官方入口与源码地图
本章只做功能总览，不做完整源码精读。官方链接用于确认产品边界和当前集成入口；GitHub 链接指向本书当前锁定的 DeepBook 源码提交。
| 功能域 | 官方文档 / GitHub 源码 | 本章关注点 |
|---|---|---|
| DeepBookV3 官方说明 | Sui Docs: DeepBookV3 | CLOB、SDK、Indexer、DEEP tokenomics、无终端 UI 的产品定位 |
| Margin 官方说明 | Sui Docs: DeepBook Margin | 杠杆交易、风险管理、抵押、利息和清算 |
| Predict 官方说明 | Sui Docs: DeepBook Predict | Testnet integration surface、binary/range、oracle、public server |
| DeepBook 总说明 | README.md | CLOB 定位、并行执行、低费用、闪电贷、治理、BalanceManager、DEEP |
| V3 现货核心 | packages/deepbook/sources/pool.move | 下单、撤单、swap、staking、治理、闪电贷、查询入口 |
| 账户抽象 | packages/deepbook/sources/balance_manager.move | owner、trader、cap、余额托管和权限证明 |
| 资产保管和闪电贷 | packages/deepbook/sources/vault/vault.move | FlashLoan、borrow/return、结算、DEEP burn |
| Margin | packages/deepbook_margin/sources | MarginManager、借贷池、oracle、风险率、TPSL |
| Predict | packages/predict/sources | 预测市场、区间头寸、LP vault、oracle、费用储备 |
| Indexer | crates/indexer | 链上事件落库、订单成交、Margin 事件、闪电贷事件 |
| Server | crates/server | REST 查询、行情、订单簿、成交、Margin 和组合数据 |
小节目录
- 01 DeepBook 解决什么问题
- 02 为什么是链上中央限价订单簿
- 03 功能地图
- 04 现货交易能力
- 05 BalanceManager 账户模型
- 06 Pool、Book、State、Vault 的分工
- 07 DEEP、费用、staking 与治理
- 08 闪电贷在源码中的位置
- 09 DeepBook Margin 是什么
- 10 DeepBook Predict 是什么
- 11 SDK、Indexer 与 Server
- 12 可以构建哪些应用
- 13 本书阅读路线
本章代码
code/s01-feature-map/：把 DeepBook 功能域、源码路径、后续章节映射整理成一份可维护清单。
Move 高阶穿插点
- 把 DeepBook 当作大型 Move 案例阅读：先判断对象所有权，再判断函数是否迁移状态。
- 看到产品能力时同步问一句：它最终依赖哪种 Move 资源约束，是
key对象、泛型资产、cap，还是 hot potato。 - 读功能地图时不要只背模块名，要把每个模块关联到一个失败场景，例如权限错误、版本错误、资产方向错误或资源未消费。
常见错误
- 直接把官方文档当作本书正文。官方文档是事实基线，本书必须继续解释源码、状态路径、失败场景和应用实现。
- 只把 DeepBook 理解成“swap 接口”。DeepBook 的底层是订单簿，swap 是构造市价吃单的一种应用入口。
- 把
deepbook_margin的借贷能力误认为 V3 spot 的普通订单能力。Margin 是独立包，调用 DeepBook 池完成杠杆交易。 - 认为源码里没有闪电贷。当前锁定源码中，
pool.move暴露borrow_flashloan_base、borrow_flashloan_quote、return_flashloan_base、return_flashloan_quote，vault.move持有具体实现。 - 把 Indexer 当作链上真实状态。Indexer 是查询层，最终事实仍然来自链上对象、交易和事件。
- 在产品设计阶段忽略
BalanceManager。大多数非 swap 交互都围绕它组织资金和权限。
本章检查清单
- 能用三句话解释 DeepBook 的产品定位。
- 能指出官方文档中 V3、Margin、Predict 的能力边界。
- 能列出 DeepBookV3 的现货核心能力。
- 能说明 Margin 和 Predict 与 V3 spot 的关系。
- 能指出闪电贷源码所在的两个关键文件。
- 能判断一个应用应该直接读链、接 SDK、接 Indexer，还是自建 Server。
进阶练习
- 画一张 DeepBook 功能地图，把用户、做市商、协议、Indexer、Server、SDK 和前端放进去。
- 阅读 pool.move，只记录所有
public fun的名字，并按“交易、治理、查询、管理”分类。 - 阅读 crates/indexer/src/handlers，找出哪些事件服务现货，哪些事件服务 Margin。