Instant Withdrawal

Instant withdrawals let a depositor burn LP tokens and receive one reserve token immediately when the vault has enough executable reserve liquidity. Use the read helpers first, then build the reserve-withdrawal instruction. If capacity is unavailable for the requested output mint, use the queued withdrawal flow instead.

Check vault capacity

fetchInstantWithdrawalCapacity returns the vault-level amount that can currently be withdrawn from reserves for one output mint.

import { ExponentVault } from "@exponent-labs/exponent-sdk";
import { Connection, PublicKey } from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const vault = await ExponentVault.load({ connection, address: vaultAddress });

const USDC_MINT = new PublicKey("...");

const capacity = await vault.fetchInstantWithdrawalCapacity({
  outputMint: USDC_MINT,
});

console.log("mint:", capacity.mint.toBase58());
console.log("amount:", capacity.amount);
console.log("decimals:", capacity.decimals);

Return value

Field	Type	Description
`mint`	`PublicKey`	Vault underlying or selected output mint
`amount`	`bigint`	Gross instant-withdrawal capacity in raw mint units
`decimals`	`number`	Decimal places for the returned mint

Check user capacity

fetchUserInstantWithdrawalCapacity applies the user’s spendable LP balance to the vault-level capacity.

const userCapacity = await vault.fetchUserInstantWithdrawalCapacity({
  owner: wallet.publicKey,
  outputMint: USDC_MINT,
});

Parameters

Parameter	Type	Description
`owner`	`PublicKey`	Depositor wallet public key
`outputMint`	`PublicKey`	Optional. Reserve mint to receive
`tokenLpAccount`	`PublicKey`	Optional. LP token account to read instead of the owner’s ATA
`tokenProgram`	`PublicKey`	Optional. Token program for the LP account

Quote an instant withdrawal

fetchInstantWithdrawalQuote quotes an executable instant withdrawal for a selected LP amount and output mint.

const quote = await vault.fetchInstantWithdrawalQuote({
  lpAmountIn: 500_000_000n,
  outputMint: USDC_MINT,
});

console.log("LP burned:", quote.lp.amountIn);
console.log("fee:", quote.fee.amount);
console.log("net base value:", quote.net.amount);
console.log("output:", quote.output.amount);
console.log("slot:", quote.quotedAtSlot);

Parameters

Parameter	Type	Description
`lpAmountIn`	`bigint`	LP token amount to burn
`outputMint`	`PublicKey`	Reserve mint to receive

Return value

Field	Type	Description
`lp`	`InstantWithdrawalQuoteLpBreakdown`	LP input, fee amount, user amount, mint, and decimals
`gross`	`InstantWithdrawalQuoteAmount`	Gross base value consumed by reserve and window limits
`fee`	`InstantWithdrawalQuoteAmount`	Base value retained in the vault by the LP fee split
`net`	`InstantWithdrawalQuoteAmount`	Base value converted into the selected output token
`output`	`InstantWithdrawalQuoteAmount`	Expected amount for the selected output mint
`quotedAtSlot`	`number`	Slot used for the quote

Execute from reserves

Use ixExecuteWithdrawalFromReservesWithResolvedAumAccounts after quoting. The resolved helper includes derived AUM accounts from current strategy state, including positions that require RPC-derived accounts.

import {
  ExponentVault,
  SQUADS_PROGRAM_ID,
} from "@exponent-labs/exponent-sdk";
import { getAssociatedTokenAddressSync } from "@solana/spl-token";
import { Connection, PublicKey, Transaction, sendAndConfirmTransaction } from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const vault = await ExponentVault.load({ connection, address: vaultAddress });

const outputMint = new PublicKey("...");
const entryIdx = vault.state.tokenEntries.findIndex((entry) =>
  entry.mint.equals(outputMint),
);

if (entryIdx === -1) {
  throw new Error("Output mint is not a vault token entry");
}

const entry = vault.state.tokenEntries[entryIdx];

const quote = await vault.fetchInstantWithdrawalQuote({
  lpAmountIn: 500_000_000n,
  outputMint,
});

const ix = await vault.ixExecuteWithdrawalFromReservesWithResolvedAumAccounts({
  owner: wallet.publicKey,
  entryIdx,
  lpAmount: quote.lp.amountIn,
  tokenSrc: entry.tokenSquadsAccount,
  tokenVaultSrc: entry.tokenAccountVault,
  tokenDst: getAssociatedTokenAddressSync(outputMint, wallet.publicKey),
  squadsProgram: SQUADS_PROGRAM_ID,
});

const tx = new Transaction().add(ix);
await sendAndConfirmTransaction(connection, tx, [wallet]);

Required parameters

Parameter	Type	Description
`owner`	`PublicKey`	Depositor wallet public key
`entryIdx`	`number`	Index of the vault token entry to withdraw
`lpAmount`	`bigint \| number`	LP token amount to burn
`tokenSrc`	`PublicKey`	Squads-owned reserve token account for the selected entry
`tokenVaultSrc`	`PublicKey`	Vault-owned reserve token account for the selected entry
`tokenDst`	`PublicKey`	Depositor token account for the output mint
`squadsProgram`	`PublicKey`	Squads program ID

Optional parameters

Parameter	Type	Description
`tokenLpSrc`	`PublicKey`	Depositor LP token source account. Defaults to the depositor’s ATA
`tokenProgram`	`PublicKey`	Token program for reserve transfers
`token2022Program`	`PublicKey`	Token-2022 program when needed
`tokenLpEscrow`	`PublicKey`	LP token escrow. Defaults to the vault’s LP escrow
`mintLp`	`PublicKey`	LP mint. Defaults to the vault’s LP mint
`extraRemainingAccounts`	`AccountMeta[]`	Additional AUM accounts when you are not using the resolved helper

Quotes depend on reserve balances, AUM, LP supply, and the instant withdrawal window. Fetch a quote and submit the transaction promptly.

Queued withdrawal fallback

Instant withdrawal only uses executable reserve liquidity. If the quote is unavailable or the output amount is too low, use ixQueueWithdrawal and ixExecuteWithdrawal instead.

Strategy Vault Basics

Vault Creation & Operations

Vault Strategy & Policies

Other Resources

Check vault capacity

Return value

Check user capacity

Parameters

Quote an instant withdrawal

Parameters

Return value

Execute from reserves

Required parameters

Optional parameters

Queued withdrawal fallback

​Check vault capacity

​Return value

​Check user capacity

​Parameters

​Quote an instant withdrawal

​Parameters

​Return value

​Execute from reserves

​Required parameters

​Optional parameters

​Queued withdrawal fallback

Check vault capacity

Return value

Check user capacity

Parameters

Quote an instant withdrawal

Parameters

Return value

Execute from reserves

Required parameters

Optional parameters

Queued withdrawal fallback