ch02-09 event::emit 与 Indexer

返回本章

先建立手感

这一节用“event::emit 与 Indexer”训练 Move 手感：先看对象和资源能不能被复制、丢弃、转移，再回到 DeepBook 里判断为什么这些限制有实际价值。

Move 对照

先用下面几处源码建立 Move 概念的落点。这里不追完整协议流程，只确认类型、ability、对象、事件和测试入口如何在真实项目中出现。

• packages/deepbook/sources/book/order_info.move
• packages/deepbook/sources/balance_manager.move
• packages/deepbook/sources/pool.move
• crates/indexer

读这些文件时，把语法点和真实对象放在一起看：ability、泛型、对象 ID、事件和测试入口分别承担什么约束。

拆开来看

链上状态告诉你“现在是什么”，事件告诉你“发生过什么”。Indexer 依赖事件重建订单、成交、余额、治理等时间序列。

hello_move.move 中 create_user 发出 UserCreated，send_greeting 发出 GreetingSent，update_balance 发出 BalanceUpdated。这是学习事件的最小样本。

DeepBook 真实事件更多：balance_manager.move 发出 BalanceManagerEvent 和 BalanceEvent；book/order_info.move 发出 OrderPlaced、OrderFilled、OrderFullyFilled 等；book/order.move 发出 OrderCanceled 和 OrderModified。

阅读补充

事件是交易执行后的链上事实记录，Indexer 把这些事实转换成查询友好的表或 API。DeepBook 的订单状态、成交、余额变化和费用解释，都不能只靠当前对象字段复原完整历史。

阅读事件时先找 event::emit，再看事件 struct 字段，最后看 indexer 如何消费这些字段。字段少了会影响链下可观测性，字段语义错了会让前端和报表都误读交易。

Move 判断

• 每个用户可见状态变化都要能找到对应事件或解释为什么没有事件。
• Indexer 延迟不等于链上交易失败，前端应区分 pending indexing 和 failed execution。
• 事件字段应包含足够的对象 ID、账户 ID 和数量信息，方便回放。

练习问题

• 为什么当前对象字段不能替代订单历史？
• event::emit 到 Indexer 表之间有哪些转换步骤？
• 前端订单列表缺一笔成交时应先查 digest 还是数据库？