Timestamp GIT

← Todos os artigos

2026-10-24

O que um carimbo de tempo do Bitcoin prova sobre o seu código?

O que um carimbo de tempo do Bitcoin prova sobre o seu código?
timestamp git blockchain proof

O que um carimbo de tempo Bitcoin prova sobre o seu código?

Se você já viu uma disputa de pagamento, uma ameaça de patente ou um cofundador que está de saída se transformar em uma discussão do tipo “prove que aconteceu quando você diz que aconteceu”, você já esbarrou no mesmo problema: seu histórico do Git vive em servidores que você não possui, em bancos de dados que podem ser editados. Então, quando alguém pergunta o que um carimbo de tempo Bitcoin realmente prova sobre o seu código, a resposta honesta é mais restrita do que o marketing exagerado que você encontra por aí — e mais útil quando você entende o limite.

Este artigo responde a essa pergunta de forma direta e, em seguida, mostra como o Timestamp GIT transforma a resposta em algo que acontece automaticamente a cada commit.

A resposta em linguagem simples: o que um carimbo de tempo Bitcoin realmente prova

Um carimbo de tempo Bitcoin prova uma coisa: um dado específico existia em um determinado momento ou antes dele.

Só isso. Nada mais, nada menos.

No contexto de código-fonte, o “dado específico” é o hash do seu commit do Git — o resumo SHA-1 ou SHA-256 que o Git gera para um estado do repositório. Quando esse hash é ancorado em um bloco Bitcoin, você obtém uma afirmação verificável matematicamente da seguinte forma:

Este hash exato existia no mais tardar no bloco N, que foi minerado na data D.

O que essa afirmação não declara:

  • Não prova que você criou o código.
  • Não prova que o código é bom, original, inédito ou não infrator.
  • Não prova que você possui algo em sentido jurídico por si só.
  • Não revela nada sobre o conteúdo do código.

O que ela faz é eliminar toda uma classe de argumentos. Uma vez que um hash está em um bloco Bitcoin, ninguém — nem você, nem um concorrente, nem um provedor de hospedagem, nem o próprio Timestamp GIT — pode retroagir a data ou alterá-lo. Essa é a propriedade que você está comprando.

E aqui está a parte que torna isso prático: quando você combina o hash ancorado com o seu histórico do Git, você obtém uma cadeia verificável que vai dos seus commits reais até um livro-razão público e imutável. O hash não flutua no espaço — ele está vinculado a um commit, que está vinculado a um repositório, que está vinculado à sua organização.

O Timestamp GIT automatiza exatamente essa cadeia para cada commit, por meio de um GitHub App, para que você nunca precise tocar na criptografia subjacente.

Uma analogia do mundo real: o tabelião do seu código

Pense em como funciona um tabelião. Você lacra um documento em um envelope, entrega-o e o tabelião carimba a parte externa com uma data. O tabelião não lê o conteúdo. Ele certifica apenas que aquele objeto lacrado existia naquele dia.

Um carimbo de tempo Bitcoin é o mesmo arranjo em escala global:

  • O envelope lacrado é o hash do seu commit. É uma impressão digital, não uma cópia. Você não consegue reverter um resumo SHA-256 de volta para os seus arquivos-fonte, e é por isso que a prova é de conhecimento zero por construção.
  • O tabelião é a rede Bitcoin. Ela é distribuída globalmente, não tem um escritório para o qual você possa ligar, e ninguém pode suborná-la para emitir um carimbo com a data de ontem.
  • O recibo é o seu arquivo .ots, que você pode entregar a um advogado, a um auditor ou à parte adversa.

Agora imagine um tabelião que visita o seu escritório todas as noites, carimba cada novo commit enquanto você dorme e arquiva os recibos no seu próprio repositório. Essa é a diferença entre o protocolo bruto — em que você teria que montar o envelope e encontrar o tabelião por conta própria — e o Timestamp GIT, que é o tabelião automatizado.

Por baixo do capô: como o hash do seu commit se torna uma prova Bitcoin

O pipeline tem três estágios. Você não opera nenhum deles manualmente, mas vale a pena saber o que acontece.

1. A impressão digital. A cada commit, o Git produz um hash unidirecional que representa o estado exato do seu repositório naquele momento. Isso é gerado localmente pelo Git; ele existe quer você carimbe algo ou não.

2. A âncora. O Timestamp GIT extrai apenas os hashes dos commits — nunca os arquivos, nunca os diffs, nunca o conteúdo dos branches. Esses hashes são reunidos em um manifesto de texto diário por repositório, uma árvore de Merkle é construída a partir deles, e a raiz de Merkle é ancorada em um bloco Bitcoin por meio do protocolo OpenTimestamps e dos calendários públicos do OTS.

3. A prova. Um arquivo de recibo .ots imutável é gravado de volta no seu repositório — em um branch dedicado de carimbos de tempo ou em um repositório sombra. Esse recibo permite que qualquer pessoa verifique o hash em relação aos dados do bloco Bitcoin.

O detalhe crucial aqui: apenas o hash é ancorado. Não há nenhum ponto no pipeline em que o seu código-fonte seja transmitido, armazenado ou lido pelo serviço no modo Enterprise ZK. A prova é verificável offline, usando apenas SHA-256 e dados de blocos Bitcoin, o que significa que ela sobrevive mesmo se o Timestamp GIT desaparecer amanhã.

Duas observações operacionais que vale a pena internalizar:

  • A confirmação do Bitcoin normalmente leva cerca de três horas, então as provas chegam ao seu repositório algumas horas depois da execução do lote noturno, não instantaneamente.
  • O GitHub App detecta commits via webhooks automaticamente. No modo Enterprise ZK, uma GitHub Action de 12 linhas executada na sua própria infraestrutura envia apenas o hash do commit para a API — o seu código-fonte nunca sai do seu ambiente.

Por que isso importa para desenvolvedores e equipes de conformidade

Os dois públicos se importam com metades diferentes da mesma garantia.

Para desenvolvedores, um histórico ancorado em Bitcoin é anterioridade com força:

  • Trolls de patentes. Se uma entidade que não pratica a invenção registra uma patente ampla sobre algo que você implementou meses antes, um hash ancorado é o escudo que invalida a reivindicação. Sem ele, você litiga com base na memória e em registros internos.
  • Disputas trabalhistas. Quando um desenvolvedor líder sai e a pergunta passa a ser “quando esse recurso foi realmente concebido?”, um carimbo de tempo imutável substitui um impasse de “ele disse, ela disse”.
  • Alegações de desenvolvimento independente. Um concorrente que afirma desenvolvimento independente tem dificuldade para explicar por que a sua lógica finalizada foi ancorada criptograficamente 18 meses antes do lançamento dele.

Para equipes de conformidade, o valor é probatório:

  • Registros internos do Git são rotineiramente descartados como parciais porque a organização controla o banco de dados. Uma prova ancorada em Bitcoin é pública e imutável, verificada contra infraestrutura neutra.
  • A prova é independente de fornecedor. Ela depende de SHA-256 e de dados de blocos Bitcoin, não de um formato proprietário que só uma empresa pode validar.
  • Existem artefatos de relatório prontos para uso: CSVs de auditoria para download, certificados em PDF por data, selos de verificação incorporáveis e um painel de status público que mostra a longevidade das provas, a data da âncora mais antiga, a regularidade diária e o bloco e a transação Bitcoin envolvidos.

Repositórios privados ganham uma proteção adicional: as URLs de status públicas acrescentam um HMAC criptografado específico da instância do servidor, de modo que apenas usuários autorizados podem ver o status desses repositórios.

Equívocos comuns sobre carimbos de tempo Bitcoin

“Isso prova que eu escrevi o código.” Isso prova que o código existia em um determinado momento. A autoria é uma afirmação separada. Na prática, a combinação de um hash ancorado em Bitcoin com o seu histórico de commits do Git — autor do commit, repositório, linha do tempo — é uma forte evidência de apoio à autoria, mas o carimbo de tempo em si diz respeito à existência, não à identidade.

“Isso expõe o meu código-fonte.” Não. Apenas os hashes são ancorados. Um resumo SHA-256 não pode ser revertido para os arquivos originais. No modo Enterprise ZK, o serviço nunca tem acesso de leitura ao seu repositório de código-fonte — uma GitHub Action envia apenas os hashes.

“Preciso executar ferramentas de linha de comando complexas.” Não com uma configuração gerenciada. Você instala o GitHub App uma vez e, a cada noite, o pipeline roda para você. Não há comandos para digitar nem nada para instalar nas máquinas dos seus desenvolvedores.

“É caro e lento.” A ancoragem é uma operação em lote noturna, incluída no serviço gerenciado. A confirmação leva algumas horas porque é assim que o Bitcoin confirma blocos — mas acontece sem supervisão, e você recebe um recibo .ots quando ela chega.

“É só um log de servidor com etapas extras.” Um log de servidor vive em um banco de dados que você controla e pode editar. Uma âncora Bitcoin vive em um livro-razão que nenhuma parte isolada controla. Essa distinção é o ponto central, e é a diferença entre evidência e alegação.

Como o Timestamp GIT torna isso sem esforço

O fluxo de trabalho é deliberadamente entediante, que é exatamente o que você quer de um pipeline de evidências.

  1. Instale o GitHub App uma vez. Cada commit em um repositório monitorado é detectado automaticamente. Sem ferramentas de linha de comando, sem ação por commit, sem necessidade de conhecer o protocolo.
  2. Escolha o seu modo de implantação. O Modo Padrão lê apenas o hash do commit HEAD do repositório monitorado e grava as provas em um branch separado ou repositório sombra. Ele exige pelo menos acesso somente leitura ao repositório de origem (não existe permissão apenas para hash de commit no modelo do GitHub) e acesso de leitura e escrita ao repositório de destino. O Modo Enterprise ZK não exige nenhum acesso de leitura ao repositório de origem e nenhuma movimentação de código-fonte — apenas a GitHub Action.
  3. Consuma os resultados. Selos de verificação para o seu README, um painel de status público e acesso à API REST para as suas próprias ferramentas:
# Last anchored Bitcoin block for a repo
curl https://timestampgit.dev/api/statusLast/acme/payments-service

# Combined summary, suitable for Shields.io
curl https://timestampgit.dev/api/statusSummary/acme/payments-service

# Full Merkle chain data for local verification of a specific day
curl https://timestampgit.dev/api/verify/acme/payments-service/2026-10-24
  1. Faça auto-hospedagem se precisar. Para ambientes isolados (air-gapped), o Timestamp GIT é distribuído como uma imagem Docker sob uma licença de auto-hospedagem. 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

O aplicativo sobe em http://localhost:8080, e um assistente de configuração 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 está disponível ao enviar o formulário de solicitação na página de Licença Docker.

Perguntas frequentes

Um carimbo de tempo Bitcoin prova que eu escrevi o código?

Não — ele prova que o código existia em um momento específico. No entanto, combinado com o seu histórico de commits do Git e com o fato de o hash estar vinculado ao seu repositório, ele fornece forte evidência de autoria. O Timestamp GIT ancora os hashes dos seus commits, criando uma cadeia verificável do seu trabalho até a blockchain do Bitcoin.

Posso verificar um carimbo de tempo Bitcoin sem confiar no Timestamp GIT?

Sim. O arquivo de recibo .ots pode ser verificado de forma independente em relação à blockchain do Bitcoin usando ferramentas padrão do OpenTimestamps. A prova depende apenas de SHA-256 e de dados de blocos Bitcoin, então você pode verificá-la offline mesmo se o Timestamp GIT desaparecer.

Qual é a diferença entre um carimbo de tempo de commit do Git e um carimbo de tempo Bitcoin?

Um carimbo de tempo de commit do Git é definido pela sua máquina local e pode ser facilmente manipulado. Um carimbo de tempo Bitcoin é ancorado em uma blockchain pública e imutável e não pode ser alterado nem ter a data retroagida por ninguém, incluindo o Timestamp GIT.

Preciso executar algum comando para carimbar os meus commits?

Não. Com o Timestamp GIT, você instala o GitHub App uma vez e ele ancora automaticamente cada commit dos repositórios monitorados todas as noites. Não são necessárias ferramentas de linha de comando nem etapas manuais.

Conclusão

Um carimbo de tempo Bitcoin prova a existência no tempo — nada mais, e essa limitação é precisamente o motivo pelo qual ele é confiável. Ele não depende da honestidade de ninguém, de um fornecedor continuar no mercado ou de um arquivo de log que ninguém pode auditar. Combinado com o seu histórico do Git, ele lhe dá uma cadeia verificável do seu trabalho até um livro-razão público que ninguém pode reescrever.

A única questão que resta é se você quer manter essa cadeia manualmente ou fazer com que ela aconteça todas as noites sem precisar pensar nisso. Instale o GitHub App, conecte um repositório e deixe a ancoragem rodar — depois confira o seu painel de status e coloque um selo no seu README. Você terá prova de existência para cada commit que fez desde o dia em que começou.

Pronto para ancorar o seu primeiro commit? Comece com o Timestamp GIT.


Posts relacionados

EU label: AI-generated content