MPC 钱包快速体验指南

本文将引导您在开发环境中快速体验 MPC 钱包的主要功能。在开发环境中，部分生产环境需要手动完成的配置已由系统默认启用，因此流程更简单、必需步骤更少。如果您已准备好在生产环境中正式使用，请参考正式使用文档。

Cobo Portal 提供两种类型的 MPC 钱包：机构钱包和终端用户钱包。本指南将介绍机构钱包的设置和使用。

本指南将为您提供在 Cobo Portal 开发环境中设置和使用 MPC 钱包的分步指导，包括：

1. 注册并激活账户
2. 设置 Cobo Guard
3. 邀请成员（可选）
4. 设置交易风控（可选）
5. 添加链（可选）
6. 创建钱包（可选）
7. 设置 Fee Station（可选）
8. 开启代币自动归集（可选）
9. 配置 KYA / KYT 扫描工具（可选）
10. 充币（可选）
11. 提币
    • Cobo Portal 网页端
    • WaaS 2.0 API 端

前提条件

• 联系我们的销售团队获取您的账户激活链接。
• 一台用于运行 Cobo Guard 的 iOS 设备，这是我们专门用于多因素认证（MFA）、操作审批、交易签名和私钥分片管理的应用程序。

注册并激活账户

使用我们销售团队提供的激活链接创建您的 Cobo Portal 账户。按邮件中的注册邀请链接完成激活：

1. 设置密码
2. 输入邮箱验证码
3. 加入团队

设置 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 的地址。如需添加其他链，请参考添加链文档。

创建钱包（可选）

为方便测试，系统已为您默认创建：

• 一个 Vault：Cobo Demo Vault (Testing Only)
• 一个钱包：Cobo Demo Vault (Testing Only) 中的 Default MPC wallet
• 私钥：主控组 2/2，签名组与恢复组在开发环境中暂不配置。
  两片私钥均由 Cobo 默认配置，因此您在开发环境中使用该 MPC 钱包发起交易时，Cobo 会自动完成交易的签名，您无需手动签名。

如需完整体验 MPC 钱包的创建流程，请参考：

• MPC 机构钱包介绍
• 创建 MPC Vault
• 设置主控组
• 设置签名组
• 设置恢复组
• 主控组 / 签名组 / 恢复组的区别

设置 Fee Station（可选）

如果您希望在开发环境中使用 Cobo 的美元稳定币代付链上交易手续费功能，或集中管理主链币以支付 Gas，可以启用 Fee Station。它相当于一个团队共享的费用账户，可根据配置策略为链上交易自动代付 Gas，并统一结算各类平台费用。详情请参阅Fee Station 简介。

开启代币自动归集（可选）

如果需要开启 MPC 钱包资金的自动归集，请参考启用自动代币归集。

配置 KYA / KYT 扫描工具（可选）

如果需要对 MPC 钱包进行 KYA / KYT 扫描，请参考Screening App 简介。

充币（可选）

为方便测试，在开发环境中，系统已为您自动分配测试币 SETH。如果需要充值其他币种（例如 USDC 或 USDT），请确认所用链（Tron / BEP-20 / ERC-20 等），并参考充值文档。

充值主链币：如需支付链上手续费，请确保钱包中有足够对应链的主链币。您可以在 Fee Station 预充值对应链的主链币，或充值美元稳定币用以代付链上手续费。

提币

Cobo Portal 网页端

请参阅从 MPC 钱包（机构钱包）转账文档。

WaaS 2.0 API 端

本章节将介绍如何使用 WaaS 2.0 API 在 MPC 钱包（机构钱包）场景中完成充币和提币。

1. 生成 API Key 与 API Secret

您需要在本地生成一对 Ed25519 密钥对，作为 API Key（公钥）和 API Secret（私钥）。更多生成 API Key 密钥对的说明，请参阅生成 API Key 和 API Secret。

2. 注册 API Key

生成 API Key 后，您需要在 Cobo Portal 上注册 API Key，并为其设置用户角色和可访问的钱包范围。更多注册 API Key 的说明，请参阅注册 API Key。

3. 接入 WaaS SDK

在完成 API Key 配置后，您可以接入 WaaS SDK。您可以先调用一个只读接口（如列出支持的链）来测试 SDK 是否配置成功，如果调用成功，说明您的开发环境已准备就绪，可以继续实现提币等功能。详情请参阅以下文档：

• JavaScript SDK 快速入门
• Python SDK 快速入门
• Go SDK 快速入门
• Java SDK 快速入门

4. 设置 Callback 和 Webhook（可选）

为了增强安全性，您应该设置一个 Callback Endpoint 来二次确认提现请求。当您通过 WaaS 2.0 API 发起提现时，该 Endpoint 将接收交易详情，并且必须确认这些详情后才能继续进行交易。要进行设置，请参考 Webhook 和 Callback 指南。

5. 发起提币交易

如果您在开发环境中配置了交易风控，钱包中配置了主控组，或者配置了 Callback Endpoint 等，这些设置会对提币流程产生影响。例如，您可能需要额外审批步骤才能完成交易。

在提币前，请确保钱包中有足够主链币用于支付链上手续费，或者已启用 Fee Station 代付功能。

以下为 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: "Org-Controlled", // 钱包类型：MPC 钱包（机构钱包）
      wallet_id: "f47ac10b-58cc-4372-a567-0e02b2c3d479", // 钱包 ID
      address: "0xYourFromAddress", // 转出地址
    },
    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：
  调用获取交易详情 接口查询交易详情。 调用获取交易列表 接口查询交易列表。

至此，您已完成 MPC 钱包在开发环境中的主要功能快速体验，包括账户设置、充币与提币等操作。如果您想要在生产环境中正式部署和使用 MPC 钱包，请参考正式使用指南。

欢迎分享您的反馈以帮助我们改进文档！