Timestamp GIT

← Todos os artigos

2026-11-02

Os timestamps de commits do Git não são à prova de adulteração — o que é

Os timestamps de commits do Git não são à prova de adulteração — o que é
timestamp git blockchain proof

Timestamps de Commit do Git Não São à Prova de Adulteração — O Que É

Abra o seu terminal e execute git log. Você verá uma data ao lado de cada commit. Agora imagine um advogado, um auditor ou o CTO da empresa que está adquirindo a sua fazendo uma pergunta simples de acompanhamento: “Como eu sei que essa data é real?”

A resposta honesta é que você não pode provar. Nem com git log, nem com o feed de atividades do GitHub, nem com o seu banco de dados de auditoria interno. Todos esses são registros que você controla, e registros que você controla podem ser editados. Este artigo explica o que “à prova de adulteração” realmente significa, por que os timestamps do Git falham no teste e como a ancoragem criptográfica no Bitcoin resolve isso — automaticamente, via Timestamp GIT.

A Pergunta: Você Pode Realmente Confiar em um Timestamp de Commit do Git?

Todo commit do Git carrega dois timestamps: a data do autor e a data do committer. Veja como visualizar ambos:

git log -1 --format='commit  %H%nauthor  %an <%ae>  %ad%ncommitter %cn <%ce>  %cd' --date=iso

Essas datas vêm do relógio da máquina que executou git commit. São entradas, não observações. O Git não consulta uma fonte de tempo confiável e não atesta nada externamente.

O que significa que você pode defini-las como quiser:

GIT_AUTHOR_DATE="2026-01-14T09:12:00+00:00" \
GIT_COMMITTER_DATE="2026-01-14T09:12:00+00:00" \
git commit -m "Add billing reconciliation job"

Isso não é um exploit. É um comportamento documentado e intencional — o mesmo mecanismo que permite importar um repositório antigo com seu histórico original intacto.

Então, quando dizemos à prova de adulteração, queremos dizer algo específico e rigoroso:

  • Ninguém — nem um colega, nem um administrador da plataforma, nem um atacante, e nem mesmo você — pode alterar o registro após o fato.
  • Qualquer pessoa pode verificá-lo sem precisar confiar na parte que o produziu.

Os timestamps do Git não satisfazem nenhuma das duas condições. Veja por quê, e o que satisfaz.

Por Que os Timestamps do Git São À Prova de Adulteração Apenas em Teoria

O modelo de integridade do Git é uma cadeia de hashes. Cada commit contém o hash do seu pai, então alterar o conteúdo de qualquer commit altera todos os hashes a jusante. Isso é integridade criptográfica real — para o conteúdo.

O timestamp é apenas um campo dentro do objeto de commit. Nada externo fixa a existência do commit a um ponto no tempo. A cadeia prova “este conteúdo é consistente com este histórico”, não “este conteúdo existia nesta data”.

Qualquer pessoa com acesso de escrita pode reescrever o histórico e as datas junto com ele:

# Amend the most recent commit with an arbitrary date
git commit --amend --no-edit --date="2025-06-01T08:00:00"

# Rewrite every commit in every branch with a new date
git filter-branch --env-filter '
  export GIT_AUTHOR_DATE="2025-06-01T08:00:00"
  export GIT_COMMITTER_DATE="2025-06-01T08:00:00"
' -- --all

Mesmo em plataformas hospedadas, um force-push substitui o histórico por completo. E os logs do lado da plataforma — entregas de webhook, trilhas de auditoria, feeds de atividades — vivem em bancos de dados que administradores e atacantes podem acessar. Em uma disputa, “temos isso nos nossos próprios logs” é exatamente o tipo de evidência que o advogado da parte contrária descarta como interesseira.

A analogia: um timestamp do Git é uma data escrita a lápis no seu próprio diário. Pode ser perfeitamente precisa. Pode ser o diário mais honesto do mundo. Mas qualquer um com uma borracha pode alterá-la, e nenhum terceiro viu você escrevê-la. A ancoragem criptográfica é o equivalente a levar aquela página do diário a um cartório e tê-la carimbada em um registro público que ninguém — incluindo o cartório — pode reescrever depois.

Como a Ancoragem Criptográfica Torna os Timestamps À Prova de Adulteração

A solução é pegar a impressão digital do seu trabalho e publicá-la em algum lugar que você não controla. É isso. Essa é a ideia inteira.

Passo 1 — A impressão digital

Quando você faz um commit, o Git transforma todo o estado do repositório em hash, gerando um identificador único (SHA-1 ou SHA-256). Esse hash é uma impressão digital unidirecional: identifica o seu estado exato de código sem revelar nada sobre o código em si.

Passo 2 — A âncora

O Timestamp GIT coleta os hashes de commit de um repositório em um arquivo de manifesto diário, gera o hash desse manifesto, constrói uma árvore de Merkle sobre o lote e incorpora a raiz de Merkle em uma transação Bitcoin usando o protocolo OpenTimestamps. A blockchain do Bitcoin é somente-anexável e replicada em milhares de nós — uma vez que a sua raiz é confirmada em um bloco, o registro de “este hash existia até esta data” é permanente.

Passo 3 — A prova

Você recebe um arquivo de recibo .ots imutável. Ele encadeia o hash do seu commit através da árvore de Merkle até um bloco específico do Bitcoin. Qualquer pessoa pode percorrer essa cadeia contra a blockchain pública e confirmar o timestamp — sem confiar em você e sem confiar no Timestamp GIT.

Esse último ponto importa mais do que parece. As garantias do produto são deliberadamente entediantes:

  • Zero-knowledge: o seu código-fonte nunca é lido, copiado ou armazenado. Apenas hashes saem do seu repositório.
  • Independente de fornecedor: a prova usa SHA-256 e dados de blocos do Bitcoin. Sem formato proprietário, sem aprisionamento tecnológico. Se o Timestamp GIT desaparecesse amanhã, os seus arquivos .ots ainda seriam verificáveis.
  • Nada para instalar nas máquinas dos desenvolvedores.

O caminho difícil para chegar aqui é conduzir o protocolo OpenTimestamps e as transações Bitcoin por conta própria — um projeto em si, abordado separadamente em Timestamp GIT vs OpenTimestamps CLI. O Timestamp GIT existe para que você não precise fazer isso.

Por Que Isso Importa: Equívocos Comuns e Riscos Reais

Equívoco: “Os timestamps do Git são bons o suficiente para uma auditoria.” Logs internos são rotineiramente desconsiderados como manipuláveis. Uma trilha de auditoria que você mesmo gera e armazena prova intenção, não existência.

Equívoco: “Timestamps em blockchain são apenas para projetos de cripto.” Qualquer hash de commit pode ser ancorado — um monólito Rails, um repositório de firmware, um sistema de negociação interno. A tecnologia não se importa com o que está no código.

Equívoco: “Nós saberíamos se alguém alterasse o nosso histórico.” Force-pushes, rebases e edições em nível de administrador são silenciosos por design. A menos que você esteja comparando cada ref contra um registro externo, você não saberia.

Os riscos reais são concretos:

  • Trolls de patentes. Uma entidade não-praticante registra uma patente ampla sobre algo que você lançou meses antes. Sem prova datada e verificável de forma independente, você está argumentando de memória.
  • Disputas com funcionários e prestadores de serviço. Quando um desenvolvedor líder sai, “quando esse recurso foi realmente construído?” se transforma em um concurso de credibilidade. Um timestamp imutável encerra isso.
  • Alegações de “sala limpa”. Um concorrente diz que desenvolveu lógica semelhante de forma independente. Provar que você tinha código finalizado e funcional 18 meses antes cria um muro que eles não conseguem escalar.
  • Conformidade e segredos comerciais. Auditores e equipes jurídicas querem cada vez mais provas de existência para PI e sistemas internos — sem publicar o código-fonte.

Como o Timestamp GIT Automatiza Timestamps À Prova de Adulteração

Aqui está a parte em que a criptografia deixa de ser problema seu.

Instale uma vez, ancore todas as noites

Instale o GitHub App nos repositórios que deseja proteger. Ele detecta novos commits via webhooks. A partir daí, não há comandos para executar, nem arquivos para gerenciar, nem mudanças no fluxo de trabalho dos desenvolvedores — cada commit é ancorado automaticamente todas as noites.

Por baixo dos panos, os hashes pendentes se acumulam em um armazenamento chave-valor em memória. À meia-noite, um worker os agrupa, grava um manifesto .txt por repositório, constrói a árvore de Merkle e ancora a raiz no Bitcoin através dos calendários públicos do OpenTimestamps. A confirmação do Bitcoin normalmente leva cerca de três horas, então as provas finalizadas chegam de volta ao seu repositório algumas horas após a execução noturna.

As provas chegam ao seu repositório

O manifesto e os arquivos de recibo .ots são enviados para um branch dedicado timestamps, ou para um repositório espelho separado, caso você prefira mantê-los fora do repositório de código-fonte. No modo padrão, o GitHub App precisa de acesso somente leitura ao repositório de origem e acesso leitura-escrita ao repositório de destino.

Verifique sem confiar em ninguém

  • Badges no README mostram o status de verificação ao vivo, com um link que qualquer pessoa pode seguir para conferir.
  • O painel de status do repositório (/status/{user}/{repo}) expõe a longevidade das provas, a data de ancoragem mais antiga, a regularidade diária, dados de bloco e transação do Bitcoin, um mapa de calor de calendário e CSV de auditoria e certificado PDF para download.
  • A página de verificação (/verification/{user}/{repo}/{date}) percorre toda a cadeia de Merkle multinível — todos os cálculos acontecem localmente no seu navegador, então ninguém vê o que você verifica.
  • A API REST fornece os mesmos dados de forma programática:
# Last anchored Bitcoin block for a repository (public)
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api | jq

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

# Full audit ledger as CSV (used for compliance exports)
curl -sL https://timestampgit.dev/api/audit/acme/payments-api -o audit-ledger.csv

Repositórios privados acrescentam um HMAC criptografado a essas URLs, restrito à sua instância de servidor, para que apenas usuários autorizados possam ler o status.

Modo Enterprise ZK

Se a sua política de segurança proíbe conceder a um terceiro acesso ao repositório de qualquer forma, o modo Enterprise ZK troca o GitHub App por uma pequena GitHub Action que roda na sua própria infraestrutura. A Action envia os hashes de commit para a API do Timestamp GIT; o repositório de destino ainda recebe as provas. O seu repositório de código-fonte nunca é lido.

Docker auto-hospedado para ambientes isolados

Para controle máximo, o Timestamp GIT é distribuído como uma imagem Docker. 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. Na primeira execução, um assistente de configuração orienta você a conectar o seu GitHub App e configurar a instância. Uma licença de demonstração por tempo limitado está disponível enviando o formulário de solicitação na página de Licença Docker.

FAQ

Posso alterar um timestamp de commit do Git após o fato? Sim, os timestamps do Git são apenas metadados definidos pela máquina do committer. Você pode emendar um commit com git commit --amend --date, reescrever o histórico com git rebase ou editar o objeto de commit diretamente. Mesmo em plataformas hospedadas como o GitHub, force-pushes podem alterar timestamps, então eles não são à prova de adulteração por si sós.

Como a ancoragem no Bitcoin torna um timestamp à prova de adulteração? O Timestamp GIT pega os hashes dos seus commits, constrói uma árvore de Merkle e incorpora a raiz em uma transação Bitcoin via OpenTimestamps. Uma vez confirmado em um bloco do Bitcoin, o timestamp é imutável — ninguém, incluindo o Timestamp GIT, pode alterá-lo. Você recebe um recibo .ots que pode ser verificado contra a blockchain do Bitcoin por qualquer pessoa.

Preciso executar algum comando do OpenTimestamps para usar o Timestamp GIT? Não. O Timestamp GIT é um serviço gerenciado: você instala o GitHub App uma vez, e ele ancora automaticamente os seus commits todas as noites. Não há CLI, nem carimbo manual, nem necessidade de aprender o protocolo OpenTimestamps. Para ambientes isolados, há uma opção auto-hospedada em Docker.

Um timestamp ancorado no Bitcoin é evidência legalmente válida? Timestamps criptográficos fornecem prova forte de existência que é cada vez mais aceita em contextos legais, mas a validade depende da jurisdição e de como a evidência é apresentada. O Timestamp GIT fornece recibos .ots prontos para tribunais e certificados PDF que você pode compartilhar com advogados ou auditores. Para uma discussão mais aprofundada, veja Um Timestamp em Blockchain É Evidência Legalmente Válida?

A Conclusão

Um timestamp do Git é uma alegação. Um timestamp ancorado no Bitcoin é evidência. A diferença entre os dois é a diferença entre dizer “nós construímos isso primeiro” e conseguir provar isso anos depois, diante de pessoas que têm todos os motivos para duvidar de você.

A boa notícia é que fechar essa lacuna não exige mais um projeto de criptografia. Instale o GitHub App uma vez, deixe-o ancorar os seus commits todas as noites e guarde os recibos .ots — além de um badge incorporável, um painel de status público e um certificado PDF para quem perguntar.

Os planos começam com um nível gratuito para repositórios públicos, Pro Agency a US$ 49/mês para repositórios privados e Enterprise ZK a US$ 199/mês para equipes que precisam do fluxo de trabalho com GitHub Action. Escolha o que corresponde à visibilidade do seu repositório e garanta a sua primeira ancoragem hoje à noite.


Posts relacionados

EU label: AI-generated content