EXTERNAL-ISSUER 是无需 IMPORT,用一条记录引用 Issuer 所公布文档中 LOCAL ID 的指示声明 Reference。

项目值
名称EXTERNAL-ISSUER-2WORD(5Q 分组。各代码的名称见下方成员表)
TAG ID0x02FL~0x033L
章节1 0001(Reference EXTERNAL),章节内偏移 C = 15~19
KindReference · 分类:指示声明
Hugo 侧reference/external-issuer.md(该页还一并讲述EXTERNAL-ISSUER-4WORD、EXTERNAL-ISSUER-16WORD)

成员

本页合并讲述一套 5Q 体系的五个代码。量化由章节内偏移 C % 5 决定(Reference)。每个代码各有一份 Codec 文档。五份 Codec 文档的字段相同,只有 DECLARE 目标和名称(BIND)不同。

TAG ID名称量化Codec ID规格文档TAG WORD
0x02FLEXTERNAL-ISSUER-2WORD-IDENTIFIEDIdentified0x000002F00x00000000/codecs/0x000002F0/0000 0010 1111 LLLL
0x030LEXTERNAL-ISSUER-2WORD-GENERICGeneric0x000003000x00000000/codecs/0x00000300/0000 0011 0000 LLLL
0x031LEXTERNAL-ISSUER-2WORD-FREE-CHOICEFree-choice0x000003100x00000000/codecs/0x00000310/0000 0011 0001 LLLL
0x032LEXTERNAL-ISSUER-2WORD-UNIVERSALUniversal0x000003200x00000000/codecs/0x00000320/0000 0011 0010 LLLL
0x033LEXTERNAL-ISSUER-2WORD-VARIABLEVariable0x000003300x00000000/codecs/0x00000330/0000 0011 0011 LLLL

字段(规格文档)

FIELD 在文档中的顺序就是 Payload 字段的顺序(Codec 规格文档)。

顺序字段(BIND)FIELD宽度接受的格式(CODEC)ENUM
1issuer#2原始值 2 WORD
2doc#3原始值 4 WORD
3target-id#4剩余原始值(0xFFFF)

EXTERNAL-ISSUER 是无需 IMPORT 即可引用 Issuer 所公布文档中 LOCAL ID 的指示声明 Reference。一条记录即含义完整,并跟随最新版本。

布局

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

相关页面

规格文档原文

这是用 geul show 读取规格文档 0x00000000/codecs/0x000002F0/latest.geul 的样子(十六进制为大写)。

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

以上是 EXTERNAL-ISSUER-2WORD-IDENTIFIED(0x02FL)的 Codec 文档。其他成员(EXTERNAL-ISSUER-2WORD-GENERIC、EXTERNAL-ISSUER-2WORD-FREE-CHOICE、EXTERNAL-ISSUER-2WORD-UNIVERSAL、EXTERNAL-ISSUER-2WORD-VARIABLE)的 Codec 文档,只有 DOC-ID 的 Codec ID、DECLARE 目标、#1 上绑定的名称(BIND)不同。