Skip to main content

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.

即刻安装 Cobo WaaS Skill，在 Claude Code、Cursor 等 AI 开发环境中使用自然语言集成 WaaS API，显著提升开发效率 🚀
本文面向考虑升级到 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 简介。 下表详细列出了 WaaS 1.0 升级到 WaaS 2.0 的关键提升。
升级维度WaaS 1.0WaaS 2.0
API 架构按钱包类型划分：相同业务功能需分别调用不同 API 操作。例如：
  • 全托管钱包提币与 MPC 钱包提币需要使用不同的 API 操作
  • 按不同 ID（如交易哈希、交易 ID、内部 ID）查询交易，也需分别调用不同的 API 操作
按用户场景聚合：相同业务功能只需调用单一 API 操作即可完成。例如：
  • 使用代币转账操作即可实现所有钱包类型的充值与提现
  • 交易查询也统一为单一 API 操作，可通过任意 ID 获取结果
新增功能模块N/A
Webhook 机制仅支持交易状态变动通知
  • 支持更多事件类型：支持交易、钱包、地址、余额、TSS 等事件通知
  • 自带调试功能：提供日志、失败重试、模拟测试等功能
开发者工具提供基础 SDK在 SDK 基础上，提供多样开发者工具：
  • Cobo CLI：命令行工具，支持快速调试与测试
  • UI Toolkit：预构建 UI 组件，加速应用开发

​
技术差异与迁移参考

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

​
技术差异

下表列出了 WaaS 1.0 与 2.0 在 API 设计、认证方式、回调机制等方面的主要技术差异。
WaaS 1.0WaaS 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 不同
支持的钱包类型
  • 全托管钱包
  • MPC 钱包
资产模型
  • 币种被视为唯一的资产类型
  • 币种代表链和加密货币的特定配对，如 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.0WaaS 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 服务的任何消息。