Инструкции LaunchLab

​

Инвентарь инструкций

​

Initialize

launch_params: {
    curve_type:                 u8,
    base_supply_max:            u64,
    base_supply_graduation:     u64,
    k:                          u128,              // или initial_virtual_quote_reserve для curve_type=1
    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. Решить кривую методом Ньютона для 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 — migrate_to_amm_wallet, записанный на привязке GlobalConfig.
• MigrateToCpswap — migrate_to_cpswap_wallet, записанный на привязке GlobalConfig.

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 соответствует инструкции (0 для AMM, 1 для CPMM). Иначе вернуть 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. Для миграций CPMM, выполненных после обновления 2026-08-17, объединить platform_scale + creator_scale в одну заблокированную долю LP, принадлежащую платформе, и выпустить максимум один 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 должны включать соответствующий PlatformAllowConfig где-либо в remaining_accounts.

​

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