本阶段课程
  1. EVM、合约、ABI 与状态
  2. Solidity 与本地合约测试
  3. ethers v6 与合约调用
  4. JSON-RPC、回执、事件与重组
  5. 链上索引与 GraphQL
  6. 预言机、价格来源与时效
  7. 合约权限、升级与安全验收
  8. DApp 发布、监控与重试
  9. 交易前端状态机 · 从点击到业务完成
  10. 合约发版验收 · 部署证据与角色交接
  11. 链上数据分析 · 事件、口径与数据延迟
  12. Solidity 事件实训 · 业务状态与索引字段
  13. Webhook 回调 · 签名核验、重复和乱序
  14. 事件索引表 · 原始记录、业务读模型与重建
本篇目录

阶段 03 · 第 4 / 14 课

JSON-RPC、回执、事件与重组

学完能做到:设计可恢复的链上事件同步和查询。

先看一个场景

支付监听服务停机十分钟后重启,只订阅新块会漏掉中间记录。需要补查、去重和处理重组。

核心原理

监听服务需要记得「上次查到哪里」。这份记号常称为游标,可以记录区块高度和哈希。重启时从游标附近查起,允许少量重复读取,用已有记录认出重复事件。

需要区分的概念

要查具体交易是否执行,读回执。要找某段时间发生的转账,则看合约产生的事件日志。区块哈希用来辨认这份历史是否仍然有效,索引服务把这些数据整理成方便查询的列表。

监听服务重启后怎样补回漏掉的付款

把 RPC 想成应用找节点查账的接口。监听服务订阅新事件是为了及时发现变化;按范围查询则可以回看以前。假设服务记住最后核验的区块高度是 100,并保留当时的区块哈希。停机期间商户在 101 收到 12.5,又在 103 收到 12.5。

  1. 重启后先核对高度 100 的区块哈希和当前节点是否一致。
  2. 从已保存的游标附近向后查日志,把两笔事件补回来。
  3. 由于范围可能重叠,重复看到旧事件时查已有记录。用链、交易哈希和日志序号识别同一个业务事件,同时保留区块哈希核对它是否属于当前历史。
  4. 如果 103 被替换而新历史没有第二笔,标记原事件失效并冲销。此时累计应回到 12.5,再等新的执行记录。
你要查什么 第一个入口
一次提交是否成功 读回执
一段时间有哪些合约动作 按区块范围查事件日志
付款属于哪段历史 查区块哈希、父块与确认条件

动手练习

保存链 ID、区块号、区块哈希、交易哈希和日志索引。重启回扫一段窗口,幂等写入;检测到历史改变时撤回无效区块对应记录。

自测

事件投递为什么可能多次出现?

查看参考答案

RPC 重试、重连补查和重复扫描都会重复投递。应用应基于来源身份与区块变化进行幂等记录。

延伸阅读

记录本课进度

完成练习后标记。进度保存在当前浏览器。

搜索课程