تعليمات LaunchLab

​

جرد التعليمات

​

Initialize

launch_params: {
    curve_type:                 u8,
    base_supply_max:            u64,
    base_supply_graduation:     u64,
    k:                          u128,              // or initial_virtual_quote_reserve for curve_type=1
    open_time:                  u64,
    quote_mint:                 Pubkey,
    base_token_metadata: {                         // inline name/symbol/uri; program CPIs to Metaplex
        name:   String,
        symbol: String,
        uri:    String,
    },
    fees: {
        buy_numerator:   u64,
        buy_denominator: u64,
        sell_numerator:  u64,
        sell_denominator: u64,
        lp_share:        u64,
        creator_share:   u64,
        protocol_share:  u64,
        total_share:     u64,
    },
    post_graduation_lp_policy:  u8,                // 0 = Burn, 1 = Lock, 2 = ToCreator
}

• quote_mint ∈ launch_config.allowed_quote_mints.
• base_supply_graduation ≤ base_supply_max.
• معاملات الرسوم تمرّ فحوصات launch_config.max_*_fee_rate.
• open_time ≥ now − slop (SDK يفرض ≥ now؛ البرنامج يتسامح مع التأخير البسيط).
• curve_type معروف.

• base_mint له supply = base_supply_max، الكل في base_vault.
• base_mint.mint_authority = launch_authority، freeze_authority = None.
• LaunchState مهيأ مع status = Active، base_sold = 0، quote_reserve_real = 0.
• quote_reserve_target محسوب من معاملات المنحنى + base_supply_graduation + buy_numerator (تقريبًا).

​

Buy (المتغير الأساسي: BuyExactIn)

quote_in:          u64
minimum_base_out:  u64

• launch_state.status == Active.
• now ≥ open_time.
• user_quote_ata.balance ≥ quote_in.
• quote_in > 0.

1. تقسيم quote_in إلى quote_in_after_fee وأجزاء الرسوم.
2. حل Newton للمنحنى لـ base_out بناءً على الاقتباس بعد الرسوم.
3. require(base_out ≥ minimum_base_out) وإلا عكس ExceededSlippage.
4. نقل quote_in من المستخدم → الخزينة. نقل base_out من الخزينة → المستخدم.
5. تحديث base_sold += base_out، quote_reserve_real += quote_in_after_fee × (lp_share / total_share).
6. تحديث عدادات الرسوم (protocol_fees_quote، creator_fees_quote).
7. state_data.num_buys += 1.
8. إذا كان quote_reserve_real ≥ quote_reserve_target بعد التحديث، يسلسل SDK عادةً تعليمة Graduate في نفس المعاملة. البرنامج لا يتخرج تلقائيًا داخل Buy — يلزم Graduate لاحق.

​

BuyExactOut

base_out:      u64
maximum_quote_in: u64

​

Sell / SellExactIn / SellExactOut

• user_base_ata.balance ≥ base_in.
• البيع لا يمكن أن يدفع base_sold تحت 0 (زائد مع المحاسبة المتسقة).
• الإطلاق هو Active.

​

MigrateToAmm / MigrateToCpswap

• MigrateToAmm — migrate_to_amm_wallet المسجل على GlobalConfig الملزم.
• MigrateToCpswap — migrate_to_cpswap_wallet المسجل على GlobalConfig الملزم.

base_lot_size:               u64
quote_lot_size:              u64
market_vault_signer_nonce:   u8

1. التحقق من pool_state.status == Migrate (أي تم الوصول إلى quote_reserve_target). وإلا عكس مع PoolMigrated (كانت الحالة بالفعل Migrated) أو PoolFunding (لا تزال في التمويل).
2. التحقق من أن pool_state.migrate_type يطابق التعليمة (0 لـ AMM، 1 لـ CPMM). وإلا عكس مع MigrateTypeNotMatch.
3. حساب الاحتياطيات بعد التخرج:
   • base_amount_out = base_vault.amount − vesting_schedule.total_locked_amount
   • quote_amount_out = quote_vault.amount − quote_protocol_fee − migrate_fee − platform_fee
4. CPI إلى برنامج الهدف (AMM v4 Initialize2 أو CPMM InitializeWithPermission) مع تلك الاحتياطيات لإنشاء مجموعة ما بعد التخرج.
5. لهجرات CPMM المنفذة بعد ترقية 2026-08-17، دمج platform_scale + creator_scale في حصة LP مقفلة مملوكة للمنصة واحدة وضرب على الأكثر مفتاح رسوم NFT واحد إلى platform_nft_wallet. حرق بقية burn_scale. قبل الترقية، كان creator_scale مقفلاً بشكل منفصل وذهب مفتاح الرسوم الخاص به إلى منشئ الرمز. الهجرات التاريخية المكتملة لم تُعدّل. لتخرج AMM v4 القديم، يتبع توزيع LP تدفق التعليمة الموجود.
6. إلغاء base_mint.mint_authority (تعيين إلى None).
7. قلب pool_state.status = Migrated، تعيين vesting_schedule.start_time = block_time + cliff_period.

​

حسابات CPMM المتبقية للهجرة

​

قائمة السماح GlobalConfig للمنصة

• 0: تقبل المنصة أي GlobalConfig صحيح بخلاف ذلك؛ لا يلزم حساب السماح.
• 1: يجب أن تتضمن Initialize و InitializeV2 و InitializeWithToken2022 PlatformAllowConfig المطابق في أي مكان في remaining_accounts.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

تعليمات الاستحقاق وإعدادات المنصة

• CreateVestingAccount, CreatePlatformVestingAccount, ClaimVestedToken
• CreatePlatformConfig, UpdatePlatformConfig, UpdatePlatformCurveParam, RemovePlatformCurveParam, CreatePlatformAllowConfig, ClosePlatformAllowConfig
• CreateConfig, UpdateConfig

​

مصفوفة تغيير الحالة

​

أين تذهب بعد ذلك

• products/launchlab/code-demos — أمثلة TypeScript لكل تعليمة.
• products/launchlab/accounts — شكل الحالة الكامل.
• reference/error-codes — تعداد خطأ LaunchLab.

• وحدة Raydium SDK v2 LaunchLab
• مصدر برنامج Raydium LaunchLab