Timestamp GIT

← Todos os artigos

2026-11-22

Automatize o timestamping no Bitcoin de cada commit do Git

Automatize o timestamping no Bitcoin de cada commit do Git
timestamp git blockchain proof

Automatize o Carimbo de Tempo em Bitcoin de Cada Commit do Git

O carimbo de tempo manual tem o mesmo modo de falha que o backup manual: funciona perfeitamente até a semana em que você está ocupado. E a semana em que você está ocupado é exatamente a semana em que você entrega o recurso que mais tarde precisará provar que entregou.

Este artigo trata de remover o humano desse ciclo. Não “lembre-se de carimbar antes de fazer o merge”, não um item de checklist no seu runbook de release — mas uma instalação única que transforma cada commit em um repositório monitorado em uma prova agrupada em Merkle e ancorada em Bitcoin, automaticamente, todas as noites, quer alguém da equipe esteja pensando em proteção de PI ou não.

Se você ainda está decidindo se a prova criptográfica de anterioridade importa para a sua situação, veja Prove Prior Art Before You File: A Founder’s Guide. Este texto assume que você já decidiu e agora quer isso rodando no piloto automático.

A Armadilha do Carimbo de Tempo Manual (e Por Que a Automação Vence)

Fazer isso à mão parece enganosamente simples. Na prática, um fluxo de trabalho manual significa que alguém da equipe precisa:

  • Lembrar de carimbar após cada commit significativo — antes que o branch seja reescrito, esmagado (squash) ou force-push.
  • Gerenciar material de chave e arquivos de prova localmente, em um lugar que sobreviva a formatações de laptop e rotatividade de pessoal.
  • Armazenar os recibos resultantes em algum lugar durável, versionado e localizável dois anos depois durante a due diligence.
  • Repetir para cada commit, em cada repositório, para sempre.

É nesse último item que os processos manuais morrem. A cobertura é inconsistente, e cobertura inconsistente é pior do que parece: em uma disputa, uma lacuna na sua cadeia de evidências convida ao argumento de que este commit — o que importa — foi a exceção. Um push esquecido numa sexta-feira à tarde pode transformar uma linha do tempo limpa em um ponto de interrogação.

O protocolo OpenTimestamps subjacente é genuinamente bem projetado, e você pode operá-lo por conta própria com ferramentas de linha de comando brutas e ancoragem manual em Bitcoin — do jeito difícil, por sua conta e seu tempo. Para uma equipe que entrega diariamente e não tem uma pessoa dedicada a cripto, isso é um projeto de manutenção disfarçado de controle de segurança.

A automação vence porque converte uma decisão recorrente em uma configuração única. Instale um GitHub App uma vez e, a partir desse momento, cada commit no repositório monitorado é capturado, enfileirado, agrupado, ancorado e arquivado de volta no seu repositório sem que um desenvolvedor toque em nada.

Configuração Única: Instale o GitHub App e Esqueça

A configuração é a parte mais curta deste artigo, e esse é o ponto.

  1. Instale o GitHub App Timestamp GIT. Escolha um único repositório ou conceda-o a toda a sua organização — cada repositório monitorado recebe suas próprias provas independentes.
  2. Escolha a origem e o destino. O App lê hashes de commit do seu repositório de origem e grava provas em um repositório de destino, seja um branch timestamps dedicado no mesmo repositório, seja um repositório sombra separado.
  3. Confirme as permissões. O modo padrão precisa de acesso somente leitura ao repositório de origem, porque o modelo de permissões do GitHub não tem um escopo “somente hashes de commit”. O acesso de escrita é necessário no repositório de destino para que as provas possam ser commitadas de volta. Essa é toda a superfície de permissões.

Nada é instalado nas máquinas dos desenvolvedores. Sem ferramentas de CLI, sem hooks de pré-commit, sem arquivos de chave para distribuir, sem etapa de onboarding para novos contratados. Os desenvolvedores continuam executando git commit e git push exatamente como antes.

Para organizações que não querem que o serviço hospedado tenha acesso de leitura ao código-fonte de forma alguma, existe o modo Enterprise ZK: uma pequena GitHub Action (12 linhas) roda dentro da sua própria infraestrutura e envia apenas o hash do commit para a API, de modo que o código-fonte nunca sai do seu ambiente. Nesse modo, o App não precisa de acesso de leitura ao repositório de origem — você apenas instala a Action. A maioria das equipes começa com o modo gerenciado padrão e trata o modo ZK como uma opção para seus repositórios mais sensíveis. O passo a passo completo de permissões está em Set Up IP Protection With a Single GitHub App Install.

Dentro do Pipeline Automatizado: Do Commit à Ancoragem em Bitcoin

Uma vez instalado, o pipeline roda no seu próprio cronograma. Eis o que acontece entre o seu git push e uma prova verificável:

  1. Detecção de commit. O GitHub App captura novos commits via webhooks. No modo Enterprise ZK, sua GitHub Action envia hashes de commit para a API.
  2. Fila de hashes. Os hashes de commit chegam a um armazenamento chave-valor em memória, aguardando o lote noturno. Note o que chega aqui: hashes, não código.
  3. Worker cron da meia-noite. Um worker acorda, agrupa todos os hashes pendentes e grava um arquivo de manifesto .txt por repositório.
  4. Construção da árvore Merkle. O worker constrói uma árvore Merkle nativamente sobre o lote do dia e então gera provas OpenTimestamps contra os calendários públicos de OTS.
  5. Ancoragem em Bitcoin. A raiz Merkle é ancorada em um bloco Bitcoin. A confirmação normalmente leva cerca de três horas, então a entrega das provas ocorre algumas horas após a execução do lote.
  6. Entrega das provas. O manifesto e os arquivos de recibo .ots são commitados de volta no seu repositório de destino automaticamente.

Duas propriedades deste design importam mais do que a mecânica:

  • Zero-knowledge por construção. O serviço nunca vê, copia ou armazena seu código-fonte. Ele lida com hashes de commit e uma raiz Merkle. O estado do seu repositório nunca entra no pipeline.
  • Independência de fornecedor. As provas se apoiam apenas em SHA-256 e dados de blocos Bitcoin. Se o Timestamp GIT desaparecesse amanhã, os recibos no seu repositório continuariam verificáveis contra a blockchain Bitcoin usando ferramentas padrão do OpenTimestamps. Para o trabalho do dia a dia, você usará a página de verificação ou a API — veja How to Verify a Bitcoin Timestamp Proof for Your Code.

Monitoramento e Tratamento de Falhas: Garantindo Que Cada Commit Seja Ancorado

Automação que você não monitora é apenas um cron job esperançoso. O Timestamp GIT expõe superfície suficiente para tornar a cobertura observável.

Painel de status. Cada repositório monitorado tem uma página de status pública em https://timestampgit.dev/status/{user}/{repo} mostrando a longevidade das provas, a data de ancoragem mais antiga, a regularidade diária, os dados do bloco e da transação Bitcoin, um mapa de calor em calendário dos dias ancorados e exportações de auditoria para download.

Badges incorporáveis. Badges do Shields.io podem ir direto para o seu README, com snippets de markdown gerados logo após você conectar o repositório. Qualquer pessoa pode clicar para verificar o carimbo de tempo publicamente.

API para alertas personalizados. Consulte o status e reconcilie contagens a partir das suas próprias ferramentas:

# Latest anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api | jq

# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api | jq

# Combined summary (what the badge uses)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api | jq

Uma verificação noturna mínima que sinaliza uma lacuna antes que ela se torne um problema de evidência:

import datetime, requests

REPO = "https://timestampgit.dev/api"
USER, SLUG = "acme", "payments-api"

summary = requests.get(f"{REPO}/statusSummary/{USER}/{SLUG}", timeout=30).json()
last = requests.get(f"{REPO}/statusLast/{USER}/{SLUG}", timeout=30).json()

# Alert if nothing has been anchored in the last 48 hours
print("summary:", summary)
print("last anchor:", last)

Aponte isso para o seu canal de alertas e você fechou o ciclo — um dia perdido se torna uma notificação em vez de uma descoberta durante a due diligence.

Cenários de falha. Webhooks são descartados, os calendários ocasionalmente caem e as redes têm soluços. Como os hashes ficam em uma fila em vez de serem carimbados na hora, um hash não ancorado simplesmente passa para o próximo lote noturno. Nada se perde; fica adiado. O sintoma visível é um dia faltando no mapa de calor ou um valor de statusLast parado, que é exatamente o que as verificações acima capturam.

Exportações de conformidade. Para auditorias, extraia o livro-razão completo como CSV ou um certificado PDF por dia:

curl -sO https://timestampgit.dev/api/audit/acme/payments-api
curl -sO https://timestampgit.dev/api/report/acme/payments-api/2026-11-22

Repositórios privados acrescentam um HMAC criptografado às suas URLs de status, de modo que apenas usuários autorizados possam ler seu status — o HMAC é específico da instância do servidor.

Boas Práticas para Carimbo de Tempo Automatizado

  • Observe o branch timestamps, não apenas o painel. Novos manifestos e arquivos .ots aparecendo são sua verdade fundamental de que a entrega funcionou de ponta a ponta.
  • Use um repositório de destino dedicado para as provas quando puder. Isso mantém seu histórico de origem limpo e facilita entregar a evidência ao jurídico sem exportar sua base de código.
  • Verifique periodicamente, não apenas uma vez. Agende uma verificação trimestral contra a página de verificação pública ou /api/verify/{user}/{repo}/{date}. Toda a computação de verificação acontece localmente no navegador — ninguém vê o que você verifica.
  • Ancore a cobertura no seu processo, não na sua memória. Se um repositório é crítico para o negócio, instale o App em toda a organização em vez de repositório por repositório; o modo de falha da instalação seletiva é um repositório que ninguém lembra de integrar.
  • Combine a implantação com o seu modelo de ameaças. Para ambientes isolados (air-gapped) ou de máxima segurança, o Timestamp GIT roda como uma imagem Docker auto-hospedada. 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 instância fica disponível em http://localhost:8080, e um assistente de primeira execução orienta você na conexão do seu GitHub App. Uma licença de demonstração por tempo limitado está disponível pelo formulário de solicitação na página Docker License (nome, empresa, e-mail, telefone opcional).

FAQ

Preciso instalar algum software nas máquinas dos meus desenvolvedores? Não. O Timestamp GIT funciona inteiramente via um GitHub App ou uma GitHub Action. Os desenvolvedores apenas fazem commit como de costume; a automação cuida do resto.

O que acontece se um commit for feito após o horário de corte noturno? Ele será incluído no lote da noite seguinte. O sistema enfileira todos os hashes pendentes e os ancora juntos.

Posso automatizar o carimbo de tempo para vários repositórios? Sim. Você pode instalar o GitHub App em vários repositórios ou em uma organização inteira, e cada repositório recebe suas próprias provas.

Como verifico se um commit recebeu carimbo de tempo? Você pode usar a página de verificação pública ou a API para verificar a prova Merkle contra a blockchain Bitcoin. Os badges também mostram o status.

O que acontece se eu fizer push de vários commits em um dia? Todos eles são coletados no lote do dia, dobrados em uma única árvore Merkle e ancorados juntos sob uma transação Bitcoin. Você ainda recebe manifestos por repositório, então hashes de commit individuais permanecem rastreáveis dentro do lote.

Posso carimbar o tempo de commits de repositórios privados? Sim — repositórios privados são suportados no plano Pro Agency (US$ 49/mês) e no Enterprise ZK (US$ 199/mês, GitHub Actions). Repositórios públicos são gratuitos no nível Open Source.

Quanto tempo leva para um commit ser ancorado? Normalmente algumas horas após a execução do lote noturno. A confirmação do Bitcoin em si normalmente leva cerca de três horas, então as provas chegam ao seu repositório algumas horas após a meia-noite.

A prova é verificável sem o Timestamp GIT? Sim. As provas dependem apenas de SHA-256 e dados de blocos Bitcoin, então podem ser verificadas de forma independente contra a blockchain — sem tecnologia proprietária e sem aprisionamento tecnológico.

Conclusão

O valor da prova de anterioridade vem da cobertura, e a cobertura vem da automação. Um processo de carimbo de tempo que depende de uma pessoa lembrar de executar algo terá buracos, e buracos são o que a parte adversa procura.

O Timestamp GIT cuida do protocolo OpenTimestamps para você: instale o GitHub App uma vez, deixe o cron noturno ancorar cada commit em Bitcoin, acompanhe os badges e endpoints de status e mantenha os recibos .ots em um repositório que você controla. A configuração leva minutos; depois disso, a única tarefa contínua é dar uma olhada em um alerta que nunca deveria disparar.

Comece com o nível Open Source gratuito em um repositório público, ou conecte um privado no Pro Agency e deixe o primeiro lote rodar esta noite. Para uma visão mais ampla do que isso custa em comparação com fazer você mesmo, leia Code Timestamping Costs Compared: Managed vs DIY.

Posts relacionados

EU label: AI-generated content