Skip to main content

Function Signature

Description

Refreshes the wallet’s MPC key shares while maintaining the same threshold signature scheme. Returns both the new externalServerKeyShares and an updated backupInfo reflecting the new backup state. You must re-cache the backupInfo into your stored walletMetadata.externalServerKeySharesBackupInfo — otherwise subsequent operations read stale metadata.

Parameters

Required Parameters

  • accountAddress (string) - The wallet address (must include 0x prefix). Must match walletMetadata.accountAddress.
  • chainName (string) - The chain name (e.g., 'EVM')
  • walletMetadata (WalletMetadata) - The cached metadata for this wallet

Optional Parameters

  • password (string) - Required when backUpToDynamic is true. Used to encrypt the refreshed shares for Dynamic-managed backup.
  • externalServerKeyShares (ServerKeyShare[]) - Current plaintext shares. If omitted, the SDK recovers from backup using password.
  • backUpToDynamic (boolean) - Whether to back the new shares up to Dynamic’s key share service. Defaults to false.

Returns

  • Promise<{ externalServerKeyShares, backupInfo }>
    • externalServerKeyShares — The newly-generated shares. Re-vault these; the old shares no longer sign with this wallet.
    • backupInfo (KeyShareBackupInfo) — Updated backup-pointer state. Merge into your cached walletMetadata.

Example

Error Handling

Last modified on May 21, 2026