LaunchLab PlatformConfig

​

Nedir

1. Markalama — ad, web sitesi, resim bağlantısı; tümü satır içi depolanır, böylece herhangi bir explorer veya toplayıcı, bir token’ı başlatan platformu gösterebilir.
2. Platform ücreti — protokolün trade_fee_rate’inin üzerine ek bir işlem ücreti (fee_rate). Platform’un platform_fee_wallet’ine tahakkuk eder. GlobalConfig.max_share_fee_rate tarafından 100 bps ile sınırlandırılır.
3. LP geçiş bölüşümü — üç depolanan tam sayı (platform_scale, creator_scale, burn_scale) toplamı 1_000_000’e eşittir. 2026-08-17 yükseltmesinden önce, creator ölçeği ayrı bir creator Fee Key’i üretiyordu. Yükseltmeden sonra yürütülen geçişler ilk ikisini platform’a ait kilitli LP payına birleştirir; geri kalan yakılır.
4. Eğri parametresi beyaz listesi — bu platformda izin verilen tam olarak hangi (supply, total_base_sell, total_quote_fund_raising, migrate_type, migrate_cpmm_fee_on, vesting_params...) kombinasyonlarını listeleyen bir Vec<PlatformCurveParam>. Vektör boşsa veya tüm girişler geçersizse, herhangi bir kombinasyon izin verilir; aksi takdirde başlatmalar tam olarak bir girişle eşleşmelidir.
5. Global-config beyaz listesi — seçilen GlobalConfig için platform tarafından oluşturulan bir PlatformAllowConfig gerektiren isteğe bağlı bir kısıtlama.

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

​

Düzen

// 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
}

• (0, 100_000, 900_000) — %90 LP yakılır, %10 platform’a kilitlenir.
• (50_000, 100_000, 850_000) — %85 yakılır, %15 platform’a kilitlenir.
• (0, 0, 1_000_000) — tam yakma, NFT mint yok. Katı “içeriden kimse yok” başlatmaları.

​

Markalama alanları

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

​

Ücret mekaniği

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 protokolün protocol_fee_owner’ına tahakkuk eder (CollectFee aracılığıyla talep edilir).
• platform_fee platform başına bir kasaya tahakkuk eder (ClaimPlatformFee veya ClaimPlatformFeeFromVault aracılığıyla talep edilir; instructions bölümüne bakın).
• creator_fee yaratıcının pubkey’i + quote mint tarafından anahtarlanan yaratıcı başına bir kasaya tahakkuk eder (ClaimCreatorFee aracılığıyla talep edilir).

​

NFT geçiş bölüşümü (yalnızca CPMM)

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

​

Eğri parametresi beyaz listesi

#[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
}

1. curve_params’ı global_config’i başlatmanın seçilen GlobalConfig’i ile eşleşen girişlere filtreleyin.
2. Filtrelenmiş liste boşsa, herhangi bir parametreye izin verin (platform bu GlobalConfig için hiçbir şeyi beyaz listelemedi).
3. Filtrelenmiş listedeki her girişin all_is_invalid() varsa (her alan joker), herhangi bir parametreye izin verin.
4. Aksi takdirde girişleri yineleyin; her girişi için, başlatmanın parametrelerini her joker olmayan alana karşı kontrol edin. Tüm joker olmayan alanlar eşleşirse, kabul edin ve dönün.
5. Hiçbir girişi eşleşmezse, InvalidInput ile geri döndürün.

​

PlatformAllowConfig — bir platformu kısıtlama

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],
}

​

Okuma yolu

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);

​

Güncelleme yolu

​

Yaygın tuzaklar

• Beyaz liste sentinel’leri yanlış ayarlanmış. total_locked_amount = 0 olan bir BondingCurveParam joker değildir — vesting’i açıkça devre dışı bırakan başlatmalarla eşleşir. Bu alan için joker u64::MAX’tır. Aynı tuzak cliff_period ve unlock_period için de vardır. Sentinel’leri doğru ayarlamak için clear() kullanın (programın açığa çıkardığı).
• NFT-bölüşüm yuvarlama. Üç ölçek tam olarak 1_000_000’e toplanmalıdır. CreatePlatformConfig’de bir hata geri döner; çalışma zamanında bir hata ekstra bir LP birimi mint veya yakardı, bu da katı eşitlik kontrolünün orada olmasının nedenidir.
• Platform vesting çift tahsisi. platform_vesting_scale > 0 ise, platform başlatmanın bağış toplama sona erdikten sonra bir kez CreatePlatformVestingAccount çağırmalıdır; unutursa, bu pay tahsis edilmemiş ve sonsuza kadar hareketsiz kalır (başlatmanın total_locked_amount bütçesi tüketilir ancak platform asla talep etmez).
• platform_cp_creator belirsizliği. Pubkey::default() olarak ayarlandığında, başlatma yaratıcısı mezuniyet sonrası CPMM havuzunun pool_creator’ü olarak kaydedilir; gerçek bir anahtara ayarlandığında, o anahtar bunun yerine kaydedilir. Bu, mezuniyet sonrası CPMM yaratıcı ücretlerinin yararlanıcısını ve orijinal CPMM::CollectCreatorFee yolunu imzalayabilecek kişiyi belirler. İzinsiz koleksiyon yolu hala bu kaydedilen anahtarın kanonik ATA’larını öder. Platform-config oluşturma zamanında hangi modeli istediğinize karar verin.
• İzin hesabı olmadan kısıtlama. restrict_global_config’i gerekli PlatformAllowConfig’i oluşturmadan etkinleştirmek, bu config’i seçen yeni başlatmaları engeller.

​

İşaretçiler

• products/launchlab/global-config — bir başlatmanın karşılaması gereken protokol tarafı kuralları.
• products/launchlab/vesting — platform_vesting_scale mekaniği.
• products/launchlab/creator-fees — yaratıcı ücretleri versus platform Fee Key hakları.
• products/launchlab/platforms — platform entegratörü nasıl yapılır.

• 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 — platform config ve allow-config giriş noktaları.