Add a Guardian After Wallet Creation

You can add guardian recovery after a wallet already exists, as long as the wallet’s current authority can still sign. Use this flow when the wallet was created first and recovery needs to be turned on afterward.

What happens in this flow

The setup still happens in two steps:

add the hidden recovery-authority role
configure the guardian public key and recovery delay

The hosted endpoints behind this flow are:

POST /transaction/wallet/recovery-authority/add
POST /transaction/recovery/configure

Prepare the setup

TypeScript

const wallet = swig.wallets.use(existingWallet);

const setup = await wallet.recovery.prepareSetup({
  feePayer,
  requesterAuthority,
  guardianPubkey,
  delaySeconds: 86_400,
});

wallet = swig.wallets.use(existing_wallet)

setup = await wallet.recovery.prepare_setup(
    fee_payer=fee_payer,
    requester_authority=requester_authority,
    guardian_pubkey=guardian_public_key,
    delay_seconds=86_400,
)

This returns:

setup.addAuthorityTransaction / setup.add_authority_transaction
setup.configureRecoveryTransaction / setup.configure_recovery_transaction

Signing model

Transaction	Who signs
`setup.addAuthorityTransaction` / `setup.add_authority_transaction`	the wallet’s current authority
`setup.configureRecoveryTransaction` / `setup.configure_recovery_transaction`	the backend recovery operator already signs it

After the current authority signs the add-authority transaction, the remaining work is fee-payer or sponsor submission for the configure transaction.

When to use this page instead of initial recovery setup

use Set Up Recovery when recovery is part of the initial wallet create flow
use this page when the wallet already exists and you are enabling recovery later

Start Here

Set Up Access

Build Wallet Flows

Add Recovery

Operate in Production

Workspace Admin

Add a Guardian After Wallet Creation

What happens in this flow

Prepare the setup

Signing model

When to use this page instead of initial recovery setup

​What happens in this flow

​Prepare the setup

​Signing model

​When to use this page instead of initial recovery setup

What happens in this flow

Prepare the setup

Signing model

When to use this page instead of initial recovery setup