Pruebas verificables de lo que registran tus agentes de IA

1. 01

   Calcula la huella del registro

   El hash se calcula donde está el registro. A Sellat solo viajan 64 caracteres hexadecimales.

   sha256sum agent-run.jsonl
   # 9f2b…c41e  agent-run.jsonl

2. 02

   Pide la prueba sin pagar: recibes la oferta

   La API responde 402 con el precio, la red, el token y la dirección. El sobre está en la cabecera PAYMENT-REQUIRED y también en el cuerpo, junto con la URL y la versión de las condiciones que se aceptan al pagar.

   curl -i https://sellat.app/api/v2/proofs \
     -H "Content-Type: application/json" \
     -d '{"hash":"<sha256 de 64 hex>","name":"agent-run.jsonl"}'
   
   HTTP/2 402
   payment-required: eyJ4NDAyVmVyc2lvbiI6Mi…
   {
     "x402Version": 2,
     "accepts": [{ "scheme": "exact", "network": "eip155:8453",
                   "amount": "10000", "asset": "0x8335…2913" }],
     "error": { "code": "payment_required",
                "message": "This call costs 0.01 USD, paid per call with x402 (USDC)." }
   }

3. 03

   Paga con el cliente oficial de x402

   El cliente lee el 402, firma una autorización EIP-3009 por el importe exacto y repite la llamada. El gas lo paga el facilitador. Por defecto el cliente no paga más de 1 $ por llamada, y ninguna llamada de Sellat lo supera.

   import { createHash } from "node:crypto";
   import { readFileSync } from "node:fs";
   import { x402Client, wrapFetchWithPayment } from "@x402/fetch";
   import { ExactEvmScheme } from "@x402/evm/exact/client";
   import { privateKeyToAccount } from "viem/accounts";
   
   const client = new x402Client();
   client.setSpendControls({ maxAmountPerPayment: "$1" });
   client.register("eip155:8453", new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)));
   const pay = wrapFetchWithPayment(fetch, client);
   
   const hash = createHash("sha256").update(readFileSync("agent-run.jsonl")).digest("hex");
   const res = await pay("https://sellat.app/api/v2/proofs", {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({ hash, name: "agent-run.jsonl", metadata: { run: "2026-10-31-0142" } }),
   });
   const proof = await res.json(); // 201: proof_id, urls, api_key (una sola vez)

4. 04

   Guarda lo que devuelve

   La respuesta trae el identificador, el estado y las URL de la prueba portable, el certificado y el paquete de evidencias. La primera prueba de una cartera devuelve una sola vez una clave de solo lectura para consultar sus pruebas gratis.

   {
     "id": "6f2c9b1e-0d1a-4b9f-8e7c-2a4d5b6c7d8e",
     "created": true,
     "state": "queued",
     "anchoring": { "policy": "fast" },
     "urls": {
       "proof_json": "https://sellat.app/api/v2/proof/6f2c9b1e-….json",
       "certificate": "https://sellat.app/certificate/…",
       "evidence_zip": "https://sellat.app/api/v2/proofs/6f2c9b1e-…/evidence.zip"
     },
     "api_key": "sellat_…",
     "payment": { "charged": true, "amount_usd": "0.01", "transaction": "0x…" }
   }

5. 05

   Añade el sello cualificado, si la fecha tiene que valer ante un tercero

   Sobre el mismo proof_id y sin volver a calcular nada. Un prestador cualificado de la lista de confianza de la UE emite el token RFC 3161 en segundos.

   await pay(`https://sellat.app/api/v2/proofs/${proof.id}/qualified`, { method: "POST" });
   // 200: qualified.state = "issued", qualified.time, tsr_url

Mismos bytes, misma cartera: la segunda llamada devuelve la prueba existente y no se cobra. Una llamada que falla tampoco se cobra: el pago se verifica antes del trabajo y se liquida después.

curl https://sellat.app/api/v2/proofs \
  -H "Authorization: Bearer sellat_…" \
  -H "Content-Type: application/json" \
  -d '{"hash":"<sha256 de 64 hex>","name":"agent-run.jsonl"}'

proof_id

El identificador de la prueba. Sirve para consultarla, descargar sus documentos y añadirle más capas sin volver a calcular el hash.

state

queued mientras el lote está abierto; anchored cuando la raíz Merkle ya está en Polygon.

anchors

La transacción de Polygon que contiene la raíz del lote, con su bloque, su hora y el enlace al explorador.

bitcoin

La atestación OpenTimestamps de la misma raíz, que se completa cuando Bitcoin la confirma, horas después.

qualified

El sello de tiempo cualificado eIDAS: hora, número de serie, política y el .tsr descargable.

proof_json

La prueba portable (sellat-proof/2): hash, hoja, camino Merkle y anclajes. Pública, sin cuenta.

certificate

El certificado legible para personas, con su PDF.

evidence_zip

El paquete para guardar fuera de Sellat: certificado PDF, proof.json y el .ots de Bitcoin, con los comandos exactos para verificarlo todo.

{"seq": 41, "prev": "3a7f…e2", "at": "2026-10-31T09:14:02Z", "tool": "crm.update", "input_sha256": "…", "output_sha256": "…"}
{"seq": 42, "prev": "sha256(línea 41)", "at": "2026-10-31T09:14:05Z", "decision": "close_deal", "evidence_sha256": "…"}
# al cerrar la tarea: POST /api/v2/proofs con el hash de la línea 42

El formato es el que tú elijas. Si sigues un estándar de registros de auditoría para agentes, la prueba lo fecha igual.