قفل الأموال (Vesting) في LaunchLab

الرموز المقفولة، جدول الإفراج بفترة انتظار (cliff) وفتح خطي، حساب VestingRecord لكل مستفيد، وتعليمات الإنشاء والمطالبة التي يستخدمها المنشئون والمنصات لتوزيع الإمدادات المحفوظة بعد التخرج.

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

عرض النسخة الإنجليزية →

قفل الأموال (Vesting) اختياري على إطلاقة LaunchLab. عيّن vesting_param.total_locked_amount = 0 عند Initialize والقسم أدناه لا ينطبق. بمجرد التفعيل، يكون الجدول ثابتًا طوال عمر الإطلاقة؛ لا يمكن تغيير فترة الانتظار وفترات الفتح بأثر رجعي.

​

لماذا قفل الأموال

منحنى الربط يبيع base_supply_graduation رموز أثناء جمع التمويل وينشئ مجمع ما بعد التخرج ببقية الرموز. يقوم قفل الأموال بحجز شريحة إضافية من الإمدادات، وتقفلها لفترة انتظار قابلة للتكوين، ثم يحررها خطيًا لمستفيد واحد أو أكثر — عادة فريق المنشئ أو المستشارون أو شركاء المنصة.

حالات الاستخدام العملية:

• تخصيص الفريق. يحتفظ المنشئ، على سبيل المثال، بـ 5% من الإمدادات لفريق التأسيس، مقفولة لمدة 6 أشهر والفتح الخطي على مدار 12 شهرًا التالية.
• تخصيص المنصة. تتلقى منصة الإطلاقة شريحة من كل رمز تدرجه، على نفس الجدول، عبر CreatePlatformVestingAccount.
• منح المستشار / المساهم. عدة مستفيدين لديهم حساباتهم الخاصة من VestingRecord، كل منها يتتبع المبلغ المطالب به بشكل مستقل.

الرموز المقفولة لا تدخل المنحنى وليست جزءًا من مجمع التخرج. تبقى نائمة في base_vault الخاص بالمجمع حتى يستدعي كل مستفيد ClaimVestedToken.

​

شكل الجدول

يتم وصف قفل الأموال للإطلاقة بثلاثة أرقام، مسجلة مرة واحدة في وقت Initialize:

الحقل	النوع	المعنى
total_locked_amount	u64	مجموع جميع الرموز الأساسية المقفولة عبر جميع المستفيدين (المنشئ + المنصة). يجب أن يكون total_locked_amount <= supply * max_lock_rate / 1_000_000 من GlobalConfig الملزمة.
cliff_period	u64 (ثانية)	وقت الانتظار بعد انتهاء جمع التمويل قبل فتح أي رموز.
unlock_period	u64 (ثانية)	مدة نافذة الفتح الخطي بعد فترة الانتظار. 0 يعني أن كل شيء يُفتح فورًا عند نهاية فترة الانتظار.

تعيش هذه القيم الثلاث على PoolState.vesting_schedule (struct VestingSchedule) بالإضافة إلى start_time على السلسلة، والذي يسجله البرنامج باسم block_time + cliff_period في لحظة انتهاء جمع التمويل بنجاح (عند استيفاء شروط التخرج لأول مرة).

// states/pool.rs
pub struct VestingSchedule {
    pub total_locked_amount:     u64,
    pub cliff_period:            u64,
    pub unlock_period:           u64,
    pub start_time:              u64,   // set by the program at fundraising end
    pub allocated_share_amount:  u64,   // running sum of allocations to vesting records
}

allocated_share_amount هو المبلغ الإجمالي المخصص بالفعل لحسابات VestingRecord عبر CreateVestingAccount / CreatePlatformVestingAccount. يجب ألا تتجاوز أبدًا total_locked_amount. إذا أفرط المنشئ في التخصيص، فإن استدعاء CreateVestingAccount التالي سيرجع مع InvalidTotalLockedAmount.

​

صيغة الفتح الخطي

بعد انتهاء جمع التمويل، يحسب البرنامج المبلغ المفتوح التراكمي لكل VestingRecord كـ:

elapsed         = min(now, start_time + unlock_period) − start_time
unlocked_amount = token_share_amount × elapsed / unlock_period

إذا كان unlock_period == 0، فإن كل token_share_amount يصبح قابلاً للمطالبة في خطوة واحدة في start_time. وإلا فإن المنحنى هو خط مستقيم من 0 في start_time إلى token_share_amount في start_time + unlock_period، محصور في token_share_amount بعد ذلك.

المبلغ المحول عند كل استدعاء ClaimVestedToken هو الفرق بين المبلغ المفتوح التراكمي المحسوب حديثًا وحقل claimed_amount الجاري على السجل.

delta_amount    = unlocked_amount − vesting_record.claimed_amount
vesting_record.claimed_amount = unlocked_amount

المطالبة قبل start_time سترجع مع VestingNotStarted. المطالبة بعد start_time + unlock_period تسوي الباقي الكامل.

​

تخطيطات الحسابات

​

VestingSchedule

يعيش مضمنًا على PoolState. انظر accounts.

​

VestingRecord

سجل لكل مستفيد. PDA مشتق كـ:

seeds = [
  b"pool_vesting",
  pool_state.key(),
  beneficiary.key(),
]
program = LaunchLab program

// states/vesting.rs
#[account]
pub struct VestingRecord {
    pub epoch:               u64,         // recent_epoch tracker
    pub pool:                Pubkey,      // back-pointer to PoolState
    pub beneficiary:         Pubkey,      // who can call ClaimVestedToken
    pub claimed_amount:      u64,         // cumulative claimed
    pub token_share_amount:  u64,         // total allocated to this beneficiary
    pub padding:             [u64; 8],
}

لا يمكن للمستفيد أن يكون لديه واحد فقط VestingRecord لكل إطلاقة. التخصيص مرة أخرى لنفس المستفيد على نفس الإطلاقة سيرجع لأن PDA موجود بالفعل.

​

التعليمات

​

CreateVestingAccount

متاح فقط للمنشئ. يخصص شريحة من total_locked_amount الخاص بالمجمع لمستفيد جديد بتهيئة PDA VestingRecord جديد.

الوسائط

share_amount: u64    // tokens to assign to this beneficiary

الحسابات

#	الاسم	W	S	الملاحظات
1	creator	W	S	يجب أن يساوي pool_state.creator؛ يدفع الإيجار للحساب الجديد.
2	beneficiary	W		يتلقى الرموز المفتوحة لاحقًا. لا يمكن تغيير المفتاح العام المحفوظ هنا.
3	pool_state	W		يتم تعديله لزيادة vesting_schedule.allocated_share_amount.
4	vesting_record	W		init؛ PDA [b"pool_vesting", pool_state, beneficiary].
5	system_program			مطلوب لإنشاء الحساب.

الشروط المسبقة

• share_amount > 0.
• pool_state.vesting_schedule.allocated_share_amount + share_amount <= total_locked_amount.
• لا يوجد VestingRecord حالي للمفتاح العام beneficiary لهذا المجمع.

الشروط اللاحقة

• تم تهيئة vesting_record مع token_share_amount = share_amount, claimed_amount = 0.
• pool_state.vesting_schedule.allocated_share_amount += share_amount.

الأخطاء الشائعة — InvalidTotalLockedAmount, InvalidInput.

​

CreatePlatformVestingAccount

متغير المسؤول عن المنصة لـ CreateVestingAccount. محفظة قفل الأموال الخاصة بالمنصة (المخزنة على PlatformConfig.platform_vesting_wallet) هي المستفيد، والمشاركة محدودة بـ PlatformConfig.platform_vesting_scale.

يجب أن يساوي الموقّع platform_config.platform_vesting_wallet. الحسابات الأخرى تعكس CreateVestingAccount. استخدم هذا عندما توافق المنصة على تلقي حصة قفل أموال ثابتة على كل إطلاقة تدرجها.

​

ClaimVestedToken

متاح فقط للمستفيد. ينقل أي رموز مفتوحة حديثًا من base_vault الخاص بالمجمع إلى ATA الخاص بالمستفيد.

الوسائط

بدون وسائط (يحسب البرنامج مبلغ المطالبة من الجدول).

الحسابات

#	الاسم	W	S	الملاحظات
1	beneficiary	W	S	يجب أن يساوي vesting_record.beneficiary.
2	authority			PDA [b"vault_auth_seed"]؛ يوقّع نقل الخزان.
3	pool_state	W		يتم تعديله فقط إذا كان الجدول يحتاج إلى إعادة التحقق.
4	vesting_record	W		يتم تحديث claimed_amount.
5	base_vault	W		خزان الرمز الأساسي للمجمع؛ يتم الخصم منه.
6	beneficiary_ata	W		يتلقى الرموز المفتوحة؛ init_if_needed.
7	base_mint			نعناع الرمز الأساسي للمجمع.
8	token_program			برنامج SPL Token أو Token-2022.
9	associated_token_program			لإنشاء ATA إذا لزم الأمر.
10	system_program			مطلوب لإنشاء الحساب.

الشروط المسبقة

• block_time >= pool_state.vesting_schedule.start_time (وإلا VestingNotStarted).
• pool_state.status == PoolStatus::Migrated — يجب أن يكون التخرج قد حدث بالفعل. الاستدعاء قبل التخرج سيرجع.
• فرق المبلغ المفتوح أكبر من صفر. استدعاء بدون فائدة (الفرق المحسوب هو 0) سيرجع.

الشروط اللاحقة

• vesting_record.claimed_amount يتقدم إلى المبلغ المفتوح التراكمي الجديد.
• يتم نقل delta_amount من الرمز الأساسي إلى beneficiary_ata.

الأخطاء الشائعة — VestingNotStarted, NoAssetsToCollect, MathOverflow.

​

مثال عملي

تعيّن الإطلاقة:

• supply = 1_000_000_000
• total_locked_amount = 100_000_000 (10% من الإمدادات)
• cliff_period = 180 * 86400 (180 يوم)
• unlock_period = 365 * 86400 (سنة واحدة خطية بعد فترة الانتظار)

يخصص المنشئ حسابي VestingRecord فورًا بعد Initialize:

• المستفيد أ (الفريق): share_amount = 70_000_000
• المستفيد ب (المستشار): share_amount = 30_000_000

allocated_share_amount = 100_000_000، يساوي total_locked_amount — لا توجد تخصيصات إضافية ممكنة.

ينتهي جمع التمويل في 2027-01-01T00:00Z. يعيّن البرنامج start_time = 2027-01-01 + 180 يوم = 2027-06-30.

في 2027-09-30 (90 يوم بعد start_time)، يستدعي المستفيد أ ClaimVestedToken:

elapsed         = min(now, start_time + 365·86400) − start_time
                = 90 · 86400
unlocked_amount = 70_000_000 × (90 / 365) ≈ 17_260_274
delta_amount    = 17_260_274 − 0 = 17_260_274

تتلقى محفظة أ 17.26 مليون رمز أساسي. يتقدم vesting_record.claimed_amount إلى 17_260_274.

بعد ستة أشهر (2028-03-31، 270 يوم بعد start_time)، يطالب أ مرة أخرى:

unlocked_amount = 70_000_000 × (270 / 365) ≈ 51_780_822
delta_amount    = 51_780_822 − 17_260_274 = 34_520_548

يتلقى أ 34.52 مليون رمز آخر. بعد 2028-06-30 (نهاية unlock_period)، تنقل المطالبة التالية ~18.22 مليون المتبقي وتترك claimed_amount == token_share_amount.

​

الحالات الحدية

• فقدان المستفيد لمفتاحه. المفتاح العام على VestingRecord.beneficiary هو الموقّع الوحيد الذي يمكنه استدعاء ClaimVestedToken. لا توجد مسار استرجاع. عيّن المستفيد إلى multisig إذا كان الاسترجاع مهمًا.
• رسوم نقل Token-2022. إذا كان نعناع الرمز الأساسي رمز Token-2022 بامتداد رسم نقل، يتلقى المستفيد delta_amount − transfer_fee، وليس الفرق الكامل. يسجل خزان المجمع المبلغ الإجمالي كمنقول — يتراكم الفرق في حساب الرسم المحتفظ به للنعناع.
• المجمع لم يتخرج. استدعاء ClaimVestedToken قبل التخرج سيرجع. تبدأ ساعة قفل الأموال فقط عند انتهاء جمع التمويل بالفعل؛ الإطلاقة المجهضة (التي لا تعيّن start_time) تترك الرموز المقفولة غير قابلة للوصول في الخزان.
• محاولات الإفراط في التخصيص. يفرض البرنامج allocated_share_amount <= total_locked_amount على كل CreateVestingAccount. البقية (إن وجدت) من total_locked_amount المتروكة غير مخصصة مفقودة — تبقى تلك الرموز في الخزان إلى الأبد بمجرد تخرج الإطلاقة. خصص المبلغ الكامل ما لم يكن هذا هو القصد.

​

المؤشرات

• products/launchlab/accounts — تخطيط PoolState الكامل بما في ذلك VestingSchedule.
• products/launchlab/instructions — دورة حياة التخرج.
• products/launchlab/platform-config — دلالات platform_vesting_scale للتخصيصات على المنصة.
• products/launchlab/global-config — سقف max_lock_rate الذي يحدد total_locked_amount.

المصادر:

• raydium-launch/programs/launchpad/src/states/vesting.rs — VestingRecord.
• raydium-launch/programs/launchpad/src/states/pool.rs — VestingSchedule, VestingParams, is_vesting_started, vesting_end_time.
• raydium-launch/programs/launchpad/src/instructions/create_vesting_account.rs.
• raydium-launch/programs/launchpad/src/instructions/claim_vested_token.rs.