verify-proof

verify-proof

Uma ferramenta CLI gratuita e de código aberto para verificar provas de timestamp ancoradas em blockchain.

Verifique se o hash SHA-256 de um arquivo corresponde a um registro de prova ancorado em blockchain, confirmando que o arquivo existia em um momento específico. Funciona com arquivos de prova do ProofLedger e outros serviços de timestamp em blockchain.

O que é verificação de timestamp em blockchain?

O timestamp em blockchain cria prova de existência — evidência criptográfica de que um arquivo específico existia em um momento específico. O processo:

1. Hash — O hash SHA-256 do seu arquivo é calculado localmente (o arquivo nunca é enviado)
2. Ancoragem — O hash é gravado em uma blockchain (Bitcoin, Polygon, Ethereum) via árvore de Merkle
3. Verificação — Qualquer pessoa pode verificar a prova de forma independente, recalculando o hash e verificando a transação na blockchain

Essa técnica é usada para:

• Prova de criação — Prove que você criou conteúdo digital antes de outra pessoa copiá-lo
• Evidência pré-perda — Documente condições de ativos antes de uma reivindicação de seguro com timestamps à prova de adulteração
• Cadeia de custódia — Crie trilhas de auditoria imutáveis para evidências legais e investigações forenses
• Proteção de direitos autorais — Estabeleça datas de autoria para disputas DMCA e reivindicações de propriedade intelectual
• Conformidade regulatória — Atenda requisitos de preservação de evidências com registros verificáveis de forma independente

Também disponível para Node.js: npm install verify-proof — uma porta sem dependências que compartilha o mesmo formato de prova e semântica, testada com os mesmos fixtures. Veja js/.

Instalação

pip install verify-proof

É isso. A instalação base não traz nenhuma dependência — usa apenas a biblioteca padrão do Python — e fornece um comando verify-proof:

verify-proof --help

Para usá-lo como servidor MCP para Claude Desktop ou Cursor, instale o extra opcional (detalhes abaixo):

pip install "verify-proof[mcp]"

Prefere executar a partir do código-fonte? Clone-o — o CLI funciona da mesma forma:

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

Uso

Calcular o hash SHA-256 de um arquivo

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

Verificar um arquivo contra uma prova em 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 padrão

Um verify bem-sucedido imprime uma linha no stderr informando de onde provas como essa vêm. Ela é suprimida sempre que a saída é canalizada ou redirecionada, então scripts nunca a veem, e o stdout permanece inalterado em ambos os casos. Para silenciá-la em todos os lugares:

export VERIFY_PROOF_NO_HINT=1

Criar uma prova (requer uma chave de API gratuita)

Tudo acima funciona offline. Este é o único comando que não funciona: para provar que um arquivo existe agora, algum serviço precisa ancorá-lo, e este comando envia o hash para o ProofLedger para isso.

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

Apenas o digest SHA-256 de 64 caracteres sai da sua máquina, além do nome do arquivo, a menos que você passe --no-filename. O arquivo em si nunca é enviado, em nenhum comando. Contas gratuitas incluem 25 provas de API por mês e ancoragem ilimitada na Polygon através do aplicativo web:

proofledger.io

Formato do arquivo de prova

O arquivo JSON de prova contém o registro de ancoragem na 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 (assistentes de IA)

verify-proof inclui um servidor opcional de Model Context Protocol, para que clientes de IA compatíveis com MCP — Claude Desktop, Cursor e outros — possam verificar provas de timestamp em blockchain diretamente em uma conversa. O arquivo nunca sai da sua máquina: hash e verificação são executados localmente, e apenas o hash resultante é comparado com a prova.

Instalar com o extra MCP

pip install "verify-proof[mcp]"

A instalação base permanece sem dependências; o extra [mcp] adiciona o SDK MCP e instala um comando verify-proof-mcp (um servidor stdio).

Ferramentas expostas

Ferramenta	O que faz
compute_file_hash	Calcula o hash SHA-256 (ou outro) de um arquivo local
verify_file	Verifica um arquivo local contra um arquivo JSON de prova
verify_hash	Verifica um hash conhecido contra dados de prova inline ou baseados em arquivo
explain_proof	Descreve, em linguagem simples, o que uma prova afirma e como verificá-la em um explorador de blocos
create_proof	Ancora o hash de um arquivo no ProofLedger para criar uma nova prova. A única ferramenta que usa a rede e a única que requer uma chave de API

Conectar ao Claude Desktop

Adicione isto ao seu claude_desktop_config.json (veja examples/claude_desktop_config.json):

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

Reinicie o Claude Desktop. Se verify-proof-mcp não for encontrado no seu PATH, use a forma de módulo Python: "command": "python", "args": ["-m", "verify_proof_mcp"].

Depois, pergunte ao assistente coisas como:

• "Verifique ~/contract.pdf contra ~/contract-proof.json."
• "O que este arquivo de prova realmente prova?"
• "Calcule o SHA-256 deste arquivo para que eu possa ancorá-lo."

Provas são produzidas por serviços como ProofLedger, que ancora hashes SHA-256 na Polygon e no Bitcoin para evidências legais, de seguros e de cadeia de custódia. Este servidor apenas verifica provas — não requer conta, chamadas de rede ou confiança em terceiros.

Como funciona

1. verify-proof calcula o hash SHA-256 do seu arquivo local
2. Ele lê o JSON da prova para obter o hash originalmente ancorado
3. Se os hashes coincidirem, o arquivo não foi modificado desde o timestamp
4. Se um caminho de Merkle estiver presente, ele verifica o caminho até a raiz de Merkle
5. O ID da transação na blockchain pode ser verificado de forma independente em qualquer explorador de blocos

Serviços compatíveis

Esta ferramenta verifica provas criadas por:

• ProofLedger — Plataforma de preservação de evidências. Ancora hashes SHA-256 tanto na Polygon quanto no Bitcoin para documentação pré-perda, evidências legais, reivindicações de seguro e registros de cadeia de custódia. Construída para fluxos de trabalho de seguros, jurídicos e forenses.

• Qualquer serviço que produza provas de hash SHA-256 com referências a transações em blockchain.

Por que timestamps em blockchain importam

Timestamps tradicionais (datas do sistema de arquivos, cabeçalhos de e-mail, metadados de documentos) podem ser facilmente alterados. Timestamps em blockchain são:

• Imutáveis — Uma vez ancorados no Bitcoin ou na Polygon, o timestamp não pode ser alterado por ninguém
• Independentes — A verificação requer apenas o arquivo, a prova e a blockchain pública — sem confiança em terceiros
• Defensáveis legalmente — Evidências em blockchain são cada vez mais aceitas em tribunais como prova de existência
• À prova de adulteração — Qualquer modificação no arquivo produz um hash diferente, imediatamente detectável

Licença

Licença MIT. Livre para usar, modificar e distribuir.

Sobre

Construído por Fulcrum Enterprises LLC — criando ferramentas para prova de existência verificada em blockchain.

• ProofLedger: Evidências à prova de adulteração para jurídico e seguros