Timestamp GIT

← Todos os artigos

2026-10-17

Os timestamps de commits do Git são confiáveis como prova legal?

Os timestamps de commits do Git são confiáveis como prova legal?
timestamp git blockchain proof

Os timestamps de commits do Git são confiáveis como prova legal?

Se você é desenvolvedor ou responsável por conformidade, provavelmente já fez alguma versão desta pergunta: meu histórico de commits mostra claramente que construí este recurso há dois anos — isso não é prova suficiente?

A resposta honesta é: depende de quem controla o relógio. Um timestamp de commit gravado pela sua máquina e armazenado no seu repositório é uma alegação sobre o passado. Um hash de commit ancorado em um registro público e imutável é evidência sobre o passado. Essas duas coisas parecem semelhantes no git log e se comportam de maneira muito diferente em uma disputa.

Este artigo explica a diferença, por que ela importa quando surgem reivindicações de patente, saídas de funcionários ou defesas do tipo “nós construímos isso de forma independente”, e como obter timestamps ancorados sem mudar a forma como sua equipe escreve código.

A resposta curta: depende de quem controla o relógio

Todo commit do Git carrega dois timestamps — uma data de autor e uma data de committer — além de um hash. Os três ficam em um arquivo dentro do seu repositório. Quem puder reescrever esse arquivo controla o timestamp.

Esse único fato determina toda a questão jurídica:

  • Timestamp auto-relatado — produzido pela sua máquina, enviado para sua conta do GitHub, armazenado em um repositório que você ou seu provedor pode reescrever. Confiável para engenharia, fraco como evidência, porque a parte que o apresenta também o controla.
  • Timestamp ancorado externamente — uma prova criptográfica da existência do hash do commit, incorporada a um registro público e imutável em um momento específico. Verificável por qualquer pessoa, inclusive pela parte adversa, sem precisar confiar em você.

A conclusão prática para desenvolvedores e equipes de conformidade é curta: o histórico do Git sozinho é evidência fraca. O histórico do Git somado a uma âncora criptográfica independente é evidência forte.

O restante deste artigo aborda por que essa distinção existe, o que a âncora realmente é e como obtê-la automaticamente.

Por que um git log comum é evidência fraca

Comece pelo que um commit realmente contém:

git log -1 --format='author:     %ad%ncommitter:  %cd%ncommit:     %H' --date=iso

A saída é assim:

author:     2026-03-14 09:12:44 +0100
committer:  2026-03-14 09:12:44 +0100
commit:     a3f9c1e7b2d4... (abbreviated)

Nada aqui está protegido. Um rebase, um amend ou um force-push reescrevem esses valores livremente:

git commit --amend --no-edit --date="2026-01-02T08:00:00"
git push --force-with-lease

Três problemas estruturais decorrem disso:

  • O problema do “registro em causa própria”. Em uma auditoria ou em um tribunal, logs internos e capturas de tela são frequentemente desconsiderados porque a parte que os apresenta também os produziu e os armazena. Um registro que você pode editar silenciosamente não é evidência independente.
  • Dependência de hospedagem. O histórico padrão do Git fica em servidores que você não possui — GitHub, GitLab, um VPS interno — ou em bancos de dados nos quais você pode escrever. A proveniência não é verificável de forma independente por terceiros.
  • Nenhuma testemunha externa. Mesmo uma linha do tempo honesta não tem nada fora da sua infraestrutura confirmando que o commit existiu naquela data.

As consequências são concretas. Patent trolls registram reivindicações amplas sobre tecnologia que você lançou meses antes, e sem prova datada você enfrenta um litígio que deveria ter conseguido encerrar cedo. Quando um desenvolvedor líder sai, “eu concebi aquele recurso” se torna uma disputa de palavra contra palavra. Um concorrente alega uma construção independente em “sala limpa” do mesmo recurso, e você não tem nada que estabeleça que já tinha a lógica finalizada 18 meses antes.

Uma analogia do mundo real: reconhecer firma de um envelope lacrado

Pense em um tabelião. Você entrega um envelope lacrado. O tabelião não o abre, não o lê e não guarda uma cópia. Ele certifica um único fato restrito: este envelope, neste estado exato, existia neste momento — e o registro dele pode ser conferido depois por terceiros.

Os timestamps criptográficos do Git se encaixam nesse modelo quase exatamente:

Analogia do tabelião Realidade do Git
Envelope lacrado O hash do commit — uma impressão digital do estado exato do seu repositório
Selo e livro do tabelião Um registro público e imutável que grava a existência do hash
“Não preciso lê-lo” Zero-knowledge: apenas o hash é processado, nunca seu código-fonte
Qualquer um pode verificar o selo Verificação independente sem confiar em você ou no serviço

A propriedade crítica é a independência. Um tabelião que trabalhasse para você, guardasse os próprios registros e pudesse reemitir selos sob demanda seria inútil em tribunal. O mesmo vale aqui: a testemunha precisa ser pública e imutável, e a verificação precisa funcionar mesmo que o operador da testemunha desapareça.

Como os timestamps criptográficos do Git realmente funcionam

O mecanismo tem três etapas. Nenhuma delas exige que você leia seu próprio código-fonte em um sistema de terceiros.

Etapa 1 — A impressão digital

O Git já gera um hash unidirecional SHA-1 ou SHA-256 que representa o estado exato de todo o seu repositório naquele commit. Mude um byte e o hash muda completamente. Essa é uma impressão digital criptograficamente segura do seu trabalho naquele momento — nada mais precisa ser extraído.

Etapa 2 — A âncora

Os hashes de commit são reunidos em um arquivo de manifesto diário em texto por repositório, transformados em hash em uma árvore de Merkle, e a raiz de Merkle é incorporada a uma transação Bitcoin usando o protocolo OpenTimestamps. Isso congela a existência do hash no tempo, registrada de forma imutável em um bloco específico do Bitcoin.

Em um pipeline gerenciado, isso roda em um cronograma: os hashes de commit entram em uma fila durante o dia, um processo da meia-noite os agrupa, constrói a árvore de Merkle e as provas, e ancora a raiz. A confirmação no Bitcoin normalmente leva cerca de três horas, então as provas aparecem algumas horas após a execução do lote.

Etapa 3 — A prova

Você recebe um arquivo de recibo .ots imutável junto com o manifesto. Esse recibo permite provar — a um advogado, a um auditor ou a um tribunal — que sua ideia existia em uma data específica. A prova se baseia inteiramente em SHA-256 e nos dados de blocos do Bitcoin, então pode ser verificada offline e de forma independente.

Três garantias decorrem desse design:

  • Zero-knowledge — seu código-fonte nunca é visto, copiado ou armazenado. Apenas o hash do Git é carimbado.
  • Independente de fornecedor — sem formato proprietário, sem aprisionamento tecnológico. A verificação depende de criptografia pública e de dados de blocos do Bitcoin.
  • Padrões prontos para tribunal — primitivas criptográficas reconhecidas globalmente, não o log privado de um fornecedor.

Por que isso importa para disputas de PI (e equívocos comuns)

Timestamps ancorados mudam a forma de três disputas comuns:

  • Reivindicações de patente. Um registro criptograficamente datado de você implementando algo antes de um pedido é anterioridade que pode invalidar reivindicações amplas.
  • Disputas de concepção por funcionários. “Quando este recurso foi concebido?” deixa de ser um concurso de memória e se torna uma linha do tempo verificável.
  • Defesas de “desenvolvimento independente”. A prova de que você tinha a lógica finalizada 18 meses antes é um muro que uma história de sala limpa não consegue escalar.

Três equívocos continuam aparecendo.

Equívoco 1: “Meu histórico de commits do GitHub basta.” O histórico hospedado é editável e controlado por uma parte com interesse no resultado. É um contexto útil. Não é evidência independente.

Equívoco 2: “Preciso aprender OpenTimestamps e transações Bitcoin.” O caminho difícil existe — montar provas manualmente e transmitir transações é possível. Para a maioria das equipes, é uma sobrecarga desnecessária, e é exatamente o tipo de coisa que acaba sendo deixada de lado sob pressão de prazos. (Para contexto sobre o que as provas representam juridicamente, veja O que é anterioridade criptográfica? Um guia para equipes de software.)

Equívoco 3: “O serviço de timestamping pode ver meu código.” Apenas hashes de commit são processados. O modelo zero-knowledge significa que o código-fonte nunca sai do seu controle — e no modo empresarial descrito abaixo, o serviço nem sequer precisa de acesso de leitura ao repositório de origem.

O caminho prático: timestamping automatizado e sem configuração com o Timestamp GIT

O Timestamp GIT é um SaaS gerenciado mais um GitHub App que automatiza e oculta totalmente o protocolo OpenTimestamps. Você instala o GitHub App uma vez. Todo commit em um repositório monitorado passa então a ser ancorado no Bitcoin automaticamente todas as noites — sem ferramentas de CLI, sem comandos de protocolo, sem etapas manuais e nada instalado nas máquinas dos seus desenvolvedores.

Há dois modos de implantação:

  • Modo Padrão (GitHub App). O app lê apenas o hash do commit HEAD do repositório monitorado e então grava as provas em um branch dedicado de timestamps — seja no mesmo repositório da origem ou em um repositório sombra separado. O modelo de permissões do GitHub significa que o app precisa de pelo menos acesso somente leitura ao repositório de origem (não existe permissão apenas para hash de commit) e acesso de leitura e escrita ao repositório de destino.
  • Modo Empresarial ZK. Uma GitHub Action de 12 linhas roda dentro da 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 exige nenhum acesso de leitura ao repositório de origem — apenas acesso de leitura e escrita ao repositório de destino para entrega das provas.

O que você recebe de volta é feito para trabalho de conformidade, não apenas para engenharia:

  • Selos de verificação que você pode incorporar ao seu README, com um link público que qualquer pessoa pode conferir. O widget de selo tem uma pré-visualização ao vivo para você ver o selo Shields.io antes de fazer o commit.
  • Um painel de status público por repositório — longevidade das provas, data da âncora mais antiga, regularidade diária, os dados do bloco e da transação Bitcoin, um mapa de calor em calendário e CSV de auditoria para download mais um certificado em PDF.
  • Uma API REST para automação: GET /api/statusSummary/{user}/{repo} para dados do selo, GET /api/audit/{user}/{repo} para o livro-razão completo de auditoria em CSV, GET /api/report/{user}/{repo}/{date} para um certificado em PDF por data, e GET /api/verify/{user}/{repo}/{date} para os dados completos da cadeia de Merkle para verificação local.
curl -s https://timestampgit.dev/api/statusSummary/your-user/your-repo

Repositórios privados acrescentam um HMAC criptografado à URL, de modo que apenas usuários autorizados podem ler o status de um repositório privado — esse HMAC é específico da instância do servidor.

Para ambientes isolados (air-gapped) ou de segurança máxima, o Timestamp GIT também está disponível como 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 aplicação fica disponível em http://localhost:8080 após a inicialização, e um assistente de configuração de primeiro uso orienta você na conexão do seu GitHub App e na configuração da instância. Uma licença de demonstração por tempo limitado para avaliação pode ser solicitada na página Docker License; você envia seu nome, empresa, e-mail e número de telefone opcional, e baixa o arquivo de licença de demonstração.

Compare isso com a rota manual — configurar o protocolo por conta própria, lidar com agrupamento, árvores de Merkle, entrega de provas e ferramentas de verificação — e o fluxo gerenciado é a diferença entre uma etapa de instalação e um projeto de engenharia contínuo.

Perguntas frequentes

Posso simplesmente usar meu histórico de commits do GitHub como prova em uma disputa legal?

O histórico do GitHub é um contexto útil, mas geralmente é tratado como auto-relatado e editável, então costuma ser desconsiderado como em causa própria em uma auditoria ou em tribunal. A ancoragem criptográfica adiciona um timestamp independente e imutável que qualquer pessoa pode verificar contra um registro público, e é isso que o torna evidência pronta para tribunal.

O Timestamp GIT vê ou armazena meu código-fonte?

Não. O serviço opera em um modelo zero-knowledge: ele processa hashes de commit, nunca seu código-fonte real. No Modo Padrão, o GitHub App lê apenas o hash do commit HEAD. No Modo Empresarial ZK, uma GitHub Action de 12 linhas rodando no seu próprio ambiente envia apenas o hash, o que significa que o serviço não precisa de acesso de leitura ao seu repositório de origem.

E se o Timestamp GIT fechar? Ainda posso provar meus timestamps?

Sim. A prova depende apenas de SHA-256 e de dados de blocos do Bitcoin via protocolo OpenTimestamps, então é independente de fornecedor. Você pode baixar seus arquivos de recibo .ots e verificá-los localmente contra a blockchain do Bitcoin usando ferramentas de verificação padrão, mesmo que a empresa desapareça. Para um passo a passo, veja Como verificar localmente uma prova de timestamp do Bitcoin.

Preciso instalar algo nas máquinas dos meus desenvolvedores ou aprender OpenTimestamps?

Não. O Timestamp GIT é um GitHub App gerenciado: você o instala uma vez, e todo commit em um repositório monitorado é ancorado no Bitcoin automaticamente todas as noites. Não há ferramentas de CLI, comandos de protocolo nem etapas manuais para seus desenvolvedores. Para ambientes isolados, há uma opção Docker auto-hospedada disponível.

A conclusão

Um timestamp de commit do Git é tão confiável quanto o relógio por trás dele. Se esse relógio é o seu próprio servidor ou sua conta hospedada, espere que a parte adversa o chame de em causa própria. Se esse relógio é um registro público e imutável que qualquer pessoa pode verificar sem confiar em você, o timestamp se torna evidência.

Histórico do Git mais ancoragem criptográfica é a combinação que se sustenta. A única questão que resta é quanto trabalho você quer gastar mantendo isso.

Instale o GitHub App uma vez, conecte um repositório e deixe a ancoragem noturna cuidar do resto — depois confira seu selo, seu painel de status e seu primeiro recibo .ots na manhã seguinte.

Posts relacionados

EU label: AI-generated content