事件索引表 · 原始记录、业务读模型与重建
学完能做到:为链上查询建最小可追溯的数据表和游标。
先看一个场景
一个看账单的网站重启后重新读取历史。一笔交易里原本有付款和返佣两条记录,网站却只存下了一条。要找回遗漏,先让服务能分清区块、交易和交易里的每条事件。
三张表的最小方案
| 表 | 关键字段 | 用途 |
|---|---|---|
| 区块观察 | 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。同一哈希可有多条日志,还需结合日志索引与区块标识区分事件及其规范链归属。