Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

ch13-03 sui-indexer-alt 在本项目中的使用方式

返回本章

先看数据问题

这一节从读模型而不是数据库表开始。围绕“sui-indexer-alt 在本项目中的使用方式”,先问交易终端、机器人或风控系统要查什么,再看 handler 和 schema 如何支撑。

源码入口

落到读模型里

crates/indexer/src/main.rs 使用 Indexer::new(...) 创建索引器,然后对每类事件注册 concurrent_pipeline。核心包由 --packages deepbook 控制,Margin 包由 --packages deepbook-margin 控制。

生产模式要求传入 --env testnet|mainnet。Sandbox 模式允许指定自定义 package id 和本地 checkpoint 路径,适合本地部署 DeepBook 后做集成测试。

本项目把 sui-indexer-alt 当作 checkpoint 消费框架使用,业务逻辑集中在 handlers。新增事件时通常先在 handlers/mod.rs 注册 handler,再补 Diesel model 和 migration,最后用 checkpoint fixture 做 snapshot,避免 pipeline 能启动但字段落库错误。

数据系统判断

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

动手检查

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