Como Verificar Localmente uma Prova de Carimbo de Tempo Bitcoin
Você tem um arquivo .ots parado em um branch de timestamps, e um advogado, um auditor ou sua própria mente cética quer saber: isso realmente prova alguma coisa, ou é apenas um arquivo que um fornecedor te entregou?
Essa pergunta é o ponto central do carimbo de tempo criptográfico. Uma prova que só o emissor pode validar não é uma prova — é uma promessa. Este artigo mostra como verificar localmente uma prova de carimbo de tempo Bitcoin, passo a passo, usando as ferramentas de verificação integradas do Timestamp GIT. Nenhuma ferramenta de linha de comando necessária, nenhuma confiança em nossos servidores necessária e — se você quiser ir além — nenhuma dependência da existência do Timestamp GIT.
Por Que a Verificação Local Importa
A maioria das atestações de software são documentos do tipo “confie em mim”. Um fornecedor assina um PDF dizendo “sim, este commit existia nesta data”. Se o fornecedor fechar, for adquirido ou mudar silenciosamente suas chaves de assinatura, sua evidência fica mais fraca. A prova nunca foi realmente sua.
Provas ancoradas no Bitcoin funcionam de forma diferente. O Timestamp GIT incorpora hashes de commit na blockchain do Bitcoin através do protocolo OpenTimestamps, usando calendários OTS públicos. O caminho de verificação usa apenas SHA-256 e dados de blocos do Bitcoin — nenhuma criptografia proprietária, nenhum segredo. Isso significa:
- A prova sobrevive ao fornecedor. Mesmo se o Timestamp GIT desaparecesse amanhã, o recibo
.otse o bloco Bitcoin que ele referencia permanecem verificáveis por qualquer pessoa. - A verificação é local por padrão. O verificador web do Timestamp GIT executa toda a computação no seu navegador. Ninguém vê o que você verifica, e nenhuma resposta de servidor é necessária para chegar a uma conclusão.
- Equipes de compliance aceitam isso. Em uma auditoria legal, “nossos logs internos dizem isso” é frequentemente descartado como autointeressado. Um caminho de Merkle que termina em um cabeçalho de bloco Bitcoin específico é uma categoria diferente de evidência.
Em resumo: todo o valor da prova de existência entra em colapso se a verificação exigir confiar no emissor. Aqui, não exige.
Se você quer o contexto conceitual sobre por que a técnica anterior precisa de ancoragem criptográfica, isso é abordado em O Que É Técnica Anterior Criptográfica? Um Guia para Equipes de Software. Este artigo é sobre o ato mecânico de verificar.
Como É uma Prova do Timestamp GIT
Quando você instala o GitHub App e conecta um repositório, cada commit entra em um lote noturno. Aqui está o que você obtém:
- Um arquivo de recibo
.ots. Uma prova criptográfica compacta de que um determinado hash de commit Git — ou melhor, a raiz de Merkle que cobre o lote de hashes de um dia — existia em um ponto específico no tempo. - Um arquivo de manifesto
.txtpor repositório. A lista de hashes de commit agrupados naquele dia. - Um branch de timestamps dedicado ou repositório shadow. As provas são enviadas de volta para sua própria infraestrutura, seja dentro do repositório de origem ou em um repositório de destino separado.
Cada prova corresponde a um lote diário. O pipeline agrupa todos os hashes de commit pendentes, constrói uma árvore de Merkle nativamente, cria provas OpenTimestamps contra calendários OTS públicos e ancora a raiz de Merkle em uma transação Bitcoin.
O arquivo .ots é autossuficiente para fins de verificação: ele contém o caminho de Merkle do seu hash de commit até a raiz ancorada, além de uma referência ao cabeçalho do bloco Bitcoin que contém a âncora. Você não precisa do banco de dados do Timestamp GIT para verificá-lo.
Uma observação sobre timing que confunde as pessoas: a confirmação do Bitcoin leva várias horas — tipicamente cerca de 3. Portanto, a etapa de escrita da prova ocorre algumas horas após a execução do worker cron da meia-noite. Um commit recente não é verificável instantaneamente. Veja Interpretando Resultados e Casos Extremos abaixo.
Passo a Passo: Verificando Sua Prova Localmente
Passo 1: Obtenha o arquivo .ots
Ele já está no seu repositório. Procure no branch de timestamps, ou no repositório shadow se você configurou as provas para ficarem separadas do código-fonte. Você também pode obtê-lo no painel do Timestamp GIT através da sua lista de repositórios.
Passo 2: Use o verificador baseado em navegador
Navegue até a página de verificação do seu repositório e data:
https://timestampgit.dev/verification/{user}/{repo}/{date}
Esta é uma verificação passo a passo, multinível, da cadeia de Merkle. Toda computação de hash acontece localmente no seu navegador — a página não envia seus dados para lugar nenhum, e ninguém vê o que você verifica. Você verá a cadeia se desenrolar do seu hash de commit, passando por nós intermediários de Merkle, até a raiz e a referência do bloco Bitcoin.
Este é o caminho que a maioria dos desenvolvedores e revisores de compliance deve seguir. Nenhuma ferramenta de CLI necessária, nenhum nó Bitcoin necessário.
Passo 3 (opcional): Verifique com ferramentas padrão do OpenTimestamps
O formato .ots é aberto. Se o seu processo exige uma cadeia de ferramentas totalmente independente — ou se você simplesmente prefere — você pode pegar o arquivo de recibo e verificá-lo contra a blockchain do Bitcoin usando ferramentas padrão de verificação do OpenTimestamps e um nó Bitcoin ou cliente leve. Esse é o “caminho difícil”, e é completamente opcional. A prova é independente do fornecedor por design: apenas SHA-256 e dados de blocos Bitcoin estão envolvidos.
Passo 4: Confirme o resultado
Uma verificação bem-sucedida fornece duas saídas concretas:
- A altura do bloco Bitcoin onde sua raiz de Merkle foi ancorada.
- O timestamp do bloco, que estabelece o limite superior de quando seu hash de commit poderia ter existido.
Essa é a sua evidência: não “o Timestamp GIT diz isso”, mas “este hash está comprovadamente contido em uma árvore de Merkle cuja raiz está comprometida no bloco Bitcoin N”.
Usando as Ferramentas de Verificação Integradas do Timestamp GIT
Além do verificador por data, há três ferramentas que vale a pena conhecer.
A página de status pública
https://timestampgit.dev/status/{user}/{repo}
Este é um painel público que mostra a longevidade das provas, sua data de âncora mais antiga, regularidade diária, os dados de bloco e transação Bitcoin por trás de cada âncora, e um mapa de calor de calendário da cobertura. Se você está fazendo due diligence em um repositório — seu ou de outra pessoa — comece aqui. Ele também expõe CSV de auditoria para download e um certificado em PDF.
A página de verificação
Abordada acima, mas vale reiterar como a ferramenta principal:
https://timestampgit.dev/verification/{user}/{repo}/{date}
Verificação da cadeia de Merkle, no navegador, para o carimbo de tempo de um dia específico.
Badges e certificados
Badges incorporáveis estão disponíveis para o seu README exibir publicamente o status de verificação. Qualquer pessoa pode clicar no link anexado ao badge e verificar o carimbo de tempo através do site. Para pacotes de auditoria, baixe o certificado em PDF para uma data específica.
Se o seu repositório for privado, observe que repositórios privados acrescentam um HMAC criptografado à URL — o HMAC é específico da instância do servidor, então apenas usuários autorizados podem ver o status desse repositório. Seu fluxo de verificação permanece inalterado; a URL é apenas restrita.
Interpretando Resultados e Casos Extremos
O que uma verificação bem-sucedida realmente significa
Ela prova que o hash de commit existia na data do bloco Bitcoin ou antes dela. Não “exatamente na”, e não “o código foi escrito então” — ela prova que o hash existia não depois daquele bloco. Para fins de técnica anterior, essa é exatamente a afirmação que você precisa: você tinha este artefato na data X ou antes dela.
Provas pendentes
Se você verificar um repositório na manhã seguinte a um commit e a prova parecer incompleta, isso é esperado. O worker cron noturno agrupa os hashes, constrói a árvore e a ancora; a confirmação do Bitcoin então leva algumas horas (normalmente cerca de 3). Uma vez confirmada, o carimbo de tempo é imutável. Espere, depois verifique novamente — nada está quebrado.
A fronteira de conhecimento zero
A verificação opera sobre hashes de commit, nunca sobre o seu código-fonte. O Timestamp GIT nunca vê, copia ou armazena seu código-fonte real. A prova confirma que um hash existia; ela não revela nada sobre o que havia no código. Isso é deliberado, e é por isso que o mesmo fluxo de verificação funciona para repositórios de código fechado e segredos comerciais.
Quando as coisas dão errado
- Arquivo
.otsausente — recupere-o do branch de timestamps, do repositório shadow ou do seu painel. - Recibo corrompido — baixe novamente do repositório ou do painel; os dados ancorados no lado do Bitcoin não são afetados, então uma cópia nova do recibo restaura a verificação.
Equipes que querem ainda menos exposição
O GitHub App gerenciado do Timestamp GIT é o caminho de configuração zero — acesso somente leitura ao repositório de origem, leitura e escrita ao repositório de destino, e as provas chegam automaticamente. Para equipes que não querem que o serviço leia nem mesmo um hash de commit, o Enterprise ZK Mode segue um caminho diferente: uma GitHub Action de 12 linhas roda na sua infraestrutura e envia apenas o hash de commit para a API do Timestamp GIT. Seu código-fonte nunca sai do seu ambiente.
Automatizando a Verificação para Compliance
Verificações manuais são suficientes para uma auditoria pontual. Se você está executando compliance contínuo, integre isso ao CI ou às suas ferramentas internas.
Obtenha dados de verificação via API
A cadeia de Merkle completa para um dia específico:
curl -s "https://timestampgit.dev/api/verify/acme-corp/payments-api/2026-09-14" \
-o verify-2026-09-14.json
Endpoints de status públicos (sem autenticação necessária):
# Last anchored Bitcoin block info
curl -s "https://timestampgit.dev/api/statusLast/acme-corp/payments-api"
# Total stamped commit count
curl -s "https://timestampgit.dev/api/statusCount/acme-corp/payments-api"
# Combined summary, useful for Shields.io badges
curl -s "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api"
Obtenha livros de auditoria e certificados
# Full audit ledger as CSV
curl -s "https://timestampgit.dev/api/audit/acme-corp/payments-api" -o audit.csv
# PDF certificate for a single date
curl -s "https://timestampgit.dev/api/report/acme-corp/payments-api/2026-09-14" \
-o certificate-2026-09-14.pdf
Uma proteção mínima de CI — falhar o build se a âncora mais recente estiver desatualizada — se parece com isto:
#!/usr/bin/env bash
set -euo pipefail
REPO_PATH="acme-corp/payments-api"
LAST=$(curl -s "https://timestampgit.dev/api/statusLast/${REPO_PATH}")
BLOCK=$(echo "$LAST" | python3 -c "import sys,json; print(json.load(sys.stdin).get('blockHeight',''))")
if [ -z "$BLOCK" ]; then
echo "No anchored Bitcoin block found for ${REPO_PATH}. Check nightly anchoring."
exit 1
fi
echo "Latest anchor confirmed in Bitcoin block ${BLOCK}"
Verificação em ambiente isolado com Docker
Para segurança máxima e ambientes isolados, o Timestamp GIT está disponível como imagem Docker. Uma configuração de início rápido com 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
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
A aplicação fica disponível em http://localhost:8080 após a inicialização. Na primeira execução, um assistente de configuração orienta você na conexão do seu GitHub App e na configuração da sua instância. Uma licença de demonstração por tempo limitado pode ser solicitada na página Docker License com seu nome, empresa, e-mail e número de telefone opcional, e o arquivo de licença de demonstração é baixável assim que emitido.
Perguntas Frequentes
Preciso executar alguma ferramenta de linha de comando para verificar uma prova do Timestamp GIT? Não. O Timestamp GIT fornece um verificador baseado em web que realiza todas as computações localmente no seu navegador. Você também pode usar ferramentas padrão do OpenTimestamps se preferir, mas isso não é obrigatório.
Quanto tempo leva para uma prova se tornar verificável? Após a ancoragem noturna, leva algumas horas (tipicamente cerca de 3) para a transação Bitcoin ser confirmada. Uma vez confirmada, a prova é imediatamente verificável.
Posso verificar uma prova sem confiar no Timestamp GIT?
Sim. O arquivo .ots contém todos os dados criptográficos necessários, e você pode verificá-lo contra a blockchain do Bitcoin usando ferramentas de código aberto. O verificador do Timestamp GIT também roda localmente, então nenhuma confiança em nossos servidores é necessária.
E se eu perder o arquivo .ots?
Você pode recuperá-lo do branch de timestamps do seu repositório ou do repositório shadow. Se você é usuário do Timestamp GIT, também pode baixá-lo do seu painel.
Conclusão
A verificação local é a diferença entre “uma empresa me disse isso” e “eu mesmo verifiquei contra a blockchain do Bitcoin”. Com o Timestamp GIT, a parte da verificação leva quatro passos e zero ferramentas de CLI: pegue o arquivo .ots, abra a página de verificação, leia a altura do bloco, pronto. O trabalho pesado — detecção de commits, agrupamento noturno, construção da árvore de Merkle, envio ao calendário OTS, ancoragem no Bitcoin e envio das provas de volta ao seu repositório — acontece automaticamente assim que o GitHub App é instalado.
Comece em timestampgit.dev, instale o GitHub App em um repositório e verifique sua primeira prova amanhã. Para repositórios privados e fluxos de compliance contínuo, os planos Pro Agency e Enterprise ZK cobrem o resto.
Posts relacionados
- GitHub App Que Carimba Commits Automaticamente
- Como Freelancers Podem Provar a Propriedade do Código Antes de uma Disputa
- O Que É Técnica Anterior Criptográfica? Um Guia para Equipes de Software