# البناء والمساهمة

المستودع الأولي مساحة تطوير خاصة تحتوي وثائق وموقعاً ثابتاً وفحوص مستودع. يتطلب النشر مفتوح المصدر والإصدارات القابلة للتنفيذ مراجعة منفصلة. لا تفترض ترخيصاً قبل اعتماد ملف ترخيص صريح.

## النهج الهندسي

نواة حتمية واحدة، وأغلفة تقديم خفيفة، ومحولات خاصة بالمصدر، مع الاحتفاظ بالأدلة الأصلية. استخدم مكتبات تشفير مراجَعة. لا تنشئ تفسيراً مستقلاً للسياسة في كل لغة SDK.

اقرأ `AGENTS.md` قبل التعديل. اعمل في فروع صغيرة بمعايير قبول واضحة. سجّل إصدارات التبعيات ومراجعات مواصفات المصدر بدقة. أرفق حالة اختبار فاشلة مع كل مثال ناجح.

## معايير المراجعة

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

## بنية المستودع

`docs/` مصدر الوثائق. يحدد `brand/` الهوية والتوكنات البصرية. يحتوي `specs/` المخططات المؤقتة. `site/` هو ناتج الموقع الثابت. يحتوي `scripts/` فحوص الوثائق المحلية. يحفظ `ops/` ملاحظات الإعداد الخاصة ولقطة من حالة النشر.

لا تضف حزم التشغيل المستقبلية إلا عند تنفيذها. لا تعرض المجلدات الفارغة أو أوامر الحزم على أنها برمجيات مكتملة.

## سير المساهمة

افتح قضية تصف المشكلة ومتطلبات الأدلة وما هو خارج النطاق وحالات النجاح والفشل. نفّذ خلف بوابة الحالة المناسبة. شغّل فحوص المستودع وصِف الاختبارات المنفذة فعلاً واطلب مراجعة. لا تضع أسرار العملاء في commit ولا تحرّك أموالاً حقيقية للاختبار.

<!-- p21-source-payment-v08 -->

## حالات توافق إضافية للمصادر والمدفوعات

تُختبر الأسماء وتوقيعات الحقول والأنماط المكررة، والحقول أو دلالات regex غير المدعومة، ومحتوى النقش الخاطئ، وتجزئات المصدر المختلفة، والتاريخ غير المكتمل للتسجيل، والشبكة الخاطئة وإعادة تنظيم المصدر. تُختبر الادعاءات المبنية على nonce وحده أو مصدر معروف، والالتزامات اللاحقة للمصدر، وتغيير الترتيب أو الأوزان، وتكرار معرّفات الطلب أو السياقات لاختيار النتيجة، وإعادة المحاولة وحجب المخرجات.

تشمل اختبارات NAT الأصلي النشر أو الرمز أو الشبكة أو المستلم الخاطئ، ونقل UNAT فقط، ونقش تحويل أنشئ ولم ينفذ، والدفع الناقص أو المتأخر أو الزائد، والملاحظات القديمة أو المتأخرة، وتعارض الفهارس، ونقص التأكيدات، والقيد المكرر لحدث، والحجوزات المتزامنة، واختلاف المستدعي، وتكرار الاسترداد وإعادة التنظيم بعد استهلاك الرصيد. يُختبر الطلب نفسه مستقلاً عبر USDC. الاختبار الاصطناعي للسياسة ليس اختبار تسوية بأموال حقيقية.


[1] https://digital-matter-theory.gitbook.io/digital-matter-theory/introduction/digital-elements/.element-registry

[2] https://github.com/Trac-Systems/ord-tap/blob/b8f6ea35cf6b9d405d4db7c58555e3c8ab33e8cd/src/index/updater/inscription_updater/tap/ops/dmt_element.rs

[3] https://digital-matter-theory.gitbook.io/digital-matter-theory/introduction/nat-use-cases/usdnat-method-1-live

[4] https://digital-matter-theory.gitbook.io/digital-matter-theory/introduction/non-arbitrary-tokens-nats/nat-token-transfer

[5] https://docs.x402.org/core-concepts/network-and-token-support

[6] https://github.com/Trac-Systems/ord-tap/blob/b8f6ea35cf6b9d405d4db7c58555e3c8ab33e8cd/README.md

[7] https://arxiv.org/abs/1605.04559