المعيار
A-REX Core — المعيار
ما يحدده المعيار، وما يفعله الرمز المطابق، وكيف يتغير، وكيف يصبح ERC. يُتاح النص المعياري عبر الوصول المبكر.
الحالة
المسودة 2.1.0-alpha.2، قبل التقديم، مع مخطط البيانات الوصفية للدفعة 1.2.0. كُتب النص بصيغة طلب تعليقات إيثريوم (ERC) كي يمكن تقديمه إلى ethereum/ERCs بعد أن يستخدم منفّذون مستقلون الواجهات في الإنتاج. سيُنشر بموجب CC0؛ والتنفيذ المرجعي بموجب MIT. وإلى أن يوجد منفّذان مستقلان، تُوسَم التغييرات المقبولة بأنها مؤقتة.
ما يحدده
A-REX Core امتداد صغير لـ ERC-1155 وERC-7943. الدفعة (شحنة من سلعة مادية، أو الحق في شحنة مستقبلية) هي معرّف رمز واحد في ERC-1155. ويضيف المعيار إليها أربع طبقات:
| الطبقة | الواجهة | ما تغطيه | إلزامية |
|---|---|---|---|
| 0 | ERC-1155 وERC-165 وIERC7943MultiToken | الأرصدة والتحويلات بالدفعات؛ التجميد، والتحويل القسري، وأهلية الحسابات | نعم |
| 1 | IARexBatch | سجل الدفعة: رموز مفتوحة للسلعة والوحدة، وتاريخا الإنتاج وانتهاء الصلاحية، ومرجع للمنشأ، والتزام بوثيقة خارج السلسلة، وحالة دورة الحياة، والنسب عند تقسيم الدفعة أو دمجها أو معالجتها | نعم |
| 2 | IARexHook وIARexHookManager | خط واحد مرتب من عقود القواعد الخارجية؛ تجيب القاعدة بسبب قابل للقراءة آليًا | نعم |
| 3 | IARexAttest | الشهادات وعمليات التفتيش والإقرارات لكل دفعة وموضوع، من جهات إصدار موثوقة لذلك الموضوع | موصى بها، في الرمز أو في عقد مرافق |
ما يفعله الرمز المطابق
- يتصرف كرمز ERC-1155 عادي، فتعمل المحافظ والأسواق والمفهرسات دون تغيير.
- يتيح واجهة الإنفاذ في ERC-7943: يمكن تجميد دفعة أو نقلها بأمر قضائي أو بسبب رهن أو سحب من السوق، وكل إجراء من هذا النوع مرئي على السلسلة.
- يحتفظ بسجل لكل دفعة ويدوّن كل تقسيم أو دمج أو خطوة معالجة، بحيث يمكن دائمًا تتبّع الدفعات الأصلية.
- يمرّر كل تحويل عبر خط قواعده ويستطيع أن يبيّن سبب رفض التحويل.
- يعلن الواجهات التي ينفذها كي تتمكن الأدوات من اكتشافه.
يكون عقد القواعد (الخطّاف) مطابقًا عندما ينفذ IARexHook. ويمكن لعقد قواعد واحد أن يخدم رموزًا كثيرة.
كيف يُتحقق من المطابقة
يأتي التنفيذ المرجعي بمجموعة اختبارات مطابقة لا تعتمد عليه: إذ لا يُوصَل إلى التنفيذ قيد الاختبار إلا عبر الواجهات المعيارية ومهايئ صغير يكتبه مؤلفوه. ويحمل كل اختبار البند الذي يتحقق منه؛ وعدد البنود 85، منها 74 بمستوى MUST و11 بمستوى SHOULD. وينتهي التشغيل بحكم، ويجب أن يشرح ادعاء المطابقة كل بند تخطّاه. أما البنود التي لا يمكن ملاحظتها على السلسلة، مثل قاعدة أن مرجع المنشأ لا يحمل بيانات شخصية، فتُترك للمراجعة.
مقترح وغير منشور
هذه التغييرات مكتوبة ومفتوحة للمراجعة. ولم يُقبل أي منها: فكل منها ينتظر تأكيد منفّذَين مستقلَّين، وتخضع التغييرات بمستوى MUST لقاعدة التغييرات الرئيسية.
| المقترح | ما الذي سيغيّره |
|---|---|
| ADR-019 (مقترح): القدرات في المعيار، والسياسات في ملفات السياسات | يثبّت المعيار الأدوار والأحداث وأشكال البيانات ودلالات الإيقاف المؤقت والإبطال وقواعد الخصوصية؛ أما من يجوز له استخدام قدرة ما، وهل هي مفعّلة، وأي القوائم أو السلطات تنطبق، فتنتقل إلى ملفات سياسات ذات إصدارات لكل ولاية قضائية ولكل مؤسسة. ويأتي بتوضيحين: يجب ألا يُشتق مرجع المنشأ من الموقع (لا تجزئة ولا ترميز للإحداثيات أو لهندسة قطعة الأرض)؛ وتُبطل الإفادةَ جهةُ إصدارها أو جهة إبطال فوّضتها، بينما لا ينبغي لدور إداري أن يُبطل في 2.x إفادة لم يُصدرها، ويجب ألا يفعل ذلك بدءًا من 3.0، كي تبقى الرموز المنشورة بالفعل مطابقة للمعيار. |
ADR-017 (مقترح): extensions في البيانات الوصفية | سيضيف مخطط البيانات الوصفية 1.3.0 كائن extensions اختياريًا، بمُدخل واحد لكل قاعدة، يتحقق منه جزء المخطط الوارد في واصف القاعدة. |
| ADR-018 (مقترح): البصمة الكربونية المصرَّح بها | يجوز للدفعة أن تحمل بصمة كربونية لمنتج يصرّح بها طرف ثالث مسمّى، منسوخة من PACT 3.0.3 إلى extensions.pact_pcf مع حالة تحقق؛ ولا تُحسب ولا تُجمع ولا تُمرَّر أبدًا إلى دفعات أخرى. |
| ADR-020 وADR-021 وADR-022 (مقترح): المهايئات المرجعية | تقرأ أدوات ERC-3643 كل دفعة عبر عرض لا يستطيع أن يسمح بأي شيء أو يرفضه؛ وادعاءات ONCHAINID صالحة ما دامت A-REX تثق بموقّعها؛ ومرآة على EAS للشهادات وسجلات الدفعات السارية. إرشادية: لا تضيف أي متطلب. |
واصف القواعد arex.module/1 (إرشادي، مقترح) | مستند JSON تنشره القاعدة أو الإضافة كي يدمجها مستخدموها دون شيفرة مخصصة. |
لا تضيف المقابلات الإرشادية مع GS1 EPCIS 2.0 وUN Transparency Protocol 0.7.0 وPACT 3.0.3 وERC-3643 وEthereum Attestation Service أي متطلب؛ ويلخّصها فصل قابلية التشغيل البيني.
ما يتركه خارجه
لا توجد قائمة بالمحاصيل أو الدرجات أو الشهادات: الرموز مفتوحة. لا توجد بيانات شخصية على السلسلة: لا إحداثيات قطع أراضٍ، ولا أسماء، ولا معرّفات لأشخاص طبيعيين، ولا أي قيمة محسوبة من موقع قطعة الأرض. لا يُفرض أي مزوّد هوية أو أوراكل أو سجل، ولا أي سياسة: فمن يجوز له الإنفاذ أو الإيقاف المؤقت أو الفحص، ومقابل أي القوائم، قرار تتخذه جهة الإصدار بموجب ولايتها القضائية. تُبنى منحنيات التلف وتدفقات التسليم ومحاسبة الكربون والتأمين كقواعد أو عقود مرافقة؛ ويعرض التنفيذ المرجعي بعضها، ولا تعتمد المطابقة عليها.
الإصدارات
تُرقَّم الواجهات مع المعيار. أي تغيير في دالة أو حدث أو متطلب هو إصدار رئيسي ويرافقه دليل ترحيل. والإضافات الاختيارية، مثل رموز موصى بها جديدة أو حقول بيانات وصفية، إصدار فرعي: فقد فتح مخطط البيانات الوصفية 1.1.0 نظام ترميز السلع، وأضاف المخطط 1.2.0 مراجع إلى دفعات رموز أخرى (upstream). ويظل كل مستند صالح بموجب مخطط سابق صالحًا. وحتى التقديم قد تتغير الواجهات، دائمًا كإصدار رئيسي.
الطريق إلى ERC
يُقدَّم النص إلى ethereum/ERCs عند تحقق أربعة شروط: تشغيل نشر إنتاجي بدفعات حقيقية لستة أشهر؛ وجود ثلاثة عقود قواعد مستقلة على الأقل؛ امتلاك التنفيذ المرجعي تدقيقًا خارجيًا منشورًا؛ وعدم تغيّر الواجهات طوال دورة إصدار واحدة. خارطة الطريق في التطورات المستقبلية.
ما يحجبه هذا الموقع
تبقى البنود المعيارية، ومصادر الواجهات ومعرّفاتها، ورموز الرفض، ومخطط البيانات الوصفية للدفعة في مستودع المعيار ما دام خاصًا. تطلب الشركات التي تريد تنفيذ A-REX أو إصدار دفعات به أو تدقيقه حق القراءة عبر طلب وصول مبكر. تُراجَع كل طلب يدويًا؛ ويحصل القرّاء المقبولون على وصول للقراءة فقط إلى المعيار والتنفيذ المرجعي. تبقى المواد سرية حتى نشرها بموجب CC0، ولا يمنح الوصول المبكر أي حصرية.