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, excluindobundle_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 deissuer_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 comattestation.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 emproofs, 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 queissuer_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 campometadata 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)

