命令参考

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

版本

使用 version 命令显示当前的 Cobo CLI 版本。

cobo version

登出

使用 logout 命令登出您的 Cobo Portal 账户或移除 Org Access Tokens 。

cobo logout [options]

选项

-u, --user：从您的 Cobo Portal 账户登出。
-o, --org：仅移除 Org Access Tokens 。
-a, --all：从您的 Cobo Portal 账户登出并移除 Org Access Tokens （默认行为）。

示例

cobo logout --user

身份验证

使用 auth 命令进行身份验证。

cobo auth <method>

参数

method: 要使用的身份验证方法。可能的值包括 apikey、user 和 org。

示例

cobo auth apikey

环境

使用 env 命令设置或查看当前环境。

cobo env <environment>

参数

<environment>：要设置的环境。可能的值包括 dev 和 prod。

示例

cobo env prod

密钥

使用 keys 命令生成和管理 API Key 密钥对和 App Key 密钥对。

生成

使用 generate 命令生成新的 API 或 App Key 密钥对。

cobo keys generate [options]

选项

--key-type <key_type>：指定要生成的密钥类型（API 或 APP）。默认为 API。
--alg <algorithm>：指定密钥生成算法。默认为 ed25519。
--force：强制替换现有的密钥。

示例

cobo keys generate --key-type APP --force

配置

使用 config 命令管理 CLI 配置设置。

设置

使用 set 命令设置配置值。

cobo config set <key> <value>

参数

key：要设置的键。
value：要设置的值。

示例

cobo config set environment dev

获取

使用 get 命令获取配置值。

cobo config get <key>

参数

key：要获取的键。

示例

cobo config get environment

列表

使用 list 命令列出所有配置值。

cobo config list

删除

使用 delete 命令删除配置值。

cobo config delete <key>

参数

key：要删除的键。

示例

cobo config delete api_key

应用

应用初始化

使用 init 命令创建一个集成 WaaS 2.0 服务的 App 。

cobo app init [options]

选项

-t, --app-type <portal|web|mobile|automation>： App 类型。
--auth <apikey|org|user>： App 使用的身份验证方法。
--wallet-type <custodial-asset|custodial-web3|mpc-org-controlled|mpc-user-controlled|smart-contract|exchange>： App 交互的钱包类型。
--mobile <flutter|react-native|kotlin|swift>： App 的移动开发框架。
--web <react|nextjs|vue|svelte>： App 的 Web 开发框架。
--backend <fastapi|django|express|flask|spring-boot|gin|laravel|rails|nextjs>： App 的后端开发框架。
-d, --directory <DIRECTORY>：创建 App 项目的目录。
-f, --force：强制覆盖项目目录，如果它已经存在。

示例

cobo app init --app-type web --auth apikey --directory my_project

应用上传

使用 upload 命令将您的 Cobo Portal Apps 发布到 Cobo Portal。

cobo app upload

应用更新

使用 update 命令部署更新到 Cobo Portal Apps 。

cobo app update

应用状态

使用 status 命令检查 Cobo Portal Apps 的状态。

cobo app status

Webhook

监听

使用 listen 命令建立 WebSocket 连接到 WaaS 2.0 服务并流式传输 Webhook 事件。

cobo webhook listen [options]

选项

--events <event_type>：通过指定事件类型来过滤事件。可能的事件类型值包括：
- wallets.transaction.created
- wallets.transaction.updated
- wallets.transaction.failed
- wallets.transaction.succeeded
- wallets.mpc.tss_request.created
- wallets.mpc.tss_request.updated
- wallets.mpc.tss_request.failed
- wallets.mpc.tss_request.succeeded
--forward <url>：将接收到的事件转发到指定的 URL。

示例

cobo webhook listen --events wallets.transaction.created,wallets.transaction.updated --forward "https://your-endpoint.com/webhook"

触发

使用 trigger 命令测试您的 Webhook 端点的功能通过触发测试 Webhook 事件。

cobo webhook trigger <event_type> [options]

参数 <event_type>：要触发的 Webhook 事件类型。可能的值包括：

wallets.transaction.created
wallets.transaction.updated
wallets.transaction.failed
wallets.transaction.succeeded
wallets.mpc.tss_request.created
wallets.mpc.tss_request.updated
wallets.mpc.tss_request.failed
wallets.mpc.tss_request.succeeded

选项 --override <json_string>：使用提供的 JSON 字符串覆盖事件负载中的特定字段。示例

cobo webhook trigger wallets.transaction.updated --override "{"chain_id": "ETH", "amount": "1000000000000000000"}"

事件

使用 events 命令检索 WaaS 2.0 中所有可用的 Webhook 事件类型。

cobo webhook events

API 命令

GET 请求

使用 get 命令发送 GET 请求到 WaaS 2.0 服务。您也可以使用它来检索所有可用的 GET 操作或显示指定操作的描述。

为了通过 Cobo CLI 发送 API 请求，您需要通过登录并使用 Org Access Tokens 或 API Keys 作为身份验证方法。详情请参照使用 Org Access Token 身份验证和使用 API Key 身份验证。

cobo get <path> [options]

参数 <path>：要发送 GET 请求的端点 URL。选项

-d, --describe：显示指定 GET 操作的描述，包括其预期响应和错误信息（如果有）。
-l, --list：列出 WaaS 2.0 服务的所有可用 GET 操作。

示例

cobo get /wallets/11223344

POST 请求

使用 post 命令发送 POST 请求到 WaaS 2.0 服务。您也可以使用它来检索所有可用的 POST 操作或显示指定操作的描述。

cobo post <path> [options]

参数 <path>：要发送 POST 请求的端点 URL。选项

-d, --describe：显示指定 POST 操作的描述，包括其预期响应和错误信息（如果有）。
-l, --list：列出 WaaS 2.0 服务的所有可用 POST 操作。

示例

cobo post /wallets --name "My New Wallet" --wallet_type Custodial

PUT 请求

使用 put 命令发送 PUT 请求到 WaaS 2.0 服务。您也可以使用它来检索所有可用的 PUT 操作或显示指定操作的描述。

cobo put <path> [options]

参数 <path>：要发送 PUT 请求的端点 URL。选项

-d, --describe：显示指定 PUT 操作的描述，包括其预期响应和错误信息（如果有）。
-l, --list：列出 WaaS 2.0 服务的所有可用 PUT 操作。

示例

cobo put /wallets/{wallet_id} --wallet_id your_wallet_id --name "Updated Wallet Name"

DELETE 请求

使用 delete 命令发送 DELETE 请求到 WaaS 2.0 服务。您也可以使用它来检索所有可用的 DELETE 操作或显示指定操作的描述。

cobo delete <path> [options]

参数 <path>：要发送 DELETE 请求的端点 URL。选项

-d, --describe：显示指定 DELETE 操作的描述，包括其预期响应和错误信息（如果有）。
-l, --list：列出 WaaS 2.0 服务的所有可用 DELETE 操作。

示例

cobo delete -l

实用命令

日志

使用 logs tail 命令实时流式传输您的 API 请求日志到 WaaS 2.0 服务。

cobo logs tail [options]

选项

--http-method：通过 HTTP 方法过滤 API 日志，例如 POST。
--request-path：通过端点路径过滤 API 日志，例如 /v2/wallets/{wallet_id}。
--status-code：通过 HTTP 状态码过滤 API 日志，例如 200。
--api-key：通过 API Key过滤 API 日志。
--ip-address：通过 IP 地址过滤 API 日志。

示例

cobo logs tail --http-method POST --status-code 404 --request-path /v2/wallets --ip-address 192.168.1.1

打开

使用 open 命令在您的默认 Web 浏览器中打开 Cobo Portal 的各种页面。

cobo open <shortcut>

参数 <shortcut>：用于快速打开 Cobo Portal 页面的快捷方式。可用的快捷方式包括：

portal：Cobo Portal 登录页面
dashboard：仪表板页面
wallets：钱包概览页面
custodial：全托管钱包概览页面
mpc：MPC 钱包概览页面
scw：智能合约钱包概览页面
exchange：交易所钱包概览页面
developer：开发者控制台
apps：Cobo Portal Apps 概览页面
pricing：定价计划页面
approval：审批页面

示例

cobo open mpc

文档

使用 doc 命令获取和更新 WaaS 2.0 的最新 OpenAPI 规范。

cobo doc <topic_or_path> [options]

参数 <topic_or_path>：指定文档主题或 API 操作路径。可能的值包括：

guides：（默认）打开 WaaS 2.0 简介指南。
api：打开 API 参考页面。
sdk：打开 WaaS SDK 指南。
apps：打开 Cobo Portal Apps 开发指南。
API 端点路径：显示指定 API 操作的详细信息，例如 /wallets/mpc/vaults。

选项 -u, --update：更新 WaaS 2.0 的 OpenAPI 规范，以确保您拥有最新的 API 定义和文档。示例

cobo doc /wallets/mpc/vaults

WaaS SDKs

Cobo CLI

Cobo UI Toolkit

其他工具

版本

登录

登出

身份验证

环境

密钥

生成

配置

设置

获取

列表

删除

应用

应用初始化

应用上传

应用更新

应用状态

Webhook

监听

触发

事件

API 命令

GET 请求

POST 请求

PUT 请求

DELETE 请求

实用命令

日志

打开

文档

WaaS SDKs

Cobo CLI

Cobo UI Toolkit

其他工具

​版本

​登录

​登出

​身份验证

​环境

​密钥

​生成

​配置

​设置

​获取

​列表

​删除

​应用

​应用初始化

​应用上传

​应用更新

​应用状态

​Webhook

​监听

​触发

​事件

​API 命令

​GET 请求

​POST 请求

​PUT 请求

​DELETE 请求

​实用命令

​日志

​打开

​文档

版本

登录

登出

身份验证

环境

密钥

生成

配置

设置

获取

列表

删除

应用

应用初始化

应用上传

应用更新

应用状态

Webhook

监听

触发

事件

API 命令

GET 请求

POST 请求

PUT 请求

DELETE 请求

实用命令

日志

打开

文档