即刻安装 Cobo WaaS Skill，在 Claude Code、Cursor 等 AI 开发环境中使用自然语言集成 WaaS API，显著提升开发效率 🚀 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 简介。
下表详细列出了 WaaS 1.0 升级到 WaaS 2.0 的关键提升。
| 升级维度 | WaaS 1.0 | WaaS 2.0 |
|---|
| API 架构 | 按钱包类型划分：相同业务功能需分别调用不同 API 操作。例如：- 全托管钱包提币与 MPC 钱包提币需要使用不同的 API 操作
- 按不同 ID（如交易哈希、交易 ID、内部 ID）查询交易，也需分别调用不同的 API 操作
| 按用户场景聚合：相同业务功能只需调用单一 API 操作即可完成。例如：- 使用代币转账操作即可实现所有钱包类型的充值与提现
- 交易查询也统一为单一 API 操作，可通过任意 ID 获取结果
|
| 新增功能模块 | N/A | |
| Webhook 机制 | 仅支持交易状态变动通知 | - 支持更多事件类型：支持交易、钱包、地址、余额、TSS 等事件通知
- 自带调试功能：提供日志、失败重试、模拟测试等功能
|
| 开发者工具 | 提供基础 SDK | 在 SDK 基础上，提供多样开发者工具： |
技术差异与迁移参考
本章节面向开发人员，介绍 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 和认证 | - API Key 是钱包特定的，只能访问关联钱包
- 使用 SECP256k1 签名进行 API 请求认证
| - API Key 是团队特定的，可用于访问多个钱包。更多信息请参阅注册 API Key
- 使用 ED25519 签名进行 API 请求认证
|
| 交易通知 | 仅支持交易状态相关事件 | |
| 提币确认 | 用于确认通过 WaaS API 发起的提币 | - 此功能在 2.0 中称为 “回调”
- 回调消息的数据结构与 1.0 不同
|
| 支持的钱包类型 | | |
| 资产模型 | - 币种被视为唯一的资产类型
- 币种代表链和加密货币的特定配对，如 ETH_USDT
| - 代币被视为唯一的资产类型，交易所钱包除外，后者将 “资产” 视为唯一的资产类型
- 代币代表链和加密货币的特定配对，如 ETH_USDT
- 资产代表存储在您链接的交易所账户中的加密货币，如 USDT
|
| 余额模型 | - 全托管钱包：可以计算整个钱包的币种余额，但不能计算每个地址的余额
- MPC 钱包：可以计算每个地址的币种余额，但不能计算整个钱包的余额
| - 全托管钱包：可以计算整个钱包的代币余额，但不能计算每个地址的余额
- MPC 钱包：可以计算整个钱包或每个地址的代币余额
|
| 余额与金额单位 | - 余额和金额以加密货币的最小单位计价，例如比特币以聪为单位
abs_balance 和 abs_amount 参数以加密货币的主要单位计价
| - 余额和金额以加密货币的主要单位计价
- 例如，对于 1.2 BTC 的充币，1.0 中记录为
120,000,000，2.0 中记录为 1.2
|
| 地址生成 | - 全托管钱包：地址基于指定币种生成，如 ETH_USDT
- MPC 钱包：地址基于指定链生成，如 ETH
| 全托管钱包 / MPC 钱包：地址基于指定链生成，如 ETH，然后可用于同链下所有代币 |
| 交易 ID | 交易的唯一标识符 | - 2.0 中的交易 ID 遵循 UUID 格式
- 1.0 中的交易 ID 在 2.0 中称为 “Cobo ID”，可继续查询
|
常见 API 操作迁移参考
下表列出了 WaaS 1.0 和 2.0 中常见钱包操作所需的 API 操作。在将代码从 1.0 迁移到 2.0 时，您可以参考此表。
| WaaS 1.0 | WaaS 2.0 |
|---|
| 创建钱包 | 不支持，因为 API Key 是钱包特定的 | 创建钱包 |
| 创建地址 | | 在钱包中创建地址 |
| 提取代币 | | 转账代币 |
| RBF 交易（加速） | [MPC 钱包] 加速交易 | 加速交易 |
| RBF 交易（放弃） | [MPC 钱包] 放弃交易 | 放弃交易 |
| 取消交易 | 不支持 | 取消交易 |
| 调用合约 | 不支持 | 调用智能合约 |
| 签名消息 | 不支持 | 签名消息 |
| 查询交易 | | |
升级步骤
本节介绍从 WaaS 1.0 升级到 2.0 的详细步骤。
前提条件
请联系我们的支持团队（[email protected]）以从 Cobo Custody 迁移到 Cobo Portal。
开始使用 WaaS 2.0
按照 WaaS 2.0 入门 中的说明设置您的账户，创建并注册您的 API Key，根据需要集成 WaaS SDK，并向 WaaS 2.0 服务发送您的第一个 API 请求。
重写代码
完成初始设置后，是时候通过将 1.0 API 操作替换为 2.0 操作来重写您的代码了。有关 1.0 和 2.0 API 操作的详细比较，请参阅 API 操作比较。
您还可以参考全托管钱包（资产钱包）入门，了解如何创建全托管钱包（资产钱包）、生成钱包地址以及接收和提取代币的分步指南。其他钱包类型的指南将在未来提供。
设置 Webhook 和 Callback Endpoint
设置 Webhook 和 Callback Endpoint，并在 Cobo Portal 中注册。
要了解 Webhook 事件、Callback 消息以及 WaaS 1.0 和 WaaS 2.0 之间的 Webhook/Callback 机制差异，请参阅 Webhook 和 Callback 简介。
要了解设置的详细步骤，请参阅设置 Callback 或 Webhook Endpoint。要注册 Endpoint，请参阅注册 Webhook Endpoint和注册 Callback Endpoint。
为 WaaS 1.0 设置的 Endpoint 将不会收到来自 WaaS 2.0 服务的任何消息。
