Timestamp GIT

← Todos os artigos

2026-10-26

Automatize o timestamping de Bitcoin para cada commit do GitHub

Automatize o timestamping de Bitcoin para cada commit do GitHub
timestamp git blockchain proof

Automatize o carimbo de data/hora Bitcoin para cada commit do GitHub

Você decidiu que seus commits merecem uma prova criptográfica de existência. Ótimo. Agora vem a parte chata: fazer isso de novo amanhã, e depois de amanhã, para cada repositório que sua equipe toca.

É aí que a maioria das iniciativas de carimbo de data/hora morre silenciosamente. Não porque a ideia esteja errada, mas porque a tarefa manual — agrupar hashes de commits, enviá-los a um serviço de calendário, acompanhar um arquivo de prova, fazer commit dele de volta — não sobrevive ao contato com uma sprint real. Se você quer automatizar o carimbo de data/hora em blockchain para repositórios do GitHub, o carimbo precisa ser um efeito colateral do git push, não uma tarefa que alguém lembra de fazer às sextas-feiras.

Este artigo percorre o caminho automatizado de ponta a ponta: uma instalação, um pipeline noturno que você nunca toca e monitoramento que informa se as provas realmente chegaram ao Bitcoin.

Por que o carimbo de data/hora manual não escala

A forma difícil de carimbar um commit é fazê-lo manualmente toda vez. Você seria responsável por:

  • Decidir quais commits valem a pena carimbar (todos valem, e esse é o problema).
  • Agrupar os hashes você mesmo para não criar uma transação Bitcoin por commit.
  • Enviar a um calendário público e acompanhar a prova pendente até a confirmação.
  • Armazenar o arquivo de prova resultante em algum lugar durável e vinculado ao commit correto.
  • Repetir tudo amanhã, e depois de cada force-push, hotfix e merge train.

Mesmo com scripts, isso é um trabalho de meio período. Alguém precisa ser dono do script, do executor de cron, do local de armazenamento e do incidente “por que a prova da semana passada está faltando”. E no momento em que essa pessoa muda de equipe, o pipeline apodrece.

O protocolo OpenTimestamps bruto é genuinamente elegante — você pode ler como ele funciona em OpenTimestamps Alternative: Managed GitHub App for Every Commit. Este artigo trata do outro problema: fazer isso rodar sem supervisão, para sempre.

O objetivo é configurar e esquecer: cada commit em um repositório monitorado é ancorado todas as noites, sem intervenção de desenvolvedores e sem nada instalado no laptop de ninguém.

Configuração única: instale o GitHub App

O Timestamp GIT é um serviço gerenciado construído em torno de um GitHub App. A configuração leva minutos e acontece uma vez por conta ou organização.

1. Instale o app. No painel do Timestamp GIT, instale o GitHub App na sua conta pessoal ou na sua organização.

2. Selecione os repositórios. Escolha todos os repositórios ou um subconjunto específico. Você pode ajustar a seleção depois sem reinstalar.

3. Confirme as permissões. O modelo de permissões é deliberadamente restrito:

Acesso Escopo Por quê
Somente leitura Repositório de origem O sistema de permissões do GitHub não tem um escopo de “apenas hash de commit”, então o app precisa de acesso de leitura para ver os hashes de commit do HEAD
Leitura e escrita Repositório de destino As provas são gravadas de volta como arquivos de manifesto e recibos .ots em um branch dedicado ou em um repositório sombra

4. Vá embora. Não há YAML para adicionar, segredo para rotacionar, CLI para instalar. Seus desenvolvedores continuam fazendo commits exatamente como fazem agora; o app reage a webhooks em segundo plano.

Se seus repositórios são públicos, o plano Open Source cobre isso de fábrica. Repositórios privados começam no plano Pro Agency — o detalhamento de preços cobre qual plano se encaixa em qual formato de equipe.

A alternativa mais restrita: modo Enterprise ZK

O modo padrão exige acesso de leitura ao seu repositório de origem. Se sua política proíbe isso — ou se você simplesmente não quer que nenhum terceiro consiga ler seu código — o modo Enterprise ZK inverte a direção. Em vez de puxar, seu lado envia: uma GitHub Action de 12 linhas roda na sua própria infraestrutura e envia apenas o hash do commit para a API do Timestamp GIT. Sua origem nunca sai do seu ambiente, e o serviço não precisa de nenhum acesso de leitura ao repositório de origem. Apenas o repositório de destino (onde as provas são gravadas) precisa de acesso de escrita.

O pipeline automatizado: do commit ao Bitcoin

Eis o que acontece após a configuração, sem você fazer nada.

1. Detecção de commits. Novos commits chegam pelos webhooks do GitHub App (modo padrão) ou pelos hashes enviados pela sua GitHub Action (modo Enterprise ZK).

2. Fila de hashes. Os hashes de commit chegam a um armazenamento chave-valor em memória e aguardam o lote noturno. Observe o que não está nesse armazenamento: seu código. Apenas hashes.

3. Worker de cron da meia-noite. Uma vez por noite, um worker:

  • Agrupa todos os hashes pendentes.
  • Monta um manifesto por repositório (.txt).
  • Constrói uma árvore Merkle nativamente sobre o lote.
  • Gera provas OpenTimestamps contra calendários OTS públicos.
  • Ancora a raiz Merkle na blockchain Bitcoin.

4. Entrega das provas. O manifesto e os arquivos de recibo .ots são enviados de volta ao seu repositório — seja em um branch dedicado timestamps junto ao seu código, seja em um repositório sombra separado.

Expectativas de tempo. O Bitcoin não confirma instantaneamente. A transação de ancoragem normalmente confirma em cerca de três horas, então espere que as provas apareçam algumas horas após a meia-noite UTC. Se você estiver verificando às 00:05 UTC e não vendo nada, não há nada errado.

A superfície de API para fluxos de trabalho personalizados

O pipeline roda sozinho, mas a API permite conectar os dados de prova às suas próprias ferramentas. Todos os endpoints são autenticados quando indicado.

# Last anchored Bitcoin block for a repository (public)
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api

# Total stamped commits (public)
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api

# Combined summary, handy for Shields.io
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api

# Full Merkle chain data for a specific day, for local verification
curl -s https://timestampgit.dev/api/verify/acme/payments-api/2026-10-25

# Audit ledger as CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/acme/payments-api

# PDF certificate for one date
curl -s -o certificate.pdf https://timestampgit.dev/api/report/acme/payments-api/2026-10-25

Instalações Enterprise ZK também usam o endpoint de commit autenticado por HMAC, onde {hash} é o valor HMAC retornado pela URL assinada que sua Action solicita:

curl -X POST \
  "https://timestampgit.dev/api/timestamp/acme/payments-api/timestamps/<hmac>/<commitId>"

Essa é toda a superfície de integração. Não há uma chamada de “iniciar um lote” para agendar — o agrupamento é tarefa do serviço.

Monitoramento e tratamento de falhas

Automação que você não monitora é apenas otimismo. O Timestamp GIT oferece três formas independentes de confirmar que o pipeline está saudável.

O painel de status público

Cada repositório ganha um painel público em /status/{user}/{repo} mostrando:

  • Longevidade das provas e a data de ancoragem mais antiga — até onde sua cadeia de provas remonta.
  • Regularidade diária, renderizada como um mapa de calor de calendário, para que uma noite perdida seja visualmente óbvia.
  • Dados de bloco e transação Bitcoin para cada ancoragem.

Badges de verificação

Incorpore um badge do Shields.io no seu README para tornar a prova pública:

![Timestamped](https://timestampgit.dev/api/statusSummary/acme/payments-api)

A página /connected/{user}/{repo} oferece um widget de incorporação de badge com pré-visualização ao vivo, incluindo o trecho markdown. Para repositórios privados, as URLs de status carregam um HMAC criptografado específico da instância do servidor — o status permanece visível apenas para quem tem o link assinado.

Verificação de saúde auto-hospedada

Como os endpoints de status são JSON simples, um pequeno script no seu próprio CI detecta um pipeline paralisado antes que um auditor o faça:

import requests

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

r = requests.get(f"{BASE}/api/statusLast/{USER}/{REPO}", timeout=15)
r.raise_for_status()

last = r.json()  # last anchored Bitcoin block info for this repository
print(last)
# Compare against yesterday's stored value in your own job to detect a stalled batch.

E se um lote noturno não for concluído? O sinal observável é o mesmo em todos os casos: o mapa de calor mostra uma lacuna e o último bloco ancorado para de avançar. Como a ancoragem é agrupada por dia, uma execução perdida fica visível em até 24 horas, em vez de no momento da auditoria — e, como a fila de hashes e os manifestos são indexados por data, uma nova execução produz uma prova distinta e datada, em vez de ambígua. Verifique primeiro o painel e depois o branch timestamps do repositório para confirmar se o manifesto e os recibos foram gravados.

A trilha de auditoria

Para revisões de conformidade, dois artefatos fazem o trabalho pesado:

  • GET /api/audit/{user}/{repo} — o livro-razão completo em CSV.
  • GET /api/report/{user}/{repo}/{date} — um certificado em PDF para uma única data.

E quando alguém quiser conferir a matemática em vez de confiar em um PDF, a página /verification/{user}/{repo}/{date} percorre a cadeia Merkle de vários níveis passo a passo. Todo esse cálculo acontece localmente no navegador — nada do que você verifica é enviado ao servidor.

Boas práticas para carimbo de data/hora automatizado

Depois que o pipeline estiver rodando, alguns hábitos mantêm a evidência útil:

  • Faça commits cedo e com frequência. Cada commit é um ponto de dados para prior art. Esmagar um mês de trabalho em um único commit pouco antes de um pedido de patente lhe dá uma ancoragem em vez de quarenta.
  • Mantenha as provas em um branch próprio. O branch automatizado timestamps é escrito por máquina; mantê-lo separado dos branches de feature deixa o git log legível e evita ruído de merge.
  • Verifique periodicamente, não apenas no momento da disputa. Faça uma verificação pontual de uma data recente pelo verificador web a cada trimestre. Descobrir uma cadeia de verificação quebrada durante um litígio é uma péssima hora para descobrir.
  • Envie as provas junto com as releases. Anexe o manifesto e os recibos da data da sua release aos artefatos da release e referencie a data na sua documentação jurídica.
  • Marque tudo que você possa patentear. Os commits são capturados automaticamente; no momento em que você começar a discutir uma ideia patenteável, garanta que o trabalho esteja commitado em vez de parado em um branch local.

Automação auto-hospedada com Docker

A hospedagem gerenciada é o padrão, mas alguns ambientes não podem usá-la: redes isoladas (air-gapped), requisitos rígidos de residência de dados ou políticas internas que proíbem qualquer serviço externo de tocar nos metadados do repositório.

Para esses casos, o Timestamp GIT é distribuído como imagem Docker. A automação é idêntica — o mesmo agrupamento noturno, a mesma construção de árvore Merkle e a mesma ancoragem no Bitcoin, só que rodando na sua infraestrutura.

Uma configuração Docker Compose de início rápido é assim:

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 assim que estiver no ar. Na primeira inicialização, um assistente de configuração orienta você a conectar seu GitHub App e configurar a instância.

Para avaliar antes de se comprometer, solicite uma licença de demonstração por tempo limitado na página de licença Docker — nome, empresa, e-mail e um telefone opcional. Um arquivo de licença de demonstração por tempo limitado fica disponível para download, e você o envia durante a fase de configuração on-premises.

Perguntas frequentes

Preciso executar algum comando ou instalar ferramentas nas máquinas dos meus desenvolvedores? Não. O Timestamp GIT funciona inteiramente via GitHub App. Uma vez instalado, cada commit em um repositório monitorado é carimbado automaticamente todas as noites. Sem ferramentas de CLI, sem comandos OpenTimestamps, sem etapas manuais.

Quanto tempo leva para um commit ser carimbado? Os commits são agrupados e ancorados uma vez por noite. A transação Bitcoin normalmente confirma em cerca de 3 horas, então as provas geralmente ficam disponíveis algumas horas após a meia-noite UTC.

Posso verificar o carimbo de data/hora de forma independente sem confiar no Timestamp GIT? Sim. Os arquivos de recibo .ots podem ser verificados usando ferramentas padrão do OpenTimestamps contra a blockchain Bitcoin. A prova depende apenas de SHA-256 e dados de blocos Bitcoin, então você pode verificar offline mesmo que nosso serviço desapareça.

E se eu precisar manter meu código-fonte completamente privado? Use o modo Enterprise ZK: uma GitHub Action na sua infraestrutura envia apenas o hash do commit para nossa API. Nunca temos acesso de leitura ao seu código-fonte. Como alternativa, auto-hospede com Docker para controle total.

O pipeline de carimbo de data/hora toca no meu código-fonte? Não. O modo padrão lê hashes de commit; o modo Enterprise ZK nunca vê o conteúdo do seu repositório. O serviço só lida com hashes SHA-256 e dados de blocos Bitcoin.

O carimbo de data/hora com o qual você não precisa se preocupar

O valor do prior art criptográfico vem da cobertura, não de uma única prova impressionante. Um commit carimbado de uma tarde heroica não prova quase nada; dezoito meses de ancoragens noturnas provam uma linha do tempo. Isso é um problema de volume, e problemas de volume são resolvidos com automação.

Esse é todo o argumento do Timestamp GIT: instale o GitHub App uma vez, escolha seus repositórios e deixe o trabalho noturno fazer o resto. As provas chegam a um branch timestamps, os badges chegam ao seu README e o CSV de auditoria está lá quando o jurídico pedir. Se você precisa de isolamento, o modo Enterprise ZK ou o Docker levam você até lá sem abrir mão da automação.

Instale o app, faça um push de um commit e verifique o painel amanhã de manhã.


Posts relacionados

EU label: AI-generated content