> ## Documentation Index
> Fetch the complete documentation index at: https://cobo.com/developers/llms.txt
> Use this file to discover all available pages before exploring further.

# 从 WaaS 1.0 升级到 WaaS 2.0

> 从 WaaS 1.0 升级到 WaaS 2.0 的指南，阐明优势并提供分步说明。

<Tip>
  即刻安装 [Cobo WaaS Skill](/developers/v2_cn/guides/overview/cobo-waas-skill)，在 Claude Code、Cursor 等 AI 开发环境中使用自然语言集成 WaaS API，显著提升开发效率 🚀
</Tip>

本文面向考虑升级到 WaaS 2.0 的 WaaS 1.0 的用户。本文介绍了升级到 WaaS 2.0 的优势与价值，两个版本的技术差异与迁移参考，并提供了升级过程的分步说明。

## WaaS 2.0 的关键提升

WaaS 2.0 相较于 WaaS 1.0 进行了重大升级，面向支付、代币化、资金自动化等多样化场景，帮助企业和开发者以更低的成本、更高的效率构建 Web3 应用。

升级到 **WaaS 2.0** 的三大核心价值：

* **功能更强大**：新增支付解决方案、Tokenization、Fee Station、自动归集、Travel Rule 等功能模块。
* **开发更高效**：API 架构统一，实现相同功能所需调用的接口更少，降低系统集成与维护复杂度。
* **运维更完善**：Webhook 升级，支持更多事件类型，并提供日志、重试、模拟测试等能力，提升可观测性和调试效率。

详细 WaaS 2.0 简介请参阅 [WaaS 2.0 简介](/developers/v2_cn/guides/overview/introduction)。

下表详细列出了 WaaS 1.0 升级到 WaaS 2.0 的关键提升。

| 升级维度           | WaaS 1.0                                                                                                                                     | WaaS 2.0                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **API 架构**     | **按钱包类型划分**：相同业务功能需分别调用不同 API 操作。例如：<ul><li>全托管钱包提币与 MPC 钱包提币需要使用不同的 API 操作</li><li>按不同 ID（如交易哈希、交易 ID、内部 ID）查询交易，也需分别调用不同的 API 操作</li></ul> | **按用户场景聚合**：相同业务功能只需调用单一 API 操作即可完成。例如：<ul><li>使用[代币转账](/developers/v2/api-references/transactions/transfer-token)操作即可实现所有钱包类型的充值与提现</li><li>[交易查询](/developers/v2/api-references/transactions/list-all-transactions)也统一为单一 API 操作，可通过任意 ID 获取结果</li></ul>                                                                                                                                                                                                                                                                                                         |
| **新增功能模块**     | N/A                                                                                                                                          | <ul><li> [支付](/developers/v2_cn/payments/overview)：一套完整的加密货币支付综合解决方案</li><li> [Tokenization](/developers/v2/api-references/tokenization/issue-token)：发行并管理链上代币化资产</li><li> [Fee Station](/developers/v2/api-references/feestation/get-fee-station-transaction-information)：Gas 费代付与统一成本结算</li><li> [自动归集](/developers/v2/api-references/autosweep/create-auto-sweep-task)：自动发起代币归集</li><li> [Travel Rule](/developers/v2/api-references/travelrule/submit-travel-rule-information-for-deposits)：满足更多合规要求</li><li> [Cobo Portal Apps](/developers/v2_cn/apps/introduction)：满足 Cobo Portal Apps 的开发需求 </li></ul> |
| **Webhook 机制** | 仅支持交易状态变动通知                                                                                                                                  | <ul><li> **支持更多[事件类型](/developers/v2_cn/guides/webhooks-callbacks/webhook-event-type)**：支持交易、钱包、地址、余额、TSS 等事件通知</li><li> **自带[调试](/developers/v2/api-references/developers--webhooks/trigger-test-event)功能**：提供日志、失败重试、模拟测试等功能</li></ul>                                                                                                                                                                                                                                                                                                                           |
| **开发者工具**      | 提供基础 SDK                                                                                                                                     | 在 SDK 基础上，提供多样开发者工具： <ul><li>[Cobo CLI](/developers/v2_cn/developer-tools/cobo-cli)：命令行工具，支持快速调试与测试</li><li>[UI Toolkit](/developers/v2_cn/developer-tools/uitoolkit-intro)：预构建 UI 组件，加速应用开发</li></ul>                                                                                                                                                                                                                                                                                                                                                             |

## 技术差异与迁移参考

本章节面向开发人员，介绍 WaaS 1.0 与 2.0 在 API 设计、认证方式、回调机制等方面的主要技术差异，并提供常见 API 操作的对照表，帮助您快速完成迁移。

### 技术差异

下表列出了 WaaS 1.0 与 2.0 在 API 设计、认证方式、回调机制等方面的主要技术差异。

|                 | WaaS 1.0                                                                                             | WaaS 2.0                                                                                                                                                                                                                                                     |
| --------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **API 设计**      | 支持 GET 和 POST 方法的 HTTP 端点                                                                            | RESTful API 按不同领域（如钱包、交易和 webhook）进行结构化。API 遵循面向资源的设计原则进行端点定义，支持包括 GET、POST、PUT 和 DELETE 在内的标准 HTTP 方法                                                                                                                                                       |
| **API Key 和认证** | <ul><li>API Key 是钱包特定的，只能访问关联钱包</li><li>使用 SECP256k1 签名进行 API 请求认证</li></ul>                         | <ul><li>API Key 是团队特定的，可用于访问多个钱包。更多信息请参阅[注册 API Key](https://manuals.cobo.com/cn/portal/developer-console/create-api-key)</li><li>使用 ED25519 签名进行 API 请求认证</li></ul>                                                                                         |
| **交易通知**        | 仅支持交易状态相关事件                                                                                          | <ul><li>此功能在 2.0 中称为 "Webhook"</li><li>支持[交易状态和 TSS 请求相关事件](/developers/v2_cn/guides/webhooks-callbacks/webhook-event-type)，且事件列表持续更新</li><li>Webhook 事件的数据结构与 1.0 不同</li></ul>                                                                                         |
| **提币确认**        | 用于确认通过 WaaS API 发起的提币                                                                                | <ul><li>此功能在 2.0 中称为 "回调"</li><li>回调消息的数据结构与 1.0 不同</li></ul>                                                                                                                                                                                                |
| **支持的钱包类型**     | <ul><li>全托管钱包</li><li>MPC 钱包</li></ul>                                                               | <ul><li>[全托管钱包](https://manuals.cobo.com/cn/portal/custodial-wallets/introduction)</li><li>[MPC 钱包](https://manuals.cobo.com/cn/portal/mpc-wallets/introduction)</li><li>[交易所钱包](https://manuals.cobo.com/cn/portal/exchange-wallets/introduction)</li></ul> |
| **资产模型**        | <ul><li>币种被视为唯一的资产类型</li><li>币种代表链和加密货币的特定配对，如 ETH\_USDT</li></ul>                                   | <ul><li>代币被视为唯一的资产类型，交易所钱包除外，后者将 "资产" 视为唯一的资产类型</li><li>代币代表链和加密货币的特定配对，如 ETH\_USDT</li><li>资产代表存储在您链接的交易所账户中的加密货币，如 USDT</li></ul>                                                                                                                          |
| **余额模型**        | <ul><li>**全托管钱包**：可以计算整个钱包的币种余额，但不能计算每个地址的余额</li><li>**MPC 钱包**：可以计算每个地址的币种余额，但不能计算整个钱包的余额</li></ul> | <ul><li>**全托管钱包**：可以计算整个钱包的代币余额，但不能计算每个地址的余额</li><li>**MPC 钱包**：可以计算整个钱包或每个地址的代币余额</li></ul>                                                                                                                                                                 |
| **余额与金额单位**     | <ul><li>余额和金额以加密货币的最小单位计价，例如比特币以聪为单位</li><li>`abs_balance` 和 `abs_amount` 参数以加密货币的主要单位计价</li></ul>   | <ul><li>余额和金额以加密货币的主要单位计价</li><li>例如，对于 1.2 BTC 的充币，1.0 中记录为 `120,000,000`，2.0 中记录为 `1.2`</li></ul>                                                                                                                                                          |
| **地址生成**        | <ul><li>**全托管钱包**：地址基于指定币种生成，如 ETH\_USDT</li><li>**MPC 钱包**：地址基于指定链生成，如 ETH</li></ul>                | **全托管钱包 / MPC 钱包**：地址基于指定链生成，如 ETH，然后可用于同链下所有代币                                                                                                                                                                                                              |
| **交易 ID**       | 交易的唯一标识符                                                                                             | <ul><li>2.0 中的交易 ID 遵循 UUID 格式</li><li>1.0 中的交易 ID 在 2.0 中称为 "Cobo ID"，可继续查询</li></ul>                                                                                                                                                                       |

### 常见 API 操作迁移参考

下表列出了 WaaS 1.0 和 2.0 中常见钱包操作所需的 API 操作。在将代码从 1.0 迁移到 2.0 时，您可以参考此表。

|            | WaaS 1.0                                                                                                                                                                                                                                       | WaaS 2.0                                                                                                                                                                                            |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 创建钱包       | 不支持，因为 API Key 是钱包特定的                                                                                                                                                                                                                          | [Create wallet](/developers/v2/api-references/wallets/create-wallet)                                                                                                                                           |
| 创建地址       | <ul><li>**\[全托管钱包]** [获取新充币地址](/developers/v1/api-references/custody-wallet/new_address)</li><li>**\[MPC 钱包]** [生成地址](/developers/v1/api-references/mpc-wallet/mpc_generate_addresses) 和 [生成地址备注](/developers/v1/api-references/mpc-wallet/mpc_generate_address_memo)</li></ul> | [Create addresses in wallet](/developers/v2/api-references/wallets/create-addresses-in-wallet)                                                                                                                 |
| 提取代币       | <ul><li>**\[全托管钱包]** [新建提币请求](/developers/v1/api-references/custody-wallet/new_withdraw_request)</li><li>**\[MPC 钱包]** [创建交易](/developers/v1/api-references/mpc-wallet/mpc_create_transaction)</li></ul>                                                             | [Transfer token](/developers/v2/api-references/transactions/transfer-token)                                                                                                                                    |
| RBF 交易（加速） | **\[MPC 钱包]** [加速交易](/developers/v1/api-references/mpc-wallet/mpc_speedup_transaction)                                                                                                                                                                    | [Speed up transaction](/developers/v2/api-references/transactions/speed-up-transaction)                                                                                                                        |
| RBF 交易（放弃） | **\[MPC 钱包]** [放弃交易](/developers/v1/api-references/mpc-wallet/mpc_drop_transaction)                                                                                                                                                                       | [Drop transaction](/developers/v2/api-references/transactions/drop-transaction)                                                                                                                                |
| 取消交易       | 不支持                                                                                                                                                                                                                                            | [Cancel transaction](/developers/v2/api-references/transactions/cancel-transaction)                                                                                                                            |
| 调用合约       | 不支持                                                                                                                                                                                                                                            | [Call smart contract](/developers/v2/api-references/transactions/call-smart-contract)                                                                                                                          |
| 签名消息       | 不支持                                                                                                                                                                                                                                            | [Sign message](/developers/v2/api-references/transactions/sign-message)                                                                                                                                        |
| 查询交易       | <ul><li>**\[全托管钱包]** [交易历史](/developers/v1/api-references/custody-wallet/transaction_history)</li><li>**\[MPC 钱包]** [获取交易列表](/developers/v1/api-references/mpc-wallet/mpc_list_transactions)</li></ul>                                                               | <ul><li>[List all transactions](/developers/v2/api-references/transactions/list-all-transactions)</li><li>[Get transaction information](/developers/v2/api-references/transactions/get-transaction-information)</li></ul> |

<Warning>
  WaaS 2.0 的列表类接口（例如 [List all transactions](/developers/v2/api-references/transactions/list-all-transactions)）会分页返回结果。默认情况下每页返回 10 条记录，最大每页为 50 条，通过 `limit` 参数设置。这与 WaaS 1.0 不同：在 1.0 中单次响应可返回全部结果。因此 WaaS 2.0 的单页会遗漏后续结果。如需获取全部记录，请使用游标参数 `before` 和 `after` 遍历所有页。
</Warning>

## 升级步骤

本节介绍从 WaaS 1.0 升级到 2.0 的详细步骤。

### 前提条件

请联系我们的支持团队（[help@cobo.com](mailto:help@cobo.com)）以从 Cobo Custody 迁移到 Cobo Portal。

### 开始使用 WaaS 2.0

按照 [WaaS 2.0 入门](/developers/v2_cn/guides/get-started/get-started-with-waas) 中的说明设置您的账户，创建并注册您的 API Key，根据需要集成 WaaS SDK，并向 WaaS 2.0 服务发送您的第一个 API 请求。

### 重写代码

完成初始设置后，是时候通过将 1.0 API 操作替换为 2.0 操作来重写您的代码了。有关 1.0 和 2.0 API 操作的详细比较，请参阅 [API 操作比较](#api-operation-comparison)。

您还可以参考[全托管钱包（资产钱包）入门](/developers/v2_cn/guides/custodial-wallets/get-started-asset-wallets)，了解如何创建全托管钱包（资产钱包）、生成钱包地址以及接收和提取代币的分步指南。其他钱包类型的指南将在未来提供。

### 设置 Webhook 和 Callback Endpoint

设置 Webhook 和 Callback Endpoint，并在 Cobo Portal 中注册。

要了解 Webhook 事件、Callback 消息以及 WaaS 1.0 和 WaaS 2.0 之间的 Webhook/Callback 机制差异，请参阅 [Webhook 和 Callback 简介](/developers/v2_cn/guides/webhooks-callbacks/introduction)。

要了解设置的详细步骤，请参阅[设置 Callback 或 Webhook Endpoint](/developers/v2_cn/guides/webhooks-callbacks/set-up-endpoint)。要注册 Endpoint，请参阅[注册 Webhook Endpoint](https://manuals.cobo.com/cn/portal/developer-console/webhooks-create)和[注册 Callback Endpoint](https://manuals.cobo.com/cn/portal/developer-console/callbacks-register)。

<Note>为 WaaS 1.0 设置的 Endpoint 将不会收到来自 WaaS 2.0 服务的任何消息。</Note>