Create SVM Wallet

Learn how to create and manage SVM server wallets with Dynamic’s Node SDK

Overview

This guide walks you through creating Solana (SVM) wallets using Dynamic’s Node SDK. You’ll learn how to set up different threshold signature schemes and understand the security implications for Solana blockchain operations.

Prerequisites

Before you begin, make sure you have:

• Set up your Dynamic project
• Created an authenticated client
• Enabled Solana chains in your dashboard

Step 1: Choose Your Security Model

Dynamic supports two threshold signature schemes for Solana wallets:

TWO_OF_TWO (Recommended for most use cases)

• Security: Highest - requires both your server and Dynamic’s infrastructure
• Availability: Lower - both parties must be online
• Use case: High-value transactions, maximum security

TWO_OF_THREE

• Security: High - requires 2 out of 3 shares
• Availability: Medium - can tolerate one party being offline
• Use case: Balanced security and availability

Step 2: Create Your First Solana Wallet

Here’s a complete example of creating a Solana wallet:

import { DynamicSvmWalletClient } from '@dynamic-labs-wallet/node-svm';
import { ThresholdSignatureScheme } from '@dynamic-labs-wallet/node';

// Create authenticated client
export const authenticatedSvmClient = async () => {
  const client = new DynamicSvmWalletClient({
    environmentId: process.env.DYNAMIC_ENVIRONMENT_ID!,
  });

  await client.authenticateApiToken(process.env.DYNAMIC_AUTH_TOKEN!);
  return client;
};

export const createSvmWallet = async ({
  thresholdSignatureScheme = ThresholdSignatureScheme.TWO_OF_TWO,
  password,
  onError
}: {
  thresholdSignatureScheme?: ThresholdSignatureScheme;
  password?: string;
  onError?: (error: Error) => void;
}) => {
  const svmClient = await authenticatedSvmClient();

  const { walletMetadata, externalServerKeyShares, rawPublicKey } =
    await svmClient.createWalletAccount({
      thresholdSignatureScheme,
      password,
      onError,
      backUpToDynamic: true,
    });

  return { walletMetadata, externalServerKeyShares, rawPublicKey };
};

// Usage example
const { walletMetadata, externalServerKeyShares } = await createSvmWallet({
  thresholdSignatureScheme: ThresholdSignatureScheme.TWO_OF_TWO,
  password: 'your-secure-password',
  onError: (error: Error) => {
    console.error('SVM wallet creation error:', error);
  },
});

console.log('Solana wallet created:', walletMetadata.accountAddress);

Step 3: Handle Errors Gracefully

Always implement proper error handling for Solana wallet creation:

try {
  const { walletMetadata } = await createSvmWallet({
    thresholdSignatureScheme: ThresholdSignatureScheme.TWO_OF_TWO,
    password: 'your-secure-password',
    onError: (error: Error) => {
      console.error('Wallet creation error:', error);
    },
  });
  console.log('Solana wallet created successfully:', walletMetadata.accountAddress);
} catch (error) {
  if (error.message.includes('insufficient funds')) {
    console.error('Insufficient funds for wallet creation');
  } else if (error.message.includes('invalid session')) {
    console.error('Invalid session ID - please re-authenticate');
  } else {
    console.error('Solana wallet creation failed:', error.message);
  }
}

Step 4: Store Wallet Information Securely

After creating a Solana wallet, you’ll receive important information that should be stored securely:

const { walletMetadata, externalServerKeyShares } = await svmClient.createWalletAccount({
  thresholdSignatureScheme: ThresholdSignatureScheme.TWO_OF_TWO,
  password: 'your-secure-password',
  backUpToDynamic: true,
});

// Persist walletMetadata in your cache; externalServerKeyShares in your secrets vault.
await redis.set(`wallet:${walletMetadata.accountAddress}`, JSON.stringify(walletMetadata));
await vault.write(`wallet:${walletMetadata.accountAddress}/shares`, externalServerKeyShares);

// Never store externalServerKeyShares in plain text
// They should be encrypted and stored securely

Step 5: Verify Your Solana Wallet

You can verify your wallet was created correctly by checking the Solana network:

import { Connection, PublicKey } from '@solana/web3.js';

const connection = new Connection('https://api.mainnet-beta.solana.com', 'confirmed');
const publicKey = new PublicKey(walletMetadata.accountAddress);

// Check if the account exists
const accountInfo = await connection.getAccountInfo(publicKey);
if (accountInfo) {
  console.log('Solana wallet verified on network');
} else {
  console.log('Wallet created but not yet on network (normal for new wallets)');
}

Best Practices

1. Password Security: Use strong, unique passwords for each Solana wallet
2. Error Handling: Always handle potential errors during wallet creation with the onError callback
3. Monitoring: Log wallet creation events for audit purposes
4. Backup Strategy: Implement secure backup strategies for key shares with backUpToDynamic: true
5. Network Selection: Choose the appropriate Solana network (mainnet, devnet, testnet)

Solana-Specific Considerations

Network Selection

• Mainnet: For production applications
• Devnet: For development and testing
• Testnet: For testing with test tokens

Account Types

• System Accounts: Standard Solana accounts for SOL storage
• Token Accounts: For SPL token storage (created separately)

Rent Exemption

Solana accounts require rent exemption (minimum balance). Dynamic handles this automatically during wallet creation.

Next Steps

Now that you’ve created a Solana wallet, you can:

• Sign Solana transactions
• Sign Solana messages
• Import existing Solana private keys
• Use imported Solana wallets