LaunchLab instructions

​

Instruction inventory

​

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. For CPMM migrations executed after the 2026-08-17 upgrade, combine platform_scale + creator_scale into one platform-owned locked-LP share and mint at most one Fee Key NFT to platform_nft_wallet. Burn the burn_scale remainder. Before the upgrade, creator_scale was locked separately and its Fee Key went to the token creator. Completed historical migrations are not modified. For legacy AMM v4 graduation, the LP disposition follows that instruction’s existing flow.
6. Revoke base_mint.mint_authority (set to None).
7. Flip pool_state.status = Migrated, set vesting_schedule.start_time = block_time + cliff_period.

​

CPMM migration remaining accounts

​

Platform GlobalConfig allowlist

• 0: the platform accepts any otherwise-valid GlobalConfig; no allow account is required.
• 1: Initialize, InitializeV2, and InitializeWithToken2022 must include the matching PlatformAllowConfig anywhere in remaining_accounts.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

Vesting and platform-config instructions

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, UpdatePlatformCurveParam, RemovePlatformCurveParam, CreatePlatformAllowConfig, ClosePlatformAllowConfig
• 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