ItemValor
NomeSIGNATURE (BIND SIGNATURE do documento de especificação)
TAG ID0x1E6L
Codec ID0x00001E60
Documento de especificação0x00000000/codecs/0x00001E60/ (alvo do DECLARE 1E60)
Seção15 1111 (Meta), deslocamento C = 6 na seção
KindMeta · classe: verificação
TAG WORD0001 1110 0110 LLLL (000K KKKC CCCC LLLL)
Descrição do índiceAssinatura sobre um alvo. A assinatura do documento assina o hash de conteúdo (commit e tag assinados do git)
Lado Hugometa/verification/signature.md

Campos (documento de especificação)

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

OrdemCampo (BIND)FIELDLarguraFormato de entrada (CODEC)ENUM
1algorithm#2valor bruto 1 WORD0x0001 ed25519
2signer#3registro0400 ISSUER-POINTER
3signature#4valor bruto restante(0xFFFF)

Assinatura sobre o hash de conteúdo do documento (commit e tag assinados do git).

Layout

TAG WORD          0001 1110 0110 LLLL      Codec 0x1E6L
[TAG de extensão de Length]
ID do algoritmo   1 WORD (0x0001 = Ed25519)
Signatário        Registro Reference ISSUER-POINTER (Issuer)
Assinatura        Todo o restante. A largura é definida pelo algoritmo (Ed25519 32 WORDs)
  • Codec: Meta 0x1E6L, classe de verificação
  • Payload: ID do algoritmo (valor bruto, 1 WORD) + signatário (Reference embutida) + assinatura (valor bruto, restante)
  • Quantidade: vários possíveis

Interpretação e validade

  • O alvo da assinatura é o hash de conteúdo. Não se assina apenas o BODY (assinatura).
  • Por ser da classe de verificação, fica de fora do hash de conteúdo. Acrescentar uma assinatura não altera o hash.
  • A verificação não é «se houver assinatura, conferir», e sim «deve haver assinatura da chave determinada».
  • O documento de lista de versões é assinado por quem publica.
  • O signatário é um ISSUER-POINTER (Issuer) que aponta para o próprio Issuer. Como é um registro Reference e termina no seu próprio Length, o layout fica único mesmo que a largura da assinatura varie conforme o algoritmo (campo restante de DECLARE).
  • Se o número de WORDs da assinatura diferir da largura definida pelo algoritmo, é inválido.

Problemas em aberto

  • Resta decidir se o instante da assinatura também será assinado.

Texto do documento de especificação

É o documento de especificação 0x00000000/codecs/0x00001E60/latest.geul lido com geul show (hexadecimal em maiúsculas).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001E6000000000
BODY
#1 DECLARE 0x1E60
#2 FIELD #1 0x0001
#3 FIELD #1 record
#11 CODEC #3 0x0400
#4 FIELD #1 rest
#5 ENUM #2 0x0001
#6 BIND #1 "SIGNATURE"
#7 BIND #2 "algorithm"
#8 BIND #3 "signer"
#9 BIND #4 "signature"
#10 BIND #5 "ed25519"