LaunchLab 指令

​

指令清單

​

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。
• 費用參數通過 launch_config.max_*_fee_rate 檢查。
• open_time ≥ now − slop（SDK 強制 ≥ now；程式容許輕微回溯）。
• curve_type 被識別。

• base_mint 有 supply = curve_param.supply，全部在 base_vault 中。
• 鑄幣權限在供應量鑄造完成後，就在這同一條指令中被撤銷（set_authority(MintTokens, None)） — 而不是在畢業時。因此基礎鑄幣永久固定供應量，之後沒有任何指令能再鑄造。
• PoolState 初始化為 status = Fund（0）、real_a = 0、real_b = 0。
• total_fund_raising_b 直接來自 curve_param.total_quote_fund_raising。
• 對於帶有 TransferFeeConfig 的 InitializeWithToken2022：transfer_fee_config_authority = launch_authority，且 withdraw_withheld_authority = PlatformConfig.transfer_fee_extension_auth（當該欄位被設定時），否則為 launch_authority。提取端在鑄幣建立時被寫入，正是為了讓平台可以在畢業前掃除扣留的費用。見 platform-config。

​

Buy（規範變體：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 — 僅在 share_fee_rate > 0 時。
2. system_program — 總是需要；檢查 == System::id()，否則 InvalidInput。
3. platform_fee_vault — PDA [platform_config, quote_token_mint]；首次使用時建立。
4. creator_fee_vault — PDA [creator, quote_token_mint]；首次使用時建立。

• 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

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

​

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。

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

​

CollectExcessLamports

​

歸屬和平台設定指令

• 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 程式源