LaunchLab GlobalConfig

​

ما هو

• نوع منحنى الربط المسموح به (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 platform 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). يحدّ معدل رسوم حصة المنصة من PlatformConfig الملزم (انظر platform-config). يفرض البرنامج 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) مختلفًا.
• protocol_fee_owner — مفتاح عام يوقع CollectFee ويطالب برسوم البروتوكول المتراكمة على كل إطلاق مرتبط بهذا التكوين. مخزن على السلسلة؛ يمكن للمسؤول تدويره عبر UpdateConfig.
• migrate_fee_owner — مفتاح عام يوقع CollectMigrateFee.

​

محافظ الهجرة

• migrate_to_amm_wallet — توقع MigrateToAmm لإطلاق قديم موجود يحتوي على migrate_type = 0 المخزن.
• migrate_to_cpswap_wallet — توقع MigrateToCpswap. كل إطلاق مهيأ حديثًا يستخدم هذا المسار.

​

قوائم المسموح على جانب المنصة

​

الافتراضيات عند التهيئة

self.max_share_fee_rate     = 10_000;                  // 100 bps
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) لاختيار PDA GlobalConfig الذي سيتم تحميله.
• 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.