EXTERNAL-ISSUER es un Reference de designación y declaración que cita en un solo registro, sin IMPORT, el LOCAL ID de un documento publicado por un Issuer.

ElementoValor
NombreEXTERNAL-ISSUER-16WORD (grupo 5Q. Los nombres por código están en la tabla de miembros más abajo)
TAG ID0x039L~0x03DL
Sección1 0001 (Reference EXTERNAL), desplazamiento dentro de la sección C = 25~29
KindReference · clasificación: designación y declaración
Lado Hugoreference/external-issuer.md (esa página trata también EXTERNAL-ISSUER-2WORD y EXTERNAL-ISSUER-4WORD)

Miembros

Esta página trata un conjunto del sistema 5Q, cinco códigos a la vez. La cuantificación es el desplazamiento dentro de la sección C % 5 (Reference). Hay un documento de Codec por código. Los campos de los cinco documentos de Codec son iguales; solo difieren el destino de DECLARE y el nombre (BIND).

TAG IDNombreCuantificaciónCodec IDDocumento de especificaciónTAG 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

Campos (documento de especificación)

El orden de los FIELD dentro del documento es el orden de los campos del Payload (Documento de especificación de Codec).

OrdenCampo (BIND)FIELDAnchoFormato aceptado (CODEC)ENUM
1issuer#2valor en bruto de 16 WORD
2doc#3valor en bruto de 4 WORD
3target-id#4resto en valor en bruto (0xFFFF)

EXTERNAL-ISSUER es un Reference de designación y declaración que cita, sin IMPORT, el LOCAL ID de un documento publicado por un Issuer. Un solo registro completa el sentido y sigue la versión más reciente.

Layout

TAG WORD          0000 001C CCCC LLLL      Codec 0x02FL~0x03DL (sección 1)
[TAG de extensión de Length]
Issuer            ancho fijado por el Codec (2/4/16 WORD)
ID de documento   4 WORD
ID de destino     todo el resto. LOCAL ID de ese documento, en el ancho más corto
Codec (Identified, Generic, Free-choice, Universal, Variable)NombreAncho del Issuer
0x02FL~0x033LEXTERNAL-ISSUER-2WORD2 WORD (registrado en geul.org, dominio verificado)
0x034L~0x038LEXTERNAL-ISSUER-4WORD4 WORD (registrado en geul.org, sin verificación)
0x039L~0x03DLEXTERNAL-ISSUER-16WORD16 WORD (calculado a partir de la clave pública)
  • El ancho lo fija el número de sistema: si sistema − 9 (C / 5 − 3, con C el desplazamiento dentro de la sección) es 0, 1 o 2, el ancho es 2, 4 o 16 WORD. La cuantificación es C % 5.
  • El Issuer ID es un valor entero. Si el valor es igual, es el mismo Issuer. El Issuer se escribe con el ancho más corto en que quepa el valor, y se elige el Codec de ese ancho (4 WORD solo a partir de 2^32, 16 WORD solo a partir de 2^64). Una notación de ancho mayor es invalid (Issuer).
  • El registro y la administración de Issuer los lleva geul.org.
  • No se escribe la versión; se sigue la más reciente. Para fijar la versión se usan IMPORT-DOC y EXTERNAL-POINTER.
  • La ubicación se encuentra con la regla de direcciones de publicación (Direcciones de publicación y lista de versiones).
  • Si es el mismo LOCAL ID de ese documento, es el mismo objeto tanto si dentro de ese documento se usa como LOCAL como si en otro documento se usa como EXTERNAL-ISSUER (o como EXTERNAL-POINTER tras un IMPORT).
  • Solo señala LOCAL de documentos. El propio documento se señala con DOC-POINTER y el propio Issuer con ISSUER-POINTER. Por eso el ID de destino no es 0. El ID de documento 0 es el documento índice de definición de términos del Issuer.

Validez

  • Es invalid si el ancho del Issuer no concuerda con el Codec, o si el valor cabe en un ancho más estrecho.
  • Es invalid si el ID de destino es 0. El ID de destino 0 (el propio documento) corresponde a DOC-POINTER.
  • Se prohíbe un WORD 0x0000 inicial en el ID de destino.

Ejemplo

DestinoWORD sequence
Issuer 0x00000002, documento 0x…0002, LOCAL 702F7 0000 0002 0000 0000 0000 0002 0007
Issuer 0x00012345, documento 0x…0002, LOCAL 702F7 0001 2345 0000 0000 0000 0002 0007

Páginas relacionadas

Texto original del documento de especificación

Así se ve el documento de especificación 0x00000000/codecs/0x00000390/latest.geul leído con geul show (hexadecimal en mayúsculas).

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"

Lo anterior es el documento de Codec de EXTERNAL-ISSUER-16WORD-IDENTIFIED (0x039L). En los documentos de Codec de los demás miembros (EXTERNAL-ISSUER-16WORD-GENERIC, EXTERNAL-ISSUER-16WORD-FREE-CHOICE, EXTERNAL-ISSUER-16WORD-UNIVERSAL, EXTERNAL-ISSUER-16WORD-VARIABLE) solo difieren el Codec ID del DOC-ID, el destino de DECLARE y el nombre asociado en #1 (BIND).