Saltar al contenido principal
Con esta guía se comprueba que un documento sellado de Blockgence no cambió y que lo emitió Blockgence. No hace falta cuenta ni el código de Blockgence: solo Python 3 y OpenSSL 3.
Qué necesitás
  • El documento, en JSON (por ejemplo documento.json).
  • Python 3, sin instalar nada más.
  • OpenSSL 3.0 o posterior. El /usr/bin/openssl de macOS es LibreSSL y no lee claves Ed25519: usá el de Homebrew (brew install openssl@3).
  • La clave pública de Blockgence, guardada como blockgence-evidencia.pub.pem.
1

Recalcular la huella del contenido

Quitá manifest.integrity, ordená las claves, serializá sin espacios en UTF-8 y aplicá sha256:
Tiene que dar lo mismo que manifest.integrity.digest. Si no coincide, el documento cambió y no hace falta seguir.
2

Armar el mensaje firmado

El mensaje es el texto blockgence-integrity-v1:sha256: seguido de la huella que calculaste en el paso 1. Usá siempre la huella recalculada, nunca la que trae el documento.
3

Extraer la firma

La firma es el campo value de manifest.integrity.attestations.signature, en base64:
4

Verificar con la clave publicada

Verificá con la clave bajada de la página de la clave pública, no con la que trae el documento:
Tiene que responder Signature Verified Successfully. Como se verifica con la clave publicada, una firma hecha con otra clave falla acá.
5

Opcional: comparar la huella de la clave del documento

Guardá el public_key_pem del documento en pub.pem. Esto tiene que dar el key_id publicado:
El resultado se compara con el hex de sha256:d8853d1c1b7322b8b7e3bab730fccd0652c0c97a825c3317b3bc705d650f5c5f.
Cada documento trae además la receta completa: la de la huella en manifest.integrity.recipe y la de la firma con OpenSSL en attestations.signature.verify_openssl.

Qué significa cada resultado

Qué prueba la firma y qué no

Que el documento lo emitió quien tiene la clave privada de Blockgence y que no cambió desde que se firmó.
Eso lo sostienen la metodología, las fuentes y lo que el propio documento declara que no pudo ver.
manifest.generated_at lo pone el propio sistema y no lo certifica un tercero. Una cota la da el sello de tiempo, si el documento lo trae.

Verificar el sello de tiempo

Si el documento trae attestations.timestamp, la huella se puede anclar en Bitcoin con el cliente oficial de OpenTimestamps. El sello está apagado por defecto: muchos documentos no lo traen, y lo dicen en timestamp_note.
1

Bajar la prueba completa

La prueba que trae el documento es la pendiente, porque el documento no cambia después de emitirse. Esperá la confirmación en Bitcoin (unas horas) y bajá la completa del enlace complete_proof_url, o de GET /v1/evidence/timestamp/{digest}.ots.
2

Verificar con el cliente oficial

Con la huella recalculada en el paso 1 de arriba:
Necesita un nodo de Bitcoin, aunque sea podado.
3

Sin nodo de Bitcoin

ots info <huella>.ots muestra el bloque y la raíz de Merkle. Esa raíz se compara con la cabecera del bloque en cualquier explorador. La prueba arranca en la huella: ots info muestra File sha256 hash: <huella>.