交易状态、哈希与安全恢复
不把一个成功替代另一个成功
| 阶段 | 可以显示 | 不应显示 |
|---|---|---|
| 用户已确认 | 已授权,准备构造或签名 | 已付款 |
| 已获得交易哈希 | 已广播 / 等待确认 | 收款方已到账 |
| 成功回执并入块 | 链上执行成功 | 已满足所有业务确认条件 |
| 达到指定原生确认等级 | 对应的 included / safe / finalized 事实 | 以固定等待秒数替代的确认结论 |
| 钱包完成对账 | 输入消费、输出和预留已核对 | 商户必然已履约 |
| 商业 Checkout 成功 | 收款会话满足其约定条件 | 退款或额外到账已处理完毕 |
回执明确失败时,保留哈希并说明执行回滚;网络查询超时则是结果未知,不能写成确定的资金失败。详见状态术语和商业支付生命周期。
在哪里保存恢复信息
提交前保存稳定操作 ID、账户、网络、资产和本次意图。提交后立即关联哈希;不要等确认完成后才写入。私密库存、完整 Note 和恢复材料需要加密持久化,不进入公开分析日志。
前端刚拿到哈希而索引尚未更新时,显示本地待确认行及区块浏览器链接。没有被索引不等于交易不存在。后台记录出现后,以稳定操作/输出标识去重合并,不把同一次付款显示成两笔。
一笔哈希可能有多个输出
一次隐私交易可能同时包含收款输出和付款人的剩余输出。列表可以按业务摘要展示,但详情应区分资产、输出归属和可执行动作。付款人能够处理自己的剩余输出,不表示有权提取他人的收款输出。
同样,普通链上转账与隐私输出不要只按金额或时间猜测为同一记录。可展示发起时间、到账或确认时间、网络、真实网络费和公开哈希;隐私字段仅在账户确有对应访问权限时展示。
恢复决策
| 情形 | 动作 |
|---|---|
| 钱包拒签且尚未发送 | 返回编辑,不生成链上成功记录 |
| allowance 已成功,付款未成功 | 核对已有 allowance 与原操作,避免重复无关授权 |
| 已有哈希但等待超时 | 查原哈希和账户状态,恢复原操作;不自动创建第二笔付款 |
| 单个 RPC 查无 | 更换受信节点再次核对,不立即释放输入 |
| 回执成功但库存未更新 | 恢复同步和对账,不重复支付 |
| 确认或区块身份变化 | 按规范链重新核对,不能保留过时的终态推断 |
SDK 的恢复接口见WalletSession。商户请求的 HTTP 幂等规则见认证、金额与重试;HTTP 幂等不代替链上 nonce、输入预留和订单履约去重。