LaunchLab instructions

​

Instruction inventory

​

Initialize

base_mint_param: MintParams {
    decimals: u8,                 // must equal the program's BASE_MINT_DECIMALS
    name:     String,
    symbol:   String,
    uri:      String,
}

curve_param: CurveParams {        // Borsh enum — one leading variant-tag byte
    Constant { data: ConstantCurve { supply: u64, total_base_sell: u64,
                                     total_quote_fund_raising: u64, migrate_type: u8 } },
    Fixed    { data: FixedCurve    { supply: u64,
                                     total_quote_fund_raising: u64, migrate_type: u8 } },
    Linear   { data: LinearCurve   { supply: u64,
                                     total_quote_fund_raising: u64, migrate_type: u8 } },
}

vesting_param: VestingParams {
    total_locked_amount: u64,     // 0 requires cliff_period == unlock_period == 0
    cliff_period:        u64,     // seconds after fundraising ends
    unlock_period:       u64,     // seconds
}

amm_fee_on: AmmCreatorFeeOn       // 0 = QuoteToken, 1 = BothToken (CPMM migrations only)

• 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 = curve_param.supply, all in base_vault.
• The mint authority is revoked in this same instruction (set_authority(MintTokens, None)) right after the supply is minted — not at graduation. The base mint is therefore permanently fixed-supply, and no later instruction can mint more.
• PoolState initialized with status = Fund (0), real_a = 0, real_b = 0.
• total_fund_raising_b comes straight from curve_param.total_quote_fund_raising.
• For InitializeWithToken2022 with a TransferFeeConfig attached: transfer_fee_config_authority = launch_authority, and withdraw_withheld_authority = PlatformConfig.transfer_fee_extension_auth when that field is set, otherwise launch_authority. The withdraw side is written at mint creation precisely so the platform can sweep withheld fees before graduation. See platform-config.

​

Buy (canonical variant: BuyExactIn)

amount_in:           u64
minimum_amount_out:  u64
share_fee_rate:      u64   // referral fee on a 1_000_000 denominator; must be
                           // <= global_config.max_share_fee_rate. Pass 0 for no
                           // referral. Any non-zero value requires the share-fee
                           // receiver as remaining_accounts[0].

1. share_fee_receiver — only when share_fee_rate > 0.
2. system_program — always; checked == System::id(), else InvalidInput.
3. platform_fee_vault — PDA [platform_config, quote_token_mint]; created on first use.
4. creator_fee_vault — PDA [creator, quote_token_mint]; created on first use.

• 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

amount_out:         u64
maximum_amount_in:  u64
share_fee_rate:     u64   // as for BuyExactIn

​

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.

​

Quote-side transfer fees

• A bound computed as if the mint were fee-free is rejected. Passing the fee-free cost as maximum_amount_in, or the fee-free proceeds as minimum_amount_out, reverts with ExceededSlippage.
• real_quote advances only by what reached the vault. A BuyExactIn of amount_in on a 5% quote mint moves real_quote by amount_in × 0.95.

​

Trade remaining accounts

​

MigrateToAmm / MigrateToCpswap

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

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. (No mint-authority step. base_mint.mint_authority was already set to None at launch creation — see the note below.)
7. Flip pool_state.status = Migrated, set vesting_schedule.start_time = block_time + cliff_period.

• transfer_fee_config_authority is always reassigned. The launch authority PDA holds it for the whole pre-graduation phase, so there is always something to move.
• WithheldWithdraw is reassigned only when the authority PDA still holds it. Launches created from 2026-08-27 onward already carry transfer_fee_extension_auth on that authority from mint creation, so the step is skipped. The guard is what keeps migration from reverting on those mints — the PDA cannot sign away an authority it no longer holds.

​

CPMM migration remaining accounts

​

CPMM migration token programs

​

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.

​

Platform launch-parameter rules

• Create allocates the account holding no group. That state does not restrict anything.
• Update upserts the group with that group_id, replacing it wholesale if it exists. It resizes the account to fit, so the signer tops up the rent it grows by and receives back the rent it shrinks by. A new group beyond the tenth returns CurveRuleGroupsExceeded; more than 25 constraints, an unknown field or operator, or the same (field, op) pair twice in one group returns InvalidCurveRuleConstraint; the four TotalSellA-derived fields on a non-constant-product config return CurveRuleFieldNotSupportedByCurve.
• Remove drops one group by id, shrinking the account and refunding the difference. An unknown id returns CurveRuleGroupNotExist.
• Close returns the whole rent to the signer. The config is then unrestricted again even while restrict_curve_param stays 1.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

CollectExcessLamports

​

Vesting and platform-config instructions

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, CreatePlatformAllowConfig, ClosePlatformAllowConfig
• CreatePlatformCurveRule, UpdatePlatformCurveRule, RemovePlatformCurveRule, ClosePlatformCurveRule
• 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