Como Verificar uma Prova de Timestamp Bitcoin para o Seu Código
Uma prova de timestamp que você não consegue verificar por conta própria é apenas uma promessa de fornecedor com branding melhor. Mais cedo ou mais tarde, alguém — um advogado em uma disputa de patente, um auditor durante a due diligence, ou um CTO que suspeita que sua “implementação independente” não era independente — vai pedir que você mostre que um determinado hash de commit existia em uma determinada data. Esse momento é a etapa de verificação, e é justamente a que a maioria das equipes nunca ensaia.
A boa notícia: com o Timestamp GIT, a verificação não é um projeto de pesquisa. O GitHub App ancora seus hashes de commit todas as noites, e verificar uma prova leva um clique, uma URL ou um curl. Este artigo percorre os caminhos exatos de verificação, o que os resultados significam e onde os casos extremos se escondem.
Por Que a Verificação Importa: Da Confiança à Prova
Há uma diferença entre uma alegação e uma evidência:
- Uma alegação é “escrevemos isso em março”. Ela vive em um banco de dados que você controla e pode ser editada.
- Uma evidência é “este hash de commit específico foi incluído em uma árvore de Merkle cuja raiz está embutida no bloco N do Bitcoin”. Qualquer pessoa pode recalculá-la.
Para conformidade, auditorias e litígios, a evidência tem um requisito extra: ela deve ser repetível e independente do fornecedor. Se sua prova só verifica enquanto os servidores de uma empresa específica estão no ar, não é realmente uma prova — é uma assinatura.
O design do Timestamp GIT leva isso em conta. O recibo .ots mais os dados públicos do bloco Bitcoin são a prova inteira. Não há componente proprietário no caminho de verificação, e nada para instalar nas máquinas dos seus desenvolvedores. Este artigo mantém o foco na etapa de verificação; se você ainda está decidindo se deve usar timestamp, o argumento estratégico está no nosso guia do fundador sobre prior art.
O Que uma Prova de Timestamp Bitcoin Realmente Contém
Uma prova para um único dia consiste em dois artefatos, armazenados em um branch timestamps dedicado ou em um repositório espelho, para que sejam versionados junto com o seu código:
- Um arquivo de manifesto (
.txt) listando os hashes de commit coletados para aquele repositório naquele dia. - Um arquivo de recibo
.otscontendo o caminho de Merkle que liga o seu hash até a raiz de Merkle ancorada no Bitcoin.
A cadeia se parece com isto:
commit hash ─┐
commit hash ─┼─ Merkle tree ─ Merkle root ─ Bitcoin transaction ─ block
commit hash ─┘ │
.ots receipt (Merkle path from your hash to the root)
Duas propriedades importam quando você verifica:
- O manifesto prova quais hashes foram incluídos.
- O recibo
.otsprova quando a raiz de Merkle entrou na cadeia.
Como a ancoragem usa o protocolo OpenTimestamps e nada mais proprietário, a prova sobrevive a nós: é SHA-256 mais dados do bloco Bitcoin, verificável offline, para sempre.
Passo a Passo: Verificando uma Prova de Timestamp com o Timestamp GIT
1. Comece pelo Badge no Seu README
Todo repositório monitorado pode exibir um badge de verificação Shields.io. Ele é um ponteiro ao vivo, não uma imagem estática: ele leva à página de status pública daquele repositório. Você gera o trecho de incorporação na página de repositório conectado (https://timestampgit.dev/connected/{user}/{repo}), que mostra uma prévia ao vivo antes de você colar.
<!-- Paste the snippet generated at /connected/{user}/{repo} -->
[](https://timestampgit.dev/status/OWNER/REPO)
Quando um revisor clica no badge, ele chega à evidência — não a uma página de marketing.
2. Leia a Página de Status do Repositório
Abra:
https://timestampgit.dev/status/{user}/{repo}
Este painel público oferece o resumo amigável para auditoria:
- Longevidade da prova — até onde vai o seu histórico de ancoragem.
- Data de ancoragem mais antiga — o primeiro dia em que seus hashes chegaram ao Bitcoin.
- Regularidade diária — prova de que a tarefa noturna realmente rodou, dia após dia.
- Dados do bloco e da transação Bitcoin para as ancoragens.
- Um mapa de calor em calendário para que lacunas sejam visualmente óbvias.
- Downloads: o CSV de auditoria e um certificado em PDF.
Para um auditor, o mapa de calor mais o CSV geralmente é suficiente para uma primeira passada. Quadrados faltando são o que deve ser investigado.
3. Verifique um Dia Específico Localmente
Para uma prova em nível de data, abra:
https://timestampgit.dev/verification/{user}/{repo}/{date}
Esta página percorre a cadeia de Merkle passo a passo e realiza o cálculo localmente no seu navegador. Nada do que você verifica é transmitido — a propriedade de conhecimento zero se aplica também à verificação, não apenas à ingestão.
Isso importa mais do que parece. Um revisor de conformidade pode verificar uma prova envolvendo repositórios internos sensíveis sem entregar ao fornecedor nenhuma informação adicional.
4. Obtenha a Cadeia de Merkle via API
Se você preferir verificar programaticamente (ou armazenar a evidência no seu próprio sistema de conformidade), a API retorna os dados completos da cadeia de Merkle para um dia específico:
curl -s "https://timestampgit.dev/api/verify/OWNER/REPO/2026-11-18" | jq
Você também pode buscar o último bloco ancorado e a contagem corrente de commits:
curl -s "https://timestampgit.dev/api/statusLast/OWNER/REPO" | jq
curl -s "https://timestampgit.dev/api/statusCount/OWNER/REPO" | jq
Sem ferramentas de CLI, sem comandos de protocolo, sem software de carteira. O trabalho pesado — detecção de commits via webhook do GitHub App, agrupamento em lotes, construção da árvore de Merkle e ancoragem no Bitcoin — já aconteceu durante a noite.
Lendo os Resultados — e os Casos Extremos
Uma prova válida significa algo restrito e forte: este hash de commit existia no momento ou antes do timestamp deste bloco Bitcoin. Ela não diz que o código é bom, que você escreveu cada linha, ou quem o digitou. A autoria além do hash é uma questão separada — nossa análise sobre se timestamps de commit do Git se sustentam como prova cobre essa distinção.
Outras coisas a ter em mente:
- Variação do timestamp do bloco. Os timestamps dos blocos Bitcoin podem variar ligeiramente em relação ao horário real. A prova permanece criptograficamente forte independentemente disso, porque o bloco em si é imutável — ninguém pode re-minerar o histórico para mover sua ancoragem.
- Prova ausente para uma data. As provas são gravadas algumas horas após a meia-noite: o worker cron agrupa os hashes, constrói a árvore de Merkle, a envia aos calendários públicos do OTS e então aguarda a confirmação do Bitcoin — normalmente cerca de três horas. Uma prova para um dia pode simplesmente ainda não ter sido gravada. Se for mais antiga que isso, verifique se o repositório estava realmente sendo monitorado durante aquela janela.
- Repositórios privados. As URLs de status para repositórios privados carregam um HMAC criptografado, e apenas quem possui essa URL pode ver o status. A verificação em si continua acontecendo localmente no navegador.
- Instâncias auto-hospedadas. Cada instância gera seu próprio HMAC. Se você migrar um badge de uma instância SaaS para sua própria implantação Docker, regenere o link do badge — um HMAC de uma instância não será validado em outra.
Verificando Sem o SaaS: Docker Auto-Hospedado e Verificações Offline
Para ambientes isolados ou de alta paranoia, o Timestamp GIT é distribuído como uma imagem Docker. Uma configuração rápida de Docker Compose se parece com isto:
services:
timestampgit:
image: rue1401/timestampgit:prod
ports:
- "8080:8080"
volumes:
- ./data:/app/data
restart: unless-stopped
valkey:
image: valkey/valkey:8
restart: unless-stopped
Depois:
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
O app fica disponível em http://localhost:8080, e um assistente de configuração na primeira inicialização orienta você a conectar seu GitHub App e configurar a instância. Uma licença de demonstração por tempo limitado está disponível na página Docker License se você quiser avaliar antes de se comprometer.
A auto-hospedagem não muda a matemática da verificação. Os arquivos .ots e os dados do bloco Bitcoin são os mesmos artefatos, e eles verificam offline. Você pode fazer tudo manualmente e alimentar o arquivo .ots nas ferramentas padrão de verificação do OpenTimestamps contra um nó Bitcoin local — esse é o caminho difícil, e funciona justamente porque a prova é independente do fornecedor. O visualizador e a API do produto simplesmente tornam isso uma questão de um clique em vez de um projeto de fim de semana.
Automatizando a Verificação para Conformidade
Se a verificação é um item de checklist em uma revisão trimestral, automatize-a:
- Exporte o ledger.
GET /api/audit/{user}/{repo}retorna o ledger de auditoria completo como CSV — o artefato que seu auditor realmente quer no arquivo. - Gere certificados por dia.
GET /api/report/{user}/{repo}/{date}produz um certificado em PDF para uma data específica, útil quando uma única prova precisa ser anexada a um contrato ou a uma petição de disputa. - Consulte periodicamente para garantir atualidade. Um pequeno cron job do seu lado captura o modo de falha que importa: a ancoragem parar silenciosamente.
#!/usr/bin/env bash
set -euo pipefail
REPOS=("acme/api" "acme/web" "acme/infra")
for repo in "${REPOS[@]}"; do
printf '%-14s ' "$repo"
curl -s "https://timestampgit.dev/api/statusLast/${repo}" | jq -c '.'
done
Execute-o diariamente; se o último bloco ancorado parar de avançar, você saberá antes de um auditor.
- Exiba o status publicamente. Incorpore o badge Shields.io para que usuários e clientes downstream possam ver o status de verificação sem precisar pedir nada a você.
Para equipes que querem separação máxima, os planos Enterprise ZK incluem uma pequena GitHub Action que roda dentro do seu próprio CI e não transmite nada além de hashes de commit — o modelo de ancoragem e verificação permanece o mesmo, e a verificação continua acontecendo localmente.
FAQ
Preciso executar algum comando do OpenTimestamps para verificar uma prova?
Não. O Timestamp GIT fornece uma página de verificação baseada na web e uma API REST que realizam toda a checagem. Você também pode baixar o arquivo .ots e usar ferramentas de verificação padrão se preferir, mas isso não é obrigatório.
Quanto tempo leva para uma prova se tornar verificável?
As provas são ancoradas todas as noites e confirmadas na blockchain do Bitcoin após algumas horas — normalmente cerca de três horas. Um commit feito hoje terá uma prova verificável no dia seguinte.
Posso verificar uma prova de um repositório privado?
Sim, mas as páginas de status de repositórios privados exigem um HMAC criptografado anexado à URL. Usuários autorizados podem acessá-las, e a verificação em si continua acontecendo localmente no seu navegador.
E se o Timestamp GIT desaparecer? Ainda posso verificar?
Sim. A prova é independente do fornecedor: ela depende apenas de SHA-256 e dos dados do bloco Bitcoin. Você pode verificar o arquivo .ots offline com ferramentas padrão do OpenTimestamps mesmo que nosso serviço não exista mais.
Conclusão
A verificação é onde o timestamp deixa de ser uma boa ideia e se torna evidência defensável. O fluxo de trabalho é curto: clique no badge, leia a página de status, abra a visualização de verificação em nível de dia, ou acesse /api/verify/{user}/{repo}/{date} e confira a cadeia de Merkle você mesmo. Todo caminho termina no mesmo lugar — um hash de commit que existia antes de um bloco Bitcoin específico, provável para sempre, sem confiar no banco de dados de ninguém.
Se você ainda não começou, a configuração é a parte chata: instale o GitHub App em um repositório e deixe a tarefa noturna rodar. Você terá sua primeira prova verificável amanhã. Acesse timestampgit.dev para conectar seu primeiro repositório.
Posts relacionados
- Prove Prior Art Before You File: A Founder’s Guide
- Best Tools to Timestamp Source Code for Auditors
- Do Git Commit Timestamps Hold Up as Proof?