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.

Presale Vault supports three sale modes. The mode controls deposit capacity, withdrawal support, token-allocation math, and when the sale can end.

​

Comparison

​

Fixed Price

Fixed Price mode is for sales where buyers should know the quote-per-base price before participating. The creator creates a fixed-price extra-params account before initializing the vault. That account stores:

• q_price, a Q64.64 price in quote-token smallest units per base-token smallest unit
• disable_withdraw, which controls whether buyers can withdraw during the ongoing sale

The program verifies that the configured price can buy at least one base-token unit for the relevant buyer caps, that the maximum cap can be fulfilled by the deposited base supply, and that the minimum and maximum caps buy different base-token amounts.

​

Deposit behavior

Fixed Price deposits are capped by:

• remaining global quote capacity
• remaining personal and registry deposit capacity
• remaining base-token supply in the buyer’s registry

The program may reduce a requested deposit to the largest amount that maps cleanly to purchasable base-token units. Fixed-price token amounts are rounded down in base-token units, and quote needed for those units is rounded up.

​

Claim behavior

The sold amount for a registry is: $$\min\left(\left\lfloor \frac{\text{registry\_total\_deposit} \times 2^{64}}{\text{q\_price}} \right\rfloor,\ \text{registry\_supply}\right)$$ Each buyer’s claimable amount is their share of that sold amount, subject to the unlock schedule.

​

FCFS

FCFS mode is for capped sales where deposits should stop once the sale reaches the maximum cap. Deposits are capped by:

• remaining global quote capacity
• remaining personal and registry deposit capacity

FCFS does not support during-sale withdrawals. If early completion is not disabled, the program updates the presale end time to the current timestamp once total deposits reach the maximum cap.

​

Claim behavior

For each registry that received deposits, the full registry supply is sold and split by deposit share: $$\text{user\_allocation} = \left\lfloor \frac{\text{registry\_supply} \times \text{user\_deposit}} {\text{registry\_total\_deposit}} \right\rfloor$$ A registry with no deposits is not treated as sold, so its supply is unsold base token.

​

Pro Rata

Pro Rata mode is for sales where buyers should be able to participate throughout the sale window even if demand exceeds the maximum cap. Deposits are not capped by the global maximum cap. They are still capped by the buyer’s remaining deposit quota. Pro Rata supports during-sale withdrawals.

​

Claim and refund behavior

Token allocation uses the same registry-level share formula as FCFS: $$\text{user\_allocation} = \left\lfloor \frac{\text{registry\_supply} \times \text{user\_deposit}} {\text{registry\_total\_deposit}} \right\rfloor$$ If total deposits exceed the maximum cap, the excess quote token is refundable after the sale completes. The creator can withdraw only up to presale_maximum_cap; buyers withdraw the remaining quote token proportionally. Deposit fees on the refunded portion are also refundable. The creator’s collectible fee in Pro Rata is the total fee minus the fee attributed to overflow quote.

​

Choosing a mode