Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.meteora.ag/llms.txt

Use this file to discover all available pages before exploring further.

Alpha Vault is Meteora’s pre-launch allocation program for DLMM, DAMM v1, and DAMM v2 Launch Pools. Users deposit the pool quote token into a vault before public trading starts; the vault buys the launch token from the connected pool during the protected pre-activation window, then users claim bought tokens and withdraw unused quote according to the vault configuration. For product and economic concepts, you can read the following documentations.

Learn more about Alpha Vault

Overview of the Alpha Vault lifecycle, pool linkage, deposit window, purchase window, and claim flow.

Alpha Vault Formulas

Formulas and definitions for allocation, refund, vesting, and rounding.

Integration

Program Accounts

Account model for vaults, escrows, configs, Merkle roots, Merkle proof metadata, crank fee whitelists, PDAs, enums, and constants.

Program Instructions

Instruction families for vault creation, escrow creation, deposits, withdrawals, claims, fills, metadata, authority, and admin config.

Program Events

Event payloads emitted by vault creation, escrow actions, fills, claims, refunds, Merkle metadata, and crank fee whitelist changes.

Program Errors

Anchor custom error codes, enum names, messages, and common integration causes.

TypeScript SDK

TypeScript SDK for reading vault state, creating vaults and escrows, deposits, withdrawals, claims, fills, and Merkle helpers.

Rust Integration

Rust integration notes for the Anchor crate, cpi feature, account types, and CPI call patterns.

Program IDs

The public Alpha Vault program ID is the same on mainnet and devnet:
NetworkProgram ID
Mainnet BetavaU6kP7iNEGkbmPkLmZfGwiGxd4Mob24QQCie5R9kd2
DevnetvaU6kP7iNEGkbmPkLmZfGwiGxd4Mob24QQCie5R9kd2
Localnet featureSNPmGgnywBvvrAKMLundzG6StojyHTHDLu7T4sdhP4k
The program treasury used for escrow fees and crank fees is:
AccountAddress
Alpha Vault treasuryBJQbRiRWhJCyTYZcAuAL3ngDCx3AyFQGKDq8zhiZAKUw

Alpha Vault IDL

Anchor IDL used by the TypeScript SDK.

TypeScript SDK

Public SDK for transactions, PDA derivation, account wrappers, Merkle helpers, and examples in tests.
Alpha Vault must be connected to a launch pool whose state points back to the vault address. The vault does not price swaps itself; fills call into the connected DLMM, DAMM v1, or DAMM v2 pool.

Commands

TaskCommand
Install TypeScript SDK dependenciescd alpha-vault-sdk/ts-client && npm install
Build TypeScript SDKcd alpha-vault-sdk/ts-client && npm run build
Run TypeScript SDK testscd alpha-vault-sdk/ts-client && npm test
Build alpha_vault programcd alpha-vault && anchor build
Run Anchor program testscd alpha-vault && anchor test

Stay Updated

Alpha Vault Changelog

Program, SDK, event, and integration notes for release planning.