Run Recovery

Once recovery is configured, the runtime flow is straightforward.

Start recovery

The guardian starts a recovery with:

TypeScript

const start = await wallet.recovery.start({
  feePayer,
  guardianPubkey: guardianPublicKey,
  newAuthority: newAuthorityPublicKey,
});

start = await wallet.recovery.start(
    fee_payer=fee_payer,
    guardian_pubkey=guardian_public_key,
    new_authority=new_authority_public_key,
)

The current wallet authority cancels a pending recovery with:

TypeScript

const cancel = await wallet.recovery.cancel({
  feePayer,
});

cancel = await wallet.recovery.cancel(fee_payer=fee_payer)

After the configured delay, the guardian executes recovery with:

TypeScript

const execute = await wallet.recovery.execute({
  feePayer,
  newAuthority: newAuthorityPublicKey,
});

execute = await wallet.recovery.execute(
    fee_payer=fee_payer,
    new_authority=new_authority_public_key,
)

The SDK can also read policy metadata through swig.wallets.getPolicy(policyId). That is where it finds fields like:

Most apps should still rely on created.recoverySetup as the setup source of truth and treat policy reads as supporting metadata.