LaunchLab 指令

​

指令清单

​

Initialize

launch_params: {
    curve_type:                 u8,
    base_supply_max:            u64,
    base_supply_graduation:     u64,
    k:                          u128,              // 或 curve_type=1 的 initial_virtual_quote_reserve
    open_time:                  u64,
    quote_mint:                 Pubkey,
    base_token_metadata: {                         // 内联名称/符号/uri；程序 CPI 到 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 = 销毁，1 = 锁定，2 = 给创建者
}

• quote_mint ∈ launch_config.allowed_quote_mints。
• base_supply_graduation ≤ base_supply_max。
• 费用参数通过 launch_config.max_*_fee_rate 检查。
• open_time ≥ now − slop（SDK 强制 ≥ now；程序容忍轻微回溯）。
• curve_type 被识别。

• base_mint 的 supply = base_supply_max，全部在 base_vault 中。
• base_mint.mint_authority = launch_authority，freeze_authority = None。
• LaunchState 初始化为 status = Active，base_sold = 0，quote_reserve_real = 0。
• quote_reserve_target 从曲线参数 + base_supply_graduation + buy_numerator 计算（大约）。

​

Buy（规范变体：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. 将 quote_in 分割为 quote_in_after_fee 和费用部分。
2. 牛顿求解曲线以获得给定后费用报价的 base_out。
3. require(base_out ≥ minimum_base_out) 否则回滚 ExceededSlippage。
4. 移动 quote_in 用户 → 金库。移动 base_out 金库 → 用户。
5. 更新 base_sold += base_out，quote_reserve_real += quote_in_after_fee × (lp_share / total_share)。
6. 更新费用计数器（protocol_fees_quote、creator_fees_quote）。
7. state_data.num_buys += 1。
8. 如果更新后 quote_reserve_real ≥ quote_reserve_target，SDK 通常在同一交易中链接 Graduate ix。程序不会在 Buy 内自动毕业 — 需要后续的 Graduate。

​

BuyExactOut

base_out:      u64
maximum_quote_in: u64

​

Sell / SellExactIn / SellExactOut

• user_base_ata.balance ≥ base_in。
• 卖出不能将 base_sold 推低于 0（考虑到会计一致性是冗余的）。
• 启动是 Active。

​

MigrateToAmm / MigrateToCpswap

• MigrateToAmm — 绑定 GlobalConfig 上记录的 migrate_to_amm_wallet。
• MigrateToCpswap — 绑定 GlobalConfig 上记录的 migrate_to_cpswap_wallet。

base_lot_size:               u64
quote_lot_size:              u64
market_vault_signer_nonce:   u8

1. 验证 pool_state.status == Migrate（即 quote_reserve_target 已达到）。否则回滚 PoolMigrated（状态已是 Migrated）或 PoolFunding（仍在融资）。
2. 验证 pool_state.migrate_type 与指令匹配（AMM 为 0，CPMM 为 1）。否则回滚 MigrateTypeNotMatch。
3. 计算毕业后的储备：
   • 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 进入目标程序（AMM v4 Initialize2 或 CPMM InitializeWithPermission）使用这些储备来创建毕业后的池。
5. 对于在 2026-08-17 升级后执行的 CPMM 迁移，将 platform_scale + creator_scale 合并为一个平台拥有的锁定 LP 份额，并最多向 platform_nft_wallet 铸造一个费用密钥 NFT。销毁 burn_scale 余额。在升级之前，creator_scale 被单独锁定，其费用密钥转到代币创建者。已完成的历史迁移不被修改。对于遗留 AMM v4 毕业，LP 处置遵循该指令的现有流程。
6. 撤销 base_mint.mint_authority（设置为 None）。
7. 翻转 pool_state.status = Migrated，设置 vesting_schedule.start_time = block_time + cliff_period。

​

CPMM 迁移剩余账户

​

平台 GlobalConfig 允许列表

• 0：平台接受任何其他有效的 GlobalConfig；不需要允许账户。
• 1：Initialize、InitializeV2 和 InitializeWithToken2022 必须在 remaining_accounts 中的任何地方包含匹配的 PlatformAllowConfig。

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

归属和平台配置指令

• CreateVestingAccount、CreatePlatformVestingAccount、ClaimVestedToken
• CreatePlatformConfig、UpdatePlatformConfig、UpdatePlatformCurveParam、RemovePlatformCurveParam、CreatePlatformAllowConfig、ClosePlatformAllowConfig
• CreateConfig、UpdateConfig

​

状态变化矩阵

​

接下来去哪里

• products/launchlab/code-demos — 每个指令的 TypeScript 示例。
• products/launchlab/accounts — 完整状态形状。
• reference/error-codes — LaunchLab 错误枚举。

• Raydium SDK v2 LaunchLab 模块
• Raydium LaunchLab 程序源代码