EXTERNAL-ISSUER is a pointer-declaration Reference that cites a LOCAL ID in a document published by an Issuer, without IMPORT, using a single record.
| Item | Value |
|---|---|
| Name | EXTERNAL-ISSUER-16WORD (a 5Q bundle. See the member table below for the name of each code) |
| TAG ID | 0x039L~0x03DL |
| Section | 1 0001 (Reference EXTERNAL), offset within section C = 25~29 |
| Kind | Reference · category: pointer-declaration |
| Hugo side | reference/external-issuer.md (that page also covers EXTERNAL-ISSUER-2WORD and EXTERNAL-ISSUER-4WORD) |
Members
This page covers one 5Q set, five codes together. The quantification is the offset within the section, C % 5 (Reference). There is one codec document per code. The fields of the five codec documents are the same; only the DECLARE target and the name (BIND) differ.
| TAG ID | Name | Quantification | Codec ID | Spec document | TAG WORD |
|---|---|---|---|---|---|
0x039L | EXTERNAL-ISSUER-16WORD-IDENTIFIED | Identified | 0x00000390 | 0x00000000/codecs/0x00000390/ | 0000 0011 1001 LLLL |
0x03AL | EXTERNAL-ISSUER-16WORD-GENERIC | Generic | 0x000003A0 | 0x00000000/codecs/0x000003A0/ | 0000 0011 1010 LLLL |
0x03BL | EXTERNAL-ISSUER-16WORD-FREE-CHOICE | Free-choice | 0x000003B0 | 0x00000000/codecs/0x000003B0/ | 0000 0011 1011 LLLL |
0x03CL | EXTERNAL-ISSUER-16WORD-UNIVERSAL | Universal | 0x000003C0 | 0x00000000/codecs/0x000003C0/ | 0000 0011 1100 LLLL |
0x03DL | EXTERNAL-ISSUER-16WORD-VARIABLE | Variable | 0x000003D0 | 0x00000000/codecs/0x000003D0/ | 0000 0011 1101 LLLL |
Fields (spec document)
The order of FIELDs in the document is the order of Payload fields (Codec spec document).
| Order | Field (BIND) | FIELD | Width | Accepted form (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | issuer | #2 | Raw value, 16 WORD | ||
| 2 | doc | #3 | Raw value, 4 WORD | ||
| 3 | target-id | #4 | Remaining raw value (0xFFFF) |
EXTERNAL-ISSUER is a pointer-declaration Reference that cites a LOCAL ID in a document published by an Issuer, without IMPORT. A single record is complete in meaning and follows the latest version.
Layout
TAG WORD 0000 001C CCCC LLLL Codec 0x02FL~0x03DL (section 1)
[Length extension TAG]
Issuer width set by the Codec (2/4/16 WORD)
Document ID 4 WORD
Target ID all the rest. LOCAL ID in that document, shortest width
| Codec (Identified, Generic, Free-choice, Universal, Variable) | Name | Issuer width |
|---|---|---|
0x02FL~0x033L | EXTERNAL-ISSUER-2WORD | 2 WORD (registered with geul.org, domain proof) |
0x034L~0x038L | EXTERNAL-ISSUER-4WORD | 4 WORD (registered with geul.org, no proof) |
0x039L~0x03DL | EXTERNAL-ISSUER-16WORD | 16 WORD (computed from a public key) |
- The width is set by the scheme number: if the scheme − 9 (
C / 5 − 3of the offset within the sectionC) is 0, 1, or 2, the width is 2, 4, or 16 WORD. The quantification isC % 5. - The Issuer ID is an integer value. The same value is the same Issuer. Write the Issuer in the shortest width that fits the value, and choose the Codec of that width (4 WORD only at
2^32or above, 16 WORD only at2^64or above). A notation in a wider width is invalid (Issuer). - geul.org handles Issuer registration and management.
- No version is written; it follows the latest version. To pin the version, use IMPORT-DOC and EXTERNAL-POINTER.
- The location is found by the publication address rule (Publication addresses and version list).
- The same LOCAL ID of that document is the same target whether it is written as a LOCAL inside that document, as an EXTERNAL-ISSUER in another document (or as an EXTERNAL-POINTER after IMPORT).
- It points only to a LOCAL of a document. A document itself is pointed to by DOC-POINTER, and an Issuer itself by ISSUER-POINTER. So the target ID is not
0. Document ID0is the term-definition index document of the Issuer.
Validity
- It is invalid if the Issuer width does not match the Codec, or if the value fits a narrower width.
- A target ID of
0is invalid. Target ID0(the document itself) is handled by DOC-POINTER. - A leading
0x0000WORD in the target ID is forbidden.
Examples
| Target | WORD sequence |
|---|---|
Issuer 0x00000002, document 0x…0002, LOCAL 7 | 02F7 0000 0002 0000 0000 0000 0002 0007 |
Issuer 0x00012345, document 0x…0002, LOCAL 7 | 02F7 0001 2345 0000 0000 0000 0002 0007 |
Related pages
Spec document source
This is the spec document 0x00000000/codecs/0x00000390/latest.geul as read by geul show (hex in uppercase).
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"
The above is the codec document of EXTERNAL-ISSUER-16WORD-IDENTIFIED (0x039L). The codec documents of the other members (EXTERNAL-ISSUER-16WORD-GENERIC, EXTERNAL-ISSUER-16WORD-FREE-CHOICE, EXTERNAL-ISSUER-16WORD-UNIVERSAL, EXTERNAL-ISSUER-16WORD-VARIABLE) differ only in the codec ID of the DOC-ID, the DECLARE target, and the name bound in #1 (BIND).