LaunchLab PlatformConfig

​

ما هو

1. العلامة التجارية — الاسم، الموقع الإلكتروني، رابط الصورة، كل شيء مخزن بشكل مضمن بحيث يمكن لأي مستكشف أو معالج بيانات عرض المنصة التي أطلقت الرمز.
2. رسم المنصة — رسم تداول إضافي (fee_rate) بالإضافة إلى trade_fee_rate الخاص بالبروتوكول. يتراكم في platform_fee_wallet الخاص بالمنصة. محدود بـ 500 bps (50000) على كل من مسار الإنشاء والتحديث، تم رفعه من 100 bps (10000) في 2026-08-26 — انظر حدود الأسعار.
3. تقسيم هجرة LP — ثلاثة أعداد صحيحة مخزنة (platform_scale, creator_scale, burn_scale) تجمع إلى 1_000_000. قبل ترقية 2026-08-17، أنتج مقياس المنشئ مفتاح رسم منفصل للمنشئ. الهجرات المنفذة بعد الترقية تجمع الاثنين الأولين في حصة LP مقفلة واحدة مملوكة للمنصة؛ الباقي يتم حرقه.
4. قواعد معاملات الإطلاق — تقييد اختياري (restrict_curve_param) يتطلب من الإطلاق تلبية حساب PlatformCurveRule الخاص بـ GlobalConfig الذي اختاره. تدعم القواعد نطاقات القيم والمستويات البديلة والبوابات من نوع الرمز؛ تعيش في حساباتها الخاصة، وليس على PlatformConfig.
5. قائمة المسموح بها للتكوين العام — تقييد اختياري يتطلب من المنصة إنشاء PlatformAllowConfig لـ GlobalConfig المختار.

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

​

التخطيط

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

#[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: withdraw-withheld authority from mint creation, fee-config authority from 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 restrict_curve_param:        u8,                // 0 = unrestricted, 1 = enforce the PlatformCurveRule
    pub curve_rule_manager:          Pubkey,            // hot wallet allowed to manage rule accounts
    pub padding:                     [u8; 78],
}

• (0, 100_000, 900_000) — 90% LP محروق، 10% مقفول للمنصة.
• (50_000, 100_000, 850_000) — 85% محروق، 15% مقفول للمنصة.
• (0, 0, 1_000_000) — حرق كامل، لا توجد عملات NFT. عمليات إطلاق صارمة “بدون مطلعين”.

​

حقول العلامة التجارية

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

​

ميكانيكا الرسوم

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

​

حدود الأسعار

​

سلطات رسم نقل Token-2022

• اضبط الحقل قبل الإطلاق، وليس بعده. إطلاق تم إنشاؤه بينما transfer_fee_extension_auth هو Pubkey::default() يضع PDA authority على جانب السحب. تعيين الحقل لاحقاً لا يزال يعمل — التخرج يجد PDA في مكانه ويسلم السلطة — لكن لا شيء يمكنه سحب الرصيد المحتفظ به في الوقت الفاصل.
• تدوير الحقل في منتصف الإطلاق يقسم السلطتين. غير transfer_fee_extension_auth بين إنشاء الإطلاق وتخرجه وسلطة السحب المحتفظ بها في mint تبقى مع المفتاح المكون عند الإنشاء (PDA لم تعد تحتفظ به، لذا تخطي الهجرة هذا التسليم) بينما تذهب سلطة تكوين الرسم إلى المفتاح الجديد. قم بالتدوير بين عمليات الإطلاق، أو خطط للتوفيق بين المفتاحين بنفسك من خلال Token-2022 مباشرة.

​

تقسيم هجرة NFT (CPMM فقط)

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

​

قواعد معاملات الإطلاق

pub restrict_curve_param: u8,   // 0 = unrestricted, 1 = enforce the rule of the used config
pub curve_rule_manager:   Pubkey, // may manage rule accounts; the platform admin always may too

• curve_rule_manager هو تفويض، وليس نقل. اضبطه من خلال UpdatePlatformConfig::CurveRuleManager وهذا المحفظة يمكنها إنشاء وتحديث وإزالة وإغلاق حسابات القواعد الخاصة بهذه المنصة دون مفتاح المسؤول. يحتفظ مسؤول المنصة بنفس القوة بالتوازي، لذا فإن تدوير أو مسح الحقل يستعيد التحكم. Pubkey::default() يعني أن المسؤول فقط يمكنه إدارة القواعد. لا يمكنه تبديل restrict_curve_param، الذي يبقى استدعاء مسؤول فقط.
• يتم فرض القواعد على GlobalConfig، وليس بدلاً منها. يتم تشغيل فحص القاعدة قبل حدود التكوين الخاصة به ويمكنه فقط تضييقها.

​

PlatformAllowConfig — تقييد منصة

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

​

مسار القراءة

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("Restrict launch params:", platformConfig.restrictCurveParam);
console.log("Rule manager:", platformConfig.curveRuleManager.toBase58());

​

مسار التحديث

​

الأخطاء الشائعة

• restrict_curve_param مفعل قبل تحديث المنشئ. بينما هو 1 يجب أن يكون PDA القاعدة في remaining_accounts على كل إطلاق، حتى بالنسبة لتكوين بدون حساب قاعدة — حساب غائب هو NotEnoughRemainingAccounts، وليس تمرير. شحن تغيير المنشئ أولاً، ثم اقلب العلم.
• restrict_curve_param مفعل مع قاعدة فارغة. قاعدة تحتفظ بمجموعات صفرية، أو مجموعة تحتفظ بقيود صفرية، تسمح بكل شيء. تفعيل العلم ليس بحد ذاته تقييداً؛ اكتب المجموعات أولاً، تحقق منها مع فحص SDK، وتدرب على التسلسل كله على devnet.
• تقريب تقسيم NFT. يجب أن تجمع المقاييس الثلاثة إلى 1_000_000 بالضبط. أخطاء قبالة واحد في CreatePlatformConfig تعود؛ قبالة واحد في وقت التشغيل ستسك أو تحرق وحدة LP إضافية واحدة، وهذا ما يوجد فحص المساواة الصارمة لمنعه.
• تخصيص استحقاق منصة مزدوج. إذا كان platform_vesting_scale > 0، يجب على المنصة استدعاء CreatePlatformVestingAccount مرة واحدة بعد انتهاء جمع أموال الإطلاق؛ إذا نسيت، تبقى تلك الحصة غير مخصصة وخاملة إلى الأبد (ميزانية total_locked_amount الخاصة بالإطلاق يتم استهلاكها لكن المنصة لا تطالب أبداً).
• غموض platform_cp_creator. عند التعيين إلى Pubkey::default()، يتم تسجيل منشئ الإطلاق كـ pool_creator لمجموعة CPMM بعد التخرج؛ عند التعيين إلى مفتاح حقيقي، يتم تسجيل هذا المفتاح بدلاً من ذلك. هذا يحدد المستفيد من رسوم منشئ CPMM بعد التخرج ومن يمكنه توقيع مسار CPMM::CollectCreatorFee الأصلي. مسار الجمع بدون إذن لا يزال يدفع ATAs الموثوقة للمفتاح المسجل. قرر في وقت إنشاء تكوين المنصة أي نموذج تريد.
• transfer_fee_extension_auth تعيين متأخر أو تدوير. يتم قراءة الحقل مرتين لكل إطلاق Token-2022 — مرة عند إنشاء mint لـ withdraw_withheld_authority، مرة عند التخرج لـ transfer_fee_config_authority — لذا فإن قيمة تتغير بين هاتين اللحظتين تترك السلطتين على مفاتيح مختلفة. انظر سلطات رسم نقل Token-2022.
• تقييد بدون حساب سماح. تفعيل restrict_global_config قبل إنشاء PlatformAllowConfig المطلوب يحجب عمليات الإطلاق الجديدة التي تختار هذا التكوين.

​

مؤشرات

• products/launchlab/global-config — قواعس جانب البروتوكول يجب أن يفي بها الإطلاق.
• products/launchlab/vesting — ميكانيكا platform_vesting_scale.
• products/launchlab/creator-fees — رسوم المنشئ مقابل حقوق مفتاح الرسم للمنصة.
• products/launchlab/platforms — دليل متكامل منصة.

• raydium-launch/programs/launchpad/src/states/platform_config.rs — PlatformConfig, PlatformParams, MigrateNftInfo, is_curve_rule_manager, is_platform_admin.
• raydium-launch/programs/launchpad/src/states/platform_curve_rule.rs — PlatformCurveRule, CurveRuleGroup, ParamConstraint.
• raydium-launch/programs/launchpad/src/states/platform_allow_config.rs — PlatformAllowConfig.
• raydium-launch/programs/launchpad/src/instructions/platform/update_platform_config.rs — إرسال PlatformConfigParam والمعينات لكل حقل التي تفرض حدود معدل وقت التحديث.
• raydium-launch/programs/launchpad/src/lib.rs — نقاط دخول تكوين المنصة والسماح بالتكوين.
• raydium-launch/programs/launchpad/src/instructions/initialize_with_token_2022.rs — حيث يتم كتابة transfer_fee_extension_auth في TransferFeeConfig الخاص بـ mint الجديد.
• raydium-launch/programs/launchpad/src/instructions/admin/migrate_to_cpswap.rs — تسليم السلطة في وقت التخرج وحارسها get_withdraw_withheld_authority.