Skip to main content
开通一个 Org-Controlled MPC 钱包是四次 API 调用加一场密钥仪式。本页把完整 链路走一遍,说明每一步的产出,并点明那些自动发生的行为——从零散的 API 参考页拼装流程时最容易漏掉的部分。
开始之前:您需要有自己的协签方。 私钥分片持有者组至少需要两个持有者 且门限为 2,而 Cobo 自己的持有者不会单独签名——因此其中一个持有者必须是 您自己的:运行 Cobo Guard 的手机(Mobile),或您自行运行的 TSS Node (API)。下面的 API 调用无法替您创建它。开发场景下,在笔记本上运行自己的节点只需几分钟:见 在开发机上运行协签节点。 请先完成该步骤,拿到节点 ID 后再回到本页。

1. 创建 vault

使用 Create vault
vault 名称中不能包含 +-=@ 这几个字符。 产出的 vault 中 root_pubkeys 为空——此时 vault 还没有密钥,在密钥生成 完成前无法承载钱包。

2. 创建私钥分片持有者组

使用 Create key share holder group
  • Cobo 会自动补位为第一持有者;您只需列出自己的持有者。participants 的计数包含 Cobo。
  • 门限必须为 2——单方持有者组会被拒绝。
  • 持有者 type 取值为 CoboMobileAPI(大小写精确;API 是缩写 词)。Mobile 表示运行 Cobo Guard 的手机,此后每笔签名都需要该手机; API 表示您自行运行的 TSS Node——本地运行方式见 在开发机上运行协签节点
  • 创建持有者组就是节点注册:列入组中的 TSS Node 在组创建成功的一刻 即不再被中继拒绝(“not bound to any app”)。组的初始 statusNew

3. 运行密钥生成仪式

使用 Create TSS request
所有持有者必须在线(持有者组查询会逐个显示 online)。轮询请求直至完成:
双方在线时通常约 20 秒。成功后 vault 携带两条曲线的 root_pubkeys (SECP256K1 与 ED25519),持有者组变为 Valid

4. 密钥生成后自动发生的行为

  • 自动创建默认钱包——第一个钱包不需要您自己建。
  • 默认钱包自带主网地址(ETH、BTC、SOL)。测试网地址不会自动生成。
  • 测试币空投仅发生在组织的第一个 vault。第二个及之后的 vault 默认钱包 是空的——请自行注入资金;在那里等空投会永远等下去。

5. 地址

在钱包的创建地址操作上补建地址,例如 Sepolia 地址:
地址由服务端从 vault 根公钥派生:协签节点离线时收款照常可用。签名 (提币、消息签名)则需要 signer 持有者在线。

常见状态速查