حسابات LaunchLab

هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.عرض النسخة الإنجليزية →

توثق هذه الصفحة رسم البياني للحسابات لكل إطلاق: PoolState (حساب الحالة الجذري لإطلاق واحد)، وخزائنه الاثنتان، وسلطة PDA، والمراجع اللاحقة للتخرج التي يكتسبها عند استقرار الإطلاق.للحصول على الإعدادات على مستوى البروتوكول التي تحد من كل إطلاق، انظر products/launchlab/global-config. للحصول على الطبقة الإضافية لكل منصة، انظر products/launchlab/platform-config. لحسابات الاستحقاق (VestingSchedule على PoolState، VestingRecord لكل مستفيد)، انظر products/launchlab/vesting.

جرد الحسابات

الحساب	المالك	الغرض
`GlobalConfig`	برنامج LaunchLab	قواعد على مستوى البروتوكول: الرسوم، حدود العرض، محافظ الهجرة. واحد لكل `(curve_type, index)`.
`PlatformConfig`	برنامج LaunchLab	طبقة إضافية لكل منصة: العلامات التجارية، رسوم المنصة، تقسيم NFT عند التخرج، قائمة بيضاء لشكل المنحنى.
`PoolState`	برنامج LaunchLab	حالة جذر كل إطلاق: النعناعات، الخزائن، معاملات المنحنى، عدادات المبيعات، عدادات الرسوم، جدول الاستحقاق، حالة التخرج.
`authority`	برنامج LaunchLab	PDA واحد في البذرة `[b"vault_auth_seed"]` يمتلك الخزائن عبر جميع الإطلاقات ويوقع CPI بعد التخرج.
`base_vault`	SPL Token / Token-2022	خزانة لكل إطلاق تحتفظ بالرموز الأساسية غير المباعة.
`quote_vault`	SPL Token	خزانة لكل إطلاق تحتفظ برموز الاقتباس المتراكمة.
`VestingRecord`	برنامج LaunchLab	سجل الجرف + فتح خطي لكل مستفيد. اختياري.
`creator_fee_vault`	SPL Token	خزانة لكل منشئ + لكل نعناع اقتباس تحتفظ برسوم المنشئ المتراكمة، يتم مسحها بواسطة `ClaimCreatorFee`.
`platform_fee_vault`	SPL Token	خزانة لكل منصة + لكل نعناع اقتباس تحتفظ برسوم المنصة المتراكمة، يتم مسحها بواسطة `ClaimPlatformFeeFromVault`.
`PlatformAllowConfig`	برنامج LaunchLab	إذن اختياري يدار من قبل المنصة لزوج واحد `(PlatformConfig, GlobalConfig)`. يتم التحقق منه فقط عندما تفعل المنصة التقييد.
(بعد التخرج) `cpmm_pool_state`	برنامج CPMM	مجموعة تم إنشاؤها بواسطة `MigrateToCpswap` لكل إطلاق جديد. يمكن للحالة القديمة أن تشير إلى تخرج AMM v4 القديم.
(بعد التخرج) Fee Key NFT	برنامج LP-Lock	قبل ترقية 2026-08-17، يمكن لمقاييس المنصة والمنشئ أن تنتج مفاتيح رسوم منفصلة. الهجرات المنفذة بعد ذلك تجمع كلا المقياسين في مفتاح رسوم منصة واحد.

يعيد raydium.launchpad.getLaunchById من SDK PoolState بالإضافة إلى علم يشير إلى ما إذا كان الإطلاق قد تخرج؛ إذا كان الأمر كذلك، يتم تضمين معرف المجموعة بعد الهجرة.

`PoolState`

حالة الجذر لكل إطلاق. أسماء الحقول أدناه تطابق بنية Rust على السلسلة (states/pool.rs)؛ تم تبسيط بعض القيم لسهولة القراءة — استشر المصدر للحصول على تخطيط الذاكرة الدقيق.

// states/pool.rs (abridged)
pub struct PoolState {
    pub epoch:                     u64,        // recent_epoch tracker
    pub auth_bump:                 u8,
    pub status:                    u8,         // PoolStatus enum
    pub base_decimals:             u8,
    pub quote_decimals:            u8,
    pub migrate_type:              u8,         // 0 = AMM v4, 1 = CPMM
    pub supply:                    u64,        // total base tokens (no decimals)
    pub total_base_sell:           u64,        // base supply allocated to the curve
    pub virtual_base:              u64,        // virtual-reserve seed
    pub virtual_quote:             u64,        // virtual-reserve seed
    pub real_base:                 u64,        // base sold so far
    pub real_quote:                u64,        // quote raised so far (excl. fees)
    pub total_quote_fund_raising:  u64,        // graduation threshold in quote

    pub quote_protocol_fee:        u64,        // accrued, pending CollectFee
    pub platform_fee:              u64,        // accrued, pending ClaimPlatformFee
    pub migrate_fee:               u64,        // accrued, pending CollectMigrateFee
    pub vesting_schedule:          VestingSchedule,

    pub global_config:             Pubkey,
    pub platform_config:           Pubkey,
    pub creator:                   Pubkey,
    pub base_mint:                 Pubkey,
    pub quote_mint:                Pubkey,
    pub base_vault:                Pubkey,
    pub quote_vault:               Pubkey,

    pub amm_creator_fee_on:        u8,         // 0 = QuoteToken, 1 = BothToken (CPMM-only)
    pub token_program_flag:        u8,         // bit flags for SPL Token vs Token-2022
    pub padding:                   [u8; 54],
}

#[derive(Default, Debug, Clone)]
pub struct VestingSchedule {
    pub total_locked_amount:    u64,
    pub cliff_period:           u64,
    pub unlock_period:          u64,
    pub start_time:             u64,           // set at graduation
    pub allocated_share_amount: u64,           // running sum across VestingRecords
}

قيم PoolStatus (من Anchor IDL):

= Funding         — accepting buys / sells; below quote_reserve_target
= Migrate         — quote_reserve_target reached; awaiting MigrateTo*
= Migrated        — MigrateTo* already executed; vesting clock running

الحقول الموجهة للمدمج:

status — ثلاث قيم، رتيبة (Funding → Migrate → Migrated). القراءات آمنة دائماً؛ الكتابات مبوابة.
real_base, real_quote — حالة المنحنى الحالية. مع virtual_base / virtual_quote فهي كافية لحساب سعر الفورية دون لمس الخزائن. انظر bonding-curve.
total_base_sell مقابل real_base — نسبة “التقدم نحو التخرج” لواجهات المستخدم.
migrate_type — يتطلب التهيئة الجديدة 1 (CPSWAP). يبقى 0 المخزن ذا معنى فقط لإطلاق موجود تم إنشاؤه قبل فرض CPMM فقط.
amm_creator_fee_on — يختار creator_fee_on = OnlyQuoteToken (0) أو BothToken (1) على مجموعة CPMM بعد التخرج. لا يختار هدف الهجرة. انظر creator-fees.
quote_protocol_fee / platform_fee / migrate_fee — ثلاثة عدادات رسوم مستقلة. لكل منها تعليمة مطالبة خاصة بها؛ انظر instructions.
vesting_schedule — موجود على كل PoolState لكن غير نشط عندما total_locked_amount == 0. انظر vesting للدورة الحياة الكاملة.

سلطة PDA

يستخدم LaunchLab سلطة PDA واحدة عبر جميع الإطلاقات، مشتقة بدون بذرة لكل إطلاق:

const LAUNCHLAB_PROGRAM_ID = new PublicKey("<LAUNCHLAB_ID>"); // see reference/program-addresses

const [authority, bump] = PublicKey.findProgramAddressSync(
  [Buffer.from("vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

هذا PDA الواحد هو:

السلطة على كل base_vault و quote_vault لإطلاق.
mint_authority على كل base_mint لإطلاق (قبل التخرج).
الموقع على CPI التخرج CPMM، وعلى التخرج AMM v4 القديم للحالة الموجودة.
الموقع على تحويلات ClaimVestedToken خارج الخزانة الأساسية.

يتم إلغاء mint_authority فوراً بعد استدعاء MigrateToCpswap أو استدعاء MigrateToAmm القديم، لذا يتم إصلاح العرض بشكل دائم. يحرس PDA إضافيان خزائن الرسوم:

const [creatorFeeVaultAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("creator_fee_vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

const [platformFeeVaultAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("platform_fee_vault_auth_seed")],
  LAUNCHLAB_PROGRAM_ID,
);

يوقعان التحويل خارج خزائن الرسوم المقابلة أثناء ClaimCreatorFee و ClaimPlatformFeeFromVault.

النعناع الأساسي

تم إنشاؤه بشكل مضمن بواسطة Initialize مع:

mint_authority = authority (ملغى عند التخرج).
freeze_authority = None.
supply = supply، مصكوك بالكامل في base_vault.
decimals اختاره المنشئ في Initialize (عادة 6).

نظراً لأن العرض الكامل مصكوك مسبقاً، فإن base_mint.supply ثابت طوال حياة الإطلاق. تحريكات المنحنى تنقل الرموز من base_vault إلى المشتري، لكنها لا تستدعي mint_to. ينشئ Initialize / InitializeV2 إطلاقات SPL Token. تسمح التعليمة المخصصة InitializeWithToken2022 بأن يكون النعناع الأساسي نعناع Token-2022 (مع TransferFeeConfig اختياري)؛ النعناع الاقتباسي لا يزال SPL Token. تتطلب جميع مسارات التهيئة الثلاثة تخرج CPMM.

الخزائن

كل من base_vault و quote_vault حسابات SPL Token قياسية مملوكة لـ LaunchLab authority PDA. يتم تخزين العناوين على PoolState ويمكن أيضاً اشتقاقها:

const [baseVault] = PublicKey.findProgramAddressSync(
  [Buffer.from("pool_vault"), poolState.toBuffer(), baseMint.toBuffer()],
  LAUNCHLAB_PROGRAM_ID,
);
const [quoteVault] = PublicKey.findProgramAddressSync(
  [Buffer.from("pool_vault"), poolState.toBuffer(), quoteMint.toBuffer()],
  LAUNCHLAB_PROGRAM_ID,
);

(تحقق من بادئات البذور الدقيقة من بنية حسابات Initialize في المصدر قبل الاعتماد على الاشتقاق في الإنتاج.)

خزائن الرسوم

يجمع PDA اثنان الرسوم عبر الإطلاقات:

خزانة رسوم المنشئ — PDA في البذور [creator, quote_mint]. كل إطلاق يكسب نفس رسوم المنشئ على نفس النعناع الاقتباسي يصب في نفس الخزانة. يقوم المنشئ بمسحها عبر ClaimCreatorFee.
خزانة رسوم المنصة — PDA في البذور [platform_config, quote_mint]. كل إطلاق موجه عبر نفس المنصة التي تستخدم نفس النعناع الاقتباسي يصب في نفس الخزانة. يقوم platform_fee_wallet للمنصة بمسحها عبر ClaimPlatformFeeFromVault. هناك أيضاً متغير مسح لكل إطلاق (ClaimPlatformFee) يسحب من quote_vault للإطلاق مباشرة دون المرور عبر الخزانة المجمعة.

يسمح نمط الخزانة المجمعة لمنشئ أو منصة عالية الحجم بإطفاء تكلفة الإيجار لتراكم الرسوم عبر العديد من الإطلاقات.

Quote vault ↔ `real_quote`

يجب أن يبقى quote_vault.balance و PoolState.real_quote متزامنين. يمكنهما الانجراف بمقدار أقصى مجموع عدادات الرسوم الثلاثة المعلقة (quote_protocol_fee، platform_fee، migrate_fee)، التي تجلس في الخزانة لكنها تنتمي إلى عدادات الرسوم وليس احتياطي المنحنى. تستخدم رياضيات المنحنى دائماً real_quote، أبداً رصيد الخزانة الخام. ثابت ما قبل التخرج:

quote_vault.balance ==
   real_quote
 + quote_protocol_fee
 + platform_fee
 + migrate_fee

انتقالات حساب دورة الحياة

الحدث	الحالة	`real_base`	`real_quote`	مجموعة ما بعد التخرج
`Initialize`	Funding	0	0	—
`BuyExactIn` / `BuyExactOut`	Funding	`+base_out`	`+quote_in_after_fee`	—
`SellExactIn` / `SellExactOut`	Funding	`−base_in`	`−quote_out_before_fee`	—
`MigrateToCpswap` (أو `MigrateToAmm` القديم)	Funding → Migrate → Migrated	(مجمد)	(مجمد)	تم الإنشاء؛ يتم تقسيم LP CPMM إلى LP مقفول مملوك للمنصة و LP محترق
`ClaimCreatorFee` / `ClaimPlatformFee*`	أي	—	—	يستنزف خزانة رسوم
`CreateVestingAccount`	Funding	—	—	يرفع `vesting_schedule.allocated_share_amount`
`ClaimVestedToken`	Migrated فقط	—	—	يستنزف `base_vault`

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

products/launchlab/bonding-curve — الرياضيات خلف real_base ↔ real_quote.
products/launchlab/instructions — قوائم الحسابات لكل تعليمة.
products/launchlab/global-config — الربط على مستوى البروتوكول.
products/launchlab/platform-config — طبقة المنصة الإضافية.
products/launchlab/vesting — ميكانيكا العرض المقفول.
products/cpmm/accounts — كيف يبدو cpmm_pool_state بعد التخرج.

المصادر:

raydium-launch/programs/launchpad/src/states/pool.rs — PoolState, PoolStatus, VestingSchedule, AmmCreatorFeeOn.
raydium-launch/programs/launchpad/src/lib.rs — ثوابت بذور PDA (AUTH_SEED, CREATOR_FEE_VAULT_AUTH_SEED, PLATFORM_FEE_VAULT_AUTH_SEED).
وحدة Raydium SDK v2 launchpad.

LaunchLab

Token launch flow

Tips & Gotchas

جرد الحسابات

`PoolState`

سلطة PDA

النعناع الأساسي

الخزائن

خزائن الرسوم

Quote vault ↔ `real_quote`

انتقالات حساب دورة الحياة

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

​جرد الحسابات

​PoolState

​سلطة PDA

​النعناع الأساسي

​الخزائن

​خزائن الرسوم

​Quote vault ↔ real_quote

​انتقالات حساب دورة الحياة

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

جرد الحسابات

`PoolState`

سلطة PDA

النعناع الأساسي

الخزائن

خزائن الرسوم

Quote vault ↔ `real_quote`

انتقالات حساب دورة الحياة

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