ch13-19 本地启动路径

返回本章

先看数据问题

这一节从读模型而不是数据库表开始。围绕“本地启动路径”，先问交易终端、机器人或风控系统要查什么，再看 handler 和 schema 如何支撑。

源码入口

• docker/deepbook-indexer/Dockerfile：容器构建、入口脚本或部署边界。
• docker/deepbook-server/Dockerfile：REST API、数据库查询、健康检查或指标实现。
• crates/indexer/src/main.rs：Indexer 启动、参数解析和 handler 装载入口。
• crates/server/README.md：REST API、数据库查询、健康检查或指标实现。

落到读模型里

本地最小路径：

1. 启动 PostgreSQL。
2. 设置 DATABASE_URL。
3. 在 MystenLabs/deepbookv3 运行 cargo run --package deepbook-indexer -- --env testnet --packages deepbook。
4. 启动 deepbook-server。
5. 调用 /status、/get_pools、/trades/:pool_name 验证数据流。

GitHub 源码应先启动 PostgreSQL 和 migration，再启动 Indexer 追 checkpoint，最后启动 Server 验证 /status 和一个真实查询。调试时固定网络、package id、数据库 URL 和起始 checkpoint，才能让不同 worker 的结果可复现。

数据系统判断

• 先确认本节涉及的事件名、handler、目标表和 API 端点，避免把链上对象状态与读模型混用。
• 查询设计必须带池子、账户、checkpoint 或时间窗口，并说明分页和索引依据。
• 对实时应用要同时检查 /status、checkpoint lag 和数据时间戳，再决定是否交易、降级或告警。
• 涉及 Flash Loan 或 Margin 时，明确 flashloans 与 loan_borrowed、loan_repaid 的语义差异。

动手检查

• 本节对应的 handler、表名和 Server 查询入口分别是什么？
• 这个数据在链上、Indexer、PostgreSQL、Server 缓存和前端之间可能出现哪些延迟或不一致？
• 如果用于机器人或风控，应该设置什么 checkpoint lag、分页窗口和降级策略？