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: {                         // インライン name/symbol/uri；プログラムは Metaplex に CPI します
        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. ターゲットプログラム（AMM v4 Initialize2 または CPMM InitializeWithPermission）に CPI して、卒業後のプールを作成します。
5. 2026-08-17 アップグレード後に実行された CPMM マイグレーションの場合、platform_scale + creator_scale を 1 つのプラットフォーム所有のロック LP シェアに結合し、最大 1 つの Fee Key NFT を platform_nft_wallet にミントします。burn_scale の残りを焼却します。アップグレード前は、creator_scale は別々にロックされ、その Fee Key はトークンクリエーターに行きました。完了した履歴マイグレーションは変更されません。レガシー 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 プログラムソース