الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

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

ملخص في فقرة واحدة

CPMM — Constant Product Market Maker، وتُعرّف رسميًا باسم “Standard AMM” في واجهة Raydium — هي تطبيق أصلي على Solana للـ AMM الكلاسيكي x · y = k. بدون كتاب أوامر OpenBook، وبدون إرث Serum، وبدون تبعيات خارجية إلا SPL Token و Token-2022. كل مجموعة سيولة تتكون من ثلاثة عناصر (خزانا توكن، وsupply واحد لـ LP) يحكمها برنامج PDA ذو سلطة، وتُسعَّر بناءً على حاصل ضرب أرصدة الخزانات. هي الـ AMM التي توصي بها Raydium لجميع مجموعات السيولة الثابتة الجديدة، وهي ما يستهدفه endpoint /pools/create وتدفق “Create pool” في واجهة الويب بشكل افتراضي.

ما يوفره CPMM

  • Token-2022 مع قائمة امتدادات موثوقة. CPMM لا يقبل أي tokkens من Token-2022. البرنامج يفرض قائمة بيضاء من الامتدادات الآمنة عند إنشاء المجموعة: TransferFeeConfig, MetadataPointer, TokenMetadata, InterestBearingConfig, و ScaledUiAmount. أي امتداد آخر على الـ mint يؤدي إلى رفض Initialize برسالة NotSupportMint — ما لم يكن الـ mint نفسه على قائمة mint بيضاء صغيرة مشفرة في البرنامج (تُستخدم لإدراج tokkens معينة حالة بحالة). رسوم التحويل بالذات تؤثر على رياضيات المبادلة وتُطبّق على الجانب الصحيح من التجارة — انظر algorithms/token-2022-transfer-fees.
  • رسوم يمكن التنبؤ بها. كل مجموعة سيولة تشير إلى AmmConfig تم اختياره عند الإنشاء. تحمل الإعدادات معدل رسم تجاري (مقسوم بين موفري السيولة والبروتوكول والصندوق) ومعدل رسم منفصل ومستقل للمنشئ. رسم المنشئ هو حسابه الخاص — ولا يكون أبدًا جزءًا من رسم التجارة. تختار المجموعات تطبيقه عند الإنشاء. القيم الافتراضية والرياضيات الكاملة موجودة في products/cpmm/fees.
  • TWAP على السلسلة عبر حلقة ملاحظة (ring buffer). كل مبادلة تحدّث حساب observation. يمكن للعقود الخارجية قراءة ملاحظة سعر تراكمية لحساب TWAP بدون oracle مخصص.
  • تخطيط حسابات مسطح. تُوصّف مجموعة السيولة بالكامل بستة PDAs (السلطة، حالة المجموعة، LP mint، خزانا التوكن، ملاحظة). بدون حساب OpenBook لكل سوق، بدون طابور أحداث، بدون طابور طلبات. المعاملات أرخص من حيث الحوسبة وعدد الحسابات مقارنة بـ AMM v4.
  • متوافق مع Burn-and-earn. يمكن قفل tokkens LP تحت برنامج LP Lock حتى يتمكن منشئ المجموعة من الاستمرار في المطالبة برسوم بدون الحفاظ على الحق في سحب السيولة. يُستخدم لإطلاقات السيولة “الدائمة”.

ما لا يقدمه CPMM

  • ليس مركزًا. السيولة موزعة بالتساوي عبر نطاق الأسعار الكامل، مثل Uniswap v2. إذا كنت تحتاج إلى صنع سوق فعال من حيث رأس المال — أي تركيز السيولة بالقرب من السعر الحالي — استخدم CLMM.
  • ليس هجينًا. بخلاف AMM v4، مجموعات CPMM لا تضع أوامر ساكنة على سوق OpenBook. يحدث التوجيه عبر مجموعات CPMM من خلال برنامج AMM Routing، وليس من خلال CLOB.
  • غير قابل للإطلاق لأي منحنيات تعسفية. المنحنى مشفر بثبات في منتج ثابت. إذا كنت تريد منحنى bonding لإطلاق token، استخدم LaunchLab، التي تتخرج إلى مجموعة CPMM عند الامتلاء.

كيف يختلف CPMM عن AMM v4

البُعدAMM v4CPMM
المنحنىمنتج ثابتمنتج ثابت
تبعية OpenBookخامل (كان يضع أوامر على سوق OpenBook في الأصل؛ تم إلغاء التكامل)لا
دعم Token-2022لا (SPL Token فقط)نعم (بما في ذلك رسوم التحويل)
عدد الحسابات لكل مبادلة V2~9~11
وحدات الحوسبة لكل مبادلة~80k–120k (مسار V2)~60k–100k
oracle TWAPلا يوجد حساب oracle أصليحلقة ملاحظة (observation)
إنشاء مجموعة جديدة اليومليس الافتراضي (البرنامج لا يزال يقبله)الافتراضي
الحالةتشغيل كاملنشط، موصى به
معالجة أعمق لقصة الهجرة موجودة في protocol-overview/versions-and-migration.

النموذج الذهني

مجموعة CPMM هي كائن مملوك من البرنامج يحمل ثلاثة أرصدة: vault0 (token0), vault1 (token1), و supply من LP mint. يتتبع supply من LP mint مطالبة المودعين على المجموعة؛ تحمل خزانات التوكن الأصول الفعلية. كل شيء آخر — PDA السلطة، حساب الملاحظة، مؤشر الإعدادات — هو مسك دفاتر لجعل تلك العلاقة ثلاثية المتغيرات قابلة للتداول وتجميع الرسوم والملاحظة. كل عملية تتجه للمستخدم تختزل إلى انتقال حالة محدد جيدًا:
  • إيداع: تحويل token0 و token1 للداخل، mint LP للمستخدم، لا تغيير في السعر.
  • سحب: burn LP من المستخدم، تحويل token0 و token1 للخارج بنسبة المجموعة الحالية، لا تغيير في السعر.
  • مبادلة: تحويل token واحد للداخل، تحويل الآخر للخارج؛ تتحرك النسبة على طول منحنى x · y = k (ناقص الرسوم)؛ حساب الملاحظة يأخذ عينة من السعر الجديد.
تجميع الرسوم (CollectProtocolFee, CollectFundFee) هو معاملة منفصلة موقعة من السلطة الخاصة؛ لا تحدث في كل مبادلة. الرياضيات موضحة في products/cpmm/math و مجموعة التعليمات في products/cpmm/instructions.

متى تختار CPMM

اختر CPMM عندما:
  • تطلق token جديد أو زوج جديد ولا لديك آراء قوية حول أي نطاق سيشهد تداول.
  • واحد أو كلا التوكنات يستخدم امتدادات Token-2022.
  • تريد نموذج رسم بسيط لكل تجارة بدلاً من نموذج ديناميكي قائم على tick.
  • تقوم بالتكامل وتريد التوجيه عبر Raydium بدون تحمل تعقيد مراكز CLMM.
فضّل CLMM عندما:
  • الزوج مستقر أو مرتبط بشدة (stablecoin-stablecoin, LST-SOL) وتريد تركيز السيولة حول التكافؤ.
  • أنت فريق صنع سوق على استعداد لإدارة النطاقات بنشاط للحصول على APR رسوم أعلى لكل دولار TVL.
فضّل AMM v4 عندما:
  • تقوم بهجرة أدوات AMM v4 الموجودة ولا تنشئ مجموعة جديدة.
(ملاحظة: وضع OpenBook الهجين في AMM v4 لم يعد نشطًا — هذا ليس سببًا لاختيار AMM v4 بعد الآن.)

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

  • الحسابات — الستة PDAs لمجموعة CPMM وكيفية اشتقاقها.
  • الرياضياتSwapBaseInput مقابل SwapBaseOutput, معالجة رسوم transfer-fee في Token-2022، تحديثات الملاحظة.
  • التعليمات — سطح التعليمات الكامل مع قوائم الحسابات.
  • الرسوم — انقسام الرسوم بأربعة اتجاهات وكيفية التجميع.
  • أمثلة الكود — مقاطع TypeScript قابلة للتشغيل لـ create / swap / deposit / withdraw.
المصادر: