Saltar para o conteúdo principal
Um Pacote de Prova Truthlocks contém evidências para verificações criptográficas suportadas de um registro. A verificação offline requer o payload correspondente, formato suportado e chaves de emissor e log confiáveis independentemente. Não estabelece o status de revogação atual, autoridade do emissor, verdade factual ou se uma ação no mundo real ocorreu.
ESPECIFICAÇÃO v1.0

1. Visão Geral

Um Pacote de Prova Truthlocks é um documento de evidência portátil. Use o formato e o verificador documentados para o endpoint que o produziu. O suporte a CBOR está listado abaixo como uma extensão futura, não uma garantia para exportações atuais. A evidência pode incluir dados de atestado, referências de chave e provas de log de transparência. Verifique a assinatura e a inclusão do log separadamente; a ausência de evidências não deve ser relatada como uma verificação aprovada. Nunca confie em uma chave pública apenas porque ela está incluída no pacote: estabeleça a chave autorizada por meio de um canal confiável. O esquema abaixo é uma descrição de referência; corresponda à versão de exportação real e seu contrato de bytes assinados antes de implementar um verificador.

2. Estrutura do Pacote

Os pacotes de prova são serializados como objetos JSON e seguem este esquema:

3. Definições de Campo

3.1 Cabeçalho

3.1.1 Hash de integridade do pacote

3.2 Atestado

3.3 Provas (Registro de Transparência)

3.4 Certificado do Emissor

4. Algoritmo de Verificação

Para verificar um Truthlocks Proof Bundle, execute os seguintes passos em ordem. Se qualquer passo falhar, o bundle é inválido.

Passo 1: Validar a integridade do pacote

Calcule o hash SHA-256 de todos os campos do pacote, excluindo bundle_hash_b64url e bundle_signature. Decodifique o valor bundle_hash_b64url em Base64url e compare-o com o hash calculado. Se não corresponderem, o pacote foi adulterado.

Passo 2: Verificar a assinatura da atestação

Usando a chave pública de issuer_certificate.public_key_der e o algoritmo especificado em attestation.signature_format, verifique attestation.signature contra o payload de atestado canônico (todos os campos de atestado, exceto signature e status).

Passo 3: Verificar hash do conteúdo

Se você tiver o arquivo original, calcule seu hash SHA-256 e compare-o com attestation.content_hash. Isso confirma que o arquivo não foi modificado desde a atestação. Se um valor document_hash estiver presente, você também pode compará-lo com seu hash calculado. O document_hash é um hash hexadecimal SHA-256 pré-calculado que o minter passou no momento da cunhagem, fornecendo uma verificação de integridade adicional independente da codificação da carga útil.

Passo 4: Verificar inclusão no log de transparência

Para cada entrada em proofs, verifique a prova de inclusão Merkle. Começando de leaf_hash na posição leaf_index, recalcule a raiz fazendo hash com cada irmão em inclusion_proof. O resultado deve corresponder a root_hash.

Passo 5: Verificar validade da chave

Confirme que issuer_certificate.valid_from ≤ attestation.issued_at ≤ issuer_certificate.valid_until (se presente).

5. Algoritmos Suportados

6. Ferramentas de Verificação

Os pacotes de prova podem ser verificados usando qualquer um destes métodos:
  • CLI: truthlock verify -b bundle.json -f original-file --trusted-log-key "$TRUTHLOCKS_LOG_PUBLIC_KEY" --trusted-issuer-key "$TRUTHLOCKS_ISSUER_PUBLIC_KEY". Fixe ambas as chaves públicas independentemente do pacote. As verificações offline não estabelecem o status de revogação atual.
  • Web: Carregar em verify.truthlocks.com/proof/[id]
  • SDK: client.verify.verifyBundle(bundleJson, fileBuffer)
  • Manual: Siga o algoritmo de verificação acima com qualquer biblioteca Ed25519/ECDSA

7. Pontos de Extensão

O campo metadata no objeto de atestado é extensível. Esquemas personalizados podem incluir campos adicionais sem quebrar a verificação. O algoritmo de verificação principal depende apenas de content_hash, signature e das provas do log de transparência. Versões futuras do formato podem introduzir:
  • Codificação CBOR para representação binária compacta
  • Pacotes de múltiplas atestações (verificação em lote)
  • Provas de consistência entre logs
  • Provas de status de revogação (incorporadas)

8. Princípios de Design

  • Autocontido: Não é necessário acesso à rede para verificação
  • Confiança minimizada: Verificável mesmo que a Truthlocks deixe de operar
  • Compatível com o futuro: Campos desconhecidos são ignorados por verificadores mais antigos
  • Determinístico: A codificação JSON canônica garante hashing consistente
  • Aberto: Usa primitivas criptográficas padrão (sem formatos proprietários)