createWalletAccount

Creates a new SVM wallet account with the specified threshold signature scheme

Function Signature

createWalletAccount(params: {
  thresholdSignatureScheme: ThresholdSignatureScheme;
  password?: string;
  onError?: (error: Error) => void;
  backUpToDynamic?: boolean;
}): Promise<{
  walletMetadata: WalletMetadata;
  rawPublicKey: string;
  externalServerKeyShares: ServerKeyShare[];
  externalKeySharesWithBackupStatus: Array<{
    share: ServerKeyShare;
    backedUpToClientKeyShareService: boolean;
  }>;
}>

Description

Creates a new SVM wallet account with the specified threshold signature scheme. Returns a walletMetadata object alongside the sensitive externalServerKeyShares. Persist both — walletMetadata in your cache and externalServerKeyShares in a secrets vault. The SDK is stateless and you must pass walletMetadata to every subsequent operation.

Parameters

Required Parameters

• thresholdSignatureScheme (ThresholdSignatureScheme) - The threshold signature scheme for the wallet

Optional Parameters

• password (string) - Password to protect the wallet’s key shares. Required when backUpToDynamic is true.
• onError ((error: Error) => void) - Error callback function for handling creation errors
• backUpToDynamic (boolean) - Whether to back up the first key share to Dynamic (defaults to false). When true, a password must be provided.

Returns

• Promise<object> - Object containing wallet information:
  • walletMetadata (WalletMetadata) - Non-sensitive identity + backup-pointer metadata. The wallet’s address is at walletMetadata.accountAddress. Persist this in your cache.
  • rawPublicKey - Raw public key
  • externalServerKeyShares (ServerKeyShare[]) - Sensitive plaintext shares for MPC operations. Store these in a secrets vault.
  • externalKeySharesWithBackupStatus - Array of key shares with their backup status. Each entry contains:
    • share - The key share (ServerKeyShare)
    • backedUpToClientKeyShareService - Whether this share was backed up to Dynamic’s client share service

Example

import { authenticatedSvmClient } from './client';
import { ThresholdSignatureScheme } from '@dynamic-labs-wallet/node';

const svmClient = await authenticatedSvmClient();

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

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

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

Related

• WalletMetadata - The metadata object passed to every operation
• importPrivateKey() - Import existing private key
• fetchWalletMetadata() - Recover identity metadata when the cache is lost
• Storage Best Practices - Where to cache metadata vs. vault shares