Timestamp GIT

← Todos os artigos

2026-11-04

Como adicionar timestamp a commits Git sem a linha de comando

Como adicionar timestamp a commits Git sem a linha de comando
timestamp git blockchain proof

Como Carimbar Commits Git com Data e Hora Sem a Linha de Comando

Você quer a propriedade, não o procedimento. A propriedade é: este hash de commit existia nesta data, e aqui está um recibo que qualquer pessoa pode verificar contra a blockchain do Bitcoin. O procedimento que você quer evitar é instalar ferramentas em cada laptop de desenvolvedor, caçar arquivos de prova em threads de chat e torcer para que alguém se lembre de como funciona o lado da verificação dois anos depois, quando um advogado perguntar.

Este guia mostra como carimbar commits Git com data e hora sem ferramentas de linha de comando. Tudo abaixo acontece em um navegador e no GitHub. Você instala um GitHub App uma vez, aponta-o para um repositório e depois continua commitando exatamente como faz hoje. O Timestamp GIT agrupa os hashes de commit todas as noites, ancora-os no Bitcoin via protocolo OpenTimestamps e envia os recibos de prova de volta para o seu repositório.

Sem CLI. Sem nó Bitcoin local. Sem necessidade de conhecimento do protocolo.

Por que evitar a linha de comando para carimbar data e hora no Git?

O caminho difícil existe, e você provavelmente consegue imaginar sua forma: instalar o cliente OpenTimestamps na sua máquina, executar um comando contra um arquivo que você construiu, guardar o recibo resultante em algum lugar e repetir sempre que lembrar. Três modos de falha surgem imediatamente:

  • É por máquina. Integrar um novo desenvolvedor significa reexplicar o ritual. Seu runner de CI também precisa disso. Seu laptop substituto precisa disso de novo.
  • É por momento. Os carimbos de data e hora só cobrem o que você lembrou de carimbar. Os commits que você esqueceu — geralmente os interessantes, feitos durante um período de correria — são justamente os que você vai querer em uma disputa.
  • É evidência frágil. Um recibo parado no diretório home de alguém, sem cadeia de custódia, não é uma trilha de auditoria.

O caminho gerenciado move tudo isso para o lado do servidor. O Timestamp GIT é um GitHub App que observa seus repositórios e ancora hashes de commit automaticamente todas as noites. Você nunca toca no protocolo subjacente. A prova é gravada de volta no seu próprio repositório, em um branch dedicado ou em um shadow repo, para que viva junto com o código que descreve.

Para contexto sobre por que um simples git log não é evidência em primeiro lugar, veja Por que seu Git Log não é prova. Este artigo é o passo a passo.

Pré-requisitos

Antes de começar, confirme que você tem:

  • Uma conta do GitHub e um repositório — público ou privado — que deseja carimbar com data e hora.
  • Permissões de administrador nesse repositório ou na organização que o possui, para que você possa instalar um GitHub App.
  • Para repositórios privados, um plano pago: Pro Agency (US$ 49/mês) ou Enterprise ZK (US$ 199/mês). Repositórios públicos são gratuitos no plano Open Source.
  • Nada mais. Nenhum software local, nenhuma instalação do OpenTimestamps, nenhum nó Bitcoin, nenhuma carteira. Um navegador é toda a cadeia de ferramentas.

Uma observação sobre permissões, porque é a primeira pergunta que as pessoas fazem. O modelo de permissões do GitHub não tem um escopo de “somente hash de commit”, então o Modo Padrão exige acesso somente leitura ao repositório de origem e acesso de leitura e escrita ao repositório de destino onde as provas são gravadas. Se até o acesso somente leitura à origem for inaceitável para você, o Modo Enterprise ZK usa uma GitHub Action e não exige nenhum acesso de leitura à origem. Mais sobre isso no Passo 6.

Passo a passo: carimbar commits com data e hora sem a linha de comando

Passo 1: Instale o GitHub App Timestamp GIT

Instale o app pelo GitHub Marketplace ou em timestampgit.dev. Durante a instalação, será perguntado quais repositórios o app pode ver, e você concederá os dois conjuntos de permissões descritos acima: somente leitura no repositório de origem, leitura e escrita no repositório que receberá os arquivos de prova.

Se você estiver carimbando uma organização inteira, instale no nível da organização uma vez, em vez de repositório por repositório.

Passo 2: Selecione os repositórios a monitorar

Abra o dashboard em https://timestampgit.dev/repos e escolha quais repositórios são monitorados. Assim que um repositório é conectado, o app detecta novos commits por meio de webhooks do GitHub — nada a configurar por commit e nada a lembrar.

Você pode verificar a conexão imediatamente. Os endpoints públicos de status retornam JSON, sem necessidade de CLI:

# Last anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/your-user/your-repo

# How many commits have been stamped so far
curl -s https://timestampgit.dev/api/statusCount/your-user/your-repo

Um repositório recém-criado legitimamente retornará contagens zeradas até a primeira execução noturna ser concluída.

Passo 3: Faça commits como de costume

Este é todo o passo de “mudança de fluxo de trabalho”, e ele está vazio. Você escreve código, faz git commit e dá push. O Timestamp GIT captura o hash de commit que o webhook entrega — não o diff, não os arquivos, não o código-fonte. O serviço nunca vê, copia ou armazena seu código real; apenas o SHA que identifica o estado do repositório.

Na prática, isso significa que seus desenvolvedores não precisam de treinamento, e sua revisão de segurança tem uma resposta curta: o único dado que sai do repositório é um hash, e um hash é uma impressão digital unidirecional.

Passo 4: Deixe o cron noturno fazer a ancoragem

À meia-noite, um worker coleta todos os hashes de commit pendentes, agrupa-os por repositório e grava um arquivo de manifesto de texto por repositório. Ele constrói uma árvore de Merkle sobre o lote, cria provas OpenTimestamps contra calendários OTS públicos e ancora a raiz de Merkle em uma transação Bitcoin.

Duas coisas decorrem desse design:

  • O agrupamento é barato e privado. Ancorar milhares de commits individualmente seria absurdo. Uma raiz de Merkle por repositório por dia significa que uma âncora cobre tudo o que foi commitado naquele dia, e os hashes individuais permanecem ocultos dentro da árvore.
  • A entrega da prova não é instantânea. O manifesto e os arquivos de recibo .ots são enviados de volta para um branch de timestamps dedicado ou shadow repository após a confirmação do Bitcoin, que normalmente leva cerca de três horas. Uma execução que começa à meia-noite geralmente termina de madrugada.

Os hashes de commit aguardam em um armazenamento chave-valor em memória até a execução, então um repositório que fica parado por um dia simplesmente não produz um novo arquivo de prova — não é um erro.

Passo 5: Incorpore um selo de verificação (opcional)

Abra a página Repository Connected do seu repositório — https://timestampgit.dev/connected/{user}/{repo} — e use o widget de selo. Ele renderiza uma prévia ao vivo e fornece um snippet Markdown para colar no seu README, para que a alegação de proveniência seja pública e clicável, em vez de um parágrafo de afirmação.

<!-- Paste the exact snippet generated by the badge widget -->
[![Timestamped with Timestamp GIT](BADGE_URL)](https://timestampgit.dev/status/your-user/your-repo)

Qualquer pessoa que clicar no selo chega à página pública de status, que também é onde os auditores vão querer ir.

Passo 6: Auto-hospede ou vá para zero-knowledge (opcional)

Existem duas implantações alternativas para equipes com requisitos mais rígidos.

O Modo Enterprise ZK inverte o fluxo de dados: uma GitHub Action de 12 linhas é executada na sua própria infraestrutura e envia apenas o hash de commit para a API do Timestamp GIT. Sua origem nunca sai do seu ambiente, e nenhum acesso de leitura ao repositório de origem é necessário — apenas leitura e escrita no repositório de destino para entrega da prova.

O Docker auto-hospedado é para ambientes isolados (air-gapped) e para quem quer a instância dentro do próprio perímetro. 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 após a inicialização. Na primeira execução, um assistente de configuração orienta você a conectar seu GitHub App e configurar a instância. A auto-hospedagem exige uma licença: você pode solicitar uma licença de demonstração por tempo limitado na página Docker License com seu nome, empresa, e-mail e telefone opcional, e baixar o arquivo de licença para avaliação.

Como confirmar que funcionou

Não tome o selo como prova. Confirme em três níveis, em ordem crescente de rigor.

1. A página de status do repositório. Visite https://timestampgit.dev/status/{user}/{repo}. Você verá a longevidade das provas, a data ancorada mais antiga, a regularidade diária, os dados do bloco Bitcoin e da transação por trás de cada âncora, e um mapa de calor de calendário mostrando quais dias produziram provas. O mapa de calor é a forma mais rápida de identificar lacunas.

2. Os artefatos de auditoria. Na página de status ou na API, obtenha o livro-razão de auditoria ou um certificado por data:

# Full audit ledger as CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/your-user/your-repo

# PDF certificate for a specific date
curl -s -o certificate.pdf https://timestampgit.dev/api/report/your-user/your-repo/2026-11-03

Esses são os documentos que você entrega a um advogado ou auditor, e o CSV é o que uma equipe de compliance vai realmente comparar com os registros internos.

3. Verificação criptográfica local. A página de verificação em https://timestampgit.dev/verification/{user}/{repo}/{date} percorre a cadeia de Merkle passo a passo, e toda a computação acontece localmente no seu navegador. Nada do que você verifica é transmitido. O arquivo de recibo .ots do mesmo dia fica no seu branch de timestamps, e qualquer pessoa pode verificá-lo de forma independente contra a blockchain do Bitcoin com ferramentas OpenTimestamps padrão — sem conta, sem chave de API, sem dependência de o Timestamp GIT existir.

Esse último ponto é o que vale repetir para o jurídico: a prova é SHA-256 mais dados de bloco do Bitcoin. Não há formato proprietário no caminho de confiança.

Solução de problemas comuns

As provas ainda não apareceram. Verifique o relógio antes de verificar qualquer outra coisa. A ancoragem exige uma confirmação do Bitcoin, que normalmente leva cerca de três horas após o lote da meia-noite. Se são 2 da manhã, nada está errado. Se já é a tarde seguinte e o branch continua vazio, verifique se o repositório está realmente na lista monitorada.

Faltam commits no manifesto. Quase sempre é um problema de permissões ou de webhook. Confirme que a instalação do GitHub App inclui o repositório específico (instalações em organizações costumam conceder “repositórios selecionados” e depois deixar um de fora) e que o app ainda tem uma conexão ativa. Verifique novamente /api/statusCount/{user}/{repo} após a próxima execução noturna.

A página de status de um repositório privado não carrega. Repositórios privados acrescentam um HMAC criptografado à URL, e esse HMAC é específico da instância do servidor. Copie o link autenticado do selo na página Repository Connected em vez de construir uma URL manualmente — um HMAC truncado ou incompatível com a instância falhará.

A implantação Docker não sobe. Verifique se o arquivo Compose nomeia exatamente rue1401/timestampgit:prod e valkey/valkey:8, se a porta 8080 não está já ocupada e se ./data existe e é gravável pelo contêiner. docker compose logs -f timestampgit normalmente indicará diretamente a dependência com falha. Se o app iniciar mas o assistente de configuração não conseguir acessar o GitHub, a configuração OAuth é o lugar a verificar.

Perguntas frequentes

Preciso instalar algo nas máquinas dos desenvolvedores? Não. O Timestamp GIT é um GitHub App gerenciado que roda na infraestrutura do GitHub e nos nossos servidores. Os desenvolvedores apenas fazem commits como de costume; nenhuma ferramenta de CLI ou software local é necessária.

Posso carimbar commits com data e hora em repositórios privados? Sim. Repositórios privados são suportados nos planos pagos (Pro Agency ou Enterprise ZK). O app lê apenas hashes de commit, nunca seu código-fonte, e as provas são armazenadas em um branch dedicado ou shadow repository.

Quanto tempo leva para um carimbo de data e hora se tornar imutável? Após o lote noturno, a raiz de Merkle é ancorada em uma transação Bitcoin. A confirmação normalmente leva cerca de 3 horas, após as quais o carimbo de data e hora é imutável e verificável.

A prova é independente do fornecedor? Sim. A prova usa apenas SHA-256 e dados de bloco do Bitcoin via protocolo OpenTimestamps. Você pode verificá-la offline com ferramentas OpenTimestamps padrão, mesmo que o Timestamp GIT deixe de existir.

O que a equipe de compliance realmente recebe? Uma página pública de status, um CSV de auditoria para download cobrindo o histórico do repositório, um certificado PDF por data e recibos .ots no repositório. Para o peso jurídico dessa evidência, veja Um carimbo de data e hora em blockchain é evidência legalmente válida?.

Conclusão: instale uma vez, prove para sempre

Carimbar commits Git com data e hora sem a linha de comando se resume a uma decisão: pare de tratar o carimbo de data e hora como um ritual por desenvolvedor e torne-o uma propriedade do repositório. Instale o GitHub App, selecione os repositórios, continue commitando. O cron noturno transforma esses commits em provas com raiz de Merkle ancoradas no Bitcoin, e os recibos voltam para o seu próprio repositório, onde pertencem.

Comece com o plano Open Source gratuito em um repositório público — não custa nada e leva cerca de cinco minutos. Quando estiver pronto para cobrir código privado, mude para o Pro Agency a US$ 49/mês, ou vá para o Enterprise ZK a US$ 199/mês se o modelo de GitHub Action se encaixar melhor na sua postura de segurança. De qualquer forma: timestampgit.dev é o único passo de instalação.

Posts relacionados

EU label: AI-generated content