The v2 Wallet API is currently in Beta. Reach out in the #wallet-api channel of the CDP Discord for any questions or fill out this form to schedule a call with a CDP team member.
The v2 Wallet API enables developers to programmatically create, manage, and use crypto accounts while CDP secures the private keys and handles complex infrastructure management. Developers can access the v2 Wallet API through either the CDP SDK or CDP’s REST endpoints.
With the v2 Wallet API, you can execute token swaps directly from your CDP accounts, combining the power of our Swap APIs with secure transaction signing. This allows you to discover the best prices, create swap quotes, and execute trades in a single call.
The following table summarizes the key differences between v1 and v2 Wallet APIs:
Feature | v1 Wallet API 🔴 | v2 Wallet API 🟢 |
---|---|---|
Security management | Complex | Easy |
Private key security | Developer-managed | Secured in AWS Nitro Enclave TEE |
Authentication | One secret per account | Single secret for all accounts |
Network support | EVM only | EVM and Solana |
EVM account scope | Single EVM network | Multiple EVM networks |
Transaction batching | - | ✅ |
Gas sponsorship | - | ✅ |
Spend permissions | - | ✅ |
Viem compatibility | - | ✅ |
Instead of securing your own private keys or needing to set up Server-Signer infrastructure, the v2 Wallet API greatly simplifies crypto key management by signing all of your transactions within a Trusted Execution Environment (TEE).
The TEE ensures that sensitive cryptographic material is never exposed to the outside world - not even to Coinbase!
The Trusted Execution Environment (TEE) provides a secure environment for signing your transactions, and ensures that your private keys are never exposed to Coinbase, AWS, or the outside world. Read more in our Security documentation.
In the v2 Wallet API, a single Wallet Secret grants access to all of your accounts across both the EVM and Solana ecosystems. This single secret is used for sensitive wallet operations, such as account creation and transaction signing.
In case your Wallet Secret is lost or compromised, you can rotate your secret at any time.
Rather than limiting usage to a single EVM network, EVM accounts created using the v2 Wallet API are compatible across all EVM chains.
The v2 Wallet API also supports Solana accounts, allowing you to create and manage Solana accounts in addition to EVM accounts.
The v2 Wallet API supports EIP-4337 smart accounts, which provide the following advanced features via smart contract calls:
More on smart accounts
Also known as a smart contract account, a smart account is an account powered by a smart contract instead of an externally owned account (EOA).
With a CDP smart account, you can:
Implemented using the EIP-4337 standard, a smart account can function like a “normal” account, enhancing usability, security, and flexibility for developers and end-users.
EVM Accounts in the v2 Wallet API can be used directly with viem as custom accounts. This allows you to leverage viem’s widely-used abstractions seamlessly with the CDP SDK. Refer to the viem compatibility guide for more details.
The v2 Wallet API integrates with our Swap APIs to enable seamless token swaps directly from your CDP accounts using Coinbase infrastructure. This integration combines price discovery, quote creation, and transaction execution into a single call, while maintaining the flexibility to use your own wallet and node if preferred. Learn more in the Wallet API Swaps guide or the Swap API overview.
Join #wallet-api in the CDP Discord to access FAQs, schedule project discussions, and connect with other developers. We welcome your feedback and suggestions for improvement.
Explore comprehensive video resources to learn about CDP Wallet API v2 features and see real-world implementations: