LaunchLab GlobalConfig

​

Что это такое

• Тип допустимой кривой связывания (curve_type).
• Ставка комиссии за торговлю, которую взимает кривая при каждой покупке и продаже.
• Комиссия за миграцию, взимаемая при выпуске.
• Минимальные значения для предложения, коэффициента блокировки, коэффициента продажи и коэффициента миграции.
• Котировочный минт (обычно обёрнутый SOL или USDC) — актив, которым пользователи покупают.
• Четыре кошелька на уровне протокола: владелец комиссии протокола, владелец комиссии миграции и два кошелька управления миграцией, зарезервированные для выпуска CPMM и устаревшего AMM v4.

​

Структура

// states/config.rs
pub const GLOBAL_CONFIG_SEED: &str = "global_config";

#[account]
pub struct GlobalConfig {
    pub epoch:                   u64,         // recent_epoch tracker
    pub curve_type:              u8,          // 0 = ConstantProduct, 1 = FixedPrice, 2 = LinearPrice
    pub index:                   u16,         // discriminator within a curve_type
    pub migrate_fee:             u64,         // SOL paid on graduation
    pub trade_fee_rate:          u64,         // 1/1_000_000 of volume
    pub max_share_fee_rate:      u64,         // 100 bps cap on the per-trade referral share fee
    pub min_base_supply:         u64,         // floor on Initialize supply (no decimals)
    pub max_lock_rate:           u64,         // ceiling on vesting locked / supply
    pub min_base_sell_rate:      u64,         // floor on base_supply_graduation / supply
    pub min_base_migrate_rate:   u64,         // floor on tokens that seed the post-graduation pool
    pub min_quote_fund_raising:  u64,         // floor on quote_reserve_target (with decimals)
    pub quote_mint:              Pubkey,
    pub protocol_fee_owner:      Pubkey,      // claims protocol fees via CollectFee
    pub migrate_fee_owner:       Pubkey,      // claims migration fees via CollectMigrateFee
    pub migrate_to_amm_wallet:   Pubkey,      // can sign MigrateToAmm
    pub migrate_to_cpswap_wallet:Pubkey,      // can sign MigrateToCpswap
    pub padding_alignment:       [u8; 8],
    pub padding:                 [u64; 15],
}

const [globalConfig] = PublicKey.findProgramAddressSync(
  [
    Buffer.from("global_config"),
    Buffer.from(quoteMint.toBytes()),
    Buffer.from([curveType]),
    u16ToBytes(index),
  ],
  LAUNCHLAB_PROGRAM_ID,
);

​

Семантика полей

​

curve_type и index

• curve_type = 0 — кривая виртуального резерва с постоянным произведением. По умолчанию и наиболее часто используется.
• curve_type = 1 — кривая с фиксированной ценой.
• curve_type = 2 — кривая с линейной ценой.

​

Комиссии

• trade_fee_rate — выражена в 1/1_000_000 от объёма торговли. Применяется к каждой покупке и продаже на кривой. protocol_fee_owner требует свою долю через CollectFee.
• migrate_fee — фиксированная комиссия в лампортах (или единицах котировки, в зависимости от конфигурации), взимаемая один раз при выпуске. Требуется migrate_fee_owner через CollectMigrateFee.
• max_share_fee_rate — инициализируется как 10_000 (100 bps). Ограничивает аргумент share_fee_rate, который принимают BuyExactIn, BuyExactOut, SellExactIn и SellExactOut — реферальную комиссию, выплачиваемую напрямую получателю доли во время сделки. Это не ограничивает PlatformConfig.fee_rate; у той ставки свои собственные ограничения, описанные в platform-config. CreateConfig при инициализации обеспечивает trade_fee_rate + max_share_fee_rate < RATE_DENOMINATOR_VALUE. На пути обновления сумму перепроверяет только param = 6 (max_share_fee_rate); param = 0 (trade_fee_rate) проверяет лишь trade_fee_rate < RATE_DENOMINATOR_VALUE, поэтому повышение одной торговой комиссии может вывести пару за совместную границу. Устанавливайте их в том порядке, который сохраняет инвариант.

​

Минимумы предложения и коэффициентов

• min_base_supply — минимальное supply (без десятичных знаков), которое может объявить кривая. По умолчанию 10_000_000.
• max_lock_rate — выражена в 1/1_000_000; по умолчанию 300_000 (30%). Ограничивает вестинг через total_locked_amount <= supply * max_lock_rate / 1_000_000.
• min_base_sell_rate — выражена в 1/1_000_000; по умолчанию 200_000 (20%). Ограничивает base_supply_graduation / supply снизу.
• min_base_migrate_rate — выражена в 1/1_000_000; по умолчанию 200_000 (20%). Ограничивает количество токенов, оставшихся для заполнения пула после выпуска.
• min_quote_fund_raising — минимальный quote_reserve_target, который может объявить запуск (с десятичными знаками). По умолчанию 30_000_000_000 единиц котировочного минта.

​

Котировочный минт и кошельки протокола

• quote_mint — актив, которым пользователи покупают. Большинство запусков используют обёрнутый SOL (So111…112) или USDC (EPjF…Dt1v). Один GlobalConfig привязан к одному котировочному минту; запуски, которым нужна другая котировка, нацелены на другую (curve_type, index). Минт может принадлежать либо программе SPL Token, либо Token-2022 — см. ниже.
• protocol_fee_owner — публичный ключ, который подписывает CollectFee и требует накопленные комиссии протокола для каждого запуска, привязанного к этой конфигурации. Хранится в цепи; администратор может ротировать его через UpdateConfig.
• migrate_fee_owner — публичный ключ, который подписывает CollectMigrateFee.

​

Котировочные минты Token-2022

• Устаревший Initialize не может запуститься против него. Только InitializeV2 и InitializeWithToken2022 принимают программу котировки Token-2022. См. instructions.
• Не применяется список разрешений расширений. В отличие от CPMM и CLMM, LaunchLab не проверяет расширения котировочного минта — CreateConfig принимает минт как есть, поэтому единственным ограничением является усмотрение администратора относительно того, какие минты привязаны к конфигурации. Проверка NoSupportExtension программы охватывает только минты базы Token-2022, которые создаёт сам LaunchLab. Рассматривайте привязку одного как действие с высокой степенью доверия; см. reference/token-2022-support.

​

Кошельки миграции

• migrate_to_amm_wallet — подписывает MigrateToAmm для существующего устаревшего запуска, чей сохранённый migrate_type = 0.
• migrate_to_cpswap_wallet — подписывает MigrateToCpswap. Каждый вновь инициализированный запуск использует этот путь.

​

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

​

Значения по умолчанию при инициализации

self.max_share_fee_rate     = 10_000;                  // 100 bps (referral share fee)
self.min_base_supply        = 10_000_000;              // no decimals
self.max_lock_rate          = 300_000;                 // 30%
self.min_base_migrate_rate  = 200_000;                 // 20%
self.min_base_sell_rate     = 200_000;                 // 20%
self.min_quote_fund_raising = 30_000_000_000;

​

Как запуск выбирает GlobalConfig

• (curve_type, index) для выбора того, какой PDA GlobalConfig загружать.
• CurveParams, описывающий форму кривой (supply, total_base_sell, total_quote_fund_raising, migrate_type).
• VestingParams, описывающий заблокированное предложение.
• MintParams для базового минта.

• curve_type совпадает с global_config.curve_type.
• supply >= global_config.min_base_supply.
• total_locked_amount <= supply * max_lock_rate / 1_000_000.
• total_base_sell >= supply * min_base_sell_rate / 1_000_000.
• (supply − total_base_sell − total_locked_amount) >= supply * min_base_migrate_rate / 1_000_000 — т.е. достаточно токенов осталось для заполнения пула после выпуска.
• total_quote_fund_raising >= min_quote_fund_raising.
• migrate_type == 1 (CPSWAP).
• Если выбранная платформа имеет restrict_global_config == 1, включается соответствующий PlatformAllowConfig.

​

Путь обновления

​

Чтение GlobalConfig с клиента

import { Raydium } from "@raydium-io/raydium-sdk-v2";

// Fetch by PDA derivation:
const [configPda] = PublicKey.findProgramAddressSync(
  [
    Buffer.from("global_config"),
    quoteMint.toBytes(),
    Buffer.from([curveType]),
    u16ToBytes(index),
  ],
  LAUNCHLAB_PROGRAM_ID,
);

// The SDK exposes the layout, not a getter — decode the account yourself:
import { LaunchpadConfig } from "@raydium-io/raydium-sdk-v2";
const info = await connection.getAccountInfo(configPda);
const config = LaunchpadConfig.decode(info!.data);
console.log(config.tradeFeeRate.toString(), config.minFundRaisingB.toString());

​

Ссылки

• products/launchlab/platform-config — наложение для каждой платформы, которое дополнительно ограничивает форму кривой.
• products/launchlab/accounts — полный граф счётов для запуска.
• products/launchlab/instructions — инструкции инициализации и обновления.
• reference/program-addresses — публичный ключ администратора, ID программы, общие органы власти.

• raydium-launch/programs/launchpad/src/states/config.rs — структура GlobalConfig и initialize.
• raydium-launch/programs/launchpad/src/lib.rs — create_config, update_config.