跳到主要内容

交易状态、哈希与安全恢复

不把一个成功替代另一个成功​

阶段可以显示不应显示
用户已确认已授权,准备构造或签名已付款
已获得交易哈希已广播 / 等待确认收款方已到账
成功回执并入块链上执行成功已满足所有业务确认条件
达到指定原生确认等级对应的 included / safe / finalized 事实以固定等待秒数替代的确认结论
钱包完成对账输入消费、输出和预留已核对商户必然已履约
商业 Checkout 成功收款会话满足其约定条件退款或额外到账已处理完毕

回执明确失败时,保留哈希并说明执行回滚;网络查询超时则是结果未知,不能写成确定的资金失败。详见状态术语和商业支付生命周期。

在哪里保存恢复信息​

提交前保存稳定操作 ID、账户、网络、资产和本次意图。提交后立即关联哈希;不要等确认完成后才写入。私密库存、完整 Note 和恢复材料需要加密持久化,不进入公开分析日志。

前端刚拿到哈希而索引尚未更新时,显示本地待确认行及区块浏览器链接。没有被索引不等于交易不存在。后台记录出现后,以稳定操作/输出标识去重合并,不把同一次付款显示成两笔。

一笔哈希可能有多个输出​

一次隐私交易可能同时包含收款输出和付款人的剩余输出。列表可以按业务摘要展示,但详情应区分资产、输出归属和可执行动作。付款人能够处理自己的剩余输出,不表示有权提取他人的收款输出。

同样,普通链上转账与隐私输出不要只按金额或时间猜测为同一记录。可展示发起时间、到账或确认时间、网络、真实网络费和公开哈希;隐私字段仅在账户确有对应访问权限时展示。

恢复决策​

情形动作
钱包拒签且尚未发送返回编辑,不生成链上成功记录
allowance 已成功,付款未成功核对已有 allowance 与原操作,避免重复无关授权
已有哈希但等待超时查原哈希和账户状态,恢复原操作;不自动创建第二笔付款
单个 RPC 查无更换受信节点再次核对,不立即释放输入
回执成功但库存未更新恢复同步和对账,不重复支付
确认或区块身份变化按规范链重新核对,不能保留过时的终态推断

SDK 的恢复接口见WalletSession。商户请求的 HTTP 幂等规则见认证、金额与重试;HTTP 幂等不代替链上 nonce、输入预留和订单履约去重。