JSON-RPC、回执、事件与重组
学完能做到:设计可恢复的链上事件同步和查询。
先看一个场景
支付监听服务停机十分钟后重启,只订阅新块会漏掉中间记录。需要补查、去重和处理重组。
核心原理
监听服务需要记得「上次查到哪里」。这份记号常称为游标,可以记录区块高度和哈希。重启时从游标附近查起,允许少量重复读取,用已有记录认出重复事件。
需要区分的概念
要查具体交易是否执行,读回执。要找某段时间发生的转账,则看合约产生的事件日志。区块哈希用来辨认这份历史是否仍然有效,索引服务把这些数据整理成方便查询的列表。
监听服务重启后怎样补回漏掉的付款
把 RPC 想成应用找节点查账的接口。监听服务订阅新事件是为了及时发现变化;按范围查询则可以回看以前。假设服务记住最后核验的区块高度是 100,并保留当时的区块哈希。停机期间商户在 101 收到 12.5,又在 103 收到 12.5。
- 重启后先核对高度 100 的区块哈希和当前节点是否一致。
- 从已保存的游标附近向后查日志,把两笔事件补回来。
- 由于范围可能重叠,重复看到旧事件时查已有记录。用链、交易哈希和日志序号识别同一个业务事件,同时保留区块哈希核对它是否属于当前历史。
- 如果 103 被替换而新历史没有第二笔,标记原事件失效并冲销。此时累计应回到 12.5,再等新的执行记录。
| 你要查什么 | 第一个入口 |
|---|---|
| 一次提交是否成功 | 读回执 |
| 一段时间有哪些合约动作 | 按区块范围查事件日志 |
| 付款属于哪段历史 | 查区块哈希、父块与确认条件 |
动手练习
保存链 ID、区块号、区块哈希、交易哈希和日志索引。重启回扫一段窗口,幂等写入;检测到历史改变时撤回无效区块对应记录。
自测
事件投递为什么可能多次出现?
查看参考答案
RPC 重试、重连补查和重复扫描都会重复投递。应用应基于来源身份与区块变化进行幂等记录。