Documentation Index
Fetch the complete documentation index at: https://manuals.cobo.com/llms.txt
Use this file to discover all available pages before exploring further.
本文将引导您在开发环境中快速体验全托管钱包（资产钱包）的主要功能。在开发环境中，部分生产环境需要手动完成的配置已由系统默认启用，因此流程更简单、必需步骤更少。如果您已准备好在生产环境中正式使用，请参考正式使用文档。
Cobo Portal 提供两种类型的全托管钱包：
资产钱包和
Web3 钱包。本指南将介绍资产钱包的设置和使用。
- 注册并激活账户
- 设置 Cobo Guard
- 邀请成员（可选）
- 设置交易风控（可选）
- 添加链（可选）
- 创建钱包（可选）
- 充币（可选）
- 提币
- Cobo Portal 网页端
- WaaS 2.0 API 端
前提条件
注册并激活账户
使用我们销售团队提供的激活链接创建您的 Cobo Portal 账户。按邮件中的注册邀请链接完成激活：
- 设置密码
- 输入邮箱验证码
- 加入团队
注册后您可通过 https://portal.dev.cobo.com/login 登录 Cobo Portal 开发环境。
设置 Cobo Guard
登录开发环境的 Cobo Portal，在左下角的弹窗中点击绑定 Cobo Guard。按照屏幕上的说明在您的 iOS 设备上安装 Cobo Guard，并将您的账户与 Cobo Guard 关联。
如果提示框被关闭，可点击左侧菜单的指南重新打开。
绑定目的：
- 作为 Cobo Portal 的 MFA 认证方式。
- 在 APP 中审批 Cobo Portal 的各类消息。
更多信息请参阅 Cobo Guard。
邀请成员（可选）
您可以邀请团队成员并分配权限。每个权限对应的可执行操作详见成员权限说明。
设置风控（可选）
配置代币转账的风控规则，包括币种、金额、黑/白名单、审批阈值（m/n 审批）。更多详情请参阅设置代币转账风控文档。
添加链（可选）
为方便测试，系统已在开发环境为您默认生成 SETH / ETH / BTC / Tron / BNB / SOL / TON 的地址。如需添加其他链，请参考添加链文档。
创建钱包（可选）
为方便测试，系统已为您默认创建一个名为 Default Wallet 的钱包。如需创建更多钱包，请参考设置资产钱包文档。
充币（可选）
在开发环境中，系统已为您自动分配测试币 SETH。如果需要充值其他币种（例如 USDC 或 USDT），请确认所用链（Tron / BEP-20 / ERC-20 等），并参考充值文档。
充值主链币：如需支付链上手续费，请确保钱包中有足够对应链的主链币。
Cobo Portal 网页端
请参阅从全托管钱包（资产钱包）转账文档。
WaaS 2.0 API 端
本章节将介绍如何使用 WaaS 2.0 API 在全托管钱包（资产钱包）场景中完成充币和提币。
- 生成 API Key 与 API Secret
您需要在本地生成一对 Ed25519 密钥对，作为 API Key（公钥）和 API Secret（私钥）。更多生成 API Key 密钥对的说明，请参阅生成 API Key 和 API Secret。
- 注册 API Key
生成 API Key 后，您需要在 Cobo Portal 上注册 API Key，并为其设置用户角色和可访问的钱包范围。更多注册 API Key 的说明，请参阅注册 API Key。
- 接入 WaaS SDK
在完成 API Key 配置后，您可以接入 WaaS SDK。您可以先调用一个只读接口（如列出支持的链）来测试 SDK 是否配置成功，如果调用成功，说明您的开发环境已准备就绪，可以继续实现提币等功能。详情请参阅以下文档：
- 设置 Callback 和 Webhook（可选）
为了增强安全性，您应该设置一个 Callback Endpoint 来二次确认提现请求。当您通过 WaaS 2.0 API 发起提现时，该 Endpoint 将接收交易详情，并且必须确认这些详情后才能继续进行交易。要进行设置，请参考 Webhook 和 Callback 指南。
- 发起提币交易
如果您在开发环境中配置了交易风控，钱包中配置了主控私钥，或者配置了 Callback Endpoint 等，这些设置会对提币流程产生影响。例如，您可能需要额外审批步骤才能完成交易。
如需支付链上手续费，请确保钱包中有足够对应链的主链币；若转账双方均为资产钱包，则可自动通过 Cobo Loop 网络完成转账，无需消耗链上 Gas。
以下为 JavaScript SDK 示例代码，更多详情可参阅发起转账 API 文档
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>");
// 创建 TransactionsApi 实例
const apiInstance = new CoboWaas2.TransactionsApi();
// 构造提币交易参数
const opts = {
TransferParams: CoboWaas2.TransferParams.constructFromObject({
request_id: "f47ac10b-58cc-4372-a567-0e02b2c3d479", // 请求 ID，需唯一
source: {
source_type: "Asset", // 钱包类型：资产钱包
wallet_id: "f47ac10b-58cc-4372-a567-0e02b2c3d479", // 钱包 ID
},
token_id: "ETH_USDT", // 代币 ID
destination: {
destination_type: "Address",
account_output: {
address: "19AR6YWEGbSoY8UT9Ksy9WrmrZPD5sL4Ku", // 收款地址
amount: "1.5", // 转账代币数量
},
},
}),
};
// 发起提币交易请求
apiInstance.createTransferTransaction(opts).then(
(data) => {
console.log("API called successfully. Returned data: " + data);
},
(error) => {
console.error(error);
},
);
API called successfully. Returned data: {
"request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d471",
"transaction_id": "c8964e6b-32d7-4da3-8407-6c4a4a8c92d7",
"status": "Submitted"
}
查看交易状态
发起交易后，您可以通过以下方式查看交易状态：
-
Cobo Portal 网页端：
登录 Cobo Portal，进入钱包 > 交易记录，在列表中找到对应交易即可查看其状态。
-
WaaS 2.0 API：
调用获取交易详情 接口查询交易详情。
调用获取交易列表 接口查询交易列表。
至此，您已完成全托管钱包（资产钱包）在开发环境中的主要功能快速体验，包括账户设置、充币与提币等操作。如果您想要在生产环境中正式部署和使用全托管钱包（资产钱包），请参考正式使用指南。
