@coinbase/cdp-solana-standard-wallet

A React hook and wallet implementation that integrates CDP (Coinbase Developer Platform) embedded Solana wallets with the Wallet Standard.

Features

🔗 Wallet Standard Integration - Works with any dapp that supports the wallet standard
🔐 CDP Authentication - Uses CDP’s secure embedded wallet infrastructure
⚛️ React Hooks - Easy-to-use hooks for React applications
🎯 TypeScript Support - Full type safety with TypeScript
🚀 Auto-Registration - Automatically registers with wallet standard ecosystem
🔄 Event-Driven - Real-time updates via CDP auth state changes
📱 Multi-Network - Supports both Solana mainnet and devnet

Installation

npm install @coinbase/cdp-solana-standard-wallet

Peer Dependencies

npm install @coinbase/cdp-core react @wallet-standard/app @wallet-standard/base @wallet-standard/features @solana/wallet-standard bs58

Optional Dependencies

Depending on your usage pattern, you may also need:

# For Option 1 (CDPHooksProvider)
npm install @coinbase/cdp-hooks

# For Option 2 (CDPReactProvider)
npm install @coinbase/cdp-react @coinbase/cdp-hooks

Usage

Option 1: With CDPHooksProvider

import { CDPHooksProvider } from '@coinbase/cdp-hooks';
import { useCdpSolanaStandardWallet } from '@coinbase/cdp-solana-standard-wallet';

// Wrap your app with CDPHooksProvider
function App() {
  return (
    <CDPHooksProvider config={{ projectId: 'your-project-id' }}>
      <MyWalletComponent />
    </CDPHooksProvider>
  );
}

// Use the hook in your component
function MyWalletComponent() {
  const { ready, wallet } = useCdpSolanaStandardWallet();

  if (!ready) {
    return <div>Loading wallet...</div>;
  }

  return (
    <div>
      <h3>CDP Solana Wallet Ready!</h3>
      <p>Name: {wallet.name}</p>
      <p>Accounts: {wallet.accounts.length}</p>
    </div>
  );
}

Option 2: With CDPReactProvider

import { CDPReactProvider } from '@coinbase/cdp-react';
import { useCdpSolanaStandardWallet } from '@coinbase/cdp-solana-standard-wallet';

// Wrap your app with CDPReactProvider
function App() {
  return (
    <CDPReactProvider config={{
      projectId: 'your-project-id',
      solana: { createOnLogin: true }
    }}>
      <MyWalletComponent />
    </CDPReactProvider>
  );
}

// Use the hook in your component
function MyWalletComponent() {
  const { ready, wallet } = useCdpSolanaStandardWallet();

  if (!ready) {
    return <div>Loading wallet...</div>;
  }

  return (
    <div>
      <h3>CDP Solana Wallet Ready!</h3>
      <p>Name: {wallet.name}</p>
      <p>Accounts: {wallet.accounts.length}</p>
    </div>
  );
}

Option 3: Standalone Usage

import { useCdpSolanaStandardWallet } from '@coinbase/cdp-solana-standard-wallet';

function MyWalletComponent() {
  // Pass config directly - hook will initialize CDP SDK
  const { ready, wallet } = useCdpSolanaStandardWallet({
    projectId: 'your-project-id'
  });

  if (!ready) {
    return <div>Initializing...</div>;
  }

  return <div>Wallet ready: {wallet.name}</div>;
}

Analytics Opt-Out

By default the SDK will emit usage analytics to help us improve the SDK. If you would like to opt-out, you can do so by setting the disableAnalytics configuration option to true.

<CDPReactProvider config={{
  projectId: "your-project-id",
  disableAnalytics: true,
}}>

Or if you’re using the standalone usage, you can pass the disableAnalytics configuration option to the hook:

const { ready, wallet } = useCdpSolanaStandardWallet({
  projectId: "your-project-id",
  disableAnalytics: true,
});

Using All Standard Wallets

import { useSolanaStandardWallets } from '@coinbase/cdp-solana-standard-wallet';

function WalletSelector() {
  const { wallets } = useSolanaStandardWallets();

  return (
    <div>
      <h3>Available Wallets:</h3>
      {wallets.map((wallet) => (
        <div key={wallet.name}>
          <img src={wallet.icon} alt={wallet.name} width="24" height="24" />
          <span>{wallet.name}</span>
          {wallet.features['cdp:'] && <span> (CDP)</span>}
        </div>
      ))}
    </div>
  );
}

Direct Wallet Usage

import { getWallets } from '@wallet-standard/app';

// Find CDP wallet among all registered wallets
const wallets = getWallets();
const cdpWallet = wallets.get().find(w => w.features['cdp:']);

if (cdpWallet) {
  // Connect to the wallet
  const { accounts } = await cdpWallet.features['standard:connect'].connect();

  // Sign a transaction
  const result = await cdpWallet.features['solana:signTransaction'].signTransaction({
    transaction: transactionBytes,
    account: accounts[0],
    chain: 'solana:mainnet'
  });

  // Sign and send a transaction
  const sendResult = await cdpWallet.features['solana:signAndSendTransaction'].signAndSendTransaction({
    transaction: transactionBytes,
    account: accounts[0],
    chain: 'solana:mainnet'
  });
}

API Reference

`useCdpSolanaStandardWallet(config?)`

Hook that manages CDP Solana wallet creation and registration. Parameters:

config (optional): CDP configuration object with projectId

Returns:

{
  ready: boolean;           // True when wallet is ready to use
  wallet: CdpSolanaWallet | null;  // The wallet instance
}

`useSolanaStandardWallets()`

Hook that returns all registered Solana wallets in the wallet standard. Returns:

{
  wallets: readonly Wallet[];  // Array of all registered wallets
}

`CdpSolanaWallet`

The wallet implementation that integrates with CDP. Properties:

name: “CDP Solana Wallet”
icon: Solana logo as base64 data URI
chains: ['solana:mainnet', 'solana:devnet']
accounts: Array of ReadonlyWalletAccount
features: Supported wallet standard features

Supported Features:

standard:connect - Connect to the wallet
standard:disconnect - Disconnect from the wallet
standard:events - Listen for wallet events
solana:signTransaction - Sign transactions
solana:signAndSendTransaction - Sign and send transactions
solana:signMessage - Sign arbitrary messages
cdp: - CDP-specific feature flag

Authentication Flow

User Authentication: User signs in via CDP (email/SMS OTP)
Wallet Creation: CDP creates embedded Solana accounts
Hook Activation: useCdpSolanaStandardWallet detects accounts
Wallet Registration: Wallet is registered with wallet standard
Ready State: ready: true indicates wallet is available
Dapp Integration: Dapps can discover and use the wallet

Network Support

Mainnet: solana:mainnet → CDP network: solana
Devnet: solana:devnet → CDP network: solana-devnet

Error Handling

The hooks handle various error scenarios gracefully:

Unauthenticated User: ready: false, wallet: null
No Solana Accounts: ready: false, wallet: null
CDP Initialization Failure: Logs error, ready: false
Network Errors: Individual operations throw descriptive errors

Security

All cryptographic operations performed by CDP’s secure infrastructure
Private keys never exposed to application code
Authentication handled via CDP’s secure auth flow
Wallet disconnect clears wallet accounts but does not sign out user (maintains session)

SDKs

CRYPTO INFRASTRUCTURE

COINBASE APIs

INSTITUTIONAL APIs

Overview

@coinbase/cdp-solana-standard-wallet

Features

Installation

Peer Dependencies

Optional Dependencies

Usage

Option 1: With CDPHooksProvider

Option 2: With CDPReactProvider

Option 3: Standalone Usage

Analytics Opt-Out

Using All Standard Wallets

Direct Wallet Usage

API Reference

`useCdpSolanaStandardWallet(config?)`

`useSolanaStandardWallets()`

`CdpSolanaWallet`

Authentication Flow

Network Support

Error Handling

Security

​@coinbase/cdp-solana-standard-wallet

​Features

​Installation

​Peer Dependencies

​Optional Dependencies

​Usage

​Option 1: With CDPHooksProvider

​Option 2: With CDPReactProvider

​Option 3: Standalone Usage

​Analytics Opt-Out

​Using All Standard Wallets

​Direct Wallet Usage

​API Reference

​useCdpSolanaStandardWallet(config?)

​useSolanaStandardWallets()

​CdpSolanaWallet

​Authentication Flow

​Network Support

​Error Handling

​Security

@coinbase/cdp-solana-standard-wallet

Features

Installation

Peer Dependencies

Optional Dependencies

Usage

Option 1: With CDPHooksProvider

Option 2: With CDPReactProvider

Option 3: Standalone Usage

Analytics Opt-Out

Using All Standard Wallets

Direct Wallet Usage

API Reference

`useCdpSolanaStandardWallet(config?)`

`useSolanaStandardWallets()`

`CdpSolanaWallet`

Authentication Flow

Network Support

Error Handling

Security