createInitializeVaultInstruction

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. Called by the vault creator.

Usage

import { createInitializeVaultInstruction } from "@exponent-labs/exponent-sdk/client/vaults";
import { Keypair, PublicKey } from "@solana/web3.js";

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,
  }
);

Accounts

Name	Signer	Writable	Description
`payer`	Yes	Yes	The vault creator and fee payer
`vault`	No	Yes	The Strategy Vault PDA to initialize
`exponentPrices`	No	Yes	Global ExponentPrices account
`mint`	No	No	Underlying token mint
`mintLp`	No	Yes	LP token mint to create
`tokenLpEscrow`	No	Yes	LP token escrow account to create
`feeTreasury`	No	Yes	Fee treasury LP token account to create
`lpDst`	No	Yes	Payer’s LP token destination account
`tokenProgram`	No	No	SPL Token program
`systemProgram`	No	No	System program
`associatedTokenProgram`	No	No	Associated Token program
`addressLookupTable`	No	No	Address lookup table for the vault
`squadsProgram`	No	No	Squads v4 program
`squadsProgramConfig`	No	Yes	Squads program config PDA
`squadsTreasury`	No	Yes	Squads treasury PDA
`squadsSettings`	No	Yes	Squads settings account
`squadsVault`	No	No	Squads vault PDA
`squadsPolicy`	No	Yes	Squads policy PDA
`squadsSettingsTransaction`	No	Yes	Squads settings transaction PDA
`squadsProposal`	No	Yes	Squads proposal PDA

Args

Name	Type	Description
`manager`	`PublicKey`	Manager authority for the vault
`feeTreasuryLpBps`	`number`	Fee treasury share in basis points (u16)
`tokenEntries`	`TokenEntry[]`	Array of token entries the vault accepts
`maxLpSupply`	`bigint`	Maximum LP token supply cap (u64)
`seedId`	`Uint8Array`	8-byte seed identifier for vault PDA derivation
`initialLpAmount`	`bigint`	Initial LP tokens to mint to the creator (u64)
`lpDecimals`	`number`	Decimal places for the LP token mint (u8)
`vaultType`	`VaultType`	Vault type variant (e.g. `{ openEnded: {} }`)
`roles`	`VaultRoles`	Role assignments (manager, sentinel, etc.)
`proposalVoteConfig`	`ProposalVoteConfig \| null`	Governance vote configuration, or null to disable

Returns

TransactionInstruction — a transaction instruction ready to be added to a transaction.