Os Carimbos de Tempo de Commit do GitHub São Admissíveis em Tribunal?
Se está à procura de saber se um carimbo de tempo de commit do GitHub é prova legalmente admissível, provavelmente já passou a fase teórica. Há um litígio em curso, um prazo a aproximar-se e alguém — um cliente, um responsável de conformidade ou o seu próprio advogado — pediu-lhe que apresentasse prova de que o seu código existia numa data específica.
A resposta incómoda é que o carimbo de tempo em si raramente é o fator decisivo. O que decide a questão é se a outra parte, e o tribunal, conseguem verificar esse carimbo de tempo de forma independente, sem terem de confiar na sua palavra.
Este artigo aborda o que torna um carimbo de tempo de commit defensável, o que contém realmente uma prova criptográfica pronta para tribunal e como verificar uma passo a passo com o Timestamp GIT. Se quiser o contexto mais aprofundado sobre porque as datas simples do Git são, à partida, prova fraca, leia Os Carimbos de Tempo de Commit do Git São Fiáveis para Prova Legal?. Este artigo mantém-se na verificação e na admissibilidade.
Porque a Admissibilidade Depende da Verificação, Não Apenas dos Carimbos de Tempo
Os metadados padrão de um commit Git — data do autor e data do committer — residem dentro do repositório. Podem ser retro-datados, reescritos ou simplesmente fabricados antes de o commit ser alguma vez enviado. Qualquer pessoa com um editor de texto e um rebase consegue produzir um commit que afirma ser do ano passado.
Os carimbos de tempo do lado do servidor do GitHub são um pouco melhores, mas continuam armazenados em infraestrutura que não controla, numa base de dados que não pode auditar e não podem ser verificados contra nada fora dessa plataforma. São um registo, não uma prova.
Os tribunais e os auditores tendem a procurar três propriedades numa peça de prova técnica:
- Imutabilidade — o registo não pode ser alterado após o facto por nenhuma das partes, incluindo a parte que o apresenta.
- Verificabilidade independente — um terceiro pode verificar a alegação sem acesso aos seus sistemas ou cooperação do seu fornecedor.
- Não auto-favorável — a prova não depende exclusivamente de registos que gerou e armazenou você mesmo. Os registos internos são frequentemente rejeitados como manipuláveis precisamente por este motivo.
É essa a distinção que importa: um carimbo de tempo é uma alegação, enquanto uma prova criptográfica é um facto verificável. Uma alegação diz “este código existia a 3 de março”. Uma prova permite que qualquer pessoa recalcule a resposta por si própria e chegue à mesma conclusão.
O Timestamp GIT fornece o segundo. Extrai os hashes dos seus commits Git — impressões digitais SHA-1 ou SHA-256 do estado do seu repositório — e ancora-os na blockchain do Bitcoin através do protocolo OpenTimestamps. Nada no resultado depende de confiar na base de dados do fornecedor.
Como É Realmente uma Prova Pronta para Tribunal
A cadeia de prova tem quatro componentes, e vale a pena conhecê-los pelos nomes antes de alguma vez precisar de os entregar a um advogado:
- O hash do commit — a impressão digital gerada pelo Git do estado exato do repositório nesse momento.
- O manifesto diário (
.txt) — um ficheiro de texto que agrupa todos os hashes de commit recolhidos para um repositório nesse dia. O manifesto recebe um hash SHA-256 próprio. - A raiz de Merkle — o único hash que resume todo o lote do dia entre repositórios.
- O ficheiro de recibo
.ots— um ficheiro imutável que liga criptograficamente o seu hash de commit a um bloco específico do Bitcoin.
O recibo .ots é o artefacto a que a maioria das pessoas se refere quando diz “a prova”. É gerado usando calendários públicos do OpenTimestamps, mas o caminho de verificação que descreve depende apenas de SHA-256 e dados de blocos do Bitcoin. Isso significa que:
- É independente do fornecedor. Sem formato proprietário, sem dependência, sem necessidade de o Timestamp GIT existir daqui a dez anos para que a prova seja verificável.
- É de conhecimento zero. O Timestamp GIT nunca vê, copia ou armazena o seu código-fonte. Apenas o hash do commit é carimbado.
- Pode ser apresentado no formato que o destinatário precisar: um certificado PDF para um advogado ou cliente, um livro de auditoria CSV para conformidade, ou o ficheiro
.otsem bruto para uma testemunha pericial técnica.
Passo a Passo: Verificar um Carimbo de Tempo com o Timestamp GIT
A verificação deve ser aborrecida. Eis a sequência real, desde “foi ancorado alguma coisa?” até “entregue este ficheiro ao advogado da parte contrária”.
1. Consulte a página pública de estado do repositório
Abra https://timestampgit.dev/status/{user}/{repo}. Este painel mostra a longevidade da prova, a data da primeira ancoragem, a regularidade diária e os dados do bloco e da transação do Bitcoin por trás das ancoragens mais recentes.
# Same data, machine-readable
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api | jq
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api | jq
statusLast devolve a informação do último bloco do Bitcoin ancorado; statusCount devolve a contagem total de commits comprometidos e carimbados. O resumo combinado usado pelo Shields.io está disponível em statusSummary.
2. Incorpore o selo de verificação
A partir da página do repositório conectado (https://timestampgit.dev/connected/{user}/{repo}) obtém URLs de selos e excertos Markdown com pré-visualização em tempo real. Coloque o selo no seu README para que qualquer pessoa que reveja o repositório — incluindo um futuro auditor — veja o estado de verificação e possa seguir a ligação para o site de verificação.
O endpoint autenticado que devolve URLs de selos e excertos é:
curl -s https://timestampgit.dev/api/badgeLink/acme/payments-api
3. Percorra a cadeia de Merkle para um dia específico
Para uma prova datada, abra https://timestampgit.dev/verification/{user}/{repo}/{date}. Esta página percorre a cadeia de Merkle de vários níveis desde o seu hash de commit até à raiz diária e daí até ao bloco do Bitcoin.
Todos os cálculos acontecem localmente no navegador. Ninguém — incluindo o Timestamp GIT — vê o que verifica. Os mesmos dados estão disponíveis através da API se quiser verificá-los nas suas próprias ferramentas:
curl -s https://timestampgit.dev/api/verify/acme/payments-api/2026-10-22 | jq
4. Obtenha os registos que vai realmente arquivar
# PDF certificate for one day
curl -sO https://timestampgit.dev/api/report/acme/payments-api/2026-10-22
# Full audit ledger as CSV
curl -sO https://timestampgit.dev/api/audit/acme/payments-api
O PDF é o artefacto certo para um cliente ou um advogado. O livro de auditoria CSV é o artefacto certo para conformidade e para mostrar um histórico de ancoragem consistente e ininterrupto.
5. Verifique de forma independente, offline
Descarregue o ficheiro de recibo .ots do ramo de carimbos de tempo do seu repositório (ou repositório sombra) e verifique-o com as ferramentas padrão de verificação do OpenTimestamps contra a blockchain do Bitcoin. Este passo não requer conta no Timestamp GIT, acesso à API nem chamada de rede ao fornecedor — é a resposta mais forte possível a “como sabemos que o seu carimbo de tempo é real?”
Para equipas de conformidade que queiram isto integrado nos seus próprios painéis, os mesmos endpoints podem ser chamados diretamente:
const base = "https://timestampgit.dev/api";
const last = await fetch(`${base}/statusLast/acme/payments-api`).then(r => r.json());
const proof = await fetch(`${base}/verify/acme/payments-api/2026-10-22`).then(r => r.json());
console.log(last.bitcoinBlock, proof.merkleRoot);
Repositórios privados: os URLs de estado acrescentam um HMAC encriptado específico da instância do servidor, para que apenas utilizadores autorizados possam ver o estado de um repositório privado. A prova em si continua ancorada no Bitcoin, e qualquer pessoa a quem entregue o ficheiro .ots pode verificá-la.
Interpretar os Resultados da Verificação e Casos-limite Comuns
Uma página de verificação só é útil se a souber ler corretamente. Algumas coisas a saber:
- Confirmado vs. pendente. Um bloco do Bitcoin confirmado significa que o carimbo de tempo é imutável. Antes da confirmação — normalmente cerca de três horas — a prova está pendente. Não apresente uma prova pendente como final.
- Ainda não ancorado. Se falta um commit, provavelmente pertence ao próximo lote noturno. O worker cron diário agrupa todos os hashes pendentes à meia-noite e depois constrói os manifestos, a árvore de Merkle e as provas OpenTimestamps. A escrita da prova em si fica concluída algumas horas mais tarde, quando a confirmação do Bitcoin chega.
- Existência, não autoria. A verificação prova que o seu hash de commit existia num determinado momento. Não prova que escreveu o código, que é original ou que é patenteável. É prova de anterioridade, não uma patente.
- Dias calmos. Um repositório sem commits numa determinada data não tem prova para essa data. A vista de regularidade diária da página de estado torna as lacunas óbvias — e é por isso que um histórico de ancoragem consistente é mais persuasivo do que um único carimbo.
- Modo ZK empresarial. Algumas equipas não podem deixar o serviço tocar de todo no repositório de origem. Nessa configuração, uma pequena GitHub Action corre na sua própria infraestrutura e envia apenas o hash do commit para a API; o serviço tem acesso de leitura-escrita apenas ao repositório de destino, nunca acesso de leitura à origem. A verificação funciona de forma idêntica, porque a prova é construída a partir do hash.
- O hash é a âncora. A prova é tão forte quanto o hash que alega. Se o hash do commit no seu ficheiro
.otsnão for o que está no histórico do seu repositório, a verificação falhará — e essa falha é o objetivo. Não pode substituir por um commit diferente após o facto.
Como o Timestamp GIT Torna a Verificação Automática
A alternativa a tudo isto é contabilidade que nunca vai conseguir manter em dia: carimbar hashes manualmente, acompanhar recibos por repositório e esperar que ninguém faça force-push enquanto não está a olhar. O Timestamp GIT elimina isso por completo.
Instala a GitHub App uma vez. A partir daí, cada commit num repositório monitorizado é ancorado no Bitcoin automaticamente todas as noites — sem ferramentas CLI, sem passos manuais, nada instalado nas máquinas dos programadores.
- Modo padrão (GitHub App). A app lê apenas o hash do commit HEAD do repositório. As provas são escritas num ramo de carimbos de tempo dedicado ou num repositório sombra separado. O modelo de permissões do GitHub exige pelo menos acesso de leitura ao repositório de origem (não existe um âmbito apenas para o hash do commit) mais acesso de leitura-escrita ao repositório de destino.
- Modo auto-hospedado. Para ambientes isolados ou de segurança máxima, está disponível uma licença auto-hospedada em Docker. Uma configuração rápida de 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
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
A instância fica disponível em http://localhost:8080, e um assistente de configuração no primeiro arranque guia-o na ligação da sua GitHub App. Pode pedir-se uma licença de demonstração com tempo limitado para avaliação na página Docker License.
- Integração com a API. As equipas de conformidade podem controlar tudo a partir dos seus próprios painéis usando
GET /api/statusLast/{user}/{repo},GET /api/statusSummary/{user}/{repo},GET /api/verify/{user}/{repo}/{date},GET /api/audit/{user}/{repo}eGET /api/report/{user}/{repo}/{date}.
Para ser justo com os adeptos do faça-você-mesmo: pode montar algo assim da forma difícil com as ferramentas de linha de comandos em bruto do OpenTimestamps e transações manuais de Bitcoin. O Timestamp GIT existe para que não tenha de o fazer — esconde o protocolo atrás de uma GitHub App e de um cron noturno.
Construir um Rasto de Provas Pronto para Admissibilidade
A prova é mais convincente quando se parece com uma prática, não com um movimento de pânico. Quatro hábitos fazem essa diferença:
- Mantenha os artefactos juntos. Guarde os recibos
.ots, os certificados PDF e os livros de auditoria CSV junto do histórico do seu repositório — idealmente no ramo de carimbos de tempo onde o produto já os escreve. - Mostre regularidade. Uma página de estado pública e selos no README demonstram que a ancoragem aconteceu diariamente, durante meses, antes de o litígio começar. Um processo consistente é muito mais difícil de atacar do que um único carimbo preenchido retroativamente.
- Aborde a dependência desde o início. A prova é verificável offline e não depende de o Timestamp GIT continuar a existir. Diga isso explicitamente no seu pacote de provas; antecipa a objeção do “o seu fornecedor diz que sim”.
- Faça corresponder o modo ao seu modelo de risco. Se o seu código-fonte nunca pode sair do seu ambiente, o modo ZK empresarial mantém-no lá enquanto produz os mesmos recibos ancorados no Bitcoin.
Um aviso que vale a pena repetir: este artigo explica o caminho técnico de verificação, não é aconselhamento jurídico. As regras de admissibilidade variam consoante a jurisdição e o tipo de processo. Consulte o seu advogado sobre o que o seu caso exige — e depois entregue-lhe uma prova que ele possa verificar sem você na sala.
FAQ
Um carimbo de tempo de commit do GitHub, por si só, é legalmente admissível?
Um carimbo de tempo padrão de commit do GitHub está armazenado em infraestrutura que não controla e pode ser alterado ou retro-datado, pelo que é frequentemente tratado como auto-favorável ou manipulável. Uma prova criptográfica que ancora o hash do commit no Bitcoin através do protocolo OpenTimestamps é verificável de forma independente e à prova de adulteração, o que a torna muito mais suscetível de ser aceite como prova. O Timestamp GIT fornece essa prova automaticamente.
Como posso verificar uma prova do Timestamp GIT sem confiar na empresa?
Descarregue o ficheiro de recibo .ots e execute as ferramentas padrão de verificação do OpenTimestamps contra a blockchain do Bitcoin. A prova baseia-se apenas em SHA-256 e dados de blocos do Bitcoin, pelo que é independente do fornecedor e verificável offline. O Timestamp GIT também oferece uma página de verificação no navegador onde todos os cálculos acontecem localmente.
E se o meu repositório for privado? Ainda posso provar um carimbo de tempo?
Sim. O Timestamp GIT suporta repositórios privados. Os URLs de estado para repositórios privados incluem um HMAC encriptado, para que apenas utilizadores autorizados os possam ver. A prova em si continua ancorada no Bitcoin e pode ser verificada por qualquer pessoa a quem partilhe o ficheiro .ots.
Preciso de executar comandos ou instalar algo nas máquinas dos programadores?
Não. O Timestamp GIT é uma GitHub App gerida: instala-a uma vez, e cada commit num repositório monitorizado é ancorado automaticamente todas as noites. Não há ferramentas CLI nem passos manuais para os seus programadores. Para ambientes isolados, está disponível uma opção auto-hospedada em Docker.
Conclusão
As questões de admissibilidade sobre carimbos de tempo de commit resumem-se quase sempre a uma coisa: a outra parte consegue verificá-lo sem confiar em você? Os metadados do repositório falham esse teste. Um hash de commit ancorado no Bitcoin e entregue como recibo .ots, certificado PDF e livro CSV passa-o — e continua a passá-lo anos mais tarde, offline, com ou sem o fornecedor em cena.
O Timestamp GIT trata de todo o pipeline por si: instale a GitHub App uma vez, ligue o repositório e deixe a ancoragem noturna correr. Comece em timestampgit.dev e consulte a página de estado do seu primeiro repositório.
Publicações relacionadas
- Carimbo de Tempo Automatizado do Git: Ancorar Commits no Bitcoin
- Como Provar a Propriedade do Código num Litígio de Pagamento com um Cliente
- Alternativa ao OpenTimestamps: GitHub App Gerida para Cada Commit