Инструкции 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.
• Для InitializeWithToken2022 с прикрепленным TransferFeeConfig: 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. Newton-решите кривую для base_out с учетом post-fee котировки.
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

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 продвигается только на то, что достигло хранилища. BuyExactIn из amount_in на 5% минте котировки перемещает real_quote на amount_in × 0.95.

​

Оставшиеся аккаунты торговли

​

MigrateToAmm / MigrateToCpswap

• MigrateToAmm — migrate_to_amm_wallet, записанный на привязке GlobalConfig.
• MigrateToCpswap — migrate_to_cpswap_wallet, записанный на привязке GlobalConfig.

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. (Нет шага mint-authority. base_mint.mint_authority уже был установлен на None при создании запуска — см. примечание ниже.)
7. Переверните pool_state.status = Migrated, установите vesting_schedule.start_time = block_time + cliff_period.

• transfer_fee_config_authority всегда переназначается. PDA запуска authority держит его на всю фазу до выпуска, поэтому всегда есть что переместить.
• WithheldWithdraw переназначается только когда PDA authority все еще его держит. Запуски, созданные с 2026-08-27 и позже, уже несут transfer_fee_extension_auth на этом органе от создания минта, поэтому шаг пропускается. Охрана — это то, что предотвращает откат миграции на этих минтах — PDA не может отказаться от права, которое оно больше не держит.

​

Оставшиеся аккаунты миграции CPMM

​

Программы токенов миграции CPMM

​

Список разрешений GlobalConfig платформы

• 0: платформа принимает любой иначе действительный GlobalConfig; аккаунт разрешения не требуется.
• 1: Initialize, InitializeV2 и InitializeWithToken2022 должны включать соответствующий PlatformAllowConfig где-нибудь в remaining_accounts.

​

Правила параметров запуска платформы

• 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