Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

البروتوكول

توفر عقود Protocol v1.1.0 مكونات على السلسلة لـ بروتوكول تجميع الالتزامات (CPP) الموضح في الفصل الأول من الورقة البيضاء. ويتبع هذا المرجع الإصدار العام v1.1.0.

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

تدير Grassroots Economics Foundation (GEF) تطبيق الويب التقدمي على cosmolocal.credit، وهو إحدى طرق التفاعل مع هذه العقود. التطبيق والعقود منفصلان. ولا يجعل تشغيل الواجهة GEF بمفرده جهة مصدرة لقسيمة أو مشرف صندوق أو أمين حفظ أو ضامنًا أو طرفًا مقابلًا في معاملة بين المستخدمين. وتعتمد هذه الأدوار على التنفيذ المعني وعناوين المتحكمين والشروط المنشورة للجهة المصدرة أو الصندوق. راجع شروط الخدمة.

نمط النشر

تُهيأ معظم الوحدات التي تحتفظ بالحالة بوصفها نسخ وكيل ERC-1967 من خلال ERC1967Factory في Solady. ويمكن لعدة نسخ مشاركة تنفيذ واحد مع الاحتفاظ بمالكين وإعدادات ومساحات تخزين منفصلة. وقد يستخدم النشر أيضًا قيمًا حتمية بحيث يمكن توقع العناوين قبل النشر.

ليست كل العقود وكلاء. فـ DecimalQuoter وSwapRouter عمليتا نشر مباشرتان بلا حالة، كما يُنشر RescueVault وERC1967Factory مباشرة. أما الوحدات الأخرى التي تحتفظ بالحالة والمدرجة أدناه فهي مصممة للنشر عبر وكيل.

لكل وكيل مدير يستطيع استبدال تنفيذه. وإدارة الوكيل منفصلة عن ملكية العقد، وينبغي إسنادها إلى عنوان يخضع لحوكمة مناسبة. ويمكن للترقية تغيير السلوك حتى بعد أن يغلق صندوق بعض إعداداته، لذلك ينبغي للمستخدمين تقييم مالك الصندوق ومدير الوكيل معًا.

كما أن دعم EIP-165 خاص بكل عقد وليس عامًا. وهو متاح في GiftableToken وطرق عرض الأسعار الثلاث وOracleRelay وLimiter وعدة سجلات وفهارس وSplitter وEthFaucet وPeriodSimple وRescueVault. ولا تعرض SwapPool وSwapRouter وFeePolicy وProtocolFeeController وCAT الدالة supportsInterface في v1.1.0.

خريطة المكونات

  • GiftableToken — آليات ERC20 للمعروض والسك والحرق وانتهاء الصلاحية الاختياري. يمكن للجهة المصدرة استخدام نسخة منه كقسيمة، لكن العقد وحده لا يحدد ما يمكن استرداده أو من يستطيع ذلك أو أين أو وفق أي شروط.
  • SwapPool — خزنة رموز ومحرك لتسوية المبادلات. ويمكن للتنفيذ إرفاق مكونات للتنسيق والتقييم والرسوم والحدود ورسوم البروتوكول، أو ترك المكونات التابعة المدعومة غير مضبوطة.
  • DecimalQuoter وRelativeQuoter وOracleQuoter — وحدات تقييم قابلة للتبديل لمعادلة المنازل العشرية أو الأسعار النسبية التي يديرها المالك أو الأسعار المشتقة من أوراكل. ويمكن لـ OracleRelay تمرير مصدر بيانات خارجي واحد إلى OracleQuoter.
  • FeePolicy وLimiter — قواعد اختيارية لرسوم أزواج الأصول وحدود رصيد كل رمز داخل الصندوق.
  • ProtocolFeeController — معدل اختياري وقابل للتغيير لرسوم البروتوكول ومستلمها وحالتها النشطة، ويمكن للصندوق الرجوع إليه أثناء التسوية.
  • TokenUniqueSymbolIndex وAccountsIndex وContractRegistry — مكونات لاكتشاف الرموز والحسابات والعناوين. ويسجل CAT تفضيلات الحساب المرتبة لرموز التسوية.
  • SwapRouter — يحسب عروض أسعار الإدخال الدقيق والإخراج الدقيق لمسار مقترح عبر عدة صناديق فقط. ولا يحتفظ بالرموز ولا ينفذ المبادلات.
  • Splitter وEthFaucet وPeriodSimple وRescueVault — أدوات مساندة للتوزيع وتمويل رسوم التشغيل ووضع حدود زمنية واسترداد الأصول.

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