EXTERNAL-ISSUER est une Reference de désignation-déclaration qui cite, sans IMPORT et en un seul enregistrement, le LOCAL ID d’un document publié par un Issuer.
| Élément | Valeur |
|---|---|
| Nom | EXTERNAL-ISSUER-16WORD (groupe 5Q. Noms par code dans le tableau des membres ci-dessous) |
| TAG ID | 0x039L~0x03DL |
| Section | 1 0001 (Reference EXTERNAL), offset dans la section C = 25~29 |
| Kind | Reference · classification : désignation-déclaration |
| Côté Hugo | reference/external-issuer.md (cette page traite aussi de EXTERNAL-ISSUER-2WORD et EXTERNAL-ISSUER-4WORD) |
Membres
Cette page traite d’un jeu complet du système 5Q, soit cinq codes. La quantification est l’offset dans la section C % 5 (Reference). Il y a un document de Codec par code. Les champs des cinq documents de Codec sont identiques ; seuls la cible DECLARE et le nom (BIND) diffèrent.
| TAG ID | Nom | Quantification | Codec ID | Document de spécification | 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 |
Champs (document de spécification)
L’ordre des FIELD dans le document est l’ordre des champs du Payload (document de spécification de Codec).
| Ordre | Champ (BIND) | FIELD | Largeur | Format accepté (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | issuer | #2 | valeur brute 16 WORD | ||
| 2 | doc | #3 | valeur brute 4 WORD | ||
| 3 | target-id | #4 | valeur brute restante (0xFFFF) |
EXTERNAL-ISSUER est une Reference de désignation-déclaration qui cite, sans IMPORT, le LOCAL ID d’un document publié par un Issuer. Un seul enregistrement suffit à en donner le sens, et elle suit la version la plus récente.
Disposition
TAG WORD 0000 001C CCCC LLLL Codec 0x02FL~0x03DL (section 1)
[TAG d'extension de Length]
Issuer largeur fixée par le Codec (2/4/16 WORD)
ID de document 4 WORD
ID de cible tout le reste. LOCAL ID de ce document, sur la largeur la plus courte
| Codec (Identified, Generic, Free-choice, Universal, Variable) | Nom | Largeur de l’Issuer |
|---|---|---|
0x02FL~0x033L | EXTERNAL-ISSUER-2WORD | 2 WORD (enregistré auprès de geul.org, preuve de domaine) |
0x034L~0x038L | EXTERNAL-ISSUER-4WORD | 4 WORD (enregistré auprès de geul.org, sans preuve) |
0x039L~0x03DL | EXTERNAL-ISSUER-16WORD | 16 WORD (calculé à partir de la clé publique) |
- La largeur est fixée par le numéro de système : si système − 9 (
C / 5 − 3, avecCl’offset dans la section) vaut 0, 1, 2, la largeur est 2, 4, 16 WORD. La quantification estC % 5. - L’Issuer ID est une valeur entière. Si la valeur est égale, c’est le même Issuer. L’Issuer s’écrit sur la plus courte largeur où la valeur tient, et l’on choisit le Codec de cette largeur (4 WORD seulement à partir de
2^32, 16 WORD seulement à partir de2^64). Une notation plus large est invalid (Issuer). - L’enregistrement et la gestion des Issuer relèvent de geul.org.
- La version n’est pas indiquée ; on suit la version la plus récente. Pour fixer la version, on utilise IMPORT-DOC et EXTERNAL-POINTER.
- L’emplacement se trouve par la règle d’adresse de publication (adresse de publication et liste des versions).
- Pour un même LOCAL ID de ce document, c’est la même cible, qu’on l’écrive en LOCAL dans ce document, en EXTERNAL-ISSUER dans un autre document (ou en EXTERNAL-POINTER après IMPORT).
- Elle ne désigne que le LOCAL d’un document. Le document lui-même se désigne par DOC-POINTER, l’Issuer lui-même par ISSUER-POINTER. L’ID de cible n’est donc pas
0. L’ID de document0est le document d’index des définitions de termes de l’Issuer.
Validité
- Si la largeur de l’Issuer ne correspond pas au Codec, ou si la valeur tient dans une largeur plus étroite, c’est invalid.
- Si l’ID de cible vaut
0, c’est invalid. L’ID de cible0(le document lui-même) relève de DOC-POINTER. - Un WORD
0x0000en tête de l’ID de cible est interdit.
Exemple
| Cible | Séquence de WORD |
|---|---|
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 |
Pages liées
Texte source du document de spécification
Le document de spécification 0x00000000/codecs/0x00000390/latest.geul tel que le lit geul show (hexadécimal en majuscules).
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"
Ce qui précède est le document de Codec de EXTERNAL-ISSUER-16WORD-IDENTIFIED (0x039L). Pour les autres membres (EXTERNAL-ISSUER-16WORD-GENERIC, EXTERNAL-ISSUER-16WORD-FREE-CHOICE, EXTERNAL-ISSUER-16WORD-UNIVERSAL, EXTERNAL-ISSUER-16WORD-VARIABLE), seuls le Codec ID du DOC-ID, la cible DECLARE et le nom lié (BIND) en #1 diffèrent.