2026-09-13 — CPMM: البروتوكول يأخذ حصة من رسم المنشئ

​

ملخص سريع للمدمجين

• كلا تعليمات جمع رسم المنشئ غيّرت قوائم حساباتهما. هذا كسر. يكتسب CollectCreatorFee حساب creator_fee_share في الموضع 5. يكتسب CollectCreatorFeePermissionless حساب amm_config في 5 و creator_fee_share في 6. كلا الإدراجين يجلسان قبل الخزائن، لذا كل شيء بعده ينزاح. أعد بناء هذه المعاملات؛ لا تصلحها.
• يجب تمرير creator_fee_share حتى عندما لا يكون موجوداً. يتم التصريح عنه بقيد بذرة لكن يُقرأ كحساب غير مفحوص، لذا يجب أن يكون العنوان هو PDA الكنسي في ["creator_fee_share", creator, amm_config] بينما الحساب نفسه اختياري. عندما يكون فارغاً، يعود البرنامج إلى AmmConfig.creator_fee_share_rate.
• يكتسب AmmConfig حقل creator_fee_share_rate، محفور من الحشو. الحساب لا يزال 236 بايت وكل تكوين موجود يبقى قابلاً للفك — لكن أول u64 من padding: [u64; 15] القديم هو الآن حقل نشط. فكاكات النموذج الذي يمثل الذيل كمصفوفة من 15 عنصراً تقرأ معدل المشاركة كـ padding[0].
• PoolState لم يتغير. 637 بايت، نفس الإزاحات، نفس الحقول. حصة البروتوكول مسجلة في عدادات protocol_fees_token_{0,1} الموجودة — لا يوجد عداد جديد ولا تعليمة جمع جديدة له.
• protocol_fees_token* ينمو الآن خارج المبادلات. أي مراقب يوفق بين تراكم البروتوكول مقابل حجم التداول سيرى قفزات عند كل جمع رسم منشئ.
• مقدّر دفع المنشئ الذي يقرأ creator_fees_token* يبالغ الآن. اضرب في (1 − share_rate / 1_000_000)، محلول لزوج (creator, amm_config) هذا.
• تمت إضافة تعليمتا إدارة: CreateCreatorFeeShare و CloseCreatorFeeShare. معامل UpdateAmmConfig جديد واحد: 8 → creator_fee_share_rate.
• لا توجد أكواد خطأ جديدة. المسارات الجديدة تعيد استخدام InvalidOwner (6001)، InvalidInput (6003) و MathOverflow (6011). 6000–6015 لم تتغير.
• يلزم تحديث IDL — تعليمتان جديدتان، نوع حساب جديد واحد، قائمتا حسابات متغيرتان، حقل تكوين جديد واحد.

​

كيف يعمل الانقسام

1. CreatorFeeShare PDA في ["creator_fee_share", creator, amm_config] — عندما يكون الحساب موجوداً ومملوكاً بواسطة CPMM، يفوز share_rate الخاص به.
2. AmmConfig.creator_fee_share_rate — الافتراضي لفئة الرسم، يُستخدم بخلاف ذلك.

// states/creator_fee_share.rs
shared_amount  = floor(creator_fee * share_rate / 1_000_000);
creator_amount = creator_fee - shared_amount;

// states/pool.rs — PoolState::settle_creator_fee
self.protocol_fees_token_i = self.protocol_fees_token_i.checked_add(shared_amount_i)?;
self.creator_fees_token_i  = 0;
// creator_amount_i is returned and transferred out to the creator

• التقريب يفضل المنشئ. المشاركة تنخفض، لذا الغبار يبقى مع المنشئ — نفس الاتجاه مثل Fees::protocol_fee و Fees::fund_fee، التي تحفر أيضاً حصة من رسم مراكم بالفعل. 20% من رسم بوحدة واحدة هو 0، وليس 1.
• القيمة محفوظة. creator_amount + shared_amount == creator_fee لكل معدل وكل رسم حتى u64::MAX.
• share_rate = 0 هو بالضبط السلوك القديم. كل من قيمة التكوين الافتراضي و PDA المفقود يعطي المنشئ الرسم كاملاً، لذا لا شيء يتغير لأي مجموعة موجودة حتى يضع المسؤول معدلاً.

​

تغييرات قائمة الحسابات

​

CreateCreatorFeeShare و CloseCreatorFeeShare

pub struct CreatorFeeShare {
    pub bump: u8,
    pub creator: Pubkey,
    pub amm_config: Pubkey,
    pub share_rate: u64,
    pub padding: [u64; 8],
}
// CreatorFeeShare::LEN == 145

• منشئ المجموعة ليس طرفاً في أي من التعليمتين ولا يوقع. حساب creator غير مفحوص — يمكن إنشاء PDA لمفتاح لا يملك مجموعة حتى الآن.
• حساب واحد يغطي زوج (creator, amm_config)، لذا يحكم كل مجموعة يملكها هذا المنشئ على فئة الرسم تلك. منشئ لديه مجموعات على فئتي رسم يحتاج إلى حسابين ليكون مغطى على كليهما.
• لا توجد مسار تحديث. init يفشل على إنشاء ثانٍ لنفس الزوج؛ لتغيير معدل، أغلق وأعد الإنشاء.

​

معامل UpdateAmmConfig 8

Some(8) => update_creator_fee_share_rate(amm_config, value),   // asserts value <= 1_000_000

​

الركوب معاً

​

ما لم يتغير

• PoolState — 637 بايت، نفس الحقول، نفس الإزاحات. حصة البروتوكول تعيد استخدام الجرافة البروتوكول الموجودة بدلاً من إضافة عدادات خاصة بها.
• AmmConfig::LEN — لا تزال 236 بايت.
• رياضيات المبادلة والاقتباس والفحص k. يتم فرض رسم المنشئ بالضبط كما هو الحال من قبل.
• CollectProtocolFee / CollectFundFee — نفس الحسابات، نفس الموقّعون. CollectProtocolFee ببساطة لديه المزيد للجمع.
• أكواد الخطأ. 6000–6015 لم تتغير؛ لا شيء مضاف.
• كل تعليمة أخرى، ومعرّف البرنامج.

​

الصفحات المحدثة

• products/cpmm/fees — قسم جديد “حصة البروتوكول من رسم المنشئ” يغطي دقة المعدل وحساب الانقسام والتقريب والعواقب على المدمج؛ تمت إضافة creator_fee_share_rate إلى قائمة الأسعار/الوحدات وجدول المعاملات الافتراضية؛ تم إعادة صياغة جدول تدفق الجمع.
• products/cpmm/instructions — تحذير التغيير الكسر في الأعلى؛ جداول حسابات كاملة لكلا مسارات رسم المنشئ؛ أقسام CreateCreatorFeeShare و CloseCreatorFeeShare جديدة؛ معامل UpdateAmmConfig 8؛ ملاحظة ترتيب CollectExcessLamports؛ صفوف الملخص ومصفوفة تغيير الحالة.
• products/cpmm/accounts — قسم حساب CreatorFeeShare جديد؛ تخطيط AmmConfig وتحذير نقش الحشو؛ ملاحظات عداد الرسم PoolState؛ صفوف دورة حياة الحساب.
• products/cpmm/overview — استدعاء رسم المنشئ والرصاصة “الرسوم المتوقعة”.
• products/cpmm/math — ملاحظة أن الانقسام متعمد غائب عن رياضيات المبادلة.
• products/cpmm/code-demos — تحذير أن منشئي SDK قبل الترقية ينبعثون من قوائم الحسابات القديمة؛ مقتطف الرسم المتراكم معلق.
• reference/program-addresses — قسم جديد “سلطة مشاركة رسم المنشئ CPMM”؛ تمت إضافة creator_fee_share إلى كتلة بذرة PDA.
• reference/fee-comparison — يتم استدعاء creator_fee_share_rate كمعدل CPMM رابع بقاعدة مختلفة.