LaunchLab PlatformConfig

Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.Lihat versi bahasa Inggris →

PlatformConfig adalah overlay tingkat platform yang berada di atas GlobalConfig. Sementara GlobalConfig mendefinisikan aturan protokol-lebar (“biaya perdagangan adalah 1%, pasokan harus minimal 10M, hanya dompet ini yang dapat lulus”), PlatformConfig adalah apa yang digunakan setiap platform peluncuran — pump.fun, UI Raydium sendiri, launchpad pihak ketiga — untuk menambahkan biaya mereka, mengklaim bagian LP pasca-kelulusan, membatasi bentuk kurva mana yang dapat dipilih peluncuran mereka, dan menampilkan branding mereka (nama, situs web, gambar) di rantai.

Apa itu

Akun PlatformConfig mengelola lima kepentingan lintas-platform untuk sebuah platform:

Branding — nama, situs web, tautan gambar, semuanya disimpan inline sehingga penjelajah atau agregator apa pun dapat menampilkan platform yang meluncurkan token.
Biaya platform — biaya perdagangan tambahan (fee_rate) di atas trade_fee_rate protokol. Terkumpul di platform_fee_wallet platform. Dibatasi pada 100 bps oleh GlobalConfig.max_share_fee_rate.
Pembagian migrasi LP — tiga bilangan bulat yang disimpan (platform_scale, creator_scale, burn_scale) yang berjumlah 1_000_000. Sebelum upgrade 2026-08-17, skala kreator menghasilkan Fee Key kreator terpisah. Migrasi yang dijalankan setelah upgrade menggabungkan dua yang pertama menjadi satu bagian LP terkunci milik platform; sisanya dibakar.
Daftar putih parameter kurva — Vec<PlatformCurveParam> yang mencantumkan kombinasi (supply, total_base_sell, total_quote_fund_raising, migrate_type, migrate_cpmm_fee_on, vesting_params...) mana yang diizinkan di platform ini. Jika vektor kosong atau semua entri tidak valid, kombinasi apa pun diizinkan; jika tidak, peluncuran harus cocok dengan salah satu entri secara tepat.
Daftar izin konfigurasi global — pembatasan opt-in yang memerlukan PlatformAllowConfig yang dibuat platform untuk GlobalConfig yang dipilih.

Derivasi PDA:

const [platformConfigPda] = PublicKey.findProgramAddressSync(
  [
    Buffer.from("platform_config"),
    platformAdmin.toBuffer(),       // platform's owning pubkey
  ],
  LAUNCHLAB_PROGRAM_ID,
);

(Lihat create_platform_config dalam sumber untuk daftar seed kanonik.)

Tata letak

// 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 (denominator 1_000_000)
pub const MAX_TRANSFER_FEE_RATE: u16 = 500;       // 5%   (denominator 10_000)
pub const MAX_CURVE_PARAMS: usize = 10;

#[account]
pub struct PlatformConfig {
    pub epoch:                       u64,
    pub platform_fee_wallet:         Pubkey,            // signs ClaimPlatformFee
    pub platform_nft_wallet:         Pubkey,            // receives the platform NFT slice at CPMM graduation
    pub platform_scale:              u64,               // share of LP minted to platform NFT
    pub creator_scale:               u64,               // creator share before upgrade; added to platform share afterward
    pub burn_scale:                  u64,               // share of LP burned permanently
    pub fee_rate:                    u64,               // platform's trade fee (1/1_000_000)
    pub name:                        [u8; 64],          // utf-8 padded with zeros
    pub web:                         [u8; 256],
    pub img:                         [u8; 256],
    pub cpswap_config:               Pubkey,            // CPMM AmmConfig that the post-grad pool will bind to
    pub creator_fee_rate:            u64,               // creator-side fee taken pre-graduation
    pub transfer_fee_extension_auth: Pubkey,            // for Token-2022 launches: who inherits transfer-fee authorities post-graduation
    pub platform_vesting_wallet:     Pubkey,
    pub platform_vesting_scale:      u64,               // platform's slice of total_locked_amount
    pub platform_cp_creator:         Pubkey,            // optional creator-of-record on the post-graduation CPMM pool
    pub restrict_global_config:      u8,                // 0 = unrestricted, 1 = require allow PDA
    pub padding:                     [u8; 107],
    pub curve_params:                Vec<PlatformCurveParam>, // whitelist of permitted curve shapes
}

platform_scale + creator_scale + burn_scale harus sama dengan 1_000_000. Sebelum upgrade 2026-08-17, creator_scale dikunci secara terpisah dan Fee Key-nya pergi ke kreator token. Untuk migrasi yang dijalankan setelah upgrade, ditambahkan ke platform_scale dan hak LP terkunci-nya pergi ke platform. Contoh hasil di bawah logika yang diperbarui:

(0, 100_000, 900_000) — 90% LP dibakar, 10% terkunci ke platform.
(50_000, 100_000, 850_000) — 85% dibakar, 15% terkunci ke platform.
(0, 0, 1_000_000) — pembakaran penuh, tidak ada NFT yang dicetak. Peluncuran “tanpa orang dalam” yang ketat.

Bidang branding

name, web, dan img adalah larik byte inline yang diisi dengan nol hingga konstanta ukuran mereka. Untuk membacanya sebagai string, potong hingga \0 pertama:

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

Konstanta sengaja murah hati (name: 64, web: 256, img: 256) sehingga platform dapat menyertakan metadata yang cukup untuk penjelajah dan agregator tanpa menyentuh penyimpanan off-chain. Apa pun yang melebihi ukuran ini akan dikembalikan di CreatePlatformConfig dengan InvalidInput.

Mekanika biaya

Swap pada kurva yang terikat pada PlatformConfig mengenakan tiga biaya berlapis:

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 terkumpul ke protocol_fee_owner protokol (diklaim melalui CollectFee).
platform_fee terkumpul ke vault per-platform (diklaim melalui ClaimPlatformFee atau ClaimPlatformFeeFromVault; lihat instructions).
creator_fee terkumpul ke vault per-kreator yang dikunci oleh pubkey kreator + quote mint (diklaim melalui ClaimCreatorFee).

creator_fee_rate dibatasi oleh MAX_CREATOR_FEE_RATE = 5000 (50 bps). fee_rate (biaya platform) dibatasi pada 10000 (100 bps) oleh GlobalConfig.max_share_fee_rate.

Pembagian migrasi NFT (CPMM-only)

Ketika peluncuran lulus ke CPMM, instruksi migrasi membagi token LP yang dicetak oleh CPMM::InitializeWithPermission dua cara:

lp_to_platform = floor(lp_total × (platform_scale + creator_scale) / 1_000_000)
lp_to_burn     = lp_total − lp_to_platform

Jika lp_to_platform bukan nol, program LP-Lock membungkusnya menjadi satu Fee Key NFT yang dimiliki oleh platform_nft_wallet. Ini menggantikan perilaku pra-upgrade yang membuat Fee Key platform dan kreator terpisah. Fee Key yang dibuat oleh migrasi yang diselesaikan sebelum upgrade tetap tidak berubah. Hak fee LP ini terpisah dari biaya kreator CPMM yang dikendalikan oleh platform_cp_creator. Bagian burn dibakar langsung, jadi tidak ada akun yang dapat menariknya atau mengklaim biaya LP yang diwakili oleh bagian itu. Peluncuran yang ada dengan migrate_type = 0 yang disimpan masih dapat menggunakan jalur AMM v4 warisan. Inisialisasi baru menolak tipe migrasi itu.

Daftar putih parameter kurva

curve_params: Vec<PlatformCurveParam> adalah mekanisme platform untuk membatasi bentuk kurva mana yang dapat dipilih peluncurannya. Jika vektor tidak kosong dan setidaknya satu entri valid, program memberlakukan di Initialize bahwa parameter peluncuran cocok dengan setidaknya satu entri secara tepat.

#[derive(AnchorSerialize, AnchorDeserialize, Clone)]
pub struct PlatformCurveParam {
    pub epoch:                u64,
    pub index:                u8,           // ordinal within this platform's whitelist
    pub global_config:        Pubkey,       // which GlobalConfig this entry applies to
    pub bonding_curve_param:  BondingCurveParam,
    pub padding:              [u64; 50],
}

#[derive(AnchorSerialize, AnchorDeserialize, Clone)]
pub struct BondingCurveParam {
    pub migrate_type:               u8,    // new launches require 1 = CPMM; u8::MAX = wildcard
    pub migrate_cpmm_fee_on:        u8,    // 0 = quote-only, 1 = both. u8::MAX = wildcard
    pub supply:                     u64,   // 0 = wildcard
    pub total_base_sell:            u64,   // 0 = wildcard
    pub total_quote_fund_raising:   u64,   // 0 = wildcard
    pub total_locked_amount:        u64,   // u64::MAX = wildcard
    pub cliff_period:               u64,   // u64::MAX = wildcard
    pub unlock_period:              u64,   // u64::MAX = wildcard
}

Setiap bidang memiliki nilai sentinel yang berarti wildcard (nilai apa pun cocok): u64::MAX untuk bidang u64, u8::MAX untuk bidang u8, 0 untuk bidang pasokan / penjualan / penggalangan dana. BondingCurveParam dengan semua sentinel adalah “izinkan apa pun” — setara dengan perilaku daftar putih kosong. Algoritma pencocokan di Initialize:

Filter curve_params ke entri yang global_config-nya cocok dengan GlobalConfig pilihan peluncuran.
Jika daftar yang disaring kosong, izinkan parameter apa pun (platform tidak memasukkan daftar putih apa pun untuk GlobalConfig ini).
Jika setiap entri dalam daftar yang disaring memiliki all_is_invalid() (setiap bidang adalah wildcard), izinkan parameter apa pun.
Jika tidak, ulangi entri; untuk setiap entri, periksa parameter peluncuran terhadap setiap bidang non-wildcard. Jika semua bidang non-wildcard cocok, terima dan kembalikan.
Jika tidak ada entri yang cocok, kembalikan dengan InvalidInput.

Ini memungkinkan platform mengatakan “kami hanya mengizinkan bentuk standar 1B-pasokan / 800M-terjual / 30k-USDC-penggalangan / tanpa-vesting” dengan menulis satu entri dengan nilai konkret untuk empat bidang itu dan wildcard di tempat lain. Atau platform yang lebih ketat mungkin menghitung tiga atau empat bentuk diskrit, satu per tingkat peluncuran yang didukung. MAX_CURVE_PARAMS = 10 membatasi ukuran daftar putih.

`PlatformAllowConfig` — membatasi platform

Setiap platform memutuskan apakah akan membatasi akun GlobalConfig mana yang dapat digunakan peluncurannya. Atur restrict_global_config dengan UpdatePlatformConfig::RestrictGlobalConfig(0 | 1).

pub const PLATFORM_ALLOW_CONFIG_SEED: &str = "platform_allow_config";

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

Seed PDA: [b"platform_allow_config", platform_config, global_config]. Admin platform membuat atau menutup satu akun per pasangan yang diizinkan melalui CreatePlatformAllowConfig dan ClosePlatformAllowConfig. Ketika pembatasan adalah 1, inisialisasi mencari remaining_accounts untuk PDA yang diharapkan dan menolak akun yang hilang dengan NotEnoughRemainingAccounts. Ketika pembatasan adalah 0, tidak ada akun izin yang diperlukan. Akun PlatformGlobalAccess yang dikelola admin protokol sebelumnya dan instruksi buat/tutup-nya sudah pensiun. Ukuran PlatformConfig dan GlobalConfig yang ada tidak berubah, tetapi dekoder harus mengganti flag global lama dengan flag platform baru. PDA akses lama tidak dikonsumsi oleh pemeriksaan baru.

Jalur baca

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

console.log("Platform:", readString(platformConfig.name));
console.log("Fee rate:", platformConfig.feeRate, "(/1M)");
console.log("NFT split:",
  platformConfig.platformScale,
  platformConfig.creatorScale,
  platformConfig.burnScale,
);
console.log("Curve whitelist size:", platformConfig.curveParams.length);

Untuk UI yang menampilkan “dari mana token ini diluncurkan”, PoolState.platform_config menunjuk langsung ke PlatformConfig asal — ambil sekali dan cache branding-nya.

Jalur pembaruan

Instruksi	Siapa yang menandatangani	Apa yang berubah
`CreatePlatformConfig`	admin platform (satu kali)	Menginisialisasi akun dengan `PlatformParams`.
`UpdatePlatformConfig`	admin platform	Pengiriman generik yang dikunci oleh `param: u8`; mengubah satu bidang per panggilan. Bidang branding, tingkat biaya, dompet vesting, dan berbagai dompet semuanya dapat diatur melalui ini.
`CreatePlatformAllowConfig` / `ClosePlatformAllowConfig`	admin platform	Tambah atau hapus satu `GlobalConfig` yang diizinkan untuk platform ini.
`UpdatePlatformCurveParam`	admin platform	Tambah atau ganti satu entri `PlatformCurveParam` berdasarkan `(global_config, index)`.
`RemovePlatformCurveParam`	admin platform	Hapus satu entri (atur ke semua-sentinel = wildcard).
`ClaimPlatformFee`	`platform_fee_wallet`	Bersihkan biaya platform per-pool dari `PoolState.quote_vault`.
`ClaimPlatformFeeFromVault`	`platform_fee_wallet`	Bersihkan vault biaya per-platform (PDA di `[platform_config, quote_mint]`).

Rotasi dompet (platform_fee_wallet, platform_nft_wallet, platform_vesting_wallet, platform_cp_creator, transfer_fee_extension_auth, cpswap_config) semuanya melalui UpdatePlatformConfig. Baca tabel pengiriman update_platform_config sumber untuk kode param yang tepat.

Jebakan umum

Sentinel daftar putih salah atur. BondingCurveParam dengan total_locked_amount = 0 bukan wildcard — cocok dengan peluncuran yang secara eksplisit menolak vesting. Wildcard untuk bidang itu adalah u64::MAX. Perangkap yang sama ada untuk cliff_period dan unlock_period. Gunakan clear() (yang program paparkan) untuk mengatur sentinel dengan benar.
Pembulatan pembagian NFT. Tiga skala harus berjumlah tepat 1_000_000. Kesalahan off-by-one di CreatePlatformConfig dikembalikan; off-by-one saat runtime akan mencetak atau membakar satu unit LP ekstra, itulah yang dicegah oleh pemeriksaan kesetaraan ketat.
Alokasi ganda vesting platform. Jika platform_vesting_scale > 0, platform harus memanggil CreatePlatformVestingAccount sekali setelah penggalangan dana peluncuran berakhir; jika lupa, bagian itu tetap tidak dialokasikan dan dorman selamanya (anggaran total_locked_amount peluncuran dikonsumsi tetapi platform tidak pernah mengklaim).
Ambiguitas platform_cp_creator. Ketika diatur ke Pubkey::default(), kreator peluncuran dicatat sebagai pool_creator pool CPMM pasca-kelulusan; ketika diatur ke kunci nyata, kunci itu dicatat sebagai gantinya. Ini menentukan penerima biaya kreator CPMM pasca-kelulusan dan siapa yang dapat menandatangani jalur CPMM::CollectCreatorFee asli. Jalur pengumpulan tanpa izin masih membayar ATA kanonik kunci yang dicatat ini. Putuskan pada waktu pembuatan konfigurasi platform model mana yang Anda inginkan.
Pembatasan tanpa akun izin. Mengaktifkan restrict_global_config sebelum membuat PlatformAllowConfig yang diperlukan memblokir peluncuran baru yang memilih konfigurasi itu.

Penunjuk

products/launchlab/global-config — aturan sisi protokol yang harus dipenuhi peluncuran.
products/launchlab/vesting — mekanika platform_vesting_scale.
products/launchlab/creator-fees — biaya kreator versus hak Fee Key platform.
products/launchlab/platforms — panduan cara integrator platform.

Sumber:

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_allow_config.rs — PlatformAllowConfig.
raydium-launch/programs/launchpad/src/lib.rs — entrypoint konfigurasi platform dan allow-config.

LaunchLab

Token launch flow

Tips & Gotchas

LaunchLab PlatformConfig

Apa itu

Tata letak

Bidang branding

Mekanika biaya

Pembagian migrasi NFT (CPMM-only)

Daftar putih parameter kurva

`PlatformAllowConfig` — membatasi platform

Jalur baca

Jalur pembaruan

Jebakan umum

Penunjuk

​Apa itu

​Tata letak

​Bidang branding

​Mekanika biaya

​Pembagian migrasi NFT (CPMM-only)

​Daftar putih parameter kurva

​PlatformAllowConfig — membatasi platform

​Jalur baca

​Jalur pembaruan

​Jebakan umum

​Penunjuk

Apa itu

Tata letak

Bidang branding

Mekanika biaya

Pembagian migrasi NFT (CPMM-only)

Daftar putih parameter kurva

`PlatformAllowConfig` — membatasi platform

Jalur baca

Jalur pembaruan

Jebakan umum

Penunjuk