LaunchLab 指令

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.

​

指令清单

• BothToken → MigrateToAmm → AMM v4 池（创建者费可以从任一侧收取；AMM v4 没有原生创建者费字段，所以创建者费通过 LP 锁定 NFT 机制而被取走）。
• QuoteToken → MigrateToCpswap → 具有 creator_fee_on = OnlyQuoteToken 的 CPMM 池（创建者通过 LaunchLab Fee Key NFT 继续从 CPMM 池赚取费用 —— 见 products/launchlab/creator-fees）。

​

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: {                         // 内联 name/symbol/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 = Burn, 1 = Lock, 2 = ToCreator
}

• 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. Newton 求解给定后费报价的 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 指令。程序不会在 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. 根据绑定的 PlatformConfig.{platform_scale, creator_scale, burn_scale}（仅 CPMM）拆分生成的 LP —— 一片铸造到 platform_nft_wallet，一片到由 LP-Lock 程序包装的创建者 NFT，一片通过 Burn & Earn 烧掉。对于 AMM v4 毕业，LP 处理由 AMM v4 自己的初始化参数控制。
6. 撤销 base_mint.mint_authority（设置为 None）。
7. 翻转 pool_state.status = Migrated，设置 vesting_schedule.start_time = block_time + cliff_period。

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

归属和平台配置指令

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

​

状态变化矩阵

​

后续步骤

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

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