بنية العقد الذكي

Documentation Index

Fetch the complete documentation index at: https://whitepaper.rwanftfi.com/llms.txt

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

بُنيت منصّة RWANFTFI على بنية عقود ذكية متينة ومعيارية وآمنة، تحكم جميع التفاعلات والتوزيعات وآليات الرموز دون تحكّم مركزي.

​

نمط Diamond (EIP-2535)

نواة نظام RWANFTFI مُطبَّقة باستخدام نمط Diamond (EIP-2535). يسمح هذا الخيار المعماري للبروتوكول بتجاوز الحدّ القياسي لحجم العقد الذكي (24 كيلوبايت) عبر توزيع الوظائف على عدّة وحدات مستقلّة تُسمّى “Facets” (وحدات عقد ذكي يُتاح الوصول إليها عبر عقد وكيل واحد).

​

الوحدات الأساسية (Facets)

​

عقود NFT وفضاءات معرّفات الرموز

يستخدم البروتوكول ثلاثة عقود NFT متمايزة (Regular، Gift، Ambassador). لمنع تصادم المعرّفات في تعيين registeredTokens على السلسلة الذي يتتبّع كلّ NFT مسكوك في النظام، تُسكّ NFT العاديّة وNFT الهدية في فضاءات tokenId منفصلة مُقسَّمة بالتساوي والفرديّة:

• NFT العاديّة — معرّفات رموز فرديّة (1, 3, 5, 7, …).
• NFT الهدية — معرّفات رموز زوجيّة (2, 4, 6, 8, …).

يُفرَض هذا التقسيم داخل منطق المُصدِر لكلّ عقد NFT في وقت السكّ. ولأنّ السكّ الناجح في عقد واحد لا يمكنه أبداً إنتاج معرّف يمكن للعقد الآخر إصداره، فإنّ فئة كاملة من أخطاء تصادم التعيينات تُلغى على مستوى نظام الأنواع — لا حاجة لحارس وقت تشغيل أو فحص إزالة تكرار لكلّ مكالمة. التقسيم غير مرئي للمستخدمين النهائيّين: تستمر المحافظ والأسواق في عرض كلّ NFT تحت عقده الأصلي.

​

مصفوفة قابليّة الترقية

• عقد Diamond (EIP-2535): قابل للترقية عبر Facet cuts — يتيح إضافة الوحدات الفرديّة أو استبدالها أو إزالتها دون إعادة نشر النظام بأكمله.
• TokenReserve (DA): قابل للترقية عبر Transparent Proxy — تحديثات المنطق ممكنة دون تغيير عنوان العقد.
• NFTs (Regular، Gift، Ambassador)، GovToken، AdminContract: غير قابلة للترقية — ضماناً لعدم قابليّة تغيير الأصول الأساسية وقواعد الحوكمة.

​

إدارة الأدوار

يستخدم النظام بنية أدوار هرميّة (AccessControlEnumerable) لإدارة الصلاحيات بأمان:

• ADMIN_ROLE: يمكنه منح/إلغاء أدوار أخرى وتغيير معايير النظام الحرجة.
• SERVICE_ROLE: يُنفَّذ بواسطة سكربتات الواجهة الخلفيّة للمهامّ المؤتمتة (مثل حلّ المكدّسات المنتهية ومعالجة الإيداعات عبر السلاسل).
• SIGNER_ROLE: يُستخدَم للتحقّق من التواقيع التشفيريّة لاعتماد إجراءات محدّدة مثل تحويلات القسائم.
• MINTER_ROLE: مفوَّض لسكّ رموز أو رموز NFT محدّدة.

​

مخطّط الأرصدة وأولويّة الدفع

لإدارة التدفّق المعقَّد للأموال، يستخدم RWANFTFI مخطّط أرصدة متعدّد المستويات داخل العقد الذكي. أرصدة المستخدم:

1. الرصيد العادي (balance): المحفظة الأساسيّة لـ USDT المتاحة. يمكن سحب الأموال هنا في أيّ وقت، أو استخدامها لشراء NFT، أو لإنشاء قسائم.
2. الرصيد التراكمي (accumulativeBalance): حساب توفير إلزامي يُحتسَب فيه 20% من كلّ مكافأة تسويق فوراً عند الاستحقاق.
   • الاستخدام: يمكن استخدامه فقط لشراء NFT بنفس المستوى أو لشراء NFT من مستوى أعلى.
   • الرسوم: يستلزم استخدام هذا الرصيد لشراء NFT رسماً 20% يُوجَّه إلى مجمع سيولة DA. كما أنّ تحويله إلى مستخدم آخر يستلزم رسماً 20% يُوجَّه إلى مجمع سيولة DA. كل حركة للرصيد التراكمي تُولِّد تدفّقاً إلى المجمع وتُنشئ أساساً لـ DA جديد.
   • إعادة التوزيع بعد 120 يوماً: إذا لم يستخدم المستخدم رصيده التراكمي خلال 120 يوماً، يصبح الرصيد غير المُستخدَم مؤهَّلاً لإعادة التوزيع. يعتمد التقسيم على نوع NFT الخاص بالمستخدم:
     • حاملو NFT العاديّة: 70% تُوجَّه إلى مجمع سيولة DA لإصدار رموز DA جديدة؛ 30% تُحوَّل إلى الراعي المباشر للمستخدم في خط الصعود.
     • حاملو NFT الهدية: 80% تُوجَّه إلى مجمع سيولة DA؛ 20% تُحوَّل إلى الراعي المباشر في خط الصعود (يحكم ذلك معيار accumulativeClaimDistributeGift المنفصل).
     • قاعدة الشلال (للنوعين): إذا كان حدّ دخل الراعي في خط الصعود مستنفَداً (يساوي صفراً)، فإنّ حصّة الراعي تنتقل إلى أعلى إلى المشارك التالي المؤهَّل في الهيكل. وإذا لم يكن لأيّ مشارك في السلسلة حدّ دخل نشط، يُوجَّه المبلغ بأكمله إلى مجمع سيولة DA.
   120 يوماً = نافذة دنيا مضمونة، لا انتهاء صلاحية تلقائي: يُفحَص معيار accumulativeDecayTime فقط داخل withdrawAccumulative() — مسار إعادة التوزيع المُفعَّل من قِبل المسؤول/الخدمة. لا يُقيَّم على مسارات الصرف أو التحويل. عمليّاً يعني هذا:

   • خلال أوّل 120 يوماً بعد الاحتساب، يكون الرصيد التراكمي مضمون السلامة — لا يمكن لأيّ شخص إعادة توزيعه.
   • بعد اليوم 120، يصبح الرصيد مؤهَّلاً لإعادة التوزيع، لكنّ إعادة التوزيع لا تُنفَّذ تلقائياً عند انقضاء المؤقّت. بل تحدث فقط عند استدعاء withdrawAccumulative() لذلك المستخدم تحديداً من قِبل SERVICE_ROLE أو ADMIN_ROLE.
   • حتى لحظة هذه المكالمة، يبقى الرصيد التراكمي “المنتهي” قابلاً للإنفاق على شراء وترقية NFT وقابلاً للتحويل إلى مستخدمين آخرين وفق القواعد والرسوم القياسية.

   النيّة المُعلَنة من الفريق، المُسجَّلة في ردّ التدقيق: “هدفنا هو ضمان سلامة أموال المستخدم لفترة زمنيّة معيّنة، لا إعطاؤها دورة حياة.” اعتبر الـ 120 يوماً النافذة الدنيا المضمونة قبل احتمال إعادة التوزيع، وليست طابعَ انتهاء صارم على السلسلة.
3. الحدّ (limit): يُمثِّل الحدّ الأقصى للدخل المتبقّي الذي يمكن لـ NFT أن يولّده.

​

أرصدة النظام

بالإضافة إلى أرصدة المستخدم، يحافظ العقد الذكي على ثلاثة أرصدة نظام داخليّة:

• رصيد التطوير (devBalance): يجمع رسوم المنصّة والعمولات لتمويل التشغيل.
• رصيد احتياطي الرمز (tokenReserveBalance): مجمع سيولة USDT الذي يدعم رمز DA بنسبة 100%. كلّ مصدر دخل في النظام البيئي يصبّ في هذا المجمع.
• رصيد تأثير السعر (priceImpactBalance): احتياطي خاصّ يُستخدَم لإدارة استقرار سعر رمز DA خلال أحداث محدّدة في النظام البيئي.

تُدار هذه الأرصدة بالكامل بواسطة العقد الذكي وليست متاحة لأيّ مستخدم فردي أو مسؤول.

​

أولويّة الدفع

عند إجراء عملية شراء، يخصم العقد الذكي الأموال بهذا الترتيب: