> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exponent.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Instant Withdrawal

> Quote and execute instant withdrawals from vault reserves

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.

```typescript theme={null}
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.

```typescript theme={null}
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.

```typescript theme={null}
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.

```typescript theme={null}
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 |

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

## Queued withdrawal fallback

Instant withdrawal only uses executable reserve liquidity. If the quote is unavailable or the output amount is too low, use [`ixQueueWithdrawal`](/developer-strategy-vaults/typescript/vault-operations/queue-withdrawal) and [`ixExecuteWithdrawal`](/developer-strategy-vaults/typescript/vault-operations/execute-withdrawal) instead.