Ancoragem Automática Noturna de Commits Git na Bitcoin, Zero Passos Manuais
A forma mais comum de as equipas “carimbarem” um commit é alguém se lembrar de o fazer.
Alguém termina uma funcionalidade, lembra-se de que o commit devia ser ancorado, e executa o fluxo de trabalho do OpenTimestamps à mão — da forma difícil — e depois guarda o recibo em algum lugar. Duas semanas depois, ninguém se lembra se o recibo daquela terça-feira existe. Outro programador junta-se à equipa, não conhece o ritual, e seis meses de commits ficam por carimbar.
Essa é a armadilha do carimbo manual: uma cobertura de prova que depende da memória. Funciona bem numa demonstração e desmorona-se ao longo de uma equipa, de um ritmo de sprints e de um ano de rotatividade. A ancoragem automática noturna de commits git na bitcoin inverte o problema: a ancoragem deixa de ser uma tarefa que uma pessoa executa e passa a ser uma propriedade do teu repositório. Instalas uma GitHub App uma vez, e todos os commits são agrupados e ancorados enquanto dormes.
Este artigo percorre esse caminho automatizado de ponta a ponta — configuração, pipeline, monitorização, alojamento próprio — e é escrito para programadores e responsáveis de conformidade que se preocupam com a prova sobreviver a uma auditoria, e não com tomar conta de um cron job.
A Armadilha do Carimbo Manual (e Como a Automação a Elimina)
Carimbar commits manualmente tem três modos de falha, e todos os três são estruturais e não pessoais:
- Dependência da memória. Alguém tem de se lembrar de executar as ferramentas no momento certo, idealmente antes de o trabalho ser público. Tarde é o mesmo que nunca para efeitos de prior art.
- Falhas silenciosas. Quando uma execução manual falha — falha de rede, calendário expirado, diretório errado — nada rebenta. Simplesmente ficas com uma lacuna na cobertura que descobres um ano depois, durante o litígio para o qual precisavas da prova.
- Dispersão de recibos. Os recibos acabam em portáteis, em conversas do Slack, numa drive partilhada que ninguém possui. Uma prova que não consegues encontrar é uma prova que não tens.
Nada disto escala. Um programador em freelance pode manter o ritual vivo durante alguns meses. Uma equipa de dez não o fará, e uma agência que gere trabalho de clientes em dezenas de repositórios não tem qualquer hipótese. Cada noite falhada é um buraco permanente no registo, porque não podes ancorar retroativamente um hash que nunca foi capturado.
O Timestamp GIT é a alternativa gerida com zero configuração: uma GitHub App que captura automaticamente os hashes dos commits, agrupa-os e ancora-os na blockchain da Bitcoin através do protocolo OpenTimestamps todas as noites. Sem ferramentas de linha de comandos, sem recibos manuais, nada instalado nas máquinas dos programadores. Obténs a propriedade criptográfica — uma data imutável e verificável de forma independente — sem executares tu próprio o protocolo subjacente.
Dois mergulhos mais profundos estão noutros artigos deste blog: How to Verify a Git Repository’s Bitcoin Timestamp cobre o lado da verificação, e Git Commit Timestamp Proof for Patent Disputes cobre o enquadramento legal. Este artigo mantém-se na própria automação.
Configuração Única: Instala a GitHub App e Esquece-a
A configuração é uma única ação, feita uma vez por repositório ou uma vez por organização.
- Instala a GitHub App do Timestamp GIT no repositório (ou em toda a organização, para que os novos repositórios fiquem cobertos por predefinição).
- Escolhe o repositório de origem que contém o teu código.
- Escolhe o repositório de destino onde as provas serão escritas — ou o mesmo repositório num ramo dedicado, ou um repositório sombra separado.
É toda a configuração. Não há requisitos nas máquinas dos programadores: sem daemon, sem hook que cada engenheiro tenha de instalar, sem lista de verificação de integração. Os novos colaboradores ficam cobertos logo no primeiro commit, porque a cobertura é uma propriedade do repositório, não uma propriedade pessoal.
O modelo de permissões. O Modo Standard precisa de acesso só de leitura ao repositório de origem e de acesso de leitura e escrita ao repositório de destino. O requisito de só leitura existe porque o sistema de permissões do GitHub não oferece um âmbito apenas para o hash do commit — o acesso de leitura à origem é a concessão mínima que permite à App ver o hash do commit HEAD. Só lê esse hash.
Se nem um hash deve sair do teu ambiente, o Modo Enterprise ZK substitui o polling da App por uma GitHub Action de 12 linhas que corre na tua própria infraestrutura e envia apenas o hash do commit para a API do Timestamp GIT. Nesse modo, o serviço precisa apenas de acesso de leitura e escrita ao repositório de destino, e de nenhum acesso de leitura ao repositório de origem — instalas a Action em vez disso.
De qualquer forma, a garantia é a mesma: nunca vemos, copiamos nem armazenamos o teu código-fonte real. Só o hash está sempre em jogo.
Dentro do Pipeline Automatizado: Do Commit à Âncora na Bitcoin
Depois de instalado, o pipeline corre sem intervenção. Eis o que acontece entre o teu git push e uma prova imutável a residir no teu repositório.
1. Deteção de commits. No Modo Standard, a GitHub App deteta novos commits através de webhooks. No Modo Enterprise ZK, a tua GitHub Action envia o hash do commit para a API. Qualquer dos caminhos produz o mesmo artefacto: uma lista de hashes de commits.
2. Fila de hashes. Os hashes recebidos chegam a um armazenamento chave-valor em memória usado puramente para agrupamento. Esta é a sala de espera — os commits acumulam-se aqui até à próxima janela de agrupamento.
3. Worker cron da meia-noite. Todas as noites, um worker pega em todos os hashes pendentes e:
- agrupa-os por repositório,
- escreve um ficheiro manifesto (
.txt) para cada repositório, - constrói uma árvore de Merkle nativamente sobre o lote,
- cria provas OpenTimestamps usando calendários OTS públicos,
- ancora a raiz de Merkle na blockchain da Bitcoin.
O agrupamento é o que torna isto barato e contínuo. Quer tenhas enviado um commit ou quatrocentos nesse dia, o custo e a cadência são os mesmos.
4. Entrega das provas. O manifesto e os ficheiros de recibo .ots são enviados de volta para o teu repositório — num ramo dedicado timestamps ou no teu repositório sombra — automaticamente.
Há um detalhe de temporização que vale a pena planear: a confirmação na blockchain da Bitcoin demora várias horas, normalmente cerca de três. Por isso, os commits enviados hoje são colocados em fila esta noite, ancorados durante a noite, e os ficheiros de prova aparecem algumas horas depois. Não ficas à espera; simplesmente encontras-los lá na manhã seguinte.
O resultado, por dia e por repositório, é uma cadeia à prova de adulteração: os hashes dos teus commits → manifesto → árvore de Merkle → raiz de Merkle → prova OpenTimestamps → bloco Bitcoin.
Monitorização e Tratamento de Falhas: Manter a Cadeia Ininterrupta
Automação que não monitorizas é apenas uma versão mais bonita da armadilha manual. O Timestamp GIT expõe endpoints de estado públicos para que possas verificar a cadeia tu próprio, sem iniciar sessão num painel:
# Last anchored Bitcoin block info for a repo
curl -s https://timestampgit.dev/api/statusLast/{user}/{repo}
# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/{user}/{repo}
# Combined summary, used for Shields.io badges
curl -s https://timestampgit.dev/api/statusSummary/{user}/{repo}
Uma verificação de continuidade simples que encaixa em qualquer agendador: chama statusLast uma vez por dia, guarda a resposta em bruto e alerta se não tiver mudado desde ontem. Se nenhuma nova âncora chegou, apanhaste a lacuna na mesma semana em vez de na mesma década.
Se preferires não construir isso tu próprio, o painel de estado público em https://timestampgit.dev/status/{user}/{repo} faz o trabalho visualmente — longevidade das provas, data da âncora mais antiga, regularidade diária, os dados do bloco e da transação Bitcoin por trás de cada âncora, e um mapa de calor de calendário que torna as noites falhadas imediatamente óbvias. A partir da mesma página podes descarregar o CSV de auditoria e um certificado PDF.
Os repositórios privados permanecem privados. Os URLs de estado para repositórios privados transportam um HMAC encriptado específico da instância do servidor, pelo que só utilizadores autorizados podem ler o estado desses repositórios. As provas continuam a ser publicamente verificáveis no sentido da Bitcoin — o hash está on-chain — mas os metadados em redor não são um livro aberto.
Badges de verificação. Para repositórios públicos, badges incorporáveis mostram o teu estado de verificação diretamente no README, com uma ligação que qualquer pessoa pode seguir para verificar o carimbo temporal no site. O badge torna a prova visível para um cliente, um adquirente ou o advogado da parte contrária sem que tenhas de produzir nada.
Quando a App se reconecta. Se um repositório for desligado e reconectado, a página de ligação dá-te o widget de incorporação do badge com uma pré-visualização em direto para que possas reverificar que a ligação está intacta.
Boas Práticas para uma Ancoragem Noturna Fiável
- Coloca uma pessoa a olhar para o mapa de calor uma vez por semana. A automação noturna remove a tarefa diária, não a responsabilidade. Uma vista de olhos semanal de cinco minutos ao painel de estado apanha tudo o que um alerta possa deixar passar.
- Alerta na ausência, não apenas nos erros. O estado perigoso é o silêncio. Alerta quando a data da âncora deixa de avançar.
- Usa um ramo dedicado
timestampsou um repositório sombra. Manter as provas fora do teu ramo predefinido significa sem ruído de merges, sem interferência acidental com o CI, e um registo de auditoria que um revisor pode percorrer sem clonar a tua aplicação. - Incorpora badges onde os compradores olham. No README, perto do cabeçalho da licença. Uma prova pública de existência é credibilidade barata.
- Exporta o registo de auditoria de forma agendada. Extrai o CSV regularmente e arquiva-o junto dos teus materiais de conformidade, e gera um certificado PDF para cada marco de lançamento. As equipas de conformidade querem um documento com uma data; dá-lhes um antes que o peçam.
- Mantém por escrito a história do “quem pode ver o quê”. Documenta o teu modo — Standard ou Enterprise ZK — e as permissões exatas concedidas. Quando as compras ou o jurídico perguntarem, estás a responder a uma pergunta que já respondeste.
Alojamento Próprio para Ambientes Air-Gapped: Início Rápido com Docker Compose
Se as tuas restrições excluem um serviço gerido — ambientes regulados, redes air-gapped, regras estritas de residência de dados — o Timestamp GIT está disponível como imagem Docker que corre o mesmo pipeline automatizado na tua própria infraestrutura.
Uma configuração de início rápido com Docker Compose tem este aspeto:
services:
timestampgit:
image: rue1401/timestampgit:prod
ports:
- "8080:8080"
volumes:
- ./data:/app/data
restart: unless-stopped
valkey:
image: valkey/valkey:8
restart: unless-stopped
Coloca-o a funcionar:
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
A aplicação fica disponível em http://localhost:8080 após o arranque. No primeiro lançamento, um assistente de configuração guia-te na ligação da tua GitHub App e na configuração da tua instância.
Para avaliação, está disponível uma licença de demonstração com tempo limitado: submete o formulário de pedido na página Docker License com o teu nome, empresa, email e número de telefone opcional, e podes descarregar um ficheiro de licença de demonstração para começar.
O alojamento próprio dá-te segurança e controlo máximos com o mesmo comportamento de agrupamento e ancoragem noturnos — a árvore de Merkle, as provas OTS e os ficheiros .ots escritos de volta nos teus repositórios.
FAQ
Preciso de executar comandos ou instalar ferramentas na minha máquina? Não. O Timestamp GIT é um serviço gerido: instalas a GitHub App uma vez, e todos os commits são ancorados automaticamente todas as noites. Nada é instalado nas máquinas dos programadores.
Quanto tempo demora um commit a ser ancorado na Bitcoin?
O worker cron noturno agrupa os commits e ancora a raiz de Merkle na Bitcoin via OpenTimestamps. A confirmação demora tipicamente cerca de 3 horas, após o que os ficheiros de prova .ots são enviados de volta para o teu repositório.
Posso verificar o carimbo temporal de forma independente?
Sim. Podes descarregar o ficheiro .ots e usar ferramentas de verificação OpenTimestamps padrão contra a blockchain da Bitcoin, ou usar a página de verificação pública em https://timestampgit.dev/verification/{user}/{repo}/{date}, que executa todos os passos da verificação da cadeia de Merkle multinível localmente no teu navegador — ninguém vê o que verificas.
E se eu precisar de manter o meu código-fonte completamente privado? Usa o modo Enterprise ZK: uma GitHub Action na tua infraestrutura envia apenas o hash do commit para a API do Timestamp GIT, pelo que o teu código nunca sai do teu ambiente. Em alternativa, aloja-o tu próprio com Docker para controlo total.
A Âncora Vale Tanto Quanto a Sua Regularidade
Um carimbo temporal que fizeste uma vez prova uma coisa sobre um momento. Um carimbo temporal feito todas as noites, automaticamente, prova que um repositório existiu num estado específico numa linha temporal contínua — e é essa a versão que se aguenta quando alguém te desafia dezoito meses depois. O carimbo manual não consegue produzir esse registo, porque o registo é definido pelos dias em que não falhaste.
O Timestamp GIT foi construído exatamente para isso: instala a GitHub App no teu repositório ou organização, escolhe onde as provas ficam, e deixa o worker noturno agrupar, construir a árvore de Merkle e ancorar os hashes dos teus commits na Bitcoin. Verifica com um badge, um painel, ou os próprios ficheiros .ots. Se preferires executá-lo dentro da tua própria rede, a licença Docker de alojamento próprio cobre-te.
Instala-o uma vez. Depois deixa de pensar nisso.
Artigos relacionados
- Code Timestamping Service Pricing for Private Repos
- OpenTimestamps Alternatives: Managed Git Timestamping
- Protecting Agency Code Deliverables With Blockchain Proof