2026-08-17 — CPMM: جمع رسوم المنشئ بدون إذن

يضيف هذا الإصدار مسارًا تشغيليًا بدون إذن لجمع رسوم المنشئ. يمكن لأي شخص الدفع لتفعيل التجميع، لكن البرنامج يثبت مالك المستقبل على PoolState.pool_creator ويثبت كلا الوجهتين على حسابات الرموز المرتبطة الموثوقة لذلك المنشئ. تبقى التعليمة الموقعة من المنشئ الحالية دون تغيير. كما يسمح لسلطة مخصصة بإنشاء PDAs Permission في CPMM. هذا التفويض غير متماثل عن قصد: يمكن للسلطة المخصصة منح الوصول إلى InitializeWithPermission، بينما فقط مسؤول البرنامج يمكنه إلغاء المنحة باستخدام ClosePermissionPda.

​

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

• تعليمة جديدة إضافية: CollectCreatorFeePermissionless. أي موقّع يمكن أن يكون payer. منشئ المجموعة المسجل لا يوقع.
• لا يمكن للمستدعي إعادة توجيه الأموال. يجب أن يساوي creator قيمة pool_state.pool_creator. يجب أن تكون creator_token_0 و creator_token_1 حسابات ATA الموثوقة لذلك المنشئ لأرصدة المجموعة وبرامجها الرمزية الخاصة بها.
• الدافع يغطي حسابات ATA المفقودة. كلا حسابي المستقبل يستخدمان init_if_needed؛ يمول الدافع الإيجار عندما لا يكون أي حساب موجودًا.
• الجمع كل شيء أو لا شيء. تنقل التعليمة كلا عدادات رسوم المنشئ المتراكمة بالكامل، وتصفر كليهما، وتحدث recent_epoch. تُرجع خطأ NoFeeCollect الموجود عندما يكون كلا العدادين صفرًا.
• التكاملات الموجودة تبقى متوافقة. لم يتم تعديل أو إزالة CollectCreatorFee. لا توجد تغييرات في تخطيط PoolState أو AmmConfig أو Permission أو الحدث أو رمز الخطأ.
• إنشاء الإذن له مالك ثانٍ. يقبل CreatePermissionPda مسؤول البرنامج أو مالك إنشاء-إذن-PDA مخصص. يبقى ClosePermissionPda مقتصرًا على المسؤول فقط.

​

حسابات التعليمة الجديدة

يأخذ CollectCreatorFeePermissionless 14 حسابًا بهذا الترتيب: بخلاف CollectCreatorFee، يحتوي التخطيط الجديد على حسابات payer و creator منفصلة وغير موقعة ولا يأخذ amm_config. لذلك يتطلب مميزًا وبناءً خاصًا به.

​

تأثير SDK و IDL

فرع مصدر البرنامج لا يتضمن تحديث SDK أو IDL ملتزم به. يجب على المدمجين تحديث IDL CPMM المنشور أو استخدام إصدار عميل يدعم صراحةً CollectCreatorFeePermissionless. مجموعة البناء @raydium-io/raydium-sdk-v2@0.2.42-alpha المثبتة في التوثيق تغطي فقط مسار المنشئ الموقع الأصلي.

​

حد الأمان

الاستدعاء بدون إذن لا يعني الحفظ بدون إذن. يمكن للمستدعي اختيار متى يجمع ويمكنه إنفاق SOL لإنشاء حسابات ATA مفقودة للمنشئ. لا يمكن للمستدعي اختيار المستفيد أو استبدال حسابات رموز عشوائية أو طلب مبلغ جزئي أو تغيير تكوين رسوم المنشئ للمجموعة. دور منشئ PDA الإذن الجديد يمكنه إنشاء منحة لأي permission_authority، ويدفع إيجار الحساب الجديد. لا يمكنه إغلاق ذلك PDA بموجب هذا التغيير. تعامل معه كسلطة منحة مفوضة، وليس كمسؤول إذن كامل.

​

ملاحظات الترحيل

• احتفظ بمعاملات CollectCreatorFee الموجودة دون تغيير.
• أضف التعليمة بدون إذن فقط بعد نشر CPMM المستهدف وIDL العميل يتضمنانها.
• يمكن للأتمتة مسح المجموعات ذات creator_fees_token_0 أو creator_fees_token_1 غير الصفرية وتفعيل الجمع دون حفظ مفاتيح المنشئ.
• تعامل مع NoFeeCollect كسباق حميد عندما يستنزف مستدعٍ آخر العدادات أولاً.
• لا تمرر حسابات رموز مستقبل عشوائية؛ اشتق حسابات ATA للمنشئ من pool_state.pool_creator وكل رصيد خزان والبرنامج الرمزي المطابق.

​

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

• products/cpmm/overview — تحديث جمع رسوم المنشئ وملخص سلامة الوجهة.
• products/cpmm/instructions — ملخص التعليمة الجديدة وقائمة الحساب الكاملة والتأثيرات ومصفوفة تغيير الحالة.
• products/cpmm/accounts — مسارات جمع عداد رسوم المنشئ وإنشاء PDA الإذن المفوض.
• products/cpmm/fees — ميكانيكا الجمع بدون إذن والتدفق التشغيلي.
• products/cpmm/code-demos — تحذير توفر SDK وحد ترحيل العميل.
• products/launchlab/platform-config — توضيح أن منشئ CPMM المسجل يبقى المستفيد حتى عندما يفعل دافع آخر الجمع.
• protocol-overview/shared-infrastructure — مسارات الجمع المحدودة بالسلطة والمقيدة بالوجهة.
• security/admin-and-multisig — حدود سلطة المنحة المفوضة وحدود جامع بدون إذن.
• reference/program-addresses — عناوين مالك CreatePermissionPda المخصص الموثوق.
• reference/error-codes — توسيع NoFeeCollect لتغطية جمع رسوم المنشئ.

تم التحقق منه 2026-08-13 مقابل:

• raydium-cp-swap commit 244e124 — Feat/permissionless collect creator fee (#76)، دمج فرع feat/permissionless-collect-creator-fee الذي كُتب هذا الإدخال ضده. تم حذف الفرع نفسه بعد الدمج.
• Commits 9585ea1 و d99d542، مقارنة مع master في 78f254e.