verify-proof

verify-proof

Una herramienta CLI gratuita y de código abierto para verificar pruebas de marca de tiempo ancladas en blockchain.

Verifica que el hash SHA-256 de un archivo coincida con un registro de prueba anclado en blockchain, confirmando que el archivo existió en un momento específico. Funciona con archivos de prueba de ProofLedger y otros servicios de marca de tiempo blockchain.

¿Qué es la verificación de marca de tiempo blockchain?

El sellado de tiempo en blockchain crea prueba de existencia — evidencia criptográfica de que un archivo específico existió en un momento específico. El proceso:

1. Hash — El hash SHA-256 de tu archivo se calcula localmente (el archivo nunca se sube)
2. Anclaje — El hash se escribe en una blockchain (Bitcoin, Polygon, Ethereum) mediante un árbol de Merkle
3. Verificación — Cualquiera puede verificar la prueba de forma independiente recalculando el hash y comprobando la transacción en la blockchain

Esta técnica se utiliza para:

• Prueba de creación — Demuestra que creaste contenido digital antes de que otra persona lo copiara
• Evidencia previa a pérdidas — Documenta las condiciones de un activo antes de una reclamación de seguro con marcas de tiempo a prueba de manipulaciones
• Cadena de custodia — Crea rastros de auditoría inmutables para evidencia legal e investigaciones forenses
• Protección de derechos de autor — Establece fechas de autoría para disputas DMCA y reclamaciones de propiedad intelectual
• Cumplimiento normativo — Cumple con los requisitos de preservación de evidencia con registros verificables de forma independiente

También disponible para Node.js: npm install verify-proof — un puerto sin dependencias que comparte el mismo formato de prueba y semántica, probado con los mismos fixtures. Ver js/.

Instalación

pip install verify-proof

Eso es todo. La instalación base no incluye ninguna dependencia — utiliza solo la biblioteca estándar de Python — y te proporciona un comando verify-proof:

verify-proof --help

Para usarlo como servidor MCP para Claude Desktop o Cursor, instala el extra opcional en su lugar (detalles abajo):

pip install "verify-proof[mcp]"

¿Prefieres ejecutarlo desde el código fuente? Clónalo — el CLI funciona igual:

git clone https://github.com/Fulcrum-Enterprises/verify-proof.git
cd verify-proof
python verify_proof.py --help

Uso

Calcular el hash SHA-256 de un archivo

verify-proof hash document.pdf
# SHA256: a1b2c3d4e5f6...
# File: document.pdf

Verificar un archivo contra una prueba blockchain

verify-proof verify document.pdf --proof proof.json
# VERIFIED: File hash matches blockchain anchor on bitcoin.
# Transaction: abc123... Anchored at: 2026-03-15T10:30:00Z

Silencioso por defecto

Un verify exitoso imprime una línea en stderr indicando de dónde provienen pruebas como esta. Se suprime cuando la salida se redirige o se canaliza, por lo que los scripts nunca la ven, y stdout no cambia en ningún caso. Para silenciarlo en todas partes:

export VERIFY_PROOF_NO_HINT=1

Crear una prueba (requiere una clave API gratuita)

Todo lo anterior funciona sin conexión. Este es el único comando que no lo hace: para probar que un archivo existe ahora, algún servicio debe anclarlo, y esto envía el hash a ProofLedger para ese fin.

export PROOFLEDGER_API_KEY=sk_...      # Account > API Keys, free tier included
verify-proof create document.pdf       # Polygon anchor
verify-proof create document.pdf --bitcoin
verify-proof create document.pdf --no-filename   # send only the hash

Solo el digest SHA-256 de 64 caracteres sale de tu máquina, además del nombre del archivo a menos que pases --no-filename. El archivo en sí nunca se sube, en ningún comando. Las cuentas gratuitas incluyen 25 pruebas API al mes y anclaje ilimitado en Polygon a través de la aplicación web:

proofledger.io

Formato del archivo de prueba

El archivo JSON de prueba contiene el registro de anclaje en blockchain:

{
  "hash": "a1b2c3d4e5f6...",
  "algorithm": "sha256",
  "blockchain": "bitcoin",
  "tx_id": "abc123...",
  "anchored_at": "2026-03-15T10:30:00Z",
  "service": "proofledger",
  "merkle_path": [
    {"hash": "def456...", "position": "right"},
    {"hash": "789abc...", "position": "left"}
  ]
}

Uso como servidor MCP (asistentes de IA)

verify-proof incluye un servidor opcional de Model Context Protocol, para que clientes de IA compatibles con MCP — Claude Desktop, Cursor y otros — puedan verificar pruebas de marca de tiempo blockchain directamente en una conversación. El archivo nunca sale de tu máquina: el hash y la verificación se ejecutan localmente, y solo el hash resultante se compara con la prueba.

Instalar con el extra MCP

pip install "verify-proof[mcp]"

La instalación base permanece sin dependencias; el extra [mcp] añade el SDK de MCP e instala un comando verify-proof-mcp (un servidor stdio).

Herramientas expuestas

Herramienta	Qué hace
compute_file_hash	Calcula el hash SHA-256 (u otro) de un archivo local
verify_file	Verifica un archivo local contra un archivo JSON de prueba
verify_hash	Verifica un hash conocido contra datos de prueba en línea o basados en archivos
explain_proof	Describe, en lenguaje sencillo, qué afirma una prueba y cómo comprobarla en un explorador de bloques
create_proof	Ancla el hash de un archivo en ProofLedger para crear una nueva prueba. La única herramienta que usa la red, y la única que requiere una clave API

Conectarlo a Claude Desktop

Añade esto a tu claude_desktop_config.json (ver examples/claude_desktop_config.json):

{
  "mcpServers": {
    "verify-proof": {
      "command": "verify-proof-mcp"
    }
  }
}

Reinicia Claude Desktop. Si verify-proof-mcp no se encuentra en tu PATH, usa la forma de módulo de Python en su lugar: "command": "python", "args": ["-m", "verify_proof_mcp"].

Luego pregunta al asistente cosas como:

• "Verifica ~/contract.pdf contra ~/contract-proof.json."
• "¿Qué prueba realmente este archivo de prueba?"
• "Calcula el SHA-256 de este archivo para poder anclarlo."

Las pruebas son producidas por servicios como ProofLedger, que ancla hashes SHA-256 a Polygon y Bitcoin para evidencia legal, de seguros y de cadena de custodia. Este servidor solo verifica pruebas — no necesita cuenta, llamadas de red ni confianza en terceros.

Cómo funciona

1. verify-proof calcula el hash SHA-256 de tu archivo local
2. Lee el JSON de prueba para obtener el hash originalmente anclado
3. Si los hashes coinciden, el archivo no ha sido modificado desde el sellado de tiempo
4. Si hay una ruta de Merkle presente, verifica la ruta hasta la raíz de Merkle
5. El ID de transacción en blockchain se puede verificar de forma independiente en cualquier explorador de bloques

Servicios compatibles

Esta herramienta verifica pruebas creadas por:

• ProofLedger — Plataforma de preservación de evidencia. Ancla hashes SHA-256 tanto a Polygon como a Bitcoin para documentación previa a pérdidas, evidencia legal, reclamaciones de seguros y registros de cadena de custodia. Diseñada para flujos de trabajo de seguros, legales y forenses.

• Cualquier servicio que produzca pruebas de hash SHA-256 con referencias a transacciones blockchain.

Por qué importan las marcas de tiempo blockchain

Las marcas de tiempo tradicionales (fechas del sistema de archivos, encabezados de correo electrónico, metadatos de documentos) pueden alterarse fácilmente. Las marcas de tiempo blockchain son:

• Inmutables — Una vez ancladas a Bitcoin o Polygon, la marca de tiempo no puede ser cambiada por nadie
• Independientes — La verificación requiere solo el archivo, la prueba y la blockchain pública — sin confianza en terceros
• Defendibles legalmente — La evidencia blockchain es cada vez más aceptada en los tribunales como prueba de existencia
• A prueba de manipulaciones — Cualquier modificación al archivo produce un hash diferente, detectable de inmediato

Licencia

Licencia MIT. Libre de usar, modificar y distribuir.

Acerca de

Creado por Fulcrum Enterprises LLC — construyendo herramientas para la prueba de existencia verificada por blockchain.

• ProofLedger: Evidencia a prueba de manipulaciones para el ámbito legal y de seguros