已成功的交易被重组回滚的检测

30 秒回答

收据记录的是某个区块上的执行结果，其中包含所在区块的标识；当链上区块组织发生变化时，同一笔交易的收据位置可能改变，按哈希查询也可能返回空结果。因此「看到过一次成功的收据」与「这笔交易已经稳定」是两件事。实现差异与工程取舍见深入回答。

【协议保证】收据中包含所在区块的标识字段（依据：EIP-1474 §eth_getTransactionReceipt）。
【协议保证】交易尚未被打包时，按哈希查询收据返回空结果（依据：EIP-1474 §eth_getTransactionReceipt）。
【工程经验】把首次拿到的区块标识保存下来，并在后续复查中比对，可以识别交易被换到其他区块的情形（依据：工程经验，无规范依据）
【工程经验】复查应设上限：确认数或最终性达到预设条件后停止轮询，避免长期占用请求配额（依据：工程经验，无规范依据）
【实现行为】wagmi 的等待收据 Hook 支持替换检测，替换回调会给出替换原因与前后两笔交易（依据：wagmi useWaitForTransactionReceipt §Parameters 的 onReplaced）
【工程经验】把「链上重组」与「同 nonce 替换」分开处理：前者需要回滚基于该交易做出的链下判断，后者需要切换到新哈希继续跟踪（依据：工程经验，无规范依据）
【工程经验】已经下发的业务动作（发放积分、开通权限）在检测到回滚时应进入补偿流程，而不是仅修改展示文案（依据：工程经验，无规范依据）
【工程经验】复查请求可能落到状态滞后的节点上；选择可信的读取源并保留多源对比能力，可以减少误判（依据：节点实现差异，无对应文档依据）

收到一次成功收据后不再复查（依据：ethereum.org JSON-RPC §eth_getTransactionReceipt 只描述查询时刻的结果）
只判断收据是否存在，不比对区块标识（依据：工程经验，无规范依据）
把链上重组与替换混为一谈，导致重复发放或丢单（依据：wagmi useWaitForTransactionReceipt §Parameters 的 onReplaced）
界面回滚了，链下记录与已发放权益没有回滚（依据：工程经验，无规范依据）
用单个节点的结果作为唯一判据，出现分歧时缺少核对手段（依据：工程经验，无规范依据）