本阶段课程
  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 · 第 14 / 14 课

事件索引表 · 原始记录、业务读模型与重建

学完能做到:为链上查询建最小可追溯的数据表和游标。

先看一个场景

一个看账单的网站重启后重新读取历史。一笔交易里原本有付款和返佣两条记录,网站却只存下了一条。要找回遗漏,先让服务能分清区块、交易和交易里的每条事件。

三张表的最小方案

表 关键字段 用途
区块观察 chain_id、height、block_hash、parent_hash、canonical 识别规范链及不同历史
原始事件 chain_id、block_hash、tx_hash、log_index、emitter、raw 追溯执行记录和保全原始值
业务投影 domain_id、value、status、source_event、decoder_version 支持页面查询、回填和核对

读取新记录时,先核对它来自哪个区块,再用合约接口描述解释各字段。若链替换了一段历史,标记旧记录失效,从变化开始的位置重算需要更新的页面数据。保留原始记录和解释时采用的接口版本,之后修正业务口径时可以重算。

从两条事件做出一张余额变化表

假设链 A、高度 108、区块哈希 X。一笔交易 TX7 写了两条日志,序号 3 是向商户支付 25,序号 4 是向返佣账户支付 1。若原始数据表只用交易哈希做唯一键,后来的日志可能覆盖前一条。为每条记录保留链、区块、交易和事件序号,才能追溯两种不同的业务含义。

随后高度 108 换成哈希 Y,Y 中没有原事件。保留 X 的原始记录和历史归属,但面向当前业务的有效记录要撤回这笔影响,再基于 Y 后的新记录计算。投影可以先理解为「把原始事件整理成页面需要的订单、余额或列表」。它应有重建方法。

核对原始数据与页面

原来的两条日志仍可用于审计,归属标为已失效。当前收入表冲销 25,返佣表冲销 1。后续若某笔交易重新进入规范区块,先确认新收据与事件,再逐项添加新的有效影响。

动手练习

写一份模拟序列,包含同一交易的两条有效日志与一个同高度替换区块。设计真值表,指出哪条记录保留为历史、哪条记为当前有效,并列出重建时会重复扫描的范围。

自测

所有链的交易哈希格式类似,能否作为全局主键?

查看参考答案

业务上仍要包含链 ID。同一哈希可有多条日志,还需结合日志索引与区块标识区分事件及其规范链归属。

记录本课进度

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

搜索课程