Timestamp GIT

← Todos os artigos

2026-11-05

Como verificar uma prova de timestamp do Bitcoin no seu navegador

Como verificar uma prova de timestamp do Bitcoin no seu navegador
timestamp git blockchain proof

Como Verificar uma Prova de Timestamp Bitcoin no Seu Navegador

Uma prova de timestamp só tem valor no momento em que alguém a verifica. Até lá, é apenas um arquivo com um nome bonito — um recibo .ots parado em um branch, um badge em um README, um PDF que ninguém abriu. A pergunta que decide se o seu prior art sobrevive a uma revisão jurídica, a uma disputa de pagamento ou a uma auditoria de due diligence é bem específica: um terceiro consegue confirmar que esse hash de commit exato existia antes de uma data específica, sem pedir ao fornecedor que o ateste?

É isso que a verificação baseada em navegador resolve. Este artigo percorre a verificação de uma prova Timestamp GIT de ponta a ponta — o que os artefatos contêm, quais páginas e endpoints você usa, e como interpretar o resultado quando ele é válido, pendente ou falho. Não é uma aula sobre transações Bitcoin; o ponto central do fluxo gerenciado é justamente que você nunca toca nessa camada.

Por Que a Verificação no Navegador Importa

A verificação é o momento em que um timestamp criptográfico deixa de ser uma alegação e se torna evidência. Tudo antes disso — hashear commits, agrupar manifestos, ancorar uma raiz Merkle no Bitcoin — é maquinário. A prova ou verifica na outra ponta, ou não verifica.

Duas propriedades fazem do navegador o lugar certo para essa checagem:

O cálculo permanece local. As páginas de verificação do Timestamp GIT executam cada etapa da cadeia Merkle no seu navegador. Ninguém vê qual repositório, qual data ou qual commit você está verificando. Para um fornecedor, isso seria um design estranho; para um sistema de prova de conhecimento zero, é o único correto. Você está verificando evidência, não solicitando um veredito.

Sem instalação, sem fé cega. Equipes de compliance e advogados externos não vão fazer git clone de um branch e compilar ferramentas. Eles precisam de uma checagem independente e repetível que produza a mesma resposta toda vez. Uma URL mais um navegador fazem isso. Um endpoint público de API também, caso você prefira automatizar a checagem no CI.

Isso importa porque a alternativa — confiar no dashboard de um fornecedor — é exatamente o que você está tentando evitar. Veja Git Commit Timestamps Aren’t Tamper-Proof — What Is para entender por que logs internos são descartados em auditorias desde o início.

O Que uma Prova de Timestamp Bitcoin Realmente Contém

Antes de verificar qualquer coisa, saiba o que você tem em mãos. Uma prova Timestamp GIT para um determinado dia consiste em três artefatos em camadas:

  • Manifesto diário — um arquivo .txt simples que lista os hashes de commit ancorados naquele dia para um determinado repositório. Contém hashes, nunca código.
  • Recibo .ots — uma prova OpenTimestamps que vincula o hash SHA-256 do manifesto a um bloco Bitcoin específico.
  • Cadeia Merkle — a estrutura que conecta os dois. O hash do seu commit individual é uma folha, o manifesto é o próximo nível acima, e a raiz Merkle é o valor único que é embutido no Bitcoin.

Portanto, verificar significa subir essa cadeia na direção correta: pegue o hash do seu commit, combine-o com seus irmãos conforme especificado pelo manifesto, produza o hash do manifesto e então confira o recibo .ots contra o cabeçalho do bloco Bitcoin.

A propriedade crítica é que o recibo é independente do fornecedor. Ele usa apenas SHA-256 e dados públicos de blocos Bitcoin. Se o Timestamp GIT desaparecesse amanhã, o recibo ainda verificaria contra a blockchain usando ferramentas abertas. Isso não é frase de marketing — é uma restrição ao formato da prova, e é por isso que a verificação no navegador pode ser honesta.

Esses arquivos ficam em um branch dedicado timestamps (ou em um repositório espelho separado), de modo que são versionados junto com o seu código sem nunca expor o conteúdo do código-fonte.

Passo a Passo: Verifique uma Prova no Seu Navegador

Aqui está o caminho completo de “tenho um repositório” até “aqui está o artefato que um auditor pode guardar.”

1. Comece na página de status do repositório

Abra a página de status pública do repositório:

https://timestampgit.dev/status/{user}/{repo}

Esta é a sua visão geral e responde à maioria das primeiras perguntas: longevidade da prova (até onde a cadeia retrocede), data da âncora mais antiga, se a ancoragem tem sido diária e regular, e os dados de bloco e transação Bitcoin de cada dia. Há um mapa de calor em calendário para que lacunas fiquem visíveis de imediato, além de downloads do livro-razão de auditoria completo (CSV) e de um certificado em PDF.

Se você só precisa de um resumo legível por máquina, os endpoints públicos de status retornam os mesmos números centrais:

curl -s https://timestampgit.dev/api/statusLast/acme/payments-service
curl -s https://timestampgit.dev/api/statusCount/acme/payments-service
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-service

2. Abra a página de verificação para uma data específica

Para uma checagem real de prova, vá até a data que lhe interessa:

https://timestampgit.dev/verification/{user}/{repo}/{date}

A página conduz você por cada nível da cadeia Merkle passo a passo — do hash do commit ao manifesto, do manifesto à raiz Merkle, da raiz Merkle ao bloco Bitcoin. Todo hash é recalculado no seu navegador. Nada sobre a sua checagem é transmitido, o que torna a página utilizável para repositórios confidenciais.

Esta é a página a enviar para um advogado. Não exige conta, nem CLI, nem explicação sobre o que é OpenTimestamps.

3. Use o badge como ponto de entrada público

Badges embutíveis são a versão de baixo atrito da mesma coisa. Adicione um ao seu README e qualquer pessoa — auditor, adquirente, advogado da parte contrária — pode clicar até a verificação sem conhecer a estrutura do seu repositório.

O widget de incorporação de badge em /connected/{user}/{repo} oferece uma prévia ao vivo mais o trecho em Markdown. O badge em si é respaldado pelo endpoint de resumo, então reflete dados ancorados reais em vez de uma imagem estática.

Badges são uma decisão de divulgação, não de segurança: eles expõem que você usa timestamp, não o que você escreveu.

4. Verifique programaticamente com a API pública

Para pipelines de CI ou um script de compliance, obtenha os dados da cadeia Merkle e verifique localmente:

curl -s "https://timestampgit.dev/api/verify/acme/payments-service/2026-10-14" \
  -o chain.json

A resposta contém a cadeia completa daquele dia. Seu script então recalcula os hashes por conta própria — a mesma matemática que a página do navegador executa:

// Node 18+ — recalcule cada etapa Merkle localmente, nunca confie na resposta do servidor
import { createHash } from "node:crypto";

const sha256 = (hex) =>
  createHash("sha256").update(Buffer.from(hex, "hex")).digest("hex");

const chain = JSON.parse(await readFile("chain.json", "utf8"));

// Percorra folha -> raiz. Cada etapa concatena o hash atual com seu irmão,
// hasheia o par e continua. O valor final deve ser igual à raiz ancorada.
let current = sha256(commitSha);
for (const step of chain.steps) {
  const [left, right] = step.order === "lr" ? [current, step.sibling] : [step.sibling, current];
  current = sha256(left + right);
}

console.log(current === chain.merkleRoot ? "PROOF OK" : "PROOF MISMATCH");

O ponto de fazer isso você mesmo é que uma checagem automatizada é evidência reproduzível da checagem, e não depende de um dashboard renderizar corretamente.

5. Baixe o certificado em PDF

Quando você precisa de algo para anexar a um e-mail ou contrato, a página de status oferece um certificado em PDF por data, também disponível diretamente:

https://timestampgit.dev/api/report/{user}/{repo}/{date}

E para o livro-razão completo em vez de um único dia:

curl -s https://timestampgit.dev/api/audit/acme/payments-service -o audit.csv

Interpretando Resultados e Tratando Casos Limite

Uma prova válida tem um significado preciso, e ele é mais restrito do que as pessoas supõem.

  • O que uma prova válida diz: este hash de commit existia no momento daquele bloco Bitcoin ou antes dele. Nada mais, nada menos. Não diz que o código compila, que é original ou que é bom. Prior art trata de existência e cronologia.
  • O que “pendente” significa: o worker noturno agrupa os hashes após a meia-noite, constrói a árvore Merkle e ancora a raiz. A confirmação do Bitcoin então leva várias horas — normalmente cerca de 3 horas — e os arquivos de prova são gravados de volta no seu repositório assim que confirmados. Commits de hoje tipicamente não terão uma prova final até o dia seguinte.
  • Repositórios privados: URLs de status para repositórios privados incluem um HMAC criptografado específico da instância do servidor, de modo que apenas usuários autorizados podem ler o status. A verificação continua rodando localmente no navegador, e o recibo .ots e o manifesto subjacentes podem ser conferidos sem expor o conteúdo do repositório.
  • Se uma prova falhar: verifique primeiro as coisas óbvias — repositório certo, data certa e manifesto certo. Um recibo .ots só verifica contra o hash de manifesto para o qual foi criado; emparelhá-lo com o manifesto de outro dia falhará corretamente e de forma confusa.
  • Ambientes air-gapped: a licença self-hosted em Docker executa toda a stack — incluindo a UI de verificação e a API — na sua própria infraestrutura, de modo que a verificação nunca sai da sua rede.

Como o Timestamp GIT Torna a Verificação Automática

A razão pela qual tudo acima é uma página e não um projeto de fim de semana é que a ancoragem é totalmente gerenciada. Você instala o GitHub App uma vez em um repositório monitorado, e cada commit é ancorado no Bitcoin automaticamente toda noite. Sem ferramentas de CLI, sem etapas manuais de protocolo, nada para rodar nas máquinas dos desenvolvedores — o que também explica por que o fluxo não depende de alguém lembrar de fazê-lo.

Por trás disso, o pipeline agrupa hashes de commit em uma fila, os agrupa à meia-noite em arquivos de manifesto por repositório, constrói uma árvore Merkle, cria provas OpenTimestamps contra calendários públicos e ancora a raiz no Bitcoin. Os arquivos de prova são então enviados de volta para um branch timestamps ou repositório espelho. Para equipes que precisam que o código-fonte fique totalmente fora do alcance do serviço, o modo Enterprise ZK usa uma GitHub Action de 12 linhas que envia apenas hashes de commit a partir da sua própria infraestrutura — o serviço produz provas verificáveis sem acesso de leitura ao repositório de código-fonte.

Se você precisa de verificação self-hosted, 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
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; um assistente de configuração na primeira execução orienta você a conectar seu GitHub App e configurar a instância. Uma licença de demonstração por tempo limitado para avaliação está disponível na página Docker License.

FAQ

Preciso instalar algum software para verificar uma prova de timestamp Bitcoin? Não. As páginas de verificação do Timestamp GIT rodam inteiramente no seu navegador, e os endpoints públicos de API retornam os dados da cadeia Merkle para checagens locais. Você também pode baixar o recibo .ots e verificá-lo offline com ferramentas padrão do OpenTimestamps, se preferir.

Posso verificar uma prova sem confiar no Timestamp GIT? Sim. A prova depende apenas de SHA-256 e dados de blocos Bitcoin, portanto é independente do fornecedor. Você pode verificar o recibo .ots contra a blockchain Bitcoin usando ferramentas abertas, mesmo que o Timestamp GIT não exista mais.

E se a transação Bitcoin da minha prova ainda não estiver confirmada? A confirmação do Bitcoin normalmente leva cerca de 3 horas. Até que a transação seja confirmada em um bloco, a prova fica pendente; após a confirmação, ela se torna imutável e pode ser verificada no seu navegador.

Como verifico uma prova de um repositório privado? URLs de status de repositórios privados incluem um HMAC criptografado, de modo que apenas usuários autorizados podem visualizá-las. Você também pode baixar o recibo .ots e o manifesto do branch timestamps e verificá-los localmente sem expor dados do repositório.

Conclusão

A verificação no navegador é o que transforma um timestamp de registro interno em algo que você pode entregar a alguém que não confia em você — que é o único público que importa em uma disputa. A checagem leva uma URL, uma data e alguns segundos de hashing local, e produz uma resposta ancorada no Bitcoin em vez de no banco de dados de um fornecedor.

Se você ainda não configurou isso, a sequência é curta: conecte um repositório ao Timestamp GIT via GitHub App, deixe o job noturno ancorar seus commits, então abra a página de status e verifique uma data de ponta a ponta. Essa única verificação bem-sucedida é a diferença entre “temos logs” e “temos prova.” Se você quer primeiro a configuração sem CLI, leia How to Timestamp Git Commits Without the Command Line em seguida.

Posts relacionados

EU label: AI-generated content