SVM SDK Complete Example

Complete example demonstrating all available SVM SDK functions with real API usage patterns

Overview

This comprehensive example demonstrates all available functions in the Dynamic SVM SDK, showing the actual API usage patterns and how to handle common operations.

Complete Example Code

// Import statements
import { DynamicSvmWalletClient } from "@dynamic-labs-wallet/node-svm";
import {
  Connection,
  LAMPORTS_PER_SOL,
  PublicKey,
  SystemProgram,
  Transaction,
} from "@solana/web3.js";
import { ThresholdSignatureScheme } from "@dynamic-labs-wallet/node";
import fs from "fs";

// Initialize SVM 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;
};

// Example usage demonstrating all available functions
async function main() {
  try {
    console.log("🚀 Starting SVM Client Demo...\n");

    // Initialize the SVM client
    const svmClient = await authenticatedSvmClient();
    console.log("✅ SVM client authenticated successfully\n");

    // 1. Create a new SVM wallet
    console.log("📝 Creating new SVM wallet...");
    const svmWallet = await svmClient.createWalletAccount({
      thresholdSignatureScheme: ThresholdSignatureScheme.TWO_OF_TWO,
      onError: (error: Error) => {
        console.error("❌ SVM wallet creation error:", error);
      },
      backUpToDynamic: true,
    });

    console.log("✅ SVM wallet created:", svmWallet.accountAddress);
    console.log("externalServerKeyShares:", svmWallet.externalServerKeyShares);
    console.log("rawPublicKey:", svmWallet.rawPublicKey);

    // Save wallet info to file
    fs.writeFileSync("svmWallet.json", JSON.stringify(svmWallet, null, 2));
    console.log("💾 Wallet saved to svmWallet.json\n");

    // 2. Get wallet information
    console.log("🔍 Getting wallet details...");
    try {
      const walletDetails = await svmClient.getWallet({
        accountAddress: svmWallet.accountAddress,
      });
      console.log("✅ Wallet details retrieved:", walletDetails);
    } catch (error) {
      console.log("⚠️ Could not retrieve wallet details:", error);
    }

    // 3. Get all SVM wallets
    console.log("\n📋 Getting all SVM wallets...");
    try {
      const allWallets = await svmClient.getSvmWallets();
      console.log("✅ Found", allWallets.length, "SVM wallets");
    } catch (error) {
      console.log("⚠️ Could not retrieve all wallets:", error);
    }

    // 4. Sign a message
    console.log("\n✍️ Signing a message...");
    try {
      const message = "Hello, Solana! This is a test message from Dynamic SVM wallet.";
      const signedMessage = await svmClient.signMessage({
        accountAddress: svmWallet.accountAddress,
        message,
      });
      console.log("✅ Message signed successfully");
      console.log("Signature:", signedMessage);
    } catch (error) {
      console.log("⚠️ Message signing failed:", error instanceof Error ? error.message : String(error));
    }

    // 5. Sign a transaction (Solana transfer example)
    console.log("\n💸 Preparing Solana transaction...");
    const connection = new Connection("https://api.devnet.solana.com", "confirmed");

    try {
      const amountInSol = 0.001;
      const recipientAddress = "EukgLDgaWNQRLemZSHK8Wc9EGhPhbG3wL9a1mxa3LHg6";

      // Create transaction
      const transaction = new Transaction().add(
        SystemProgram.transfer({
          fromPubkey: new PublicKey(svmWallet.accountAddress),
          toPubkey: new PublicKey(recipientAddress),
          lamports: amountInSol * LAMPORTS_PER_SOL,
        })
      );

      // Get latest blockhash
      const { blockhash } = await connection.getLatestBlockhash();
      transaction.recentBlockhash = blockhash;
      transaction.feePayer = new PublicKey(svmWallet.accountAddress);

      console.log("📝 Transaction prepared, signing with SVM wallet...");

      // Sign the transaction — returns base58 Ed25519 signature (not the full signed tx)
      const signatureBase58 = await svmClient.signTransaction({
        walletMetadata: svmWalletMetadata,
        transaction,
      });

      // To broadcast: decode the signature and add it back to the transaction
      // import { decodeBase58, addSignatureToTransaction } from '@dynamic-labs-wallet/node-svm';
      // const signedTx = addSignatureToTransaction({ transaction, signature: decodeBase58(signatureBase58), signerPublicKey });
      // const txid = await connection.sendRawTransaction(signedTx.serialize());

      console.log("✅ Transaction signed successfully");
      console.log("Signature (base58):", signatureBase58);
    } catch (error) {
      console.log("⚠️ Transaction signing failed:", error instanceof Error ? error.message : String(error));
    }

    // 6. Import private key (if you have one)
    console.log("\n🔑 Testing private key import...");
    try {
      const importedWallet = await svmClient.importPrivateKey({
        privateKey: "your-private-key-here", // Replace with actual private key
        chainName: "SVM",
        thresholdSignatureScheme: ThresholdSignatureScheme.TWO_OF_TWO,
        backUpToDynamic: true,
        password: "test-password",
      });
      console.log("✅ Private key imported:", importedWallet.accountAddress);
    } catch (error) {
      console.log("ℹ️ Private key import skipped (no valid key provided)");
    }

    // 7. Export key information
    console.log("\n📤 Exporting key information...");
    try {
      const exportedKey = await svmClient.exportKey({
        accountAddress: svmWallet.accountAddress,
        chainName: "SVM",
      });
      console.log("✅ Key exported:", exportedKey);
    } catch (error) {
      console.log("ℹ️ Key export not available or requires additional setup");
    }

    // 8. Export private key
    console.log("\n🔓 Exporting private key...");
    try {
      const privateKey = await svmClient.exportPrivateKey({
        accountAddress: svmWallet.accountAddress,
      });
      console.log("✅ Private key exported:", privateKey);
    } catch (error) {
      console.log("ℹ️ Private key export not available or requires additional setup");
    }

    // 9. Test connection to Solana network
    console.log("\n🌐 Testing Solana network connection...");
    try {
      const balance = await connection.getBalance(new PublicKey(svmWallet.accountAddress));
      console.log("✅ Solana connection successful");
      console.log("Wallet balance:", balance / LAMPORTS_PER_SOL, "SOL");
    } catch (error) {
      console.log("ℹ️ Solana network connection test skipped");
    }

    console.log("\n🎉 SVM Client Demo completed successfully!");
    console.log("📁 Check svmWallet.json for wallet details");

    // Summary of what was accomplished
    console.log("\n📊 Demo Summary:");
    console.log("✅ Successfully completed:");
    console.log(`   • Created SVM wallet: ${svmWallet.accountAddress}`);
    console.log(`   • Raw public key: ${svmWallet.rawPublicKey}`);
    console.log(`   • External server key shares: ${svmWallet.externalServerKeyShares?.length || 0}`);
    console.log(`   • Solana network connection: Working`);

    // Try to get additional wallet details if available
    try {
      const walletDetails = await svmClient.getWallet({
        accountAddress: svmWallet.accountAddress,
      });
      console.log(`   • Wallet ID: ${walletDetails.walletId || "N/A"}`);
      console.log(`   • Threshold scheme: ${walletDetails.thresholdSignatureScheme || "N/A"}`);
      console.log(`   • Chain name: ${walletDetails.chainName || "N/A"}`);
    } catch (error) {
      console.log("   • Additional wallet details: Not available");
    }

  } catch (error) {
    console.error("❌ Error in SVM demo:", error);
  }
}

// Run the example
main();

Key API Patterns

1. Wallet Creation

const wallet = await svmClient.createWalletAccount({
  thresholdSignatureScheme: ThresholdSignatureScheme.TWO_OF_TWO,
  onError: (error: Error) => {
    console.error("Wallet creation error:", error);
  },
  backUpToDynamic: true,
});

2. Message Signing

const signature = await svmClient.signMessage({
  message: "Hello, Solana!",
  accountAddress: wallet.accountAddress,
});

3. Transaction Signing

// Returns base58 Ed25519 signature — decode and attach before broadcasting
const signatureBase58 = await svmClient.signTransaction({
  walletMetadata: walletMetadata,
  transaction: transaction,
});

// Full broadcast pattern:
import { decodeBase58, addSignatureToTransaction } from '@dynamic-labs-wallet/node-svm';
const signedTx = addSignatureToTransaction({
  transaction,
  signature: decodeBase58(signatureBase58),
  signerPublicKey: new PublicKey(walletMetadata.accountAddress),
});
const txid = await connection.sendRawTransaction(signedTx.serialize());

4. Wallet Retrieval

const walletDetails = await svmClient.getWallet({
  accountAddress: wallet.accountAddress,
});

5. Getting All Wallets

const allWallets = await svmClient.getSvmWallets();

Available Functions

The SVM SDK provides the following main functions:

• createWalletAccount() - Create new SVM wallet
• importPrivateKey() - Import existing private key
• getWallet() - Get specific wallet details
• getSvmWallets() - Get all SVM wallets
• signMessage() - Sign messages
• signTransaction() - Sign transactions
• exportKey() - Export wallet key data
• exportPrivateKey() - Export private key

Error Handling

Always implement proper error handling:

try {
  const result = await svmClient.someFunction(params);
  console.log("Operation successful:", result);
} catch (error) {
  console.error("Operation failed:", error instanceof Error ? error.message : String(error));
}

Environment Setup

Make sure you have these environment variables:

DYNAMIC_AUTH_TOKEN=your_auth_token_here
DYNAMIC_ENVIRONMENT_ID=your_environment_id_here

Dependencies

Install required packages:

bun add @dynamic-labs-wallet/node-svm @solana/web3.js @dynamic-labs-wallet/node

Next Steps

• Create SVM wallets
• Sign transactions
• Sign messages
• Import private keys