# Developer Hub: 🌐 Version 2.0 EN ## 🌐 Version 2.0 EN - [🌐 Version 2.0 EN / API References (172 pages)](https://cobo.com/developers/_llms/version-2-0-en/api-references.md): Documentation for 🌐 Version 2.0 EN / API References. ### Guides #### Overview - [Introduction to Wallet-as-a-Service (WaaS) 2.0](https://cobo.com/developers/v2/guides/overview/introduction.md) - [Cobo WaaS Skill](https://cobo.com/developers/v2/guides/overview/cobo-waas-skill.md) - [Development and production environments](https://cobo.com/developers/v2/guides/overview/environments.md): Overview of WaaS 2.0 API environments for development and production, including purposes and URLs. - [Authentication](https://cobo.com/developers/v2/guides/overview/cobo-auth.md): Guide to authenticating API requests to the WaaS service using Cobo Auth, including API key and signature details. - [Error codes and status codes](https://cobo.com/developers/v2/guides/overview/error-codes.md): List of error codes for the WaaS 2.0 API, with explanations and troubleshooting tips. ##### Permissions - [Permissions and wallet scopes](https://cobo.com/developers/v2/guides/overview/permissions-and-scopes.md): Detailed explanation of permissions and wallet scopes in WaaS 2.0 for secure access control. - [Permission list](https://cobo.com/developers/v2/guides/overview/permission-list.md): Comprehensive list of resources and operations defining permissions for the WaaS 2.0 API. #### Get started - [Send your first request](https://cobo.com/developers/v2/guides/get-started/get-started-with-waas.md): Use the WaaS 2.0 API: set up account, generate API key, authenticate requests, and send API requests. - [Integrate Custodial Wallets (Asset Wallets)](https://cobo.com/developers/v2/guides/custodial-wallets/get-started-asset-wallets.md) - [Integrate MPC Wallets (Organization-Controlled Wallets)](https://cobo.com/developers/v2/guides/mpc-wallets/get-started-ocw.md) #### Webhooks and callbacks - [Introduction to Webhooks and Callbacks](https://cobo.com/developers/v2/guides/webhooks-callbacks/introduction.md): Introduction to webhooks and callbacks in WaaS 2.0, explaining their purpose and implementation. - [Set up a callback or webhook endpoint](https://cobo.com/developers/v2/guides/webhooks-callbacks/set-up-endpoint.md): Step-by-step guide to setting up a webhook endpoint in WaaS 2.0 for real-time event notifications. - [Webhook event types and data types](https://cobo.com/developers/v2/guides/webhooks-callbacks/webhook-event-type.md): Comprehensive list of webhook event types in WaaS 2.0, detailing each event's purpose and data structure. #### Transactions - [Transaction sources and destinations](https://cobo.com/developers/v2/guides/transactions/sources-and-destinations.md): Overview of transaction sources and destinations in WaaS 2.0. - [Transfer routing](https://cobo.com/developers/v2/guides/transactions/transfer-routing.md): Understand how token transfers are processed as Cobo Loop transfers or on-chain transfers, and how to control that behavior with request parameters. - [Estimate transaction fees](https://cobo.com/developers/v2/guides/transactions/estimate-fees.md): Guide on estimating transaction fees in WaaS 2.0, including factors affecting fees and calculation methods. - [Solana token account rent](https://cobo.com/developers/v2/guides/transactions/solana-token-account-rent.md): How Solana Associated Token Account (ATA) rent works, who pays it, and what to expect in transaction records. - [Manage transactions](https://cobo.com/developers/v2/guides/transactions/manage-transactions.md): Comprehensive guide on managing transactions in WaaS 2.0, covering canceling, speeding up, and dropping transactions. - [RBF (Replace-By-Fee) transaction lifecycle](https://cobo.com/developers/v2/guides/transactions/rbf-transaction-lifecycle.md): Understand how Replace-By-Fee (RBF) replaces an unconfirmed transaction, how the original transaction's status changes, and the events you receive. - [Validate addresses](https://cobo.com/developers/v2/guides/transactions/validate-addresses.md): Validate transaction destination addresses server-side with the Cobo API instead of hand-coded, per-chain format rules. ##### Transaction statuses - [Transaction statuses and sub-statuses](https://cobo.com/developers/v2/guides/transactions/status.md): Guide to understanding transaction statuses in WaaS 2.0. - [Transaction status flow for Custodial Wallets (Asset Wallets)](https://cobo.com/developers/v2/guides/transactions/transaction-process-custodial.md): Understand the detailed transaction status flow for deposits and withdrawals in Custodial Wallets (Asset Wallets) - [Transaction status flow for MPC Wallets and Web3 Wallets](https://cobo.com/developers/v2/guides/transactions/transaction-process-mpc.md): Understand the detailed transaction status flow for deposits and withdrawals in MPC Wallets and Custodial Wallets (Web3 Wallets) ##### Smart contract call samples - [Batch transfers using smart contracts](https://cobo.com/developers/v2/guides/transactions/batch-transfer.md): Use the WaaS 2.0 API to call a batch transfer smart contract and complete multiple token transfers in a single transaction. - [Swap tokens on Solana using Jupiter](https://cobo.com/developers/v2/guides/transactions/sol-jupiter-swap.md): A complete example guide for integrating Cobo WaaS SDK with Jupiter to perform token swaps on Solana. #### MPC Wallets - [MPC wallet setup, end to end](https://cobo.com/developers/v2/guides/mpc-wallets/mpc-setup-end-to-end.md): The complete path from nothing to a usable Org-Controlled MPC wallet: vault, key share holder group, key generation, wallet, address β€” and what happens automatically at each step. - [Balances and transaction amounts for MPC Wallets](https://cobo.com/developers/v2/guides/mpc-wallets/balance-amounts.md): Understand balances and transaction amounts in MPC Wallets. ##### Server co-signers - [Introduction to server co-signers](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/tss-node-overview.md): Overview of server co-signers using TSS Node for automated transaction signing. - [Run a co-signer on your development machine](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/local-development-co-signer.md): Set up a local TSS Node for development and testing β€” a laptop is enough, no public inbound access, about seven minutes end to end. - [Verify key shares](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/key-share-verify.md): Learn how to verify your key shares to ensure they are valid and properly configured - [Troubleshoot server co-signer setup](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/troubleshooting.md): Resolve common errors when setting up a server co-signer and generating key shares. - [Appendix](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/appendix.md): Appendix for the Server Co-signer guide. ###### Deploy and configure a server co-signer - [TSS Node package release notes](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/tss-node-release-notes.md): Release notes for the TSS Node package, detailing updates and new features. - [Network environments for deploying a server co-signer](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/tss-node-network-environments.md): Learn about the network environments required for deploying a server co-signer. - [Server requirements for deploying a server co-signer](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/tss-node-server-environments.md): Minimum and recommended server requirements for hosting a TSS Node. - [Deploy a server co-signer](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/tss-node-deployment.md): Learn how to deploy a server co-signer, including installing the TSS Node package and initializing the TSS Node. - [Update a server co-signer](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/tss-node-update.md): Instructions for updating a server co-signer to the latest TSS Node version. - [TSS Node event notifications](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/tss-node-event-notifications.md): Configure your TSS Node to push key generation, signing, and resharing events to your own server, and verify them with the node's RSA public key. ###### Risk control mechanisms - [Risk control mechanisms overview](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/risk-control-mechanisms.md): Understanding the risk control mechanisms in server co-signer - [Risk control best practices for server co-signers](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/risk-control-best-practices.md) - [Embedded risk control mechanism](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/embedded-risk-controls.md): Configure basic risk controls in the server co-signer ###### TSS Node callback - [TSS Node callback mechanism](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/callback-server-overview.md): Understanding the TSS Node callback mechanism architecture and workflow - [Deploy a TSS Node callback server](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/callback-server-deploy.md): Step-by-step guide to deploy a TSS Node callback server - [Configure callback keys and TSS Node](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/callback-server-configure.md): Configure callback keys and TSS Node settings for secure communication between your callback server and TSS Node - [Callback request and response formats](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/callback-server-data-structure.md): Detailed specifications of the payload formats used in TSS Node callback server interaction ###### Backup, restore, and recovery - [Backup, restore, and recovery](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/disaster-recovery-overview.md): Overview of backup, restore, and recovery methods for your key shares - [Back up your key share](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/key-shares-backup.md): Learn how to back up your key share. - [Restore key shares](https://cobo.com/developers/v2/guides/mpc-wallets/server-co-signer/key-shares-restore.md): Guide to restoring TSS Node key shares from backup #### Resources - [Changelog](https://cobo.com/developers/v2/guides/overview/changelog.md): Detailed changelog of all additions and changes to the WaaS 2.0 API. - [Upgrade from WaaS 1.0 to 2.0](https://cobo.com/developers/v2/guides/overview/upgrade-guide.md): Guide for upgrading from WaaS 1.0 to 2.0, highlighting benefits and providing step-by-step instructions. - [Integrate MPC Wallets (User-Controlled Wallets)](https://cobo.com/developers/v2/guides/mpc-wallets/get-started-ucw.md): Guide to building User-Controlled Wallets using the WaaS 2.0 API and the UCW SDK, covering setup, wallet creation, and transaction management. ### Developer Tools #### WaaS SDKs - [Get started with Python SDK](https://cobo.com/developers/v2/developer-tools/quickstart-python.md): Learn to integrate, configure, and use the Python SDK with code samples for seamless app development. - [Get started with Java SDK](https://cobo.com/developers/v2/developer-tools/quickstart-java.md): Learn to integrate, configure, and use the Java SDK with code samples for seamless app development. - [Get started with Go SDK](https://cobo.com/developers/v2/developer-tools/quickstart-go.md): Learn to integrate, configure, and use the Go SDK with code samples for seamless app development. - [Get started with JavaScript SDK](https://cobo.com/developers/v2/developer-tools/quickstart-javascript.md): Learn to integrate, configure, and use the JavaScript SDK with code samples for seamless app development. #### Cobo CLI - [Key management](https://cobo.com/developers/v2/developer-tools/cobo-cli/key-management.md): Generate and manage API and app key pairs for authentication to the WaaS 2.0 service. ##### Overview - [Introduction to Cobo CLI](https://cobo.com/developers/v2/developer-tools/cobo-cli/introduction.md): Learn about Cobo CLI, a tool for building, testing, and managing WaaS 2.0 integrations. - [Changelog](https://cobo.com/developers/v2/developer-tools/cobo-cli/changelog.md): Stay updated with all the latest changes and additions to Cobo CLI through the changelog. ##### Get started - [Quick start guide](https://cobo.com/developers/v2/developer-tools/cobo-cli/quick-start-guide.md): Get started with Cobo CLI installation, authentication, configuration, and basic commands. - [Version and updates](https://cobo.com/developers/v2/developer-tools/cobo-cli/version-and-updates.md): Learn how to check and update your Cobo CLI version for the latest features and improvements. - [Login and authentication](https://cobo.com/developers/v2/developer-tools/cobo-cli/login-and-authentication.md): Authenticate Cobo CLI with the WaaS 2.0 service using API keys, Org Access Tokens, or Cobo Portal accounts. - [Environment management](https://cobo.com/developers/v2/developer-tools/cobo-cli/environment-management.md): Switch between development and production environments with Cobo CLI. - [Configuring Cobo CLI](https://cobo.com/developers/v2/developer-tools/cobo-cli/configuration.md): Guide to inspect and modify Cobo CLI configurations for optimal command usage. ##### API commands - [GET requests](https://cobo.com/developers/v2/developer-tools/cobo-cli/get-requests.md): Perform GET HTTP requests to the WaaS 2.0 service using Cobo CLI. - [POST requests](https://cobo.com/developers/v2/developer-tools/cobo-cli/post-requests.md): Perform POST HTTP requests to the WaaS 2.0 service using Cobo CLI. - [PUT requests](https://cobo.com/developers/v2/developer-tools/cobo-cli/put-requests.md): Perform PUT HTTP requests to the WaaS 2.0 service using Cobo CLI. - [DELETE requests](https://cobo.com/developers/v2/developer-tools/cobo-cli/delete-requests.md): Perform DELETE HTTP requests to the WaaS 2.0 service using Cobo CLI. ##### App development - [Create a WaaS application](https://cobo.com/developers/v2/developer-tools/cobo-cli/app-init.md): Use the `init` command to create and configure a WaaS application with Cobo CLI, specifying app type and frameworks. - [Publish Cobo Portal Apps](https://cobo.com/developers/v2/developer-tools/cobo-cli/app-upload.md): Use the `app upload` command to publish your Cobo Portal Apps to Cobo Portal efficiently. - [Update Cobo Portal Apps](https://cobo.com/developers/v2/developer-tools/cobo-cli/app-update.md): Deploy updates to your Cobo Portal App using the `app update` command to keep your app current. - [Check Cobo Portal App status](https://cobo.com/developers/v2/developer-tools/cobo-cli/app-status.md): Use the `app status` command to verify the current status of your Cobo Portal Apps in production. ##### Webhooks - [Listen and forward events](https://cobo.com/developers/v2/developer-tools/cobo-cli/listen-and-forward-events.md): Stream and forward webhook events from the WaaS 2.0 service using Cobo CLI. - [Trigger webhook events](https://cobo.com/developers/v2/developer-tools/cobo-cli/trigger-events.md): Test your webhook endpoint by triggering test events with Cobo CLI. - [List event types](https://cobo.com/developers/v2/developer-tools/cobo-cli/event-types.md): Retrieve available webhook event types in WaaS 2.0 using Cobo CLI. ##### Utility commands - [View real-time logs](https://cobo.com/developers/v2/developer-tools/cobo-cli/real-time-logs.md): Stream real-time API request logs in your terminal for monitoring and troubleshooting. - [Open browser shortcuts](https://cobo.com/developers/v2/developer-tools/cobo-cli/open-browser-shortcuts.md): Use Cobo CLI shortcuts to quickly open Cobo Portal pages in your browser. - [View API documentation](https://cobo.com/developers/v2/developer-tools/cobo-cli/api-documentation.md): Fetch and update the latest WaaS 2.0 OpenAPI specification with Cobo CLI for up-to-date API definitions. ##### Command reference - [Global options](https://cobo.com/developers/v2/developer-tools/cobo-cli/global-options.md): Customize Cobo CLI command behavior with global options for environment and authentication. - [Command reference](https://cobo.com/developers/v2/developer-tools/cobo-cli/cli-commands.md): A comprehensive guide to all commands supported by Cobo CLI for efficient usage. #### Cobo UI Toolkit - [Introduction to Cobo UI Toolkit](https://cobo.com/developers/v2/developer-tools/uitoolkit-intro.md): Discover Cobo UI Toolkit for seamless Cobo Portal App development. Simplify tasks with utility functions and React integration. - [UI Toolkit API reference](https://cobo.com/developers/v2/developer-tools/uitoolkit-api.md): Explore the Cobo UI Toolkit API for efficient app development. Access hooks, functions, and types for seamless integration. #### Other tools - [Get testnet coins](https://cobo.com/developers/v2/developer-tools/get-testnet-coins.md): Learn how to obtain testnet coins for testing your integration with the WaaS 2.0 API. ##### UCW SDKs - [Get started with UCW SDK (iOS)](https://cobo.com/developers/v2/developer-tools/quickstart-ucw-ios.md): Learn to integrate, install, and implement MPC Wallets (User-Controlled Wallets) with detailed code samples. ###### UCW SDK operations ###### Initialize Secrets - [Initialize Secrets](https://cobo.com/developers/v2/developer-tools/ucw-sdk/initialize-secrets/initialize-secrets.md): This operation initializes a passphrase-encrypted Secrets file that contains a unique TSS Node ID. ###### UCW class - [Create UCW class](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/create-ucw.md): This operation creates an instance of the UCW class, decrypts the Secrets file, establishes a connection with the Cobo server, and optionally registers a callback endpoint to monitor the connection status. - [Destroy UCW class](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/destroy-ucw.md): This operation destroys an instance of the UCW class. - [Get connection status](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/get-connection-status.md): This operation retrieves the connection status with the Cobo server. ###### TSS request - [List pending TSS requests](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/list-pending-tss-requests.md): This operation retrieves a list of pending TSS requests. - [Get TSS requests](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/get-tss-requests.md): This operation retrieves the specified TSS requests. - [Approve TSS requests](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/approve-tss-requests.md): This operation approves the specified TSS requests. - [Reject TSS requests](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/reject-tss-requests.md): This operation rejects the specified TSS requests and provides reason for the rejection. ###### Transaction - [List pending transactions](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/list-pending-transactions.md): This operation retrieves a list of all pending transactions. - [Get transactions](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/get-transactions.md): This operation retrieves the specified transactions. - [Approve transactions](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/approve-transactions.md): This operation approves the specified transactions. - [Reject transactions](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/reject-transactions.md): This operation rejects the specified transactions and provides reason for the rejection. ###### Backup recovery key shares - [Export recovery key shares](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/export-recovery-key-shares.md): This operation exports the specified key shares as a passphrase-encrypted JSON data, which can later be used with the [Import recovery key share](https://www.cobo.com/developers/v2/developer-tools/ucw-sdk/ucwrecoverkey-class/import-recovery-key-share) and [Recover private keys](https://www.cobo.com/… ###### Backup Secrets - [Export Secrets](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/export-secrets.md): This operation exports the Secrets file as a passphrase-encrypted JSON data of TSS Node. You can then use the [Import Secrets](https://www.cobo.com/developers/v2/developer-tools/ucw-sdk/other-apis/import-secrets) operation to restore the Secrets file. ###### UCWPublic class - [Create UCWPublic class](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucwpublic-class/create-ucw-public.md): This operation creates an instance of the UCWPublic class. - [Destroy UCWPublic class](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucwpublic-class/destroy-ucw-public.md): This operation destroys an instance of the UCWPublic class. - [Get TSS Node ID](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucwpublic-class/get-tss-node-id.md): This operation retrieves the TSS Node ID. - [Get TSS key share groups](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucwpublic-class/get-tss-key-share-groups.md): This operation retrieves detailed information about the specified TSS key share groups. - [List active TSS key share groups](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucwpublic-class/list-active-tss-key-share-groups.md): This operation retrieves a list of all active TSS key share groups. ###### UCWRecoverKey class - [Create UCWRecoverKey class](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucwrecoverkey-class/create-ucw-recover-key.md): This operation creates an instance of the UCWRecoverKey class. - [Destroy UCWRecoverKey class](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucwrecoverkey-class/destroy-ucw-recover-key.md): This operation destroys an instance of the UCWRecoverKey class and clears the recovery key shares that have already been imported into memory. ###### Recover keys - [Import recovery key share](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucwrecoverkey-class/import-recovery-key-share.md): This operation imports and decrypts the JSON data of recovery key shares, created by the [Export recovery key shares](https://www.cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/export-recovery-key-shares) or [Export Secrets](https://www.cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-cl… - [Recover private keys](https://cobo.com/developers/v2/developer-tools/ucw-sdk/ucwrecoverkey-class/recover-private-keys.md): This operation recovers the full private keys for the specified addresses using recovery key shares imported via the [Import recovery key share](https://www.cobo.com/developers/v2/developer-tools/ucw-sdk/ucwrecoverkey-class/import-recovery-key-share) operation. ###### Restore Secrets - [Import Secrets](https://cobo.com/developers/v2/developer-tools/ucw-sdk/other-apis/import-secrets.md): This operation imports the JSON data of Secrets created with the [Export Secrets](https://www.cobo.com/developers/v2/developer-tools/ucw-sdk/ucw-class/export-secrets) operation. The imported file will then be converted into a new passphrase-encrypted Secrets file, and TSS Node ID within the Secrets… ###### Others - [Get UCW SDK information](https://cobo.com/developers/v2/developer-tools/ucw-sdk/other-apis/get-sdk-info.md): This operation retrieves detailed information about the UCW SDK. - [Set logger](https://cobo.com/developers/v2/developer-tools/ucw-sdk/other-apis/set-logger.md): This operation enables activity logging for the UCW SDK. ### Cobo Portal Apps #### Introduction - [Introduction to Cobo Portal App development](https://cobo.com/developers/v2/apps/introduction.md): Explore Cobo Portal App development with WaaS 2.0 API, Cobo CLI, and Cobo UI toolkit. #### Get started - [Create a sample app](https://cobo.com/developers/v2/apps/get-started.md): Start building a Cobo Portal App with our step-by-step guide. Learn to set up, preview, and publish using Cobo CLI. #### Build an app - [Build a Cobo Portal App](https://cobo.com/developers/v2/apps/build-app.md): Build a Cobo Portal App from scratch. Follow detailed steps for development, authentication, and publishing using Cobo CLI and WaaS API. - [Configure approval workflow](https://cobo.com/developers/v2/apps/configure-workflow.md): Configure approval workflows in Cobo Portal Apps. Learn to set rules, manage operations, and ensure secure transaction approvals. ##### Authentication - [Authentication with Cobo OAuth](https://cobo.com/developers/v2/apps/authentication.md): Authenticate Cobo Portal Apps with Cobo OAuth. Learn to use app keys, secrets, and Org Access Tokens for secure API requests. - [Org Access Tokens](https://cobo.com/developers/v2/apps/org-access-tokens.md): Discover how Org Access Tokens enable secure resource access in Cobo Portal Apps. Learn token acquisition, refresh, and permission management. - [User Info Tokens](https://cobo.com/developers/v2/apps/verify-users.md): Learn how to use User Info Tokens in Cobo Portal Apps to verify user identity and control access with JWTs. ## Optional - [Payments Solution](https://www.cobo.com/payments/en/guides/overview)