storeEncryptedBackupByWallet

Stores encrypted backup for a wallet using external server key shares

Function Signature

storeEncryptedBackupByWallet(params: {
  accountAddress: string;
  walletMetadata: WalletMetadata;
  externalServerKeyShares: ServerKeyShare[];
  password?: string;
  backUpToDynamic: boolean;
}): Promise<{
  keySharesWithBackupStatus: Array<{
    share: ServerKeyShare;
    backedUpToClientKeyShareService: boolean;
  }>;
  backupInfo: KeyShareBackupInfo;
}>

Description

Stores encrypted backup for a wallet’s external server key shares on Dynamic’s key share service. Returns per-share backup status and an updated backupInfo — merge backupInfo into your cached walletMetadata.externalServerKeySharesBackupInfo.

Parameters

Required Parameters

• accountAddress (string) - The wallet address. Must match walletMetadata.accountAddress.
• walletMetadata (WalletMetadata) - The cached metadata for this wallet
• externalServerKeyShares (ServerKeyShare[]) - Plaintext shares to back up
• backUpToDynamic (boolean) - Whether to back the shares up to Dynamic

Optional Parameters

• password (string) - Required when backUpToDynamic is true

Returns

• Promise<object> - { keySharesWithBackupStatus, backupInfo }. Merge backupInfo into cached walletMetadata.

Example

import { authenticatedSvmClient } from './client';

const svmClient = await authenticatedSvmClient();
const walletMetadata = JSON.parse(await redis.get(`wallet:${accountAddress}`));
const externalServerKeyShares = await vault.read(`wallet:${accountAddress}/shares`);

const { backupInfo } = await svmClient.storeEncryptedBackupByWallet({
  accountAddress,
  walletMetadata,
  externalServerKeyShares,
  password: 'user-password',
  backUpToDynamic: true,
});

const updated = { ...walletMetadata, externalServerKeySharesBackupInfo: backupInfo };
await redis.set(`wallet:${accountAddress}`, JSON.stringify(updated));

Related

• storeEncryptedBackupByWalletWithRetry() - Store backup with automatic retry
• recoverEncryptedBackupByWallet() - Recover encrypted backup