How-to: Remove funds trustlessly

The App Kit SDK supports trustless withdrawals from a Unified Balance as a recovery path that keeps funds under your control. Trustless removal requires two onchain transactions: first, call initiateRemoveFund to start the seven-day waiting period. After the waiting period ends, call removeFund to return the funds to your wallet.

removeFund is designed as a trustless escape hatch for fallback or recovery scenarios only, such as when your normal spend path is unavailable. It is not intended for day-to-day payouts, withdrawals, or crosschain movement. In normal situations, use spend to move funds instantly from a Unified Balance.

Prerequisites

Before you begin, ensure that you’ve:

These are required so any example below runs with a valid kit and adapter.

Initiate and complete a removal

EVM
Solana

Start the waiting period

First, call initiateRemoveFund to record the request to remove funds and start the seven-day waiting period.This example initiates a removal of 1 USDC on Base Sepolia:

TypeScript

const initiateResult = await kit.unifiedBalance.initiateRemoveFund({
  from: {
    adapter,
    chain: "Base_Sepolia",
  },
  amount: "1.00",
});

console.log("Remove fund initiated:", initiateResult);

initiateRemoveFund returns a result object that includes the transaction details for the pending removal. In step 2, pass the same adapter and chain values to removeFund to complete it (you can reuse the same variables as in this example).

Complete the removal after seven days

After the seven-day waiting period ends, call removeFund to return funds to the wallet for that adapter on that blockchain:

TypeScript

const removeResult = await kit.unifiedBalance.removeFund({
  from: {
    adapter,
    chain: "Base_Sepolia",
  },
});

console.log("Remove fund complete:", removeResult);

Keep these constraints in mind for EVM removals:

Calling removeFund before the waiting period has elapsed fails with an error. Wait seven days after calling initiateRemoveFund before calling removeFund.
Funds go to the wallet associated with the adapter on the specified blockchain.
Only one pending removeFund request is allowed per blockchain and address.

Start the waiting period

First, call initiateRemoveFund to record the request to remove funds and start the seven-day waiting period.This example initiates a removal of 1 USDC on Solana Devnet:

TypeScript

const from = { adapter, chain: "Solana_Devnet" as const };

const initiateResult = await kit.unifiedBalance.initiateRemoveFund({
  from,
  amount: "1.00",
});

console.log("Initiate result:", initiateResult);

Complete the removal after seven days

After the seven-day waiting period ends, use the same from context as step 1 to call removeFund and complete the removal:

TypeScript

const removeResult = await kit.unifiedBalance.removeFund({ from });

console.log("Remove result:", removeResult);

Keep these constraints in mind for Solana removals:

Calling removeFund before the waiting period has elapsed fails with an error. Wait seven days after calling initiateRemoveFund before calling removeFund.
Funds return to the wallet for the Solana adapter you use in from.
The sample uses "Solana_Devnet" as const so TypeScript narrows the chain type for from.

Send

Bridge

Swap

Unified Balance

How-to: Remove funds trustlessly

Prerequisites

Initiate and complete a removal

​Prerequisites

​Initiate and complete a removal

Prerequisites

Initiate and complete a removal