GlobalConfig في LaunchLab

​

ما هو

• نوع منحنى الربط المسموح به (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 — رسم ثابت بالـ lamports (أو وحدات الاقتباس، حسب التكوين) يُفرض مرة واحدة عند التخرج. يطالب به 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 و UpdateConfig يفرضان trade_fee_rate + max_share_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) لاختيار أي GlobalConfig PDA يتم تحميله.
• 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,
);

const config = await raydium.launchpad.getGlobalConfig(configPda);
console.log(config.tradeFeeRate, config.minQuoteFundRaising);

​

مؤشرات

• products/launchlab/platform-config — طبقة تراكب لكل منصة تحدّ شكل المنحنى بشكل أكبر.
• products/launchlab/accounts — الرسم البياني الكامل للحسابات لإطلاق.
• products/launchlab/instructions — تعليمات Initialize والتحديث.
• reference/program-addresses — مفتاح المسؤول، معرف البرنامج، السلطات المشتركة.

• raydium-launch/programs/launchpad/src/states/config.rs — هيكل GlobalConfig و initialize.
• raydium-launch/programs/launchpad/src/lib.rs — create_config، update_config.