Saltar al contenido principal
Un Paquete de Prueba de Truthlocks contiene evidencia para las comprobaciones criptográficas soportadas de un registro. La verificación offline requiere la carga útil correspondiente, el formato soportado y las claves de emisor y de registro de confianza independiente. No establece el estado de revocación actual, la autoridad del emisor, la verdad fáctica o si ocurrió una acción en el mundo real.
ESPECIFICACIÓN v1.0

1. Resumen

Un Paquete de Prueba de Truthlocks es un documento de evidencia portátil. Utilice el formato y el verificador documentados para el punto final que lo produjo. El soporte CBOR se enumera a continuación como una extensión futura, no una garantía para las exportaciones actuales. La evidencia puede incluir datos de atestación, referencias de claves y pruebas de registro de transparencia. Verifique la firma y la inclusión en el registro por separado; la ausencia de evidencia no debe reportarse como una verificación aprobada. Nunca confíe en una clave pública únicamente porque está incluida en el paquete: establezca la clave autorizada a través de un canal confiable. El esquema a continuación es una descripción de referencia; haga coincidir la versión de exportación real y su contrato de bytes firmados antes de implementar un verificador.

2. Estructura del Paquete

Los paquetes de prueba se serializan como objetos JSON y siguen este esquema:

3. Definiciones de Campo

3.1 Encabezado

3.1.1 Hash de integridad del paquete

3.2 Atestación

3.3 Pruebas (Registro de Transparencia)

3.4 Certificado del emisor

4. Algoritmo de Verificación

Para verificar un paquete de prueba de Truthlocks, ejecute los siguientes pasos en orden. Si algún paso falla, el paquete no es válido.

Paso 1: Validar la integridad del paquete

Calcule el hash SHA-256 de todos los campos del paquete excluyendo bundle_hash_b64url y bundle_signature. Decodifique en Base64url el valor bundle_hash_b64url y compárelo con su hash calculado. Si no coinciden, el paquete ha sido manipulado.

Paso 2: Verificar la firma de la atestación

Usando la clave pública de issuer_certificate.public_key_der y el algoritmo especificado en attestation.signature_format, verifique attestation.signature contra la carga útil de atestación canónica (todos los campos de atestación excepto signature y status).

Paso 3: Verificar hash de contenido

Si tiene el archivo original, calcule su hash SHA-256 y compárelo con attestation.content_hash. Esto confirma que el archivo no ha sido modificado desde la certificación. Si un valor document_hash está presente, también puede compararlo con su hash calculado. El document_hash es un hash hexadecimal SHA-256 precalculado que el minter pasó en el momento de la acuñación, proporcionando una verificación de integridad adicional independiente de la codificación de la carga útil.

Paso 4: Verificar inclusión en el registro de transparencia

Para cada entrada en proofs, verifique la prueba de inclusión de Merkle. Comenzando desde leaf_hash en la posición leaf_index, vuelva a calcular la raíz haciendo hash con cada hermano en inclusion_proof. El resultado debe coincidir con root_hash.

Paso 5: Verificar validez de la clave

Confirme que issuer_certificate.valid_from ≤ attestation.issued_at ≤ issuer_certificate.valid_until (si está presente).

5. Algoritmos Soportados

6. Herramientas de Verificación

Los paquetes de prueba se pueden verificar utilizando cualquiera de estos 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". Fije ambas claves públicas independientemente del paquete. Las comprobaciones sin conexión no establecen el estado de revocación actual.
  • Web: Subir en verify.truthlocks.com/proof/[id]
  • SDK: client.verify.verifyBundle(bundleJson, fileBuffer)
  • Manual: Siga el algoritmo de verificación anterior con cualquier biblioteca Ed25519/ECDSA

7. Puntos de Extensión

El campo metadata en el objeto de atestación es extensible. Los esquemas personalizados pueden incluir campos adicionales sin romper la verificación. El algoritmo de verificación central solo depende de content_hash, signature y las pruebas del registro de transparencia. Las futuras versiones de formato pueden introducir:
  • Codificación CBOR para una representación binaria compacta
  • Paquetes de múltiples atestaciones (verificación por lotes)
  • Pruebas de consistencia entre registros
  • Pruebas de estado de revocación (incrustadas)

8. Principios de Diseño

  • Autocontenido: No se requiere acceso a la red para la verificación
  • Confianza minimizada: Verificable incluso si Truthlocks deja de funcionar
  • Compatible con versiones futuras: Los campos desconocidos son ignorados por los verificadores más antiguos
  • Determinista: La codificación JSON canónica garantiza un hash consistente
  • Abierto: Utiliza primitivas criptográficas estándar (sin formatos propietarios)