Skip to main content
即刻安装 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.0 与 2.0 在 API 设计、认证方式、回调机制等方面的主要技术差异,并提供常见 API 操作的对照表,帮助您快速完成迁移。

技术差异

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

常见 API 操作迁移参考

下表列出了 WaaS 1.0 和 2.0 中常见钱包操作所需的 API 操作。在将代码从 1.0 迁移到 2.0 时,您可以参考此表。
WaaS 2.0 的列表类接口(例如 List all transactions)会分页返回结果。默认情况下每页返回 10 条记录,最大每页为 50 条,通过 limit 参数设置。这与 WaaS 1.0 不同:在 1.0 中单次响应可返回全部结果。因此 WaaS 2.0 的单页会遗漏后续结果。如需获取全部记录,请使用游标参数 beforeafter 遍历所有页。

升级步骤

本节介绍从 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 服务的任何消息。