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 = 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 计算（大约）。
• 对于带有 TransferFeeConfig 的 InitializeWithToken2022：transfer_fee_config_authority = launch_authority，当该字段被设置时 withdraw_withheld_authority = PlatformConfig.transfer_fee_extension_auth，否则 launch_authority。提取端在代币创建时写入，正是为了让平台可以在毕业前扫除扣留的费用。见platform-config。

​

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。

​

报价端转账费用

• 计算为代币无费用的界限被拒绝。将无费用成本作为 maximum_amount_in 传递，或将无费用收益作为 minimum_amount_out 传递，会以 ExceededSlippage 回滚。
• real_quote 仅按到达金库的金额推进。5% 报价代币上的 BuyExactIn amount_in 将 real_quote 移动 amount_in × 0.95。

​

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。

• transfer_fee_config_authority 总是被重新分配。启动 authority PDA 在整个毕业前阶段持有它，所以总有东西要移动。
• WithheldWithdraw 仅当 authority PDA 仍然持有它时才被重新分配。从 2026-08-27 起创建的启动已经在代币创建时在该权限上携带 transfer_fee_extension_auth，所以该步骤被跳过。守卫是什么防止迁移在这些代币上回滚 — PDA 无法签署它不再持有的权限。

​

CPMM 迁移剩余账户

​

CPMM 迁移代币程序

​

平台 GlobalConfig 允许列表

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

​

平台启动参数规则

• Create 分配不持有任何组的账户。该状态不限制任何东西。
• Update 使用该 group_id 更新插入组，如果存在则完全替换它。它调整账户大小以适应，所以签署者补充它增长的租金并收回它缩小的租金。超过第十个的新组返回 CurveRuleGroupsExceeded；超过 25 个约束、未知字段或运算符，或同一组中相同的 (field, op) 对两次返回 InvalidCurveRuleConstraint；非常数乘积配置上的四个 TotalSellA 派生字段返回 CurveRuleFieldNotSupportedByCurve。
• Remove 按 id 删除一个组，缩小账户并退款差额。未知 id 返回 CurveRuleGroupNotExist。
• Close 将整个租金返回给签署者。即使 restrict_curve_param 保持 1，配置也不再受限制。

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

归属和平台配置指令

• CreateVestingAccount、CreatePlatformVestingAccount、ClaimVestedToken
• CreatePlatformConfig、UpdatePlatformConfig、CreatePlatformAllowConfig、ClosePlatformAllowConfig
• CreatePlatformCurveRule、UpdatePlatformCurveRule、RemovePlatformCurveRule、ClosePlatformCurveRule
• CreateConfig、UpdateConfig

​

状态变化矩阵

​

接下来去哪里

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

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