JavaScript SDK 快速入门

即刻安装 Cobo WaaS Skill，在 Claude Code、Cursor 等 AI 开发环境中使用自然语言集成 WaaS API，显著提升开发效率 🚀

概述

本指南介绍如何开始使用 Cobo WaaS 2.0 JavaScript SDK，它允许您使用 JavaScript 编程语言将 WaaS 服务集成到您的现有 App 中。要了解使用 WaaS API 所需的初始设置步骤，请参阅发送您的第一个 API 请求。您可以访问 GitHub 查看 SDK 的源代码。

前提条件

安装 Node.js 和 NPM。
按照创建您的账户和团队中的说明设置您的 Cobo 账户并创建您的团队。如果已经设置了团队，请让您的团队管理员邀请您加入团队。
您已生成 API Key 和 API Secret，并在 Cobo Portal 上注册了 API Key。

安装与项目准备

mkdir waas2-js && cd waas2-js
npm init -y

安装 SDK：

npm install @cobo/cobo-waas2 --save

安装完成后的目录结构（示例）如下：

waas2-js/
├─ node_modules/
├─ package.json
├─ package-lock.json
└─ (稍后将创建) index.js

如果您的项目已存在 package.json 和 package-lock.json，可直接将二者放到根目录后执行 npm install 拉取依赖。

在项目根目录创建一个文件 index.js，并将以下示例代码粘贴到该文件中。

配置 API Key 和 HTTP Host

设置 API Secret。

// 初始化默认 API 客户端
const apiClient = CoboWaas2.ApiClient.instance
// 设置 API Secret
apiClient.setPrivateKey("<YOUR_API_SECRET_IN_HEX>");

选择环境。

// 选择开发环境
apiClient.setEnv(CoboWaas2.Env.DEV);

// 选择生产环境
// apiClient.setEnv(CoboWaas2.Env.PROD);

示例代码

API 操作级别的文档和示例代码请参照 WaaS SDK GitHub 仓库内的 docs 文件夹。

列出支持的链

const CoboWaas2 = require("@cobo/cobo-waas2");
// 初始化 API 客户端
const apiClient = CoboWaas2.ApiClient.instance;
// 设置运行环境（开发环境：Env.DEV，生产环境：Env.PROD）
apiClient.setEnv(CoboWaas2.Env.DEV);
// 配置 API Secret，请将 <YOUR_PRIVATE_KEY> 替换为您的 API Secret。
apiClient.setPrivateKey("<YOUR_PRIVATE_KEY>");
// 创建 WalletsApi 实例
const apiInstance = new CoboWaas2.WalletsApi();
// 定义查询参数
const opts = {
  wallet_type: "Custodial",      // 钱包类型：全托管钱包
  wallet_subtype: "Asset",       // 钱包子类型：资产钱包
  chain_ids: "BTC,ETH",          // 需要查询的链 ID：BTC，ETH
  limit: 10,                     // 返回数量限制为 10 条
  before: "RqeEoTkgKG5rpzqYzg2Hd3szmPoj2cE7w5jWwShz3C1vyGmk1", // 分页用，可选
  after: "RqeEoTkgKG5rpzqYzg2Hd3szmPoj2cE7w5jWwShz3C1vyGSAk",  // 分页用，可选
};
// 调用 API 列出支持的链
apiInstance.listSupportedChains(opts).then(
  (data) => {
    console.log("API called successfully. Returned data: " + data);
  },
  (error) => {
    console.error(error);
  },
);

示例响应如下：

API called successfully. Returned data: {
 "data": [
   {
     "chain_id": "BTC",
     "symbol": "Bitcoin",
     "icon_url": "https://d.cobo.com/public/logos/btc%403x.png",
     "explorer_tx_url": "https://mempool.space/tx/{txn_id}",
     "explorer_address_url": "https://mempool.space/address/{address}",
     "require_memo": false,
     "confirming_threshold": 4
   },
   {
     "chain_id": "ETH",
     "symbol": "Ethereum",
     "icon_url": "https://d.cobo.com/public/logos/eth%403x.png",
     "explorer_tx_url": "https://etherscan.io/tx/{txn_id}",
     "explorer_address_url": "https://etherscan.io/address/{address}",
     "require_memo": false,
     "confirming_threshold": 64
   }
 ],
 "pagination": {
   "before": "",
   "after": "",
   "total_count": 2
 }
}

创建钱包

const CoboWaas2 = require("@cobo/cobo-waas2");
// 初始化 API 客户端
const apiClient = CoboWaas2.ApiClient.instance;
// 设置运行环境（开发环境：Env.DEV，生产环境：Env.PROD）
apiClient.setEnv(CoboWaas2.Env.DEV);
// 配置 API Secret，请将 <YOUR_PRIVATE_KEY> 替换为您的 API Secret
apiClient.setPrivateKey("<YOUR_PRIVATE_KEY>");
// 创建 WalletsApi 实例
const apiInstance = new CoboWaas2.WalletsApi();
// 定义创建钱包的参数
const opts = {
  CreateWalletParams: CoboWaas2.CreateWalletParams.constructFromObject({
    name: "My WaaS 2.0 Wallet", // 钱包名称
    wallet_type: "Custodial",   // 钱包类型：全托管钱包
    wallet_subtype: "Asset",    // 子类型：资产钱包
  }),
};
// 调用 API 创建钱包
apiInstance.createWallet(opts).then(
  (data) => {
    console.log("API called successfully. Returned data: " + data);
  },
  (error) => {
    console.error(error);
  },
);

WaaS SDKs

Cobo CLI

Cobo UI Toolkit

其他工具

JavaScript SDK 快速入门

概述

前提条件

安装与项目准备

配置 API Key 和 HTTP Host

示例代码

列出支持的链

创建钱包

​概述

​前提条件

​安装与项目准备

​配置 API Key 和 HTTP Host

​示例代码

​列出支持的链

​创建钱包

概述

前提条件

安装与项目准备

配置 API Key 和 HTTP Host

示例代码

列出支持的链

创建钱包