Skip to main content
Try Cobo WaaS Skill in your AI coding assistant (Claude Code, Cursor, etc.). Describe your needs in natural language to auto-generate production-ready SDK code and debug faster 🚀

​
version

Use the version command to display the current version of Cobo CLI.

​
login

Use the login command to log in to your Cobo Portal account or acquire an Org Access Token.
Options
  • -u, --user: Log in with your Cobo Portal account (default).
  • -o, --org: Acquire an Org Access Token.
  • --refresh-token: Refresh the existing Org Access Token instead of generating a new one.
Example

​
logout

Use the logout commands to log out of your Cobo Portal account or remove the Org Access Token.
Options
  • -u, --user: Log out from your Cobo Portal account.
  • -o, --org: Remove the Org Access Token only.
  • -a, --all: Log out from your Cobo Portal account and remove the Org Access Token (default behavior).
Example

​
auth

Use the auth command to set or view the current authentication method.
Arguments
  • method: The authentication method to set. Possible values include apikey, user, and org.
Example

​
env

Use the env command to set or view the current environment.
Arguments
  • <environment>: The environment to set. Possible values include dev and prod.
Example

​
keys

Use the keys commands to generate and manage API key pairs and app key pairs.

​
generate

Use the generate command to generate a new API or app key pair.
Options
  • --key-type <key_type>: Specify the type of key to generate (API or APP). Default is API.
  • --alg <algorithm>: Specify the key generation algorithm. Default is ed25519.
  • --force: Force replacement of existing keys.
Example

​
config

Use the config commands to manage CLI configuration settings.

​
set

Use the set command to set a configuration value.
Arguments
  • key: The key to set.
  • value: The value to set.
Example

​
get

Use the get command to get a configuration value.
Arguments
  • key: The key to get.
Example

​
list

Use the list command to list all configuration values.

​
delete

Use the delete command to delete a configuration value.
Arguments
  • key: The key to delete.
Example

​
app

​
app init

Use the init command to create an application that integrates the WaaS 2.0 service.
Options
  • -t, --app-type <portal|web|mobile|automation>: The type of WaaS application.
  • --auth <apikey|org|user>: The authentication method that the application uses to access the WaaS 2.0 service.
  • --wallet-type <custodial-asset|custodial-web3|mpc-org-controlled|mpc-user-controlled|smart-contract|exchange>: The wallet type that the application interacts with.
  • --mobile <flutter|react-native|kotlin|swift>: The mobile development framework of the application.
  • --web <react|nextjs|vue|svelte>: The web development framework of the application.
    Currently Cobo CLI only supports react.
  • --backend <fastapi|django|express|flask|spring-boot|gin|laravel|rails|nextjs>: The backend development framework of the application.
    Currently Cobo CLI only supports fastapi.
  • -d, --directory <DIRECTORY>: The directory in which you want to create the application project.
  • -f, --force: Force overwrite the project directory if it already exists.
Example

​
app upload

Use the upload command to publish your Cobo Portal Apps to Cobo Portal.

​
app update

Use the update command to deploy updates to a Cobo Portal App on Cobo Portal.

​
app status

Use the status command to check the status of Cobo Portal Apps.

​
webhook

​
listen

Use the listen command to establish a WebSocket connection to the WaaS 2.0 service and stream webhook events.
Options
  • --events <event_type>: Filter the events by specifying event types. Possible values for event types include:
    • 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>: Forward received events to the specified URL.
Example

​
trigger

Use the trigger command to test the functionality of your webhook endpoint by triggering a test webhook event.
Arguments <event_type>: The webhook event type you want to trigger. Possible values include:
  • 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
Options --override <json_string>: Override specific fields in the event payload with the provided JSON string. Example

​
events

Use the events command to retrieve all available webhook event types in WaaS 2.0.

​
API commands

​
get

Use the get command to make a GET request to the WaaS 2.0 service. You can also use it to retrieve a list of all available GET operations or display the description of a specified operation within the WaaS 2.0 API.
To make API requests via Cobo CLI, you need to authenticate your requests by logging in and using Org Access Tokens or API Keys as the authentication method. For more information, refer to Authenticate with Org Access Tokens and Authenticate with API Keys.
Arguments <path>: The URL of the endpoint to which the GET request will be sent. Options
  • -d, --describe: Display the description of the specified GET operation, including its expected responses and error information (if any).
  • -l, --list: List all available GET operations of the WaaS 2.0 service.
Example

​
post

Use the post command to make a POST request to the WaaS 2.0 service. You can also use it to retrieve a list of all available POST operations or display the description of a specified operation within the WaaS 2.0 API.
To make API requests via Cobo CLI, you need to authenticate your requests by logging in and using Org Access Tokens or API Keys as the authentication method. For more information, refer to Authenticate with Org Access Tokens and Authenticate with API Keys.
Arguments <path>: The URL of the endpoint to which the POST request will be sent. Options
  • -d, --describe: Display the description of the specified POST operation, including its expected responses and error information (if any).
  • -l, --list: List all available POST operations of the WaaS 2.0 service.
Example

​
put

Use the put command to make a PUT request to the WaaS 2.0 service. You can also use it to retrieve a list of all available PUT operations or display the description of a specified operation within the WaaS 2.0 API.
To make API requests via Cobo CLI, you need to authenticate your requests by logging in and using Org Access Tokens or API Keys as the authentication method. For more information, refer to Authenticate with Org Access Tokens and Authenticate with API Keys.
Arguments <path>: The URL of the endpoint to which the PUT request will be sent. Options
  • -d, --describe: Display the description of the specified PUT operation, including its expected responses and error information (if any).
  • -l, --list: List all available PUT operations of the WaaS 2.0 service.
Example

​
delete

Use the delete command to make a DELETE request to the WaaS 2.0 service. You can also use it to retrieve a list of all available DELETE operations or display the description of a specified operation within the WaaS 2.0 API.
To make API requests via Cobo CLI, you need to authenticate your requests by logging in and using Org Access Tokens or API Keys as the authentication method. For more information, refer to Authenticate with Org Access Tokens and Authenticate with API Keys.
Arguments <path>: The URL of the endpoint to which the DELETE request will be sent. Options
  • -d, --describe: Display the description of the specified DELETE operation, including its expected responses and error information (if any).
  • -l, --list: List all available DELETE operations of the WaaS 2.0 service.
Example

​
Utility commands

​
logs tail

Use the logs tail command to stream real-time logs of your API requests to the WaaS 2.0 service directly in your terminal.
Options
  • --http-method: Filter API logs by the HTTP method, such as POST.
  • --request-path: Filter API logs by the endpoint path, such as /v2/wallets/{wallet_id}.
  • --status-code: Filter API logs by the HTTP status code, such as 200.
  • --api-key: Filter API logs by a specific API key used in requests.
  • --ip-address: Filter API logs by the IP address from which requests were made.
Example

​
open

Use the open command to open various pages of Cobo Portal conveniently in your default web browser with shortcuts.
Arguments <shortcut>: Shortcut used to quickly open a page of Cobo Portal. The following shortcuts are available:
  • portal: The login page of Cobo Portal
  • dashboard: The Dashboard page
  • wallets: The Wallets overview page
  • custodial: The Custodial Wallets overview page
  • mpc: The MPC Wallets overview page
  • scw: The Smart Contract Wallets overview page
  • exchange: The Exchange Wallets overview page
  • developer: Developer Console
  • apps: The Cobo Portal Apps overview page
  • pricing: The Pricing Plans page
  • approval: The Approvals page
Example

​
doc

Use the doc command to fetch and update the latest WaaS 2.0 OpenAPI specification.
Arguments <topic_or_path>: Specifies the documentation topic or the API operation path. Possible values include: Options -u, --update: Update the OpenAPI specification for WaaS 2.0, ensuring you have the latest API definitions and documentation. Example