Skip to main content

​
Function Signature

importPrivateKey(params: {
  privateKey: string;
  chainName: string;
  thresholdSignatureScheme: ThresholdSignatureScheme;
  password: string;
  backUpToClientShareService?: boolean;
}): Promise<{
  accountAddress: string;
  rawPublicKey: string;
  /** @deprecated Use externalKeySharesWithBackupStatus instead */
  externalServerKeyShares: ServerKeyShare[];
  externalKeySharesWithBackupStatus: Array<{
    share: ServerKeyShare;
    backedUpToClientKeyShareService: boolean;
  }>;
}>

​
Description

Imports an existing Solana private key into the MPC wallet system. The private key is split into shares according to the specified threshold signature scheme.

​
Parameters

​
Required Parameters

  • privateKey (string) - The Solana private key to import
  • chainName (string) - The chain name (use ‘SVM’ for Solana chains)
  • thresholdSignatureScheme (ThresholdSignatureScheme) - The threshold signature scheme for the wallet
  • password (string) - Wallet password for security

​
Optional Parameters

  • backUpToClientShareService (boolean) - Whether to back up the first key share to Dynamic’s client share service (defaults to false)

​
Returns

  • Promise<object> - Object containing wallet information:
    • accountAddress - The wallet’s account address
    • rawPublicKey - Raw public key
    • externalKeySharesWithBackupStatus - Array of key shares with their backup status (see createWalletAccount for details)
    • externalServerKeyShares - (deprecated) Use externalKeySharesWithBackupStatus instead

​
Example

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

const svmClient = await authenticatedSvmClient();

const wallet = await svmClient.importPrivateKey({
  privateKey: 'YourSolanaPrivateKey',
  chainName: 'SVM',
  thresholdSignatureScheme: ThresholdSignatureScheme.TWO_OF_TWO,
  password: 'your-password',
  backUpToClientShareService: true,
});

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

​
Error Handling

try {
  const wallet = await svmClient.importPrivateKey({
    privateKey: 'YourSolanaPrivateKey',
    chainName: 'SVM',
    thresholdSignatureScheme: ThresholdSignatureScheme.TWO_OF_TWO,
    password: 'your-password',
    backUpToClientShareService: true,
  });
  console.log('Private key imported successfully');
} catch (error) {
  console.error('Failed to import private key:', error);
}