Timestamp GIT

← Todos os artigos

2026-11-06

OpenTimestamps sem CLI: carimbo de tempo Bitcoin gerenciado

OpenTimestamps sem CLI: carimbo de tempo Bitcoin gerenciado
timestamp git blockchain proof

OpenTimestamps Sem a CLI: Carimbo de Tempo Bitcoin Gerenciado

Se você já pesquisou sobre como provar que um trecho de código existia em uma data específica, provavelmente já se deparou com o OpenTimestamps. E também provavelmente já se deparou com a parte que ninguém coloca na manchete: a linha de comando, os calendários, os arquivos .ots e uma vaga sensação de que agora você precisa entender transações Bitcoin.

Este artigo é o OpenTimestamps explicado sem a CLI. Não porque o protocolo seja ruim — ele é genuinamente excelente — mas porque a linha de comando é um detalhe de implementação, não um requisito. Existe um caminho gerenciado em que um GitHub App monitora seu repositório e ancora cada commit no Bitcoin enquanto você dorme. Você instala uma vez. Nunca digita um comando de carimbo de tempo.

Vamos cobrir o que o OpenTimestamps realmente faz, por que a analogia com um cartório se encaixa quase perfeitamente, o que acontece nos bastidores todas as noites e os equívocos que impedem as equipes de adotá-lo. A mecânica bruta do protocolo é tratada aqui como contexto; o foco é o fluxo de trabalho automatizado e o que ele oferece.

O Que É OpenTimestamps Sem a CLI?

OpenTimestamps é um protocolo para provar que alguns dados existiam em ou antes de um determinado momento. Ele faz isso agregando dados em uma árvore de Merkle, calculando o hash da raiz e gravando essa raiz em um bloco Bitcoin. Como os blocos Bitcoin são imutáveis e replicados globalmente, a âncora se torna um registro público e à prova de adulteração da existência.

A CLI é apenas uma interface para esse protocolo. Um serviço web, um GitHub App ou um worker agendado podem fazer exatamente a mesma coisa — e fazer melhor, porque o agrupamento em lotes e o tratamento de calendários são justamente as partes em que humanos são ruins.

A abordagem gerenciada funciona assim: você instala o GitHub App Timestamp GIT em um repositório. A partir daí, cada commit é detectado automaticamente, agrupado em lotes noturnos e ancorado no Bitcoin via OpenTimestamps. As provas voltam para o seu repositório como arquivos de recibo e manifestos. Sem comandos, sem ferramentas locais, sem nó Bitcoin.

Para ser explícito quanto ao escopo: este artigo explica o conceito e o fluxo de trabalho gerenciado. Ele não orienta você em operações brutas do protocolo. Se quiser aprofundamentos sobre tópicos adjacentes, veja como verificar uma prova de carimbo de tempo Bitcoin no seu navegador e por que seu Git log não é prova.

Uma Analogia Simples: O Cartório para o Seu Código

Imagine um cartório. Você entrega um documento. Eles não o leem. Calculam um selo à prova de adulteração sobre ele, carimbam com uma data e registram esse selo em um livro público que qualquer um pode inspecionar. Depois, se alguém contestar a data, você apresenta o documento, recalcula o selo e aponta para o registro no livro.

OpenTimestamps é esse cartório, com duas melhorias:

  • O “documento” é um hash, não o seu código. O Git já produz um hash unidirecional único (SHA-1 ou SHA-256) para cada commit, representando o estado exato do seu repositório naquele momento. Esse hash é a impressão digital. O Timestamp GIT só lida com a impressão digital.
  • O livro é a blockchain do Bitcoin. Em vez do livro encadernado de um cartório em um arquivo de aço, o selo é registrado em um bloco que milhares de nós independentes replicam. Ninguém — nem você, nem nós, nem uma ordem judicial — pode reescrevê-lo.

A terceira melhoria é a que importa no dia a dia: com o Timestamp GIT, o cartório visita você automaticamente todas as noites. Sem agendamento, sem fila, sem papelada. Você faz commit do código; o carimbo acontece em um cronograma com o qual você nunca precisa se preocupar.

Como Funciona nos Bastidores (Resumidamente)

Três etapas, e apenas a do meio envolve algo parecido com infraestrutura.

Etapa 1 — A impressão digital. Quando você faz commit, o Git gera um hash único para aquele commit. O Timestamp GIT coleta apenas esses hashes. Seu código-fonte nunca é lido, copiado ou armazenado.

Etapa 2 — A âncora. Um worker cron da meia-noite agrupa todos os hashes pendentes, constrói uma árvore de Merkle nativa por repositório, cria um arquivo de manifesto .txt e ancora a raiz de Merkle no Bitcoin usando calendários públicos do OpenTimestamps.

Etapa 3 — A prova. O manifesto e os arquivos de recibo .ots são enviados de volta para o seu repositório — em um branch dedicado de timestamps ou em um repositório sombra separado. A partir daí, qualquer pessoa pode verificar offline contra os dados dos blocos Bitcoin.

Dois detalhes operacionais que vale conhecer:

  • A confirmação do Bitcoin leva várias horas, normalmente cerca de três. Portanto, a gravação das provas é concluída algumas horas após o lote noturno, não instantaneamente.
  • A verificação é independente do fornecedor. A prova depende apenas de SHA-256 e dos dados dos blocos Bitcoin. Sem formato proprietário, sem aprisionamento tecnológico.

Aqui está o formato do que um lote noturno produz, conceitualmente:

timestamps/
├── 2026-11-05/
│   ├── manifest.txt        # commit hashes for the day
│   └── manifest.txt.ots    # OpenTimestamps receipt for the Merkle root
└── 2026-11-06/
    ├── manifest.txt
    └── manifest.txt.ots

Os recibos são o artefato que você guarda. Todo o resto é conveniência.

Por Que o Carimbo de Tempo Gerenciado Importa

Executar o protocolo por conta própria é possível. Também é um projeto de manutenção: confiabilidade dos calendários, lógica de agrupamento em lotes, tratamento de confirmações Bitcoin, armazenamento de recibos e uma história de verificação para auditores. Para a maioria das equipes, isso é uma distração do produto real.

Um serviço gerenciado remove essas peças móveis:

  • Nenhum conhecimento de protocolo necessário. Você não precisa aprender sobre servidores de calendário, provas de Merkle ou estrutura de transações Bitcoin. O caminho difícil existe; você tem permissão para pulá-lo.
  • Provas prontas para tribunais e independentes do fornecedor. A evidência vive no Bitcoin, não no nosso banco de dados. Qualquer um pode verificá-la sem confiar em nós.
  • Adequação ao fluxo de trabalho. Instale o GitHub App uma vez. Cada commit subsequente é ancorado automaticamente. Sem hábitos a mudar, nada para instalar nas máquinas dos desenvolvedores.
  • Superfície de conformidade. Selos públicos de verificação para arquivos README, CSVs de auditoria para download e certificados PDF por data dão aos auditores algo concreto para examinar.

Para agências e freelancers, esse último ponto faz trabalho real durante disputas de pagamento e reivindicações de autoria. Para empresas, é um escudo contra trolls de patentes que alegam direitos sobre coisas que já rodam em sistemas internos.

Equívocos Comuns Sobre o OpenTimestamps

“Você precisa ser um especialista em Bitcoin.” Você precisa confiar na matemática, não em especialistas. Com um serviço gerenciado, a complexidade é tratada: agrupamento em lotes, ancoragem e entrega de provas acontecem em um cronograma. Você interage com um painel e um branch no seu repositório.

“O carimbo de tempo expõe meu código-fonte.” Não expõe. Apenas os hashes dos commits são ancorados. O serviço nunca vê, copia ou armazena seu código — o princípio de conhecimento zero é arquitetural, não uma promessa de política. No modo Enterprise ZK, o envio do hash roda como uma GitHub Action na sua própria infraestrutura, enviando apenas o hash para a API, de modo que o serviço não tem nenhum acesso de leitura ao repositório de origem.

“As provas são tão confiáveis quanto o fornecedor.” As provas são nativas do Bitcoin. Você pode baixar os arquivos de recibo .ots e verificá-los offline usando a verificação padrão do OpenTimestamps contra a blockchain. Se o Timestamp GIT desaparecesse amanhã, suas provas ainda seriam válidas.

“É caro e lento.” O agrupamento diário em lotes significa que muitos commits compartilham uma única âncora Bitcoin, e é por isso que a economia funciona. A confirmação leva algumas horas — aceitável para evidência de anterioridade, que é julgada em meses e anos, não em minutos.

Começando Sem a CLI

Existem dois modos de implantação, e nenhum deles exige um terminal nas máquinas dos desenvolvedores.

Modo Padrão (GitHub App). Instale o GitHub App nos repositórios que deseja monitorar. Ele lê o hash do commit HEAD automaticamente e grava as provas em um branch dedicado — seja no mesmo repositório ou em um repositório de destino separado. O modelo de permissões do GitHub exige pelo menos acesso somente leitura ao repositório de origem (não existe permissão apenas para hash de commit), além de acesso de leitura e escrita ao repositório de destino.

Modo Enterprise ZK. Uma GitHub Action de 12 linhas roda na sua infraestrutura e envia apenas o hash do commit para a API do Timestamp GIT. Aqui você precisa de acesso de leitura e escrita apenas ao repositório de destino, e nenhum acesso de leitura à origem. Escolha este modo quando até a visibilidade do hash precisar permanecer dentro do seu perímetro.

De qualquer forma, a sequência após a instalação é tranquila: commits são detectados, hashes são enfileirados, o worker noturno os ancora e as provas aparecem no seu branch de timestamps algumas horas após a confirmação do Bitcoin.

Auto-Hospedagem Com Docker

Para ambientes isolados (air-gapped) ou de segurança máxima, o Timestamp GIT é distribuído como 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

Suba os serviços:

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. Uma licença de demonstração por tempo limitado para avaliação pode ser solicitada na página Docker License com seu nome, empresa, e-mail e telefone opcional; o arquivo de licença fica disponível para download imediatamente.

O Que Você Ganha Quando Está Rodando

  • Um painel público de status por repositório: longevidade das provas, data da âncora mais antiga, regularidade diária, dados de bloco e transação Bitcoin, um mapa de calor de calendário e CSV de auditoria e certificado PDF para download.
  • Selos de verificação para o seu README, com um link que qualquer pessoa pode seguir para conferir o carimbo de tempo. Repositórios privados acrescentam um HMAC criptografado à URL para que apenas usuários autorizados possam ver o status.
  • Um verificador baseado em navegador que executa a checagem da cadeia de Merkle em vários níveis localmente, para que ninguém veja o que você verifica.
  • Uma API REST se você quiser automatizar verificações de status: /api/statusLast/{user}/{repo}, /api/statusCount/{user}/{repo}, /api/audit/{user}/{repo} e similares.
# Check the last anchored Bitcoin block for a repo
curl https://timestampgit.dev/api/statusLast/youruser/yourrepo

Os planos acompanham o quanto de privacidade você precisa: Open Source para repositórios públicos, Pro Agency para repositórios privados e Enterprise ZK para isolamento baseado em GitHub Action. Os detalhes estão na página de preços.

FAQ

Preciso instalar algum software ou executar comandos para usar o OpenTimestamps com o Timestamp GIT?

Não. O Timestamp GIT é um GitHub App gerenciado. Você o instala uma vez, e ele carimba automaticamente seus commits todas as noites. Não há ferramentas de CLI para instalar nem comandos para executar.

Como o Timestamp GIT garante que meu código-fonte permaneça privado?

O Timestamp GIT opera com um princípio de conhecimento zero: ele processa apenas hashes de commits do Git, nunca seu código-fonte real. No modo Enterprise ZK, até os hashes são enviados da sua infraestrutura via uma GitHub Action, de modo que o serviço nunca tem acesso de leitura ao seu repositório.

Posso verificar os carimbos de tempo de forma independente sem confiar no Timestamp GIT?

Sim. As provas são ancoradas na blockchain do Bitcoin usando o protocolo OpenTimestamps. Você pode baixar os arquivos de recibo .ots e verificá-los offline usando a verificação padrão do OpenTimestamps, ou usar o verificador integrado baseado em navegador que roda localmente.

O que acontece se o Timestamp GIT sair do mercado?

Suas provas continuam válidas porque estão embutidas na blockchain do Bitcoin. A verificação depende apenas do Bitcoin e do SHA-256, então você pode continuar provando a existência do seu código de forma independente.

Conclusão

O OpenTimestamps resolve um problema real — provar que dados existiam em um momento específico — e o resolve com nada além de hashing e Bitcoin. A linha de comando nunca foi o ponto. Era apenas a primeira interface.

A interface gerenciada se adequa melhor a como as equipes realmente trabalham: instale um GitHub App, continue fazendo commits e deixe um job noturno ancorar os hashes. Você recebe recibos .ots, um branch de manifesto, selos de verificação, CSVs de auditoria e certificados PDF — tudo respaldado por provas que sobrevivem ao fornecedor.

Se você quer a versão automatizada, instale o Timestamp GIT em um repositório e faça um commit. Essa é a configuração inteira. O cartório aparece hoje à noite.

EU label: AI-generated content