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émentValeur
NomEXTERNAL-ISSUER-16WORD (groupe 5Q. Noms par code dans le tableau des membres ci-dessous)
TAG ID0x039L~0x03DL
Section1 0001 (Reference EXTERNAL), offset dans la section C = 25~29
KindReference · classification : désignation-déclaration
Côté Hugoreference/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 IDNomQuantificationCodec IDDocument de spécificationTAG 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

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).

OrdreChamp (BIND)FIELDLargeurFormat accepté (CODEC)ENUM
1issuer#2valeur brute 16 WORD
2doc#3valeur brute 4 WORD
3target-id#4valeur 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)NomLargeur de l’Issuer
0x02FL~0x033LEXTERNAL-ISSUER-2WORD2 WORD (enregistré auprès de geul.org, preuve de domaine)
0x034L~0x038LEXTERNAL-ISSUER-4WORD4 WORD (enregistré auprès de geul.org, sans preuve)
0x039L~0x03DLEXTERNAL-ISSUER-16WORD16 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, avec C l’offset dans la section) vaut 0, 1, 2, la largeur est 2, 4, 16 WORD. La quantification est C % 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 de 2^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 document 0 est 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 cible 0 (le document lui-même) relève de DOC-POINTER.
  • Un WORD 0x0000 en tête de l’ID de cible est interdit.

Exemple

CibleSéquence de WORD
Issuer 0x00000002, document 0x…0002, LOCAL 702F7 0000 0002 0000 0000 0000 0002 0007
Issuer 0x00012345, document 0x…0002, LOCAL 702F7 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.