EXTERNAL-ISSUER は、Issuer が公表したドキュメントの LOCAL ID を、IMPORT なしにレコード 1 つで引用する指示宣言 Reference だ。

項目値
名前EXTERNAL-ISSUER-16WORD (5Q グループ。コードごとの名前は下のメンバー表)
TAG ID0x039L~0x03DL
セクション1 0001 (Reference EXTERNAL)、セクション内オフセット C = 25~29
KindReference · 分類: 指示宣言
Hugo 側reference/external-issuer.md (そのページは EXTERNAL-ISSUER-2WORD、EXTERNAL-ISSUER-4WORD もまとめて扱う)

メンバー

このページは 5Q 体系の 1 セット、コード 5 つをまとめて扱う。量化はセクション内オフセット C % 5 だ(Reference)。Codec ドキュメントはコードごとに 1 つある。5 つの Codec ドキュメントはフィールドが同じで、DECLARE 対象と名前(BIND)だけが異なる。

TAG ID名前量化Codec ID規格ドキュメントTAG WORD
0x039LEXTERNAL-ISSUER-16WORD-IDENTIFIEDIdentified0x000003900x00000000/codecs/0x00000390/0000 0011 1001 LLLL
0x03ALEXTERNAL-ISSUER-16WORD-GENERICGeneric0x000003A00x00000000/codecs/0x000003A0/0000 0011 1010 LLLL
0x03BLEXTERNAL-ISSUER-16WORD-FREE-CHOICEFree-choice0x000003B00x00000000/codecs/0x000003B0/0000 0011 1011 LLLL
0x03CLEXTERNAL-ISSUER-16WORD-UNIVERSALUniversal0x000003C00x00000000/codecs/0x000003C0/0000 0011 1100 LLLL
0x03DLEXTERNAL-ISSUER-16WORD-VARIABLEVariable0x000003D00x00000000/codecs/0x000003D0/0000 0011 1101 LLLL

フィールド (規格ドキュメント)

FIELD のドキュメント内の順序が Payload のフィールド順だ(Codec 規格ドキュメント)。

順序フィールド(BIND)FIELD幅受け取る形式(CODEC)ENUM
1issuer#2生値 16 WORD
2doc#3生値 4 WORD
3target-id#4残り全部の生値(0xFFFF)

EXTERNAL-ISSUER は、Issuer が公表したドキュメントの LOCAL ID を IMPORT なしに引用する指示宣言 Reference だ。レコード 1 つで意味が完結し、最新バージョンに従う。

レイアウト

TAG WORD          0000 001C CCCC LLLL      Codec 0x02FL~0x03DL (セクション 1)
[Length 拡張 TAG]
Issuer            Codec が定める幅 (2/4/16 WORD)
ドキュメント ID   4 WORD
対象 ID           残り全部。そのドキュメントの LOCAL ID、最短幅
Codec (Identified, Generic, Free-choice, Universal, Variable)名前Issuer 幅
0x02FL~0x033LEXTERNAL-ISSUER-2WORD2 WORD (geul.org 登録、ドメイン証明)
0x034L~0x038LEXTERNAL-ISSUER-4WORD4 WORD (geul.org 登録、証明なし)
0x039L~0x03DLEXTERNAL-ISSUER-16WORD16 WORD (公開鍵から計算)
  • 幅は体系番号で決まる: 体系 − 9(セクション内オフセット C の C / 5 − 3)が 0、1、2 なら 2、4、16 WORD だ。量化は C % 5 だ。
  • Issuer ID は整数値だ。値が同じなら同じ Issuer だ。Issuer は値が収まる最短幅で書き、その幅の Codec を選ぶ(2^32 以上のときだけ 4 WORD、2^64 以上のときだけ 16 WORD)。より広い幅の表記は invalid だ(Issuer)。
  • Issuer の登録と管理は geul.org が担う。
  • バージョンは書かず、最新バージョンに従う。バージョンを固定するには IMPORT-DOC と EXTERNAL-POINTER を使う。
  • 場所は公表アドレスの規則で見つける(公表アドレスとバージョン一覧)。
  • そのドキュメントの同じ LOCAL ID なら、そのドキュメント内で LOCAL として書いても、別のドキュメントで EXTERNAL-ISSUER として書いても(または IMPORT の後に EXTERNAL-POINTER として書いても)同じ対象だ。
  • ドキュメントの LOCAL だけを指す。ドキュメント自身は DOC-POINTER、Issuer 自身は ISSUER-POINTER で指す。したがって対象 ID は 0 ではない。ドキュメント ID 0 は Issuer の用語定義索引ドキュメントだ。

有効性

  • Issuer 幅が Codec と合わない、または値がより狭い幅に収まるなら invalid だ。
  • 対象 ID が 0 なら invalid だ。対象 ID 0(ドキュメント自身)は DOC-POINTER が担う。
  • 対象 ID の先頭の 0x0000 WORD は禁止する。

例

対象WORD sequence
Issuer 0x00000002、ドキュメント 0x…0002、LOCAL 702F7 0000 0002 0000 0000 0000 0002 0007
Issuer 0x00012345、ドキュメント 0x…0002、LOCAL 702F7 0001 2345 0000 0000 0000 0002 0007

関連ページ

規格ドキュメント原文

規格ドキュメント 0x00000000/codecs/0x00000390/latest.geul を geul show で読んだ様子だ(16進は大文字)。

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000039000000000
BODY
#1 DECLARE 0x0390
#2 FIELD #1 0x0010
#3 FIELD #1 0x0004
#4 FIELD #1 rest
#5 BIND #1 "EXTERNAL-ISSUER-16WORD-IDENTIFIED"
#6 BIND #2 "issuer"
#7 BIND #3 "doc"
#8 BIND #4 "target-id"

上は EXTERNAL-ISSUER-16WORD-IDENTIFIED(0x039L)の Codec ドキュメントだ。ほかのメンバー(EXTERNAL-ISSUER-16WORD-GENERIC、EXTERNAL-ISSUER-16WORD-FREE-CHOICE、EXTERNAL-ISSUER-16WORD-UNIVERSAL、EXTERNAL-ISSUER-16WORD-VARIABLE)の Codec ドキュメントは、DOC-ID の Codec ID、DECLARE 対象、#1 に結んだ名前(BIND)だけが異なる。