EXTERNAL-ISSUER é a Reference de indicação e declaração que cita, num único registro e sem IMPORT, o LOCAL ID de um documento publicado por um Issuer.

ItemValor
NomeEXTERNAL-ISSUER-4WORD (grupo 5Q. Os nomes por código estão na tabela de membros abaixo)
TAG ID0x034L~0x038L
Seção1 0001 (Reference EXTERNAL), deslocamento C na seção = 20~24
KindReference · classificação: indicação e declaração
Lado Hugoreference/external-issuer.md (essa página trata também de EXTERNAL-ISSUER-2WORD e EXTERNAL-ISSUER-16WORD)

Membros

Esta página trata de um conjunto do sistema 5Q, cinco códigos. A quantificação é o deslocamento na seção C % 5 (Reference). Há um documento de codec por código. Os campos dos cinco documentos de codec são iguais; só diferem o alvo do DECLARE e o nome (BIND).

TAG IDNomeQuantificaçãoCodec IDDocumento de especificaçãoTAG WORD
0x034LEXTERNAL-ISSUER-4WORD-IDENTIFIEDIdentified0x000003400x00000000/codecs/0x00000340/0000 0011 0100 LLLL
0x035LEXTERNAL-ISSUER-4WORD-GENERICGeneric0x000003500x00000000/codecs/0x00000350/0000 0011 0101 LLLL
0x036LEXTERNAL-ISSUER-4WORD-FREE-CHOICEFree-choice0x000003600x00000000/codecs/0x00000360/0000 0011 0110 LLLL
0x037LEXTERNAL-ISSUER-4WORD-UNIVERSALUniversal0x000003700x00000000/codecs/0x00000370/0000 0011 0111 LLLL
0x038LEXTERNAL-ISSUER-4WORD-VARIABLEVariable0x000003800x00000000/codecs/0x00000380/0000 0011 1000 LLLL

Campos (documento de especificação)

A ordem dos FIELD no documento é a ordem dos campos do Payload (Documento de especificação de Codec).

OrdemCampo (BIND)FIELDLarguraFormato aceito (CODEC)ENUM
1issuer#2valor bruto de 4 WORD
2doc#3valor bruto de 4 WORD
3target-id#4valor bruto restante (0xFFFF)

EXTERNAL-ISSUER é a Reference de indicação e declaração que cita, sem IMPORT, o LOCAL ID de um documento publicado por um Issuer. Um único registro completa o sentido e segue a versão mais recente.

Layout

TAG WORD          0000 001C CCCC LLLL      Codec 0x02FL~0x03DL (seção 1)
[TAG estendida de Length]
Issuer            largura definida pelo Codec (2/4/16 WORD)
ID do documento   4 WORD
ID do alvo        todo o restante. LOCAL ID desse documento, na menor largura
Codec (Identified, Generic, Free-choice, Universal, Variable)NomeLargura do Issuer
0x02FL~0x033LEXTERNAL-ISSUER-2WORD2 WORD (registrado em geul.org, domínio comprovado)
0x034L~0x038LEXTERNAL-ISSUER-4WORD4 WORD (registrado em geul.org, sem comprovação)
0x039L~0x03DLEXTERNAL-ISSUER-16WORD16 WORD (calculado a partir da chave pública)
  • A largura é determinada pelo número do sistema: se sistema − 9 (C / 5 − 3 do deslocamento C na seção) for 0, 1, 2, a largura é 2, 4, 16 WORD. A quantificação é C % 5.
  • O Issuer ID é um valor inteiro. Valor igual é o mesmo Issuer. O Issuer é escrito na menor largura em que o valor cabe, e escolhe-se o Codec dessa largura (4 WORD somente a partir de 2^32, 16 WORD somente a partir de 2^64). Uma notação de largura maior é invalid (Issuer).
  • O registro e a gestão de Issuer ficam a cargo de geul.org.
  • A versão não é registrada; segue-se a mais recente. Para fixar a versão, usam-se IMPORT-DOC e EXTERNAL-POINTER.
  • A localização se encontra pela regra de endereço de publicação (endereço de publicação e lista de versões).
  • Se o LOCAL ID desse documento é o mesmo, é o mesmo alvo, tanto se usado como LOCAL dentro desse documento quanto como EXTERNAL-ISSUER em outro documento (ou como EXTERNAL-POINTER após IMPORT).
  • Aponta apenas LOCAL do documento. O próprio documento é apontado por DOC-POINTER e o próprio Issuer por ISSUER-POINTER. Por isso o ID do alvo não é 0. O ID de documento 0 é o documento de índice das definições de termos do Issuer.

Validade

  • É invalid se a largura do Issuer não corresponde ao Codec, ou se o valor cabe numa largura mais estreita.
  • É invalid se o ID do alvo for 0. O ID de alvo 0 (o próprio documento) fica a cargo do DOC-POINTER.
  • WORD 0x0000 à frente no ID do alvo é proibido.

Exemplo

AlvoWORD 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 do documento de especificação

Como o documento de especificação 0x00000000/codecs/0x00000340/latest.geul aparece ao ser lido com geul show (hexadecimal em maiúsculas).

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

Acima está o documento de codec de EXTERNAL-ISSUER-4WORD-IDENTIFIED (0x034L). Os documentos de codec dos outros membros (EXTERNAL-ISSUER-4WORD-GENERIC, EXTERNAL-ISSUER-4WORD-FREE-CHOICE, EXTERNAL-ISSUER-4WORD-UNIVERSAL, EXTERNAL-ISSUER-4WORD-VARIABLE) diferem apenas no Codec ID do DOC-ID, no alvo do DECLARE e no nome ligado em #1 (BIND).