Exponent

https://docs.exponent.finance/
Admin
Exponent is a yield exchange protocol on Solana that enables users to exchange productive yield...
Tokens:217,075
Snippets:1,998
Trust Score:7.9
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install Exponent SDK

Source: https://docs.exponent.finance/developer-core/typescript/instructions/overview

Install the required SDK and Solana web3 dependencies.

```bash
npm install @exponent-labs/exponent-sdk @solana/web3.js
```

--------------------------------

### Install Mintlify skill

Source: https://docs.exponent.finance/AGENTS.md

Use this command to install the Mintlify skill for product knowledge.

```bash
npx skills add https://mintlify.com/docs
```

--------------------------------

### Initialize SDK and Load Market

Source: https://docs.exponent.finance/developer-tranching/sdk-quickstart

Setup the connection and load the on-chain market state.

```typescript
import {
  LOCAL_ENV,
  TranchingMarket,
} from "@exponent-labs/exponent-sdk";
import { TrancheSide } from "@exponent-labs/exponent-sdk/client/tranching";
import {
  Connection,
  Keypair,
  PublicKey,
  Transaction,
  sendAndConfirmTransaction,
} from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const wallet = Keypair.fromSecretKey(/* your keypair */);
const marketAddress = new PublicKey("...");

// Loads onchain market state, return model storage, SY linkage, and tranche LP mints.
const market = await TranchingMarket.load(connection, marketAddress, LOCAL_ENV);
```

--------------------------------

### Install Exponent SDK

Source: https://docs.exponent.finance/developer-clmm/sdk-quickstart

Choose the package manager command appropriate for your project environment.

```bash
yarn add @exponent-labs/exponent-sdk
```

```bash
npm install @exponent-labs/exponent-sdk
```

```bash
pnpm add @exponent-labs/exponent-sdk
```

--------------------------------

### Install Exponent SDK dependencies

Source: https://docs.exponent.finance/developer-clmm/raw-instructions/overview

Install the required SDK and Solana packages to use the raw instruction builders.

```bash
npm install @exponent-labs/exponent-sdk @solana/web3.js @solana/codecs
```

--------------------------------

### Initialize SDK Connection

Source: https://docs.exponent.finance/developer-core/core-sdk

Setup the connection to the Solana network and load the vault instance.

```typescript
import { Vault, YtPosition, LOCAL_ENV } from "@exponent-labs/exponent-sdk";
import {
  Connection,
  PublicKey,
  Transaction,
  sendAndConfirmTransaction,
  Keypair,
} from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const wallet = Keypair.fromSecretKey(/* your keypair */);
const vaultAddress = new PublicKey("...");

const vault = await Vault.load(LOCAL_ENV, connection, vaultAddress);
```

--------------------------------

### Provide Liquidity Classic Usage

Source: https://docs.exponent.finance/developer-clmm/typescript/instructions/ix-provide-liquidity-classic

Example demonstrating how to initialize the MarketThree class and execute a liquidity provision transaction.

```typescript
import { MarketThree, LOCAL_ENV } from "@exponent-labs/exponent-sdk";
import { Connection, PublicKey, Transaction, sendAndConfirmTransaction, Keypair } from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const market = await MarketThree.load(LOCAL_ENV, connection, marketAddress);

const { ixs, setupIxs, signers } = await market.ixProvideLiquidityClassic({
  depositor: wallet.publicKey,
  amountBase: 5_000_000_000n,
  amountPt: 5_000_000_000n,
  minLpOut: 9_000_000_000n,
  lowerTickApy: 0.05,  // 5% APY
  upperTickApy: 0.15,  // 15% APY
});

const tx = new Transaction().add(...setupIxs, ...ixs);
const signature = await sendAndConfirmTransaction(connection, tx, [wallet, ...signers]);
```

--------------------------------

### Provide Liquidity Usage Example

Source: https://docs.exponent.finance/developer-clmm/typescript/instructions/ix-wrapper-provide-liquidity

Demonstrates how to invoke ixWrapperProvideLiquidity to add liquidity to a market and execute the resulting transaction.

```typescript
import { MarketThree, LOCAL_ENV } from "@exponent-labs/exponent-sdk";
import { Connection, PublicKey, Transaction, sendAndConfirmTransaction, Keypair } from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const market = await MarketThree.load(LOCAL_ENV, connection, marketAddress);

const { ixs, setupIxs, signers } = await market.ixWrapperProvideLiquidity({
  depositor: wallet.publicKey,
  amountBase: 10_000_000_000n,
  minLpOut: 9_000_000_000n,
  lowerTickApy: 0.05,  // 5% APY
  upperTickApy: 0.15,  // 15% APY
});

const tx = new Transaction().add(...setupIxs, ...ixs);
const signature = await sendAndConfirmTransaction(connection, tx, [wallet, ...signers]);
```

--------------------------------

### Create Wrapper Manage Vault Settings Instruction

Source: https://docs.exponent.finance/developer-strategy-vaults/raw-instructions/raw-wrapper-manage-vault-settings

Use this instruction during initial vault setup to configure parameters. The vault must have zero AUM to proceed.

```typescript
import { createWrapperManageVaultSettingsInstruction } from "@exponent-labs/exponent-sdk/client/vaults";
import { PublicKey, SystemProgram } from "@solana/web3.js";

const ix = createWrapperManageVaultSettingsInstruction(
  {
    manager: managerKeypair.publicKey,
    vault: vaultAddress,
    exponentPrices: exponentPricesAddress,
    systemProgram: SystemProgram.programId,
  },
  {
    actions: [
      { addTokenEntry: { mint: usdcMint, oracle: usdcOracleAddress } },
      { setWithdrawalPeriod: { seconds: 86400 } },
    ],
  }
);
```

--------------------------------

### Buy YT using MarketThree

Source: https://docs.exponent.finance/developer-clmm/typescript/instructions/ix-wrapper-buy-yt

Demonstrates the implementation of ixWrapperBuyYt to purchase YT tokens, including setup and transaction execution.

```typescript
import { MarketThree, LOCAL_ENV } from "@exponent-labs/exponent-sdk";
import { Connection, PublicKey, Transaction, sendAndConfirmTransaction } from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const market = await MarketThree.load(LOCAL_ENV, connection, marketAddress);

const { ixs, setupIxs } = await market.ixWrapperBuyYt({
  owner: wallet.publicKey,
  ytOut: 1_000_000_000n,
  maxBaseIn: 1_200_000_000n,
});

const tx = new Transaction().add(...setupIxs, ...ixs);
const signature = await sendAndConfirmTransaction(connection, tx, [wallet]);
```

--------------------------------

### Deposit Liquidity with TypeScript

Source: https://docs.exponent.finance/developer-clmm/typescript/instructions/add-liquidity

Example of initializing a market and executing a liquidity deposit transaction. Ensure the generated LP position keypair is included in the transaction signers.

```typescript
import { MarketThree, LOCAL_ENV } from "@exponent-labs/exponent-sdk";
import { Connection, PublicKey, Transaction, sendAndConfirmTransaction } from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const market = await MarketThree.load(LOCAL_ENV, connection, marketAddress);

const { ix, signers } = market.ixDepositLiquidity({
  depositor: wallet.publicKey,
  ptInIntent: 5_000_000_000n,   // max PT to deposit
  syInIntent: 5_000_000_000n,   // max SY to deposit
  lowerTickKey: 0.05,           // 5% APY lower bound
  upperTickKey: 0.15,           // 15% APY upper bound
});

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

--------------------------------

### createInitializeTranchingMarketInstruction

Source: https://docs.exponent.finance/developer-tranching/raw-instructions/raw-initialize-tranching-market

Builds a raw instruction that initializes the market account, return model storage account, SY escrow, and Senior/Junior LP mints.

```APIDOC
## createInitializeTranchingMarketInstruction

### Description
Builds a raw instruction that initializes the market account, return model storage account, SY escrow, and Senior/Junior LP mints.

### Signature
`createInitializeTranchingMarketInstruction(accounts, args)`

### Accounts
- **payer** (PublicKey) - Rent and transaction payer
- **adminSigner** (PublicKey) - Admin signer authorized by Exponent admin state
- **market** (PublicKey) - Market PDA
- **returnModelStorage** (PublicKey) - Return model storage PDA
- **addressLookupTable** (PublicKey) - ALT used by market CPI account indexes
- **syProgram** (PublicKey) - Linked SY program
- **syMint** (PublicKey) - SY mint
- **tokenSyEscrow** (PublicKey) - Market SY escrow PDA
- **mintLpSenior** (PublicKey) - Senior LP mint PDA
- **mintLpJunior** (PublicKey) - Junior LP mint PDA
- **tokenProgram** (PublicKey) - SPL Token program
- **systemProgram** (PublicKey) - System program
- **admin** (PublicKey) - Exponent admin state

### Arguments
- **roles** (TranchingMarketRoles) - Admin and sentinel role lists
- **riskConfig** (TranchingRiskConfig) - Coverage, recovery, liquidation, and minimum amount parameters
- **protocolFeeConfig** (TranchingProtocolFeeConfig) - Fee recipient and fee rates
- **returnModel** (TrancheReturnModelUpdate) - Initial return allocation model
- **syCpiAccounts** (CpiAccounts) - ALT indexes for SY CPI account groups
- **maxSeniorLpSupply** (u64) - Optional Senior LP supply cap. 0 means uncapped except coverage
- **maxJuniorLpSupply** (u64) - Optional Junior LP supply cap. 0 means uncapped
- **seedId** ([u8; 8]) - Market seed ID

### Returns
- **TransactionInstruction** - A transaction instruction ready to be added to a transaction.
```

--------------------------------

### createBuyYtInstruction

Source: https://docs.exponent.finance/developer-clmm/raw-instructions/raw-buy-yt

Builds a raw instruction to buy YT tokens using SY. This instruction strips SY into PT and YT, then sells the excess PT back to the pool for SY, effectively converting the input SY into YT at the current market rate.

```APIDOC
## createBuyYtInstruction

### Description
Builds a raw instruction to buy YT tokens using SY. This instruction strips SY into PT and YT, then sells the excess PT back to the pool for SY, effectively converting the input SY into YT at the current market rate.

### Parameters
#### Accounts
- **trader** (PublicKey) - Wallet executing the trade
- **market** (PublicKey) - The CLMM market account
- **ticks** (PublicKey) - The market tick array account
- **tokenSyTrader** (PublicKey) - Trader's SY token account
- **tokenYtTrader** (PublicKey) - Trader's YT token account
- **tokenPtTrader** (PublicKey) - Trader's PT token account
- **tokenSyEscrow** (PublicKey) - Market SY escrow account
- **tokenPtEscrow** (PublicKey) - Market PT escrow account
- **tokenYtEscrow** (PublicKey) - Market YT escrow account
- **tokenFeeTreasurySy** (PublicKey) - SY fee treasury account
- **tokenFeeTreasuryPt** (PublicKey) - PT fee treasury account
- **tokenProgram** (PublicKey) - SPL Token program
- **addressLookupTable** (PublicKey) - Market address lookup table
- **syProgram** (PublicKey) - SY program
- **exponentCoreProgram** (PublicKey) - Exponent core program
- **eventAuthority** (PublicKey) - Event authority PDA
- **program** (PublicKey) - CLMM program ID

#### Arguments
- **syIn** (u64) - Amount of SY tokens to spend
- **minYtOut** (u64) - Minimum amount of YT tokens to receive
- **priceSpotLimit** (f64) - Optional: Price limit for anti-sandwich protection

### Returns
- **TransactionInstruction** - A transaction instruction ready to be added to a transaction.
```

--------------------------------

### Initialize Market

Source: https://docs.exponent.finance/developer-clmm/sdk-quickstart

Set up the connection and load the market instance using the SDK.

```typescript
import { MarketThree, LOCAL_ENV } from "@exponent-labs/exponent-sdk";
import {
  Connection,
  PublicKey,
  Transaction,
  sendAndConfirmTransaction,
  Keypair,
} from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const wallet = Keypair.fromSecretKey(/* your keypair */);
const marketAddress = new PublicKey("...");

const market = await MarketThree.load(LOCAL_ENV, connection, marketAddress);
```

--------------------------------

### createWrapperProvideLiquidityInstruction

Source: https://docs.exponent.finance/developer-clmm/raw-instructions/raw-wrapper-provide-liquidity

Creates a transaction instruction to provide liquidity to a CLMM market starting from base assets.

```APIDOC
## createWrapperProvideLiquidityInstruction

### Description
Provides liquidity to a CLMM market starting from base assets in a single atomic operation. This instruction mints SY from the base asset, strips the SY into PT and YT via the Exponent core program, deposits the PT as liquidity into the specified tick range, and returns the YT tokens to the depositor.

### Arguments
- **lowerTick** (u32) - The lower tick boundary key for the liquidity position
- **upperTick** (u32) - The upper tick boundary key for the liquidity position
- **amountBase** (u64) - The amount of base asset to provide
- **minLpOut** (u64) - The minimum amount of LP tokens to receive
- **mintSyRemAccountsUntil** (u8) - The number of CPI remaining accounts used for SY minting
- **depositYtAccountsUntil** (u8) - The number of CPI remaining accounts used for YT deposit

### Accounts
- **depositor** (PublicKey) - Wallet providing liquidity
- **market** (PublicKey) - The CLMM market account
- **ticks** (PublicKey) - The market tick array account
- **tokenPtEscrow** (PublicKey) - Market PT escrow account
- **tokenYtEscrow** (PublicKey) - Market YT escrow account
- **tokenSyEscrow** (PublicKey) - Market SY escrow account
- **tokenSyDepositor** (PublicKey) - Depositor's SY token account
- **tokenYtDepositor** (PublicKey) - Depositor's YT token account
- **tokenPtDepositor** (PublicKey) - Depositor's PT token account
- **mintYt** (PublicKey) - YT mint address
- **mintPt** (PublicKey) - PT mint address
- **tokenProgram** (PublicKey) - SPL Token program
- **marketAddressLookupTable** (PublicKey) - Market address lookup table
- **syProgram** (PublicKey) - SY program
- **exponentCoreProgram** (PublicKey) - Exponent core program
- **lpPosition** (PublicKey) - LP position account
- **systemProgram** (PublicKey) - System program
- **rent** (PublicKey) - Rent sysvar
- **eventAuthority** (PublicKey) - Event authority PDA
- **program** (PublicKey) - CLMM program ID

### Returns
- **TransactionInstruction** - A transaction instruction ready to be added to a transaction.
```

--------------------------------

### orderbook.ixWrapperPostOffer

Source: https://docs.exponent.finance/developer-orderbook/typescript/instructions/ix-wrapper-post-offer

Posts a limit order to the Exponent orderbook. Returns the transaction instruction and necessary setup instructions.

```APIDOC
## orderbook.ixWrapperPostOffer

### Description
Posts a limit order to the Exponent orderbook. This method returns the primary transaction instruction and an array of setup instructions required for the transaction.

### Parameters
#### Required Parameters
- **trader** (PublicKey) - The trader's wallet public key
- **price** (number) - The limit price for the offer in APY terms
- **amount** (bigint) - The amount to offer in lamports
- **offerType** (OfferType) - The type of offer (OfferType.BuyYt / OfferType.SellYt)
- **offerOption** (OfferOptions) - Offer execution option via offerOptions("FillOrKill", [boolean])
- **virtualOffer** (boolean) - Whether this is a virtual offer
- **expirySeconds** (number) - Time until the offer expires (in seconds)
- **mintSy** (PublicKey) - The SY token mint address

#### Optional Parameters
- **ptSrc** (PublicKey) - PT token source account
- **ytSrc** (PublicKey) - YT token source account
- **sySrc** (PublicKey) - SY token source account
- **tokenBaseTrader** (PublicKey) - Base token account for the trader

### Returns
- **ix** (TransactionInstruction) - The instruction that posts the limit order
- **setupIxs** (Array<TransactionInstruction>) - Array of setup instructions (PT/YT/SY associated token account creation)
```

--------------------------------

### orderbook.ixWrapperMarketOffer

Source: https://docs.exponent.finance/developer-orderbook/typescript/instructions/ix-wrapper-market-offer

Executes a market order on the Exponent orderbook by returning a transaction instruction and required setup instructions.

```APIDOC
## orderbook.ixWrapperMarketOffer

### Description
Executes a market order on the Exponent orderbook. This method returns the primary transaction instruction and any necessary setup instructions for token accounts.

### Parameters
#### Required Parameters
- **trader** (PublicKey) - The trader's wallet public key
- **maxPriceApy** (number) - Maximum price in APY terms
- **amount** (bigint) - The amount to trade
- **offerType** (OfferType) - The type of offer (OfferType.BuyYt / OfferType.SellYt)
- **minAmountOut** (bigint) - Minimum amount to receive (slippage protection)
- **virtualOffer** (boolean) - Whether this is a virtual offer
- **mintSy** (PublicKey) - The SY token mint address

#### Optional Parameters
- **ptSrc** (PublicKey) - PT token source account
- **ytSrc** (PublicKey) - YT token source account
- **sySrc** (PublicKey) - SY token source account
- **tokenBaseTrader** (PublicKey) - Base token account for the trader

### Returns
- **ix** (TransactionInstruction) - The instruction that executes the market order
- **setupIxs** (Array<TransactionInstruction>) - An array of setup instructions to run before the main instruction, including account creation if necessary
```

--------------------------------

### createInitializeVaultInstruction

Source: https://docs.exponent.finance/developer-strategy-vaults/raw-instructions/raw-initialize-vault

Builds a raw instruction to create a new Strategy Vault with roles, token entries, an LP mint, and Squads smart account integration.

```APIDOC
## createInitializeVaultInstruction

### Description
Builds a raw instruction to create a new Strategy Vault with roles, token entries, an LP mint, and Squads smart account integration. This sets up the full vault infrastructure including the Squads multisig for strategy execution.

### Signature
`createInitializeVaultInstruction(accounts, args)`

### Parameters
- **accounts** (Object) - Required. Contains the required Solana accounts including payer, vault, mints, and various Squads program PDAs.
- **args** (Object) - Required. Contains configuration parameters including manager, fee treasury BPS, token entries, max LP supply, seed ID, initial LP amount, LP decimals, vault type, roles, and proposal vote configuration.

### Usage Example
```typescript
import { createInitializeVaultInstruction } from "@exponent-labs/exponent-sdk/client/vaults";

const ix = createInitializeVaultInstruction(
  {
    payer: wallet.publicKey,
    vault: vaultPda,
    exponentPrices: exponentPricesPda,
    mint: underlyingMintAddress,
    mintLp: lpMintPda,
    tokenLpEscrow: lpEscrowPda,
    feeTreasury: feeTreasuryPda,
    lpDst: payerLpTokenAccount,
    tokenProgram: TOKEN_PROGRAM_ID,
    systemProgram: SYSTEM_PROGRAM_ID,
    associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
    addressLookupTable: lookupTableAddress,
    squadsProgram: SQUADS_PROGRAM_ID,
    squadsProgramConfig: squadsProgramConfigPda,
    squadsTreasury: squadsTreasuryPda,
    squadsSettings: squadsSettingsPda,
    squadsVault: squadsVaultPda,
    squadsPolicy: squadsPolicyPda,
    squadsSettingsTransaction: squadsSettingsTransactionPda,
    squadsProposal: squadsProposalPda,
  },
  {
    manager: managerPublicKey,
    feeTreasuryLpBps: 500,
    tokenEntries: [
      { mint: usdcMint, oracle: usdcOracle, decimals: 6 },
    ],
    maxLpSupply: BigInt(1_000_000_000_000),
    seedId: new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]),
    initialLpAmount: BigInt(1_000_000),
    lpDecimals: 6,
    vaultType: { openEnded: {} },
    roles: {
      manager: managerPublicKey,
      sentinel: sentinelPublicKey,
    },
    proposalVoteConfig: null,
  }
);
```
```

--------------------------------

### createWrapperBuyYtInstruction

Source: https://docs.exponent.finance/developer-clmm/raw-instructions/raw-wrapper-buy-yt

Builds a raw instruction to buy YT tokens from base assets in a single atomic operation.

```APIDOC
## createWrapperBuyYtInstruction

### Description
Builds a raw instruction to buy YT tokens from base assets in a single atomic operation. This instruction handles SY minting from the base asset, stripping SY into PT and YT, and selling excess PT back to the pool.

### Parameters
#### Accounts
- **buyer** (PublicKey) - Required - Wallet executing the trade
- **market** (PublicKey) - Required - The CLMM market account
- **ticks** (PublicKey) - Required - The market tick array account
- **tokenSyTrader** (PublicKey) - Required - Trader's SY token account
- **tokenYtTrader** (PublicKey) - Required - Trader's YT token account
- **tokenPtTrader** (PublicKey) - Required - Trader's PT token account
- **tokenSyEscrow** (PublicKey) - Required - Market SY escrow account
- **tokenPtEscrow** (PublicKey) - Required - Market PT escrow account
- **tokenYtEscrow** (PublicKey) - Required - Market YT escrow account
- **marketAddressLookupTable** (PublicKey) - Required - Market address lookup table
- **tokenProgram** (PublicKey) - Required - SPL Token program
- **syProgram** (PublicKey) - Required - SY program
- **systemProgram** (PublicKey) - Required - System program
- **tokenFeeTreasurySy** (PublicKey) - Required - SY fee treasury account
- **tokenFeeTreasuryPt** (PublicKey) - Required - PT fee treasury account
- **exponentCoreProgram** (PublicKey) - Required - Exponent core program
- **eventAuthority** (PublicKey) - Required - Event authority PDA
- **program** (PublicKey) - Required - CLMM program ID

#### Arguments
- **ytOut** (u64) - Required - Amount of YT tokens to receive
- **maxBaseAmount** (u64) - Required - Maximum amount of base asset to spend
- **mintSyAccountsLength** (u8) - Required - Number of CPI accounts used for SY minting
- **depositYtAccountsUntil** (u8) - Required - Number of CPI accounts used for YT deposit

### Returns
- **TransactionInstruction** - A transaction instruction ready to be added to a transaction.
```

--------------------------------

### Check SY Exchange Rate Assertion

Source: https://docs.exponent.finance/developer-strategy-vaults/vault-assertion

Example of asserting the SY/base exchange rate for a core vault.

```typescript
const report = await assertion.check({
  conditions: [{
    kind: VaultAssertionConditionKind.SyExchangeRate,
    coreVault: new PublicKey("..."),
    exchangeRate: { warnBelow: "1.03", blockBelow: "1.01" },
  }],
});
```

--------------------------------

### Collect Interest Instruction Usage

Source: https://docs.exponent.finance/developer-orderbook/typescript/instructions/ix-wrapper-collect-interest

Example of invoking the collect interest instruction using the orderbook client.

```typescript
import { PublicKey } from "@solana/web3.js";

const ix = await orderbook.ixWrapperCollectInterest({
  trader: wallet.publicKey,
  mintSy: syMintAddress,
});
```

--------------------------------

### createSellYtInstruction

Source: https://docs.exponent.finance/developer-clmm/raw-instructions/raw-sell-yt

Builds a raw instruction to sell YT tokens for SY. This instruction buys PT from the pool, merges the PT and YT back into SY, and returns the net SY to the trader.

```APIDOC
## createSellYtInstruction

### Description
Builds a raw transaction instruction to sell YT tokens for SY. This process buys PT from the pool, merges the PT and YT back into SY, and returns the net SY to the trader.

### Parameters
#### Accounts
- **trader** (PublicKey) - Wallet executing the trade
- **market** (PublicKey) - The CLMM market account
- **ticks** (PublicKey) - The market tick array account
- **tokenYtTrader** (PublicKey) - Trader's YT token account
- **tokenPtTrader** (PublicKey) - Trader's PT token account
- **tokenSyTrader** (PublicKey) - Trader's SY token account
- **tokenSyEscrow** (PublicKey) - Market SY escrow account
- **tokenPtEscrow** (PublicKey) - Market PT escrow account
- **tokenYtEscrow** (PublicKey) - Market YT escrow account
- **addressLookupTable** (PublicKey) - Market address lookup table
- **tokenFeeTreasurySy** (PublicKey) - SY fee treasury account
- **tokenFeeTreasuryPt** (PublicKey) - PT fee treasury account
- **tokenProgram** (PublicKey) - SPL Token program
- **syProgram** (PublicKey) - SY program
- **exponentCoreProgram** (PublicKey) - Exponent core program
- **eventAuthority** (PublicKey) - Event authority PDA
- **program** (PublicKey) - CLMM program ID

#### Args
- **ytIn** (u64) - Amount of YT tokens to sell
- **minSyOut** (u64) - Minimum amount of SY tokens to receive
- **priceSpotLimit** (f64) - Optional: Price limit for anti-sandwich protection

### Returns
- **TransactionInstruction** - A transaction instruction ready to be added to a transaction.
```

--------------------------------

### Withdraw Liquidity to Base Usage

Source: https://docs.exponent.finance/developer-clmm/typescript/instructions/ix-withdraw-liquidity-to-base

Example demonstrating how to load a market and execute a liquidity withdrawal transaction.

```typescript
import { MarketThree, LOCAL_ENV } from "@exponent-labs/exponent-sdk";
import { Connection, PublicKey, Transaction, sendAndConfirmTransaction } from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const market = await MarketThree.load(LOCAL_ENV, connection, marketAddress);

const { ixs, setupIxs } = await market.ixWithdrawLiquidityToBase({
  owner: wallet.publicKey,
  amountLp: 9_000_000_000n,
  minBaseOut: 8_500_000_000n,
  lpPosition: lpPositionPublicKey,
});

const tx = new Transaction().add(...setupIxs, ...ixs);
const signature = await sendAndConfirmTransaction(connection, tx, [wallet]);
```

--------------------------------

### Initialize SDK Connection

Source: https://docs.exponent.finance/skill.md

Set up the connection and wallet instance required for SDK operations.

```typescript
import { Vault, MarketThree, Orderbook, TranchingMarket, LOCAL_ENV } from "@exponent-labs/exponent-sdk";
import { Connection, PublicKey, Keypair } from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const wallet = Keypair.fromSecretKey(/* your secret key */);
```

--------------------------------

### Initialize Yield Position

Source: https://docs.exponent.finance/developer-core/core-sdk

Create a YieldTokenPosition account required for tracking yield. This is a one-time setup per vault.

```typescript
const initIx = vault.ixInitializeYieldPosition({
  owner: wallet.publicKey,
});

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

--------------------------------

### Check Orderbook Price Assertion

Source: https://docs.exponent.finance/developer-strategy-vaults/vault-assertion

Example of asserting orderbook price conditions, including implied APY thresholds.

```typescript
const report = await assertion.check({
  conditions: [{
    kind: VaultAssertionConditionKind.OrderbookPrice,
    orderbook: new PublicKey("..."),
    impliedApy: { blockAboveBps: 1_050 },
  }],
});
```

--------------------------------

### createWrapperDepositInstruction

Source: https://docs.exponent.finance/developer-tranching/raw-instructions/raw-wrapper-deposit

Builds a raw instruction that mints SY from base assets, deposits the SY into the selected tranche, and mints tranche LP shares.

```APIDOC
## createWrapperDepositInstruction

### Description
Builds a raw instruction that mints SY from base assets, deposits the SY into the selected tranche, and mints tranche LP shares.

### Signature
`createWrapperDepositInstruction(accounts, args)`

### Accounts
- **user** (PublicKey) - Depositor (Signer, Writable)
- **market** (PublicKey) - Tranching market account (Writable)
- **returnModelStorage** (PublicKey) - Return model storage account (Writable)
- **addressLookupTable** (PublicKey) - Market address lookup table
- **syProgram** (PublicKey) - Linked SY program
- **syMint** (PublicKey) - SY mint (Writable)
- **tokenSrc** (PublicKey) - User SY token account used by the wrapper (Writable)
- **tokenSyEscrow** (PublicKey) - Market SY escrow (Writable)
- **tokenLpDst** (PublicKey) - Destination LP token account (Writable)
- **mintLp** (PublicKey) - Senior or Junior LP mint (Writable)
- **tokenProgram** (PublicKey) - SPL Token program
- **eventAuthority** (PublicKey) - Event authority PDA
- **program** (PublicKey) - Exponent Tranching program

### Arguments
- **trancheSide** (TrancheSide) - Senior or Junior
- **amountBase** (u64) - Base asset amount to wrap into SY, in raw base-token units
- **minLpOut** (u64) - Minimum selected-tranche LP shares to mint, in raw LP units
- **mintSyAccountsUntil** (u8) - Number of remaining accounts used by the SY mint CPI segment

### Returns
- **TransactionInstruction** - A transaction instruction ready to be added to a transaction.
```

--------------------------------

### Check CLMM Price Assertion

Source: https://docs.exponent.finance/developer-strategy-vaults/vault-assertion

Example of asserting CLMM price conditions using the assertion check method.

```typescript
const report = await assertion.check({
  conditions: [{
    kind: VaultAssertionConditionKind.ClmmPrice,
    market: new PublicKey("..."),
    impliedApy: { blockAboveBps: 1_500 },
  }],
});
```

--------------------------------

### createStripInstruction

Source: https://docs.exponent.finance/developer-core/raw-instructions/raw-strip

Builds a raw instruction to strip SY tokens into equal amounts of PT and YT.

```APIDOC
## createStripInstruction

### Description
Builds a raw instruction to strip SY tokens into equal amounts of PT (Principal Token) and YT (Yield Token).

### Parameters
#### Accounts
- **depositor** (PublicKey) - The user stripping SY
- **authority** (PublicKey) - Vault authority PDA
- **vault** (PublicKey) - Vault account
- **sySrc** (PublicKey) - Source SY token account
- **escrowSy** (PublicKey) - Vault SY escrow account
- **ytDst** (PublicKey) - Destination YT token account
- **ptDst** (PublicKey) - Destination PT token account
- **mintYt** (PublicKey) - YT mint address
- **mintPt** (PublicKey) - PT mint address
- **tokenProgram** (PublicKey) - SPL Token program
- **addressLookupTable** (PublicKey) - Vault address lookup table
- **syProgram** (PublicKey) - SY program
- **yieldPosition** (PublicKey) - Vault robot yield position
- **eventAuthority** (PublicKey) - Event authority PDA
- **program** (PublicKey) - Exponent Core program

#### Args
- **amount** (bigint) - Amount of SY to strip (in base units)

### Returns
- **TransactionInstruction** - A transaction instruction ready to be added to a transaction.
```

--------------------------------

### Withdraw Liquidity Usage

Source: https://docs.exponent.finance/developer-clmm/typescript/instructions/remove-liquidity

Example of using ixWithdrawLiquidity to burn LP tokens and receive PT and SY tokens.

```typescript
import { MarketThree, LOCAL_ENV } from "@exponent-labs/exponent-sdk";
import { Connection, PublicKey, Transaction, sendAndConfirmTransaction } from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const market = await MarketThree.load(LOCAL_ENV, connection, marketAddress);

const { ixs, setupIxs } = market.ixWithdrawLiquidity({
  withdrawer: wallet.publicKey,
  lpIn: 9_000_000_000n,           // LP tokens to burn
  lpPosition: lpPositionPublicKey, // from getUserLpPositions
  minPtOut: 4_000_000_000n,       // minimum PT to receive
  minSyOut: 4_000_000_000n,       // minimum SY to receive
});

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

--------------------------------

### Initialize the Orderbook

Source: https://docs.exponent.finance/developer-orderbook/sdk-quickstart

Set up the connection and load the orderbook instance using your Solana wallet and environment configuration.

```typescript
import { Orderbook, LOCAL_ENV } from "@exponent-labs/exponent-sdk";
import {
  Connection,
  PublicKey,
  Transaction,
  sendAndConfirmTransaction,
  Keypair,
} from "@solana/web3.js";
const connection = new Connection("https://api.mainnet-beta.solana.com");
const wallet = Keypair.fromSecretKey(/* your keypair */);
const orderbookAddress = new PublicKey("...");
const syMintAddress = new PublicKey("...");

const orderbook = await Orderbook.load(LOCAL_ENV, connection, orderbookAddress);
```

--------------------------------

### Mint jlTokens with Exponent SDK

Source: https://docs.exponent.finance/developer-strategy-vaults/jupiter-lend-earn-instructions

Demonstrates creating mint instructions with and without an asset spend cap, then executing them via the jupiterEarnAction interface.

```typescript
import {
  createJupiterEarnMintInstruction,
  createJupiterEarnMintWithMaxAssetsInstruction,
  jupiterEarnAction,
} from "@exponent-labs/exponent-sdk";

const mintIx = createJupiterEarnMintInstruction(assetInAccounts, 5_000_000n);

const mintMaxIx = createJupiterEarnMintWithMaxAssetsInstruction(
  assetInAccounts,
  5_000_000n,    // jlTokens to mint
  5_100_000n,    // maximum underlying to spend
);

jupiterEarnAction.mint({ instruction: mintIx });
jupiterEarnAction.mintWithMaxAssets({ instruction: mintMaxIx });
```

--------------------------------

### Withdraw Liquidity Classic Usage

Source: https://docs.exponent.finance/developer-clmm/typescript/instructions/ix-withdraw-liquidity-classic

Example demonstrating how to initialize the market and execute a liquidity withdrawal using the ixWithdrawLiquidityClassic method.

```typescript
import { MarketThree, LOCAL_ENV } from "@exponent-labs/exponent-sdk";
import { Connection, PublicKey, Transaction, sendAndConfirmTransaction } from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const market = await MarketThree.load(LOCAL_ENV, connection, marketAddress);

const { ixs, setupIxs } = await market.ixWithdrawLiquidityClassic({
  owner: wallet.publicKey,
  amountLp: 9_000_000_000n,
  lpPosition: lpPositionPublicKey,
});

const tx = new Transaction().add(...setupIxs, ...ixs);
const signature = await sendAndConfirmTransaction(connection, tx, [wallet]);
```

--------------------------------

### Get a Trade Quote

Source: https://docs.exponent.finance/developer-orderbook/sdk-quickstart

Simulate a trade to estimate output and fees. Always use connection.getClock() for the unixNow parameter to avoid drift.

```typescript
import { QuoteDirection } from "@exponent-labs/exponent-sdk";

const clock = await connection.getClock();
const unixNow = Number(clock.unixTimestamp);

const quote = orderbook.getQuote({
  inAmount: 1_000_000_000,
  direction: QuoteDirection.SY_TO_YT,
  unixNow,
  syExchangeRate: 1.000009210084,
});

console.log("Expected output:", quote.outAmount);
console.log("Maker fees:", quote.makerFees);
console.log("Taker fees:", quote.takerFees);
```

--------------------------------

### MarketThree.ixWrapperBuyYt(params)

Source: https://docs.exponent.finance/developer-clmm/typescript/instructions/ix-wrapper-buy-yt

Constructs instructions to buy YT tokens using base assets. This method is asynchronous as it requires constructing minting and deposit accounts based on market configuration.

```APIDOC
## MarketThree.ixWrapperBuyYt

### Description
Converts base assets into YT (Yield Tokens) by wrapping the base into SY, stripping SY into PT and YT, and swapping the PT back for SY in a single atomic operation.

### Parameters
#### Required Parameters
- **owner** (PublicKey) - The owner's wallet public key
- **ytOut** (bigint) - Amount of YT tokens to receive
- **maxBaseIn** (bigint) - Maximum amount of base asset to spend

#### Optional Parameters
- **tokenSyTrader** (PublicKey) - Intermediate SY token account. Defaults to owner's ATA
- **tokenPtTrader** (PublicKey) - Intermediate PT token account. Defaults to owner's ATA
- **tokenYtTrader** (PublicKey) - Destination YT token account. Defaults to owner's ATA
- **tokenBaseTrader** (PublicKey) - Source base token account. Defaults to owner's ATA

### Returns
Returns a `Promise<PreparedInstruction>` containing:
- **ixs** (TransactionInstruction[]) - Main instructions to execute
- **setupIxs** (TransactionInstruction[]) - Setup instructions for creating ATAs
```

--------------------------------

### Withdraw Funds Instruction Usage

Source: https://docs.exponent.finance/developer-orderbook/typescript/instructions/ix-wrapper-withdraw-funds

Example of calling the ixWrapperWithdrawFunds instruction to withdraw specific amounts of PT and YT, and all available SY tokens.

```typescript
import { amount } from "@exponent-labs/exponent-sdk";
import { PublicKey } from "@solana/web3.js";

const ix = await orderbook.ixWrapperWithdrawFunds({
  trader: wallet.publicKey,
  mintSy: syMintAddress,
  ptAmount: amount("Some", [500_000_000n]),
  ytAmount: amount("Some", [500_000_000n]),
  syAmount: amount("All"),
});
```

--------------------------------

### MarketThree.ixWrapperSellYt

Source: https://docs.exponent.finance/developer-clmm/typescript/instructions/ix-wrapper-sell-yt

Constructs instructions to sell YT tokens for base assets.

```APIDOC
## MarketThree.ixWrapperSellYt

### Description
Converts YT (Yield Tokens) back into base assets by merging YT with PT to create SY and then redeeming SY for base in a single atomic operation.

### Method
SDK Method (Async)

### Parameters
#### Required Parameters
- **owner** (PublicKey) - The owner's wallet public key
- **amount** (bigint) - Amount of YT tokens to sell
- **minBaseOut** (bigint) - Minimum amount of base asset to receive

#### Optional Parameters
- **tokenBaseTrader** (PublicKey) - Destination base token account. Defaults to owner's ATA
- **tokenSyTrader** (PublicKey) - Intermediate SY token account. Defaults to owner's ATA
- **tokenYtTrader** (PublicKey) - Source YT token account. Defaults to owner's ATA
- **tokenPtTrader** (PublicKey) - Intermediate PT token account. Defaults to owner's ATA

### Returns
- **ixs** (TransactionInstruction[]) - Main instructions to execute
- **setupIxs** (TransactionInstruction[]) - Setup instructions for creating ATAs
```

--------------------------------

### Initialize MarketThree and Instruction Wrapper

Source: https://docs.exponent.finance/developer-clmm/typescript/instructions/overview

Load the MarketThree instance and prepare instruction wrappers for protocol interactions.

```typescript
import { MarketThree } from "@exponent-labs/exponent-sdk";

const market = await MarketThree.load(env, connection, marketAddress);
const { ixs, setupIxs } = await market.ixWrapperBuyPt({...});
```

--------------------------------

### Execute a market order with ixWrapperMarketOffer

Source: https://docs.exponent.finance/developer-orderbook/typescript/instructions/ix-wrapper-market-offer

Use this instruction to initiate a market order on the orderbook. Ensure all required parameters like trader public key, amount, and offer type are provided.

```typescript
import { PublicKey } from "@solana/web3.js";
import { OfferType } from "@exponent-labs/exponent-sdk";

const { ix, setupIxs } = await orderbook.ixWrapperMarketOffer({
  trader: wallet.publicKey,
  maxPriceApy: 5.5,
  amount: 1_000_000_000n,
  offerType: OfferType.BuyYt,
  minAmountOut: 990_000_000n,
  virtualOffer: false,
  mintSy: syMintAddress,
});
```

--------------------------------

### createVaultSyncTransaction

Source: https://docs.exponent.finance/developer-strategy-vaults/kamino-vault-instructions

Generates a set of instructions required to perform a Kamino Vault action, returning a structured object containing setup, pre, main, and post instructions.

```APIDOC
## createVaultSyncTransaction

### Description
Generates a low-level sync transaction result consisting of setup, pre, main, and post instructions for a Kamino Vault action.

### Parameters
- **instructions** (Array) - Required - List of kaminoVaultAction operations.
- **owner** (PublicKey) - Required - The owner of the vault.
- **connection** (Connection) - Required - Solana RPC connection.
- **policyPda** (PublicKey) - Required - The policy PDA.
- **vaultPda** (PublicKey) - Required - The vault PDA.
- **signer** (PublicKey) - Required - The wallet public key signing the transaction.
- **vaultAddress** (PublicKey) - Required - The address of the vault.

### Returns
- **setupInstructions** (Array) - Idempotent setup instructions.
- **preInstructions** (Array) - Instructions to run before the sync step.
- **instruction** (TransactionInstruction) - The main sync transaction instruction.
- **postInstructions** (Array) - Instructions to run after the sync step.
```

--------------------------------

### Execute Kamino Lend deposit via createVaultSyncTransaction

Source: https://docs.exponent.finance/developer-strategy-vaults/kamino-instructions

Use this pattern to perform a deposit into Kamino Lend. Ensure instructions are executed in the specific order: setup, pre, main, and post.

```typescript
import BN from "bn.js";
import {
  KaminoMarket,
  createVaultSyncTransaction,
  kaminoAction,
} from "@exponent-labs/exponent-sdk";
import {
  Transaction,
  sendAndConfirmTransaction,
} from "@solana/web3.js";

const { setupInstructions, preInstructions, instruction, postInstructions } =
  await createVaultSyncTransaction({
    instructions: [
      kaminoAction.deposit(KaminoMarket.MAIN, "USDC", new BN(100_000_000)),
    ],
    owner: vaultPda,
    connection,
    policyPda,
    vaultPda,
    signer: wallet.publicKey,
    vaultAddress,
  });

const tx = new Transaction().add(
  ...setupInstructions,
  ...preInstructions,
  instruction,
  ...postInstructions,
);
await sendAndConfirmTransaction(connection, tx, [wallet]);
```

--------------------------------

### Initialize Orderbook and Instructions

Source: https://docs.exponent.finance/developer-orderbook/typescript/instructions/overview

Load an orderbook instance and access the instruction wrapper methods.

```typescript
import { Orderbook } from "@exponent-labs/exponent-sdk";

// Load an orderbook
const orderbook = await Orderbook.load(env, connection, orderbookAddress);

// Use instructions
const { ix, setupIxs } = await orderbook.ixWrapperPostOffer({...});
```

--------------------------------

### createWrapperSellYtInstruction

Source: https://docs.exponent.finance/developer-clmm/raw-instructions/raw-wrapper-sell-yt

Creates a transaction instruction to sell YT tokens for base assets in a single atomic operation.

```APIDOC
## createWrapperSellYtInstruction

### Description
Sells YT tokens for base assets in a single atomic operation. This instruction buys PT on the market, merges the PT and YT back into SY, and then redeems the SY for the underlying base asset.

### Parameters
#### Accounts
- **seller** (PublicKey) - Required - Wallet executing the trade
- **market** (PublicKey) - Required - The CLMM market account
- **ticks** (PublicKey) - Required - The market tick array account
- **tokenSyTrader** (PublicKey) - Required - Trader's SY token account
- **tokenYtTrader** (PublicKey) - Required - Trader's YT token account
- **tokenPtTrader** (PublicKey) - Required - Trader's PT token account
- **tokenSyEscrow** (PublicKey) - Required - Market SY escrow account
- **tokenYtEscrow** (PublicKey) - Required - Market YT escrow account
- **tokenPtEscrow** (PublicKey) - Required - Market PT escrow account
- **marketAddressLookupTable** (PublicKey) - Required - Market address lookup table
- **tokenProgram** (PublicKey) - Required - SPL Token program
- **syProgram** (PublicKey) - Required - SY program
- **tokenFeeTreasurySy** (PublicKey) - Required - SY fee treasury account
- **tokenFeeTreasuryPt** (PublicKey) - Required - PT fee treasury account
- **exponentCoreProgram** (PublicKey) - Required - Exponent core program
- **eventAuthority** (PublicKey) - Required - Event authority PDA
- **program** (PublicKey) - Required - CLMM program ID

#### Arguments
- **ytAmount** (u64) - The amount of YT tokens to sell
- **minBaseAmount** (u64) - The minimum amount of base asset to receive
- **redeemSyAccountsUntil** (u8) - The number of CPI remaining accounts used for SY redemption

### Returns
- **TransactionInstruction** - A transaction instruction ready to be added to a transaction.
```

--------------------------------

### Create Update Policy Instruction in TypeScript

Source: https://docs.exponent.finance/developer-strategy-vaults/raw-instructions/raw-update-policy

Generates a transaction instruction to update a Squads policy configuration. Requires the manager's public key and various PDA accounts associated with the Squads setup.

```typescript
import { createUpdatePolicyInstruction } from "@exponent-labs/exponent-sdk/client/vaults";
import { PublicKey } from "@solana/web3.js";

const ix = createUpdatePolicyInstruction(
  {
    payer: wallet.publicKey,
    vault: vaultAddress,
    manager: managerPublicKey,
    squadsSettings: squadsSettingsPda,
    squadsSettingsTransaction: squadsSettingsTransactionPda,
    squadsProposal: squadsProposalPda,
    squadsPolicy: squadsPolicyPda,
    squadsProgram: SQUADS_PROGRAM_ID,
    systemProgram: SYSTEM_PROGRAM_ID,
  },
  {
    policyConfig: {
      programId: updatedProgramId,
      instructionDiscriminator: updatedDiscriminatorBytes,
      accountConstraints: [
        { index: 0, address: requiredAccountAddress },
      ],
    },
  }
);
```
Tokens:
Raw