Инструкции 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 → пул CPMM с creator_fee_on = OnlyQuoteToken (создатель продолжает зарабатывать комиссии от пула CPMM через NFT-ключ LaunchLab Fee — см. /ru/products/launchlab/creator-fees).

​

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. Newton-решить кривую для base_out по постоплатному quote.
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 (все еще в funding).
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. Разделить результирующий LP в соответствии с связыванием PlatformConfig.{platform_scale, creator_scale, burn_scale} (только CPMM) — одна часть отчеканена на platform_nft_wallet, одна на creator NFT, обернутая программой LP-Lock, одна сожжена через 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

​

Инструкции Vesting и platform-config

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, UpdatePlatformCurveParam, RemovePlatformCurveParam, CreatePlatformGlobalAccess, ClosePlatformGlobalAccess
• CreateConfig, UpdateConfig

​

Матрица изменения состояния

​

Куда дальше

• /ru/products/launchlab/code-demos — примеры TypeScript для каждой инструкции.
• /ru/products/launchlab/accounts — полная форма состояния.
• /ru/reference/error-codes — LaunchLab error enum.

• Raydium SDK v2 LaunchLab module
• Raydium LaunchLab program source