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 時
    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 計算（大約）。

​

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 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. 根據繫結的 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 程式原始碼