PUBLICATION وDEPRECATION وTOMBSTONE هي Edge عبارة تسجّل نشر إصدار الوثيقة والتوصية بإيقاف استخدامه وحذفه، وتحدد هذه الصفحة أيضاً مواصفة وثيقة قائمة الإصدارات المكتوبة بهذه الـ Edge (Codec 0x0B8L~0x0BAL).

البندالقيمة
الاسمTOMBSTONE (BIND مستند المواصفة TOMBSTONE)
TAG ID0x0BAL
Codec ID0x00000BA0
مستند المواصفة0x00000000/codecs/0x00000BA0/ (هدف DECLARE 0BA0)
القسم5 0101 (Edge العبارة)، الإزاحة داخل القسم C = 26
KindEdge · العائلة: العبارة، الحزمة: أخرى
TAG WORD0000 1011 1010 LLLL (000K KKKC CCCC LLLL)
وصف الفهرسحذف (شاهد قبر) لإصدار منشور. DOC-POINTER، فئة السبب
جانب Hugoedge/publication.md (وهو يتناول أيضاً PUBLICATION وDEPRECATION)

الحقول (مستند المواصفة)

ترتيب FIELD داخل المستند هو ترتيب حقول Payload (مستند مواصفة Codec). لا يُصرَّح بـ Edge Id الخاص بـ Edge عبر FIELD.

الترتيبالحقل (BIND)FIELDالعرضالصيغة المقبولة (CODEC)ENUM
1doc#2سجل0410 DOC-POINTER، 0420 CODEC-POINTER
2reason#4قيمة خام 1 WORD

هذه Edge عبارة تسجّل نشر الوثيقة وإهمالها (deprecate) وحذفها، وهي مواصفة وثيقة قائمة الإصدارات المكتوبة بتلك الـ Edge. تحدد صيغة قائمة الإصدارات في عنوان النشر وقائمة الإصدارات.

الرموز

CodecالاسمPayload
0x0B8LPUBLICATIONEdge Id وDOC-POINTER وتجزئة المحتوى
0x0B9LDEPRECATIONEdge Id وDOC-POINTER
0x0BALTOMBSTONEEdge Id وDOC-POINTER وفئة السبب
  • الرموز الثلاثة مضمَّنة في المفكِّك (الطبقة 0). تُفسَّر قائمة الإصدارات دون الرجوع إلى codebook.
  • لا توجد صيغة فرعية (TAG خاص بالـ Codec). تُحفظ قاعدة Edge كما هي: أول عنصر في Payload هو Edge Id.

التخطيط

TAG WORD          Edge، Codec 0x0B8L / 0x0B9L / 0x0BAL
[Length TAG ممتد]
Edge Id           سجل LOCAL Reference
الوثيقة            سجل DOC-POINTER Reference (Issuer، ID الوثيقة، ID الإصدار). وفي قائمة إصدارات Codec يكون CODEC-POINTER
تجزئة المحتوى      16 WORD   (PUBLICATION)
فئة السبب          1 WORD    (TOMBSTONE)
الحقلالعرضالوصف
Edge Idسجل LOCAL Referenceالرقم التسلسلي في القائمة. يُرقَّم من 1 ويُلحق تباعاً
الوثيقةسجل DOC-POINTERإصدار واحد من الوثيقة المنشورة (DOC-POINTER). Issuer وID الوثيقة هما نفسا الوثيقة التي تتناولها القائمة. فتبيّن وثيقة القائمة ما هي قائمته حتى دون مسار. ID الإصدار هو الرقم التسلسلي داخل تلك الوثيقة (إصدار الوثيقة) ولا يُستخدم 0 (الأحدث). وتستخدم قائمة إصدارات Codec CODEC-POINTER (Issuer، Codec ID، ID الإصدار)
تجزئة المحتوى16 WORDتجزئة محتوى ذلك الإصدار (SHA-256، تجزئة محتوى الوثيقة)
فئة السبب1 WORDرمز فئة سبب الحذف. جدول الرموز مسألة مفتوحة
  • الطول بعد DOC-POINTER ثابت لكل رمز (16 و0 و1 WORD). وإن اختلف رُفض.
  • لا يوضع الزمن في السجل. فـ RECORDED-AT في وثيقة القائمة التي نُشر فيها السجل أول مرة هو زمن النشر والإهمال والحذف.

وثيقة قائمة الإصدارات

تواصل جهة النشر كتابة وثيقة قائمة إصدارات واحدة لكل وثيقة: /<Issuer>/docs/<ID الوثيقة>/versions.geul (وللـ Codec /<Issuer>/codecs/<Codec ID>/versions.geul، وقائمة Issuer في الأسفل). تدخل كل الإصدارات التي نشرتها تلك الجهة لتلك الوثيقة في قائمة واحدة.

DOC-1WORD/2WORD/4WORD     الطول الكلي
  SPEC-VERSION            0x0001 (v1)
  PARENT                  Value من نوع SHA-256-DIGEST. تجزئة محتوى وثيقة القائمة السابقة (لا يوجد إن كانت أول قائمة)
  RECORDED-AT             Value من نوع POSIX-TIMESTAMP-SECONDS. وقت إصدار هذه القائمة
  NEXT-LOCAL-ID           LOCAL ID التالي الذي سيُعيَّن (إن وُجدت إصدارات)
  SIGNATURE               توقيع جهة النشر. الهدف تجزئة محتوى وثيقة القائمة هذه
BODY
  PUBLICATION · DEPRECATION · TOMBSTONE …
END
  • HEAD Meta: SPEC-VERSION وPARENT وRECORDED-AT وNEXT-LOCAL-ID وSIGNATURE.
  • لا يوضع DOC-ID في وثيقة قائمة الإصدارات (استثناء لوثيقة القائمة، DOC-ID). فالقائمة ليست وثيقة منشورة بل سجل تابع للوثيقة. وما هي قائمته يبيّنه DOC-POINTER (ID الوثيقة) في السجل. لذلك يُعرف ما هي قائمته حتى لو استُلمت دون مسار (hashes/، dump).
  • يجب أن تكون ID الوثيقة في السجلات كلها هي الوثيقة التي تتناولها القائمة. ويُرفض سجل وثيقة أخرى.
  • لا تضع وثيقة قائمة الإصدارات IMPORT وتستخدم Codec الطبقة 0 فقط. ولا يوضع في BODY إلا PUBLICATION·DEPRECATION·TOMBSTONE. ولا يوضع BIND لاسم الوثيقة (عنوان النشر وقائمة الإصدارات).
  • تضع وثيقة القائمة الجديدة BODY وثيقة القائمة السابقة كما هو في المقدمة وتُلحق السجلات. لا تُعدَّل ولا تُحذف ولا يُغيَّر ترتيبها.
  • توقّع جهة النشر القائمة. فنشر geul.org يوقّعه geul.org (GEUL Issuer)، والنشر الخاص يوقّعه ذلك Issuer.
  • ID الوثيقة 0x0000000000000000 هي وثيقة فهرس تعريف مصطلحات Issuer (Issuer والنشر). ويُشار إلى Issuer نفسه بـ ISSUER-POINTER.

قائمة إصدارات وثيقة القائمة

وثيقة القائمة هي قائمة Issuer issuers/ واحدة (عنوان النشر وقائمة الإصدارات). وقائمة Issuer أيضاً تبدأ من الإصدار 1 وتضع قائمة الإصدارات issuers/versions.geul. يشير السجل إلى إصدار القائمة بـ DOC-POINTER لـ ID وثيقة محجوزة (0x00000000 و0xFFFFFFFFFFFFFFFF وID الإصدار).

  • صيغة السجل كما سبق. لذلك يُعرف ما هي قائمته حتى لو استُلمت بـ hashes/.
  • لا تضع وثيقة القائمة نفسها (<ID الإصدار>.geul) DOC-ID أيضاً.
  • ID الوثيقة 0xFFFFFFFFFFFFFFFF لا تُستلم في أي Issuer بعنوان <Issuer>/docs/<ID الوثيقة>/ (404).
  • latest.geul للقائمة اسم مستعار لا يُخزَّن. يُبحث في قائمة الإصدارات هذه عن أحدث إصدار ويُخرَج بايتاته.

القواعد

  • ID الإصدار في PUBLICATION تصاعدي بلا فجوات من 1. تعيّن جهة النشر ID الإصدار.
  • لا تُنشر تجزئة المحتوى نفسها مرة أخرى. وإن وُجدت أُعيد ID الإصدار ذاك.
  • يشير DEPRECATION·TOMBSTONE إلى ID إصدار PUBLICATION سبق ظهوره فقط. ويُرفض ما يشير إلى إصدار غير موجود.
  • تُحسب حالة الإصدار بتطبيق السجلات بالتتابع. منشور ← deprecated ← محذوف. لا يُنشر الإصدار المحذوف مرة أخرى ولا يُقدَّم.
  • أحدث إصدار هو أعلى ID إصدار ليس deprecated ولا محذوفاً.
  • إذا بلغ ID الإصدار نهاية 2 WORD فلا تُنشر الوثيقة أكثر وتُصدر بـ ID وثيقة جديدة.

العنوان

/.well-known/geul/<Issuer>/docs/<ID الوثيقة>/versions.geul        أحدث وثيقة قائمة (متغيرة)
/.well-known/geul/<Issuer>/codecs/<Codec ID>/versions.geul        أحدث وثيقة قائمة للـ Codec (متغيرة)
/.well-known/geul/issuers/versions.geul                           أحدث قائمة إصدارات لقائمة Issuer (متغيرة)
/.well-known/geul/<Issuer>/hashes/<تجزئة المحتوى>.geul             وثيقة قائمة سابقة (ثابتة)
  • المتغير هو عنوان أحدث قائمة. يُتحقَّق من القائمة المستلمة بالتوقيع وRECORDED-AT وسلسلة PARENT.
  • تبقى وثائق القوائم السابقة كلها في <Issuer>/hashes/. وبتتبع سلسلة PARENT يمكن استرجاع القائمة في أي وقت.

التحقق

  • يجب أن يكون في وثيقة القائمة SIGNATURE بمفتاح جهة النشر المحدد.
  • يجب أن تكون ID الوثيقة في السجلات مساوية لـ ID الوثيقة المطلوبة.
  • يجب أن تكون تجزئة محتوى القائمة السابقة المسجلة في سجل القفل ضمن سلسلة PARENT للقائمة الجديدة. ويجب أن يساوي BODY تلك القائمة مقدمة BODY القائمة الجديدة.
  • يجب أن تساوي تجزئة محتوى الوثيقة المستلمة القيمةَ التي دوّنها PUBLICATION لـ ID الإصدار ذاك، وأن يساوي DOC-ID للوثيقة Issuer وID الوثيقة المطلوبين. وليس لوثيقة القائمة DOC-ID.

مسائل مفتوحة

  • جدول رموز فئة السبب.
  • القيمة الافتراضية لخوارزمية التوقيع وتخطيط Payload الخاص بـ SIGNATURE.
  • وقت الانتقال إلى سجل Merkle (إثبات التضمين والاتساق) وصيغته عندما تكبر القائمة.
  • منع الإرجاع إلى الوراء على مستوى Issuer. ولأن القوائم تشكّل سلسلة منفصلة لكل وثيقة، فإن هجوم تقديم قائمة قديمة لوثيقة واحدة لا يُمنع إلا بسلسلة تلك الوثيقة.

صفحات ذات صلة

نص مستند المواصفة الأصلي

هذا مستند المواصفة 0x00000000/codecs/0x00000BA0/latest.geul كما يُقرأ بـ geul show (الأرقام السداسية عشرية بحروف كبيرة).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000BA000000000
BODY
#1 DECLARE 0x0BA0
#2 FIELD #1 record
#9 CODEC #2 0x0410
#4 FIELD #1 0x0001
#5 BIND #1 "TOMBSTONE"
#6 BIND #2 "doc"
#8 BIND #4 "reason"
#10 CODEC #2 0x0420