LaunchLab instructions

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

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

​

Instruction inventory

• BothToken → MigrateToAmm → AMM v4 pool (creator fee can be collected from either side; AMM v4 has no native creator-fee field, so creator fees are taken via the LP-lock NFT mechanism instead).
• QuoteToken → MigrateToCpswap → CPMM pool with creator_fee_on = OnlyQuoteToken (creator continues to earn fees from the CPMM pool through the LaunchLab Fee Key NFT — see products/launchlab/creator-fees).

​

Initialize

launch_params: {
    curve_type:                 u8,
    base_supply_max:            u64,
    base_supply_graduation:     u64,
    k:                          u128,              // or initial_virtual_quote_reserve for curve_type=1
    open_time:                  u64,
    quote_mint:                 Pubkey,
    base_token_metadata: {                         // inline name/symbol/uri; program CPIs to Metaplex
        name:   String,
        symbol: String,
        uri:    String,
    },
    fees: {
        buy_numerator:   u64,
        buy_denominator: u64,
        sell_numerator:  u64,
        sell_denominator: u64,
        lp_share:        u64,
        creator_share:   u64,
        protocol_share:  u64,
        total_share:     u64,
    },
    post_graduation_lp_policy:  u8,                // 0 = Burn, 1 = Lock, 2 = ToCreator
}

• quote_mint ∈ launch_config.allowed_quote_mints.
• base_supply_graduation ≤ base_supply_max.
• Fee parameters pass launch_config.max_*_fee_rate checks.
• open_time ≥ now − slop (SDK enforces ≥ now; program tolerates slight backdating).
• curve_type is recognized.

• base_mint has supply = base_supply_max, all in base_vault.
• base_mint.mint_authority = launch_authority, freeze_authority = None.
• LaunchState initialized with status = Active, base_sold = 0, quote_reserve_real = 0.
• quote_reserve_target computed from curve params + base_supply_graduation + buy_numerator (approximately).

​

Buy (canonical variant: BuyExactIn)

quote_in:          u64
minimum_base_out:  u64

• launch_state.status == Active.
• now ≥ open_time.
• user_quote_ata.balance ≥ quote_in.
• quote_in > 0.

1. Split quote_in into quote_in_after_fee and the fee parts.
2. Newton-solve the curve for base_out given the post-fee quote.
3. require(base_out ≥ minimum_base_out) else revert ExceededSlippage.
4. Move quote_in user → vault. Move base_out vault → user.
5. Update base_sold += base_out, quote_reserve_real += quote_in_after_fee × (lp_share / total_share).
6. Update fee counters (protocol_fees_quote, creator_fees_quote).
7. state_data.num_buys += 1.
8. If quote_reserve_real ≥ quote_reserve_target after the update, the SDK typically chains a Graduate ix in the same transaction. The program does not auto-graduate inside Buy — a subsequent Graduate is required.

​

BuyExactOut

base_out:      u64
maximum_quote_in: u64

​

Sell / SellExactIn / SellExactOut

• user_base_ata.balance ≥ base_in.
• Selling cannot push base_sold below 0 (redundant with the above given accounting is consistent).
• Launch is Active.

​

MigrateToAmm / MigrateToCpswap

• MigrateToAmm — the migrate_to_amm_wallet recorded on the binding GlobalConfig.
• MigrateToCpswap — the migrate_to_cpswap_wallet recorded on the binding GlobalConfig.

base_lot_size:               u64
quote_lot_size:              u64
market_vault_signer_nonce:   u8

1. Verify pool_state.status == Migrate (i.e., quote_reserve_target has been reached). Otherwise revert with PoolMigrated (status was already Migrated) or PoolFunding (still in funding).
2. Verify pool_state.migrate_type matches the instruction (0 for AMM, 1 for CPMM). Otherwise revert with MigrateTypeNotMatch.
3. Compute the post-graduation reserves:
   • base_amount_out = base_vault.amount − vesting_schedule.total_locked_amount
   • quote_amount_out = quote_vault.amount − quote_protocol_fee − migrate_fee − platform_fee
4. CPI into the target program (AMM v4 Initialize2 or CPMM InitializeWithPermission) with those reserves to create the post-graduation pool.
5. Split the resulting LP per the binding PlatformConfig.{platform_scale, creator_scale, burn_scale} (CPMM only) — one piece minted to platform_nft_wallet, one to a creator NFT wrapped by the LP-Lock program, one burned via Burn & Earn. For AMM v4 graduation, the LP disposition is governed by AMM v4’s own initialization parameters.
6. Revoke base_mint.mint_authority (set to None).
7. Flip pool_state.status = Migrated, set vesting_schedule.start_time = block_time + cliff_period.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

Vesting and platform-config instructions

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, UpdatePlatformCurveParam, RemovePlatformCurveParam, CreatePlatformGlobalAccess, ClosePlatformGlobalAccess
• CreateConfig, UpdateConfig

​

State-change matrix

​

Where to go next

• products/launchlab/code-demos — TypeScript examples for each instruction.
• products/launchlab/accounts — full state shape.
• reference/error-codes — LaunchLab error enum.

• Raydium SDK v2 LaunchLab module
• Raydium LaunchLab program source