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.
Use CPI only when your Solana program must compose directly with Presale Vault. For off-chain apps, launch scripts, and dashboards, the TypeScript SDK is simpler and safer.
Do not hand-type account order from memory. Generate CPI bindings from the Presale Vault IDL or depend on the local Anchor crate with the cpi feature, then compare against SDK-built instructions for the same flow.
Program ID
pub const PRESALE_PROGRAM_ID: Pubkey =
pubkey!("presSVxnf9UU8jMxhgSMqaRwNiT36qeBdNeTRKjTdbj");
Dependency
[dependencies]
presale = { path = "../presale/programs/presale", features = ["cpi"] }
CPI Instruction Scope
The full instruction list is documented in Program Instructions. CPI integrations most often need:
| Flow | Instruction |
|---|
| Create buyer escrow | create_permissionless_escrow, create_permissioned_escrow_with_merkle_proof, or create_permissioned_escrow_with_creator |
| Deposit quote token | deposit |
| Withdraw during presale | withdraw |
| Claim base token | claim |
| Refund failed or prorata overflow quote | withdraw_remaining_quote |
| Refresh claimable state | refresh_escrow |
| Close escrow | close_escrow |
Event CPI Accounts
Most account structs use #[event_cpi]. Generated clients include these accounts after the primary accounts:
| Account | Why it appears |
|---|
event_authority | Anchor event-CPI PDA for the presale program. |
program | The presale program account used by event CPI emission. |
Account Planning
| Flow | Required planning |
|---|
| Initialize presale | Presale PDA, vault PDAs, presale authority, base and quote token programs, payer base token account, base signer, creator, fixed-price extra-args remaining account when mode is fixed price, and Token 2022 base transfer-hook accounts when required. |
| Create permissionless escrow | Presale state, escrow PDA from registry 0, owner, payer, and system program. |
| Create Merkle proof escrow | Presale state, escrow PDA from registry index, owner, Merkle root config, payer, proof, and deposit cap. |
| Create authority escrow | Presale state, escrow PDA from registry index, owner, operator PDA, operator owner signer, payer, and deposit cap. |
| Deposit | Presale state, quote vault, quote mint, escrow, payer quote token account, payer signer, token program, and quote transfer-hook remaining accounts when required. |
| Withdraw | Presale state, quote vault, quote mint, presale authority, escrow, owner quote token account, owner signer, token program, memo program, and quote transfer-hook accounts when required. |
| Claim | Presale state, base vault, base mint, presale authority, escrow, owner base token account, owner signer, token program, memo program, and base transfer-hook accounts when required. |
| Creator withdraw | Base or quote vault and mint are passed as remaining accounts depending on whether the presale failed or completed. |
Presale account whenever possible. Avoid deriving business assumptions from user input alone.
Token 2022 Remaining Accounts
Presale Vault supports Token 2022 transfer hooks through RemainingAccountsInfo:
pub enum AccountsType {
TransferHookBase,
TransferHookQuote,
}
| Transfer | Slice type |
|---|
| Base token transfers | TransferHookBase |
| Quote token transfers | TransferHookQuote |
Common CPI Failures
| Error or symptom | Likely cause |
|---|
NotEnoughAccountKeys | Missing event CPI accounts, memo program, mode-specific remaining accounts, or transfer-hook remaining accounts. |
ConstraintSeeds / ConstraintAddress | Presale, vault, escrow, operator, Merkle root, presale authority, or event authority PDA is wrong. |
ConstraintHasOne | Escrow, vault, mint, owner, or metadata account does not match parent account state. |
PresaleNotOpenForDeposit | Presale progress is not Ongoing. |
PresaleNotOpenForWithdraw | Mode disallows withdrawal, fixed-price withdrawal is disabled, or presale is no longer ongoing. |
MissingPresaleExtraParams | Fixed-price initialization did not pass the fixed-price extra-args account as the first remaining account. |
InvalidRemainingAccountSlice | Remaining-account slice type or length does not match the accounts provided. |
MissingRemainingAccountForTransferHook | Token 2022 mint has a transfer hook but CPI did not forward the hook accounts. |
NoTransferHookProgram | Hook accounts were forwarded for a mint without a transfer-hook program. |
EscrowNotEmpty | CPI attempted to close an escrow before all state-dependent claim, refund, or withdrawal requirements were complete. |
Best Practices
| Check | Detail |
|---|
| Generate accounts | Use generated CPI bindings or the local Anchor crate. Compare account metas against the TypeScript SDK for the same flow. |
| Simulate first | Simulate CPI transactions with realistic presale state, especially Token 2022 and permissioned flows. |
| Respect lifecycle state | Load Presale and derive PresaleProgress from current timestamp before deciding which instruction to call. |
| Handle once-only flags | Creator withdrawal, fee collection, unsold token action, and remaining quote withdrawal are guarded by account flags. |
| Plan Token 2022 fees | Transfer-fee mints affect gross and net amounts. Use SDK or Rust helper math before setting amounts and bounds. |
| Keep registries straight | Derive escrows with the intended registry index and validate registry caps before submitting transactions. |
| Test every mode | Fixed-price, prorata, and FCFS have different withdrawal, cap, price, and refund behavior. |
