LaunchLab GlobalConfig

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

ما هو

• نوع منحنى الربط المسموح به (curve_type).
• معدل رسوم التداول الذي يفرضه المنحنى على كل عملية شراء وبيع.
• رسوم الهجرة المفروضة عند التخرج.
• حدود دنيا على العرض ومعدل القفل ومعدل البيع ومعدل الهجرة.
• عملة الاقتباس (عادة SOL المرقومة أو USDC) — الأصل الذي يشتري به المستخدمون.
• ثلاث محافظ على جانب البروتوكول: مالك رسوم البروتوكول، مالك رسوم الهجرة، ومحفظتا التحكم في الهجرة اللتان تصرحان بالتخرج إلى AMM v4 / CPMM.
• علم اختياري (requires_platform_auth) يتحكم في المنصات التي يمكنها استخدام هذا الإعداد.

​

التخطيط

// 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 requires_platform_auth:  u8,          // 0/1 flag
    pub padding_alignment:       [u8; 7],
    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 (التخرج إلى AMM v4 + OpenBook).
• migrate_to_cpswap_wallet — يجب أن يوقع MigrateToCpswap. يُستخدم لـ migrate_type = 1 (التخرج إلى CPMM). تأخذ إطلاقات Token-2022 هذا المسار دائمًا.

​

requires_platform_auth

​

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

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;
self.requires_platform_auth = 0;

​

كيف يختار إطلاق 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.
• إذا كان requires_platform_auth != 0، يتم تضمين PDA PlatformGlobalAccess صحيح.

​

مسار التحديث

​

قراءة 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.