تعليمات LaunchLab

​

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

​

Initialize

base_mint_param: MintParams {
    decimals: u8,                 // must equal the program's BASE_MINT_DECIMALS
    name:     String,
    symbol:   String,
    uri:      String,
}

curve_param: CurveParams {        // Borsh enum — one leading variant-tag byte
    Constant { data: ConstantCurve { supply: u64, total_base_sell: u64,
                                     total_quote_fund_raising: u64, migrate_type: u8 } },
    Fixed    { data: FixedCurve    { supply: u64,
                                     total_quote_fund_raising: u64, migrate_type: u8 } },
    Linear   { data: LinearCurve   { supply: u64,
                                     total_quote_fund_raising: u64, migrate_type: u8 } },
}

vesting_param: VestingParams {
    total_locked_amount: u64,     // 0 requires cliff_period == unlock_period == 0
    cliff_period:        u64,     // seconds after fundraising ends
    unlock_period:       u64,     // seconds
}

amm_fee_on: AmmCreatorFeeOn       // 0 = QuoteToken, 1 = BothToken (CPMM migrations only)

• 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 = curve_param.supply، الكل في base_vault.
• تُلغى سلطة الصك في هذه التعليمة نفسها (set_authority(MintTokens, None)) مباشرة بعد صك العرض — وليس عند التخرج. لذا فإن عملة الأساس ثابتة العرض بشكل دائم، ولا يمكن لأي تعليمة لاحقة صك المزيد.
• PoolState مهيأ مع status = Fund (0)، real_a = 0، real_b = 0.
• total_fund_raising_b يأتي مباشرة من curve_param.total_quote_fund_raising.
• لـ InitializeWithToken2022 مع TransferFeeConfig مرفق: transfer_fee_config_authority = launch_authority، و withdraw_withheld_authority = PlatformConfig.transfer_fee_extension_auth عندما يتم تعيين هذا الحقل، وإلا launch_authority. يتم كتابة جانب السحب عند إنشاء العملة بالضبط حتى تتمكن المنصة من مسح الرسوم المحتفظ بها قبل التخرج. انظر platform-config.

​

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

amount_in:           u64
minimum_amount_out:  u64
share_fee_rate:      u64   // referral fee on a 1_000_000 denominator; must be
                           // <= global_config.max_share_fee_rate. Pass 0 for no
                           // referral. Any non-zero value requires the share-fee
                           // receiver as remaining_accounts[0].

1. share_fee_receiver — فقط عندما share_fee_rate > 0.
2. system_program — دائمًا؛ يُفحص أنه == System::id()، وإلا InvalidInput.
3. platform_fee_vault — PDA [platform_config, quote_token_mint]؛ يُنشأ عند أول استخدام.
4. creator_fee_vault — PDA [creator, quote_token_mint]؛ يُنشأ عند أول استخدام.

• 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 ix في نفس المعاملة. البرنامج لا يتخرج تلقائيًا داخل Buy — يلزم Graduate لاحق.

​

BuyExactOut

amount_out:         u64
maximum_amount_in:  u64
share_fee_rate:     u64   // as for BuyExactIn

​

Sell / SellExactIn / SellExactOut

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

​

رسوم نقل جانب الاقتباس

• يتم رفض حد محسوب كما لو كانت العملة خالية من الرسوم. تمرير التكلفة الخالية من الرسوم كـ maximum_amount_in، أو العائدات الخالية من الرسوم كـ minimum_amount_out، ينعكس مع ExceededSlippage.
• real_quote يتقدم فقط بما وصل إلى الخزان. BuyExactIn من amount_in على عملة اقتباس 5٪ ينقل real_quote بـ amount_in × 0.95.

​

حسابات التداول المتبقية

​

MigrateToAmm / MigrateToCpswap

• MigrateToAmm — migrate_to_amm_wallet المسجل على ربط GlobalConfig.
• MigrateToCpswap — migrate_to_cpswap_wallet المسجل على ربط GlobalConfig.

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.

• يتم إعادة تعيين transfer_fee_config_authority دائمًا. يحتفظ بها PDA authority الإطلاق لمرحلة ما قبل التخرج بأكملها، لذا هناك دائمًا شيء للنقل.
• يتم إعادة تعيين WithheldWithdraw فقط عندما يحتفظ بها PDA authority لا تزال. الإطلاقات التي تم إنشاؤها من 2026-08-27 فصاعدًا تحمل بالفعل transfer_fee_extension_auth على تلك السلطة من إنشاء العملة، لذا يتم تخطي الخطوة. الحراسة هي ما يمنع الهجرة من الانعكاس على تلك العملات — لا يمكن لـ PDA التوقيع على سلطة لم تعد تحتفظ بها.

​

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

​

برامج رمز هجرة CPMM

​

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

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

​

قواعد معاملات الإطلاق للمنصة

• Create يخصص الحساب الذي لا يحتوي على مجموعة. تلك الحالة لا تقيد أي شيء.
• Update يدرج المجموعة مع group_id ذلك، مستبدلاً بالكامل إذا كانت موجودة. يعيد حجم الحساب ليناسب، لذا يضيف الموقّع الإيجار الذي ينمو به ويتلقى الإيجار الذي ينكمش به. مجموعة جديدة تتجاوز العاشرة تُرجع CurveRuleGroupsExceeded؛ أكثر من 25 قيد، حقل غير معروف أو عامل، أو نفس زوج (field, op) مرتين في مجموعة واحدة تُرجع InvalidCurveRuleConstraint؛ الحقول الأربعة المشتقة من TotalSellA على إعدادات غير ثابتة الناتج تُرجع CurveRuleFieldNotSupportedByCurve.
• Remove يسقط مجموعة واحدة حسب المعرّف، ينكمش الحساب ويسترد الفرق. معرّف غير معروف يُرجع CurveRuleGroupNotExist.
• Close يعيد الإيجار بالكامل إلى الموقّع. الإعدادات غير مقيدة بعد ذلك حتى عندما يبقى restrict_curve_param 1.

​

CollectFee

​

CollectMigrateFee

​

ClaimCreatorFee

​

ClaimPlatformFee

​

ClaimPlatformFeeFromVault

​

CollectExcessLamports