Ir al contenido

Verificar un comprobante

El sentido de HardState es que usted nunca tenga que confiar en la institución, en la API ni en nosotros. El verificador (HardState Verifier) recalcula cada eslabón — desde los bytes del evento hasta el encabezado de un bloque de Bitcoin — en su navegador, contra exploradores públicos. Una HardState Proof (.hardstate.json) reúne todo lo necesario para comprobar un evento sin conexión.

Integridad

Un evento anclado no se puede alterar después.

Autoría

Lo firmó una llave que la propia bitácora de la institución autorizaba en ese momento.

Completitud

Ningún evento anclado se puede quitar ni reordenar sin romper la cadena.

Tiempo

Se puede probar que existía antes de un bloque concreto de Bitcoin.

Lo que no prueba: la veracidad del contenido, ni que un acto que nunca se registró no ocurrió.

  1. Abra app.hardstate.net/verify y suelte una prueba .hardstate.json, o abra un comprobante directamente en https://app.hardstate.net/r/<hash>.

  2. El verificador corre por completo en el cliente. Muestra cada comprobación de abajo con su propio resultado (pasa / falla) e informa la hora del primer bloque de Bitcoin confirmado como “existía antes de”.

Una prueba es un paquete JSON autocontenido. batch, ots y anchor faltan hasta que estén disponibles: vuelva a pedir la prueba más tarde (GET /v1/proofs/<hash>) para completarla.

{
"hardstate": "proof", "hss": 1,
"subject": { "kind": "event", "signed": { "event": {…}, "sig": {…} }, "hash": "…" },
"authority": [ /* issuer.create and the key.add / session.open establishing the signer */ ],
"batch": { "id": "…", "root": "…", "path": [{ "s": "R", "h": "…" }, { "s": "L", "h": "…" }] },
"ots": "<base64 of the detached .ots for batch.root>",
"anchor": { "network": "bitcoin", "txid": "…", "root": "…", "path": [{ "s": "L", "h": "…" }] },
"logUrl": "https://api.hardstate.net/v1/issuers/<id>/log",
"issuedAt": "…"
}

Un verificador hace — y debería mostrar — cada paso:

  1. Integridad. SHA-256(canonical(subject.signed.event)) == subject.hash (el JSON canónico es RFC 8785).

  2. Firma y autoridad. La firma verifica con la llave del firmante, y esa llave la autorizó la propia bitácora de la institución antes del evento, dentro de los permisos que se le dieron. Con una sesión, el veredicto nombra a la persona que la abrió, y una sesión vencida no puede firmar registros que aparezcan en Bitcoin después.

  3. Lote. La hoja (0x01 ‖ hash para un evento, 0x02 ‖ digest para el sello de un ciudadano) combinada con batch.path recalcula batch.root: cada paso indica el hash hermano y de qué lado va (hashes de RFC 9162).

  4. OpenTimestamps. El .ots es una prueba para batch.root; para cada atestación de Bitcoin a la altura h, el mensaje atestado es igual a la raíz de Merkle del bloque h. El encabezado del bloque se obtiene de al menos dos fuentes independientes, que deben coincidir.

  5. Ancla. 0x03 ‖ batch.root con anchor.path recalcula anchor.root; la transacción anchor.txid lleva el script OP_RETURN de anchor.root y está confirmada, con la misma regla de dos fuentes.

  6. Documento (opcional). Con un archivo y su sal, el compromiso recalculado es uno de los de event.docs.

  7. Completitud (opcional, en línea). La bitácora completa de la institución se reproduce desde seq 0 sin errores y contiene exactamente este evento en su seq.

Algunas preguntas son sobre una ausencia: ¿alguna persona revisó esta decisión de IA? ¿Se revocó la llave de este funcionario antes de cierta fecha? ¿Se registró alguna vez este documento? HardState responde con una prueba de ausencia: hasta cierta entrada de la bitácora de la institución, anclada en Bitcoin, no existía ese registro. Se comprueba igual que un comprobante, y puede soltar el archivo en app.hardstate.net/verify. Las reglas están en el Receipt Format (en inglés).

Veredicto Significado
invalid (no válido) Falló algún paso de los que se hicieron.
valid (válido) Pasan las comprobaciones 1–3 y al menos una de OpenTimestamps (4) o Ancla (5) pasa en la red principal (mainnet) de Bitcoin.
pending (pendiente) En cualquier otro caso; por ejemplo, el evento está en un lote pero aún no se confirma en Bitcoin.

No necesita usar el verificador de HardState para nada. La vía de OpenTimestamps es un .ots separado estándar sobre la raíz del lote, así que sirve cualquier cliente de OpenTimestamps:

Ventana de terminal
# Fetch the detached .ots for a batch and verify it against Bitcoin:
curl -s https://api.hardstate.net/v1/batches/<id>/ots -o batch.ots
ots verify -d <batch_root_hex> batch.ots

Para la HardState Anchor diaria, lea el OP_RETURN de la transacción en cualquier explorador de bloques y confirme que el script es:

6a 24 48 53 53 01 <32-byte anchor root> # OP_RETURN PUSH36 "HSS" ‖ 0x01 ‖ root

y luego recalcule 0x03 ‖ batch.root subiendo por anchor.path hasta esa raíz.

El formato es el abierto HardState Receipt Format (en inglés), y su verificador de referencia es @hardstate/receipt (Apache-2.0):

import { verifyReceipt } from "@hardstate/receipt";
const verdict = await verifyReceipt(proof);
// → { status: "valid" | "invalid" | "pending", steps: [...], provenBefore?: number }

HardState es una empresa de Zevlat Intelligence. © 2026 Zevlat Intelligence.