LaunchLab PlatformConfig

Конфигурация для каждой платформы, которая настраивает брендинг, распределение комиссий, доли миграции NFT, распределение вестинга и список допустимых форм кривых для любого запуска на этой платформе.

Эта страница переведена с помощью ИИ. За эталон принимается английская версия.

Открыть английскую версию →

PlatformConfig — это уровень платформы, который располагается над GlobalConfig. Если GlobalConfig определяет правила протокола в целом («комиссия торговли 1%, минимум предложения 10M, только этот кошелёк может сделать градацию»), то PlatformConfig — это то, что каждая платформа запуска — pump.fun, собственный интерфейс Raydium, сторонние лаунчпады — использует для добавления своей комиссии, получения доли LP после градации, ограничения формы кривых для своих запусков и размещения своего брендинга (имя, сайт, изображение) в блокчейне.

​

Что это такое

Аккаунт PlatformConfig управляет четырьмя сквозными функциями платформы:

1. Брендинг — имя, сайт, ссылка на изображение, хранящиеся в самом аккаунте, чтобы любой обозреватель или агрегатор мог показать платформу, запустившую токен.
2. Комиссия платформы — дополнительная торговая комиссия (fee_rate) сверх протокольной trade_fee_rate. Накапливается в platform_fee_wallet платформы. Ограничена 100 bps параметром GlobalConfig.max_share_fee_rate.
3. Распределение миграции NFT — три целых числа (platform_scale, creator_scale, burn_scale), которые в сумме дают RATE_DENOMINATOR_VALUE = 1_000_000 и разбивают LP после градации на часть, отчеканиваемую на кошелёк NFT платформы, часть на кошелёк NFT создателя и часть, сжигаемую (Burn & Earn). Имеет значение только при градации на CPMM (migrate_type = 1).
4. Белый список параметров кривой — Vec<PlatformCurveParam>, перечисляющий ровно те комбинации (supply, total_base_sell, total_quote_fund_raising, migrate_type, migrate_cpmm_fee_on, vesting_params...), которые разрешены на этой платформе. Если вектор пуст или все записи неверны, любая комбинация разрешена; в противном случае запуски должны точно совпадать с одной из записей.

Вывод PDA:

const [platformConfigPda] = PublicKey.findProgramAddressSync(
  [
    Buffer.from("platform_config"),
    platformAdmin.toBuffer(),       // публичный ключ владельца платформы
  ],
  LAUNCHLAB_PROGRAM_ID,
);

(См. create_platform_config в исходном коде для полного списка семян.)

​

Структура

// states/platform_config.rs
pub const PLATFORM_CONFIG_SEED: &str = "platform_config";
pub const NAME_SIZE: usize = 64;
pub const WEB_SIZE:  usize = 256;
pub const IMG_SIZE:  usize = 256;
pub const MAX_CREATOR_FEE_RATE: u64 = 5000;       // 50 bps (знаменатель 1_000_000)
pub const MAX_TRANSFER_FEE_RATE: u16 = 500;       // 5%   (знаменатель 10_000)
pub const MAX_CURVE_PARAMS: usize = 10;

#[account]
pub struct PlatformConfig {
    pub epoch:                       u64,
    pub platform_fee_wallet:         Pubkey,            // подписывает ClaimPlatformFee
    pub platform_nft_wallet:         Pubkey,            // получает долю NFT платформы при градации на CPMM
    pub platform_scale:              u64,               // доля LP, отчеканиваемая для платформы NFT
    pub creator_scale:               u64,               // доля LP, отчеканиваемая для NFT создателя
    pub burn_scale:                  u64,               // доля LP, сжигаемая через Burn & Earn
    pub fee_rate:                    u64,               // торговая комиссия платформы (1/1_000_000)
    pub name:                        [u8; 64],          // utf-8 дополнена нулями
    pub web:                         [u8; 256],
    pub img:                         [u8; 256],
    pub cpswap_config:               Pubkey,            // AmmConfig CPMM, который получит пул после градации
    pub creator_fee_rate:            u64,               // комиссия создателя до градации
    pub transfer_fee_extension_auth: Pubkey,            // для запусков Token-2022: кто наследует права трансфер-комиссии после градации
    pub platform_vesting_wallet:     Pubkey,
    pub platform_vesting_scale:      u64,               // доля платформы в total_locked_amount
    pub platform_cp_creator:         Pubkey,            // опциональный создатель пула CPMM после градации
    pub padding:                     [u8; 108],
    pub curve_params:                Vec<PlatformCurveParam>, // белый список разрешённых форм кривых
}

platform_scale + creator_scale + burn_scale должны равняться 1_000_000 (проверяется MigrateNftInfo::check). Стандартные распределения в продакшене:

• (0, 100_000, 900_000) — 90% LP сжигается, 10% создателю. Стандартный справедливый запуск в стиле pump.
• (50_000, 100_000, 850_000) — небольшая доля платформы (5%), 10% создателю, 85% сжигается.
• (0, 0, 1_000_000) — полное сжигание, без отчеканивания NFT. Строгие запуски «без инсайдеров».

​

Поля брендинга

name, web и img — это встроенные массивы байтов, дополненные нулями до их констант размера. Чтобы прочитать их как строки, обрежьте до первого \0:

function readString(bytes: Uint8Array): string {
  const end = bytes.indexOf(0);
  return Buffer.from(end === -1 ? bytes : bytes.subarray(0, end)).toString("utf-8");
}

Константы намеренно щедрые (name: 64, web: 256, img: 256), чтобы платформы могли включить достаточно метаданных для обозревателей и агрегаторов без обращения к off-chain хранилищу. Всё, что превышает эти размеры, отменяется при CreatePlatformConfig с ошибкой InvalidInput.

​

Механика комиссий

Своп на кривой, привязанной к PlatformConfig, взимает три слоя комиссий:

trade_fee     = amount_in × global_config.trade_fee_rate    / 1_000_000
platform_fee  = amount_in × platform_config.fee_rate        / 1_000_000
creator_fee   = amount_in × platform_config.creator_fee_rate / 1_000_000

amount_after_fee = amount_in − trade_fee − platform_fee − creator_fee

• trade_fee накапливается на счету protocol_fee_owner протокола (снимается через CollectFee).
• platform_fee накапливается в хранилище для каждой платформы (снимается через ClaimPlatformFee или ClaimPlatformFeeFromVault; см. instructions).
• creator_fee накапливается в хранилище для каждого создателя, ключ которого — это публичный ключ создателя + кошелёк кавычек (снимается через ClaimCreatorFee).

creator_fee_rate ограничена MAX_CREATOR_FEE_RATE = 5000 (50 bps). fee_rate (комиссия платформы) ограничена 10000 (100 bps) по GlobalConfig.max_share_fee_rate.

​

Распределение миграции NFT (только CPMM)

Когда запуск переходит на CPMM (migrate_type = 1, подписано migrate_to_cpswap_wallet), инструкция миграции разбивает отчеканенные LP токены тремя способами:

lp_to_platform = lp_total × platform_scale / 1_000_000   → platform_nft_wallet
lp_to_creator  = lp_total × creator_scale  / 1_000_000   → NFT создателя (Fee Key)
lp_to_burn     = lp_total × burn_scale     / 1_000_000   → программа Burn & Earn lock

Доли платформы и создателя обёртываются как NFT программой LP-Lock (LockrWmn6K5twhz3y9w1dQERbmgSaRkfnTeTKbpofwE) — владелец NFT может претендовать на накопленные комиссии CPMM бесконечно, но не может вывести базовую ликвидность. См. products/launchlab/creator-fees для потока Fee Key после градации.

Доля для сжигания отправляется в программу Lock с is_burn = true, чтобы LP токены были постоянно недоступны — они обеспечивают ценовой минимум пула без никогда не выплачивая комиссии.

Когда migrate_type = 0 (градация на AMM v4), поля распределения NFT игнорируются и весь LP блокируется / сжигается согласно отдельному потоку на стороне AMM v4.

​

Белый список параметров кривой

curve_params: Vec<PlatformCurveParam> — это механизм платформы для ограничения того, какие формы кривых её запуски могут выбирать. Если вектор непуст и хотя бы одна запись верна, программа принудительно проверяет при Initialize, что параметры запуска совпадают с хотя бы одной записью ровно.

#[derive(AnchorSerialize, AnchorDeserialize, Clone)]
pub struct PlatformCurveParam {
    pub epoch:                u64,
    pub index:                u8,           // порядковый номер в белом списке платформы
    pub global_config:        Pubkey,       // какой GlobalConfig применяется для этой записи
    pub bonding_curve_param:  BondingCurveParam,
    pub padding:              [u64; 50],
}

#[derive(AnchorSerialize, AnchorDeserialize, Clone)]
pub struct BondingCurveParam {
    pub migrate_type:               u8,    // 0 = AMM v4, 1 = CPMM. u8::MAX = подстановочный символ
    pub migrate_cpmm_fee_on:        u8,    // 0 = только quote, 1 = оба. u8::MAX = подстановочный символ
    pub supply:                     u64,   // 0 = подстановочный символ
    pub total_base_sell:            u64,   // 0 = подстановочный символ
    pub total_quote_fund_raising:   u64,   // 0 = подстановочный символ
    pub total_locked_amount:        u64,   // u64::MAX = подстановочный символ
    pub cliff_period:               u64,   // u64::MAX = подстановочный символ
    pub unlock_period:              u64,   // u64::MAX = подстановочный символ
}

Каждое поле имеет значение-дозорный, означающий подстановочный символ (любое значение совпадает): u64::MAX для полей u64, u8::MAX для полей u8, 0 для полей предложения / продажи / сбора средств. BondingCurveParam со всеми дозорными символами — это «разрешить всё» — эквивалентно поведению пустого белого списка.

Алгоритм совпадения при Initialize:

1. Отфильтруйте curve_params к записям, чей global_config совпадает с выбранным запуском GlobalConfig.
2. Если отфильтрованный список пуст, разрешите любые параметры (платформа ничего не добавила в белый список для этого GlobalConfig).
3. Если каждая запись в отфильтрованном списке имеет all_is_invalid() (каждое поле — подстановочный символ), разрешите любые параметры.
4. Иначе переберите записи; для каждой записи проверьте параметры запуска по каждому не-подстановочному полю. Если все не-подстановочные поля совпадают, примите и вернитесь.
5. Если записи не совпали, откатитесь с InvalidInput.

Это позволяет платформе сказать «мы разрешаем только стандартную форму 1B-supply / 800M-sold / 30k-USDC-raise / no-vesting», написав одну запись с конкретными значениями для этих четырёх полей и подстановочными символами везде. Или более строгая платформа может перечислить три или четыре дискретные формы, по одной для каждого поддерживаемого уровня запуска.

MAX_CURVE_PARAMS = 10 ограничивает размер белого списка.

​

PlatformGlobalAccess — авторизация платформы

Когда GlobalConfig имеет requires_platform_auth = 1, каждый Initialize для него должен включить PDA PlatformGlobalAccess, доказывающий предварительную авторизацию платформы:

// states/platform_global_access.rs
pub const PLATFORM_GLOBAL_ACCESS_SEED: &str = "platform_global_access";

#[account]
pub struct PlatformGlobalAccess {
    pub bump:            u8,
    pub global_config:   Pubkey,
    pub platform_config: Pubkey,
    pub padding:         [u64; 8],
}

PDA семена: [b"platform_global_access", global_config, platform_config].

Администратор протокола создаёт по одному на каждую пару (GlobalConfig, PlatformConfig) через CreatePlatformGlobalAccess и отзывает через ClosePlatformGlobalAccess. Без этого аккаунта запуск не может привязаться к этому GlobalConfig из закрытой платформы.

​

Путь чтения

const platformConfig = await raydium.launchpad.getPlatformConfig(platformConfigPda);

console.log("Платформа:", readString(platformConfig.name));
console.log("Комиссия:", platformConfig.feeRate, "(/1M)");
console.log("Распределение NFT:",
  platformConfig.platformScale,
  platformConfig.creatorScale,
  platformConfig.burnScale,
);
console.log("Размер белого списка кривых:", platformConfig.curveParams.length);

Для интерфейса, показывающего «откуда был запущен этот токен», PoolState.platform_config указывает напрямую на исходящий PlatformConfig — получите его один раз и кэшируйте брендинг.

​

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

Инструкция	Кто подписывает	Что изменяется
CreatePlatformConfig	администратор платформы (один раз)	Инициализирует аккаунт с PlatformParams.
UpdatePlatformConfig	администратор платформы	Универсальная диспетчеризация, ключ по param: u8; изменяет одно поле за вызов. Поля брендинга, ставки комиссий, кошелёк вестинга и различные кошельки — всё можно установить через это.
UpdatePlatformCurveParam	администратор платформы	Добавить или заменить одну запись PlatformCurveParam по (global_config, index).
RemovePlatformCurveParam	администратор платформы	Очистить одну запись (установить на все-дозорные = подстановочный символ).
ClaimPlatformFee	platform_fee_wallet	Собрать комиссию платформы для каждого пула из PoolState.quote_vault.
ClaimPlatformFeeFromVault	platform_fee_wallet	Собрать хранилище платформы (PDA по [platform_config, quote_mint]).

Ротация кошельков (platform_fee_wallet, platform_nft_wallet, platform_vesting_wallet, platform_cp_creator, transfer_fee_extension_auth, cpswap_config) — всё через UpdatePlatformConfig. Прочитайте таблицу диспетчеризации update_platform_config в исходном коде для точных кодов param.

​

Распространённые ошибки

• Неправильно установленные дозорные символы белого списка. BondingCurveParam с total_locked_amount = 0 не является подстановочным символом — он совпадает с запусками, явно отказывающимися от вестинга. Подстановочный символ для этого поля — u64::MAX. Та же ловушка существует для cliff_period и unlock_period. Используйте clear() (который программа предоставляет) для правильной установки дозорных символов.
• Округление распределения NFT. Три масштаба должны в сумме дать ровно 1_000_000. Ошибки на один при CreatePlatformConfig откатываются; ошибки во время выполнения отчеканили бы или сожгли один дополнительный LP unit, что именно предотвращает проверка строгого равенства.
• Двойное распределение вестинга платформы. Если platform_vesting_scale > 0, платформа должна вызвать CreatePlatformVestingAccount один раз после окончания сбора средств запуска; если забудет, эта доля остаётся нераспределённой и неактивной навечно (бюджет total_locked_amount запуска расходуется, но платформа никогда не требует).
• Неоднозначность platform_cp_creator. Когда установлен на Pubkey::default(), создатель запуска записывается как pool_creator пула CPMM после градации; когда установлен на реальный ключ, вместо него записывается этот ключ. Это влияет на то, кто может позже вызвать CPMM::CollectCreatorFee. Решите при создании конфигурации платформы, какую модель вы хотите.

​

Ссылки

• products/launchlab/global-config — протокольные правила, которые должен удовлетворять запуск.
• products/launchlab/vesting — механика platform_vesting_scale.
• products/launchlab/creator-fees — NFT Fee Key, Burn & Earn.
• products/launchlab/platforms — руководство интегратора платформы.

Исходные файлы:

• raydium-launch/programs/launchpad/src/states/platform_config.rs — PlatformConfig, PlatformParams, MigrateNftInfo, PlatformCurveParam, BondingCurveParam, is_valid_curve_param.
• raydium-launch/programs/launchpad/src/states/platform_global_access.rs — PlatformGlobalAccess.
• raydium-launch/programs/launchpad/src/lib.rs — create_platform_config, update_platform_config, update_platform_curve_param, remove_platform_curve_param, create_platform_global_access, close_platform_global_access, claim_platform_fee, claim_platform_fee_from_vault.