关于 MPC 钱包交易新增 Reorg 的交易状态公告

尊敬的 Cobo  用户：

为了提供更好的 MPC 交易体验，Cobo MPC 钱包交易将新增 Reorg 的交易状态回调。

什么是 Reorg？

在区块链中，Reorg 是指当两个或更多的区块同时被挖出，然后被添加到区块链上，形成了分叉。当其中一个分叉的长度超过了另一个，较短的分叉将被丢弃，而较长的分叉将成为主链。这个过程就被称为重组。在重组过程中，被丢弃的分叉上的交易可能会被回滚。

Reorg 状态会发生在交易的什么节点？

交易在链上有一个确认数后，有可能发生 Reorg 的情况

在 Cobo 的交易状态下，对应的是以下阶段WaaS 1.0 API：发生在【PENDING_CONFIRMATION(501)】状态之后，链上确认数满之前WaaS 2.0 API：发生在【COMFIRMING（confirmations(1/m) 】状态之后，链上确认数满之前

交易新增 Reorg 的交易状态涉及范围

WaaS 1.0 API
影响钱包：MPC 收发币钱包，MPC Web3 钱包 充值交易：1. 交易状态新增【Reorg（902）】交易状态，该状态为交易终态，代表交易失败，该状态会有 Callback 回调通知2. 交易上链后，Cobo 会重新创建新的交易，对新交易进行推送

WaaS 2.0 API
影响钱包：MPC Wallets (User-Controlled)、MPC Wallets (User-Controlled)充值交易：在交易状态 Failed 下，会新增 Reorg 子状态，该状态会有 Webhook 回调通知

具体适配流程：

只需要对入账交易进行处理

若您接入的是 WaaS API 1.0 版本

推荐做法：在交易达到 SUCCESS 时，对交易金额进行入账
无需修改

若您因业务需要，在交易到达在 PENDING_CONFIRMATION(501) 时，对交易金额进行入账

当该交易发生 Reorg 后，Cobo 会将 Reorg 状态回调给您，此时您需要
1. 对交易取消入账
2. 当该交易重新上链后，Cobo 会创建新的交易，会将新交易回调给您，您对新交易进行处理即可

若您接入的是 WaaS API 2.0 版本

推荐做法：在交易达到 Completed 时，对交易金额进行入账
无需修改

若您因业务需要，在交易到达在 Confirming 时，对交易金额进行入账

当该交易发生 Reorg 后，该交易将会流转成 Failed（Reorg）状态，Cobo 会将该交易状态回调给您，此时
1. 您需要对交易取消入账
2. 当该交易重新上链后，Cobo 会创建新的交易，会将新交易回调给您，您对新交易进行处理即可

上线时间：

Dev 环境上线时间：10月28日
Prod 环境上线时间：11月18日

为了不影响您业务的正常使用，请在 Cobo 上线前，完成业务适配。
该功能上线后，如有任何问题请随时联系我们。

Cobo Support
2024年10月21日