OpenTimestamps vs Timestamp GIT: Provas Manuais ou GitHub App?
Você tomou a decisão importante: seus commits Git devem ser ancorados no Bitcoin, para que daqui a seis meses ou seis anos você possa provar que uma linha específica de trabalho existia em uma data específica. Agora vem a segunda decisão, mais prática — você mesmo opera o protocolo OpenTimestamps, ou deixa um GitHub App gerenciado fazer isso por você?
Essa pergunta não é sobre criptografia. Ambos os caminhos terminam no mesmo lugar: uma raiz de Merkle dos hashes dos seus commits embutida em um bloco Bitcoin via OpenTimestamps. A pergunta é sobre quem opera esse pipeline, quanto tempo de engenharia ele custa e o que sua equipe de compliance precisa aprovar. Este artigo compara as duas abordagens segundo os critérios que realmente decidem a compra: facilidade, automação, modelo de segurança, integração e custo.
Se você ainda está construindo o argumento para fazer timestamping, leia primeiro Cryptographic Prior Art: The Startup Shield Against Patent Trolls. Este artigo assume que você já está convencido e está escolhendo uma ferramenta.
O Cenário: Quais São Suas Opções para Timestamping de Git?
Existem essencialmente três rotas.
1. O protocolo bruto. OpenTimestamps é um protocolo aberto com ferramentas CLI de referência. Você o instala, envia hashes para servidores de calendário públicos, acompanha os arquivos de prova e, eventualmente, atualiza essas provas quando a transação de ancoragem é confirmada em um bloco Bitcoin. É gratuito, é independente de fornecedor e é genuinamente o substrato sobre o qual todo o resto se apoia. Também coloca todo o ônus operacional — agendamento, agrupamento em lotes, armazenamento, ciclo de vida das provas, monitoramento de confirmações — sobre você.
2. Um serviço gerenciado sobre o protocolo. Timestamp GIT é um SaaS mais um GitHub App que automatiza todo o fluxo de trabalho do OpenTimestamps. Você instala o GitHub App em um repositório e, a partir daí, cada commit é capturado automaticamente e ancorado todas as noites. Sem CLI nas máquinas dos desenvolvedores, sem stamping manual, sem arquivos de prova para rastrear. A evidência volta para o seu próprio repositório como um manifesto mais recibos .ots, e o dashboard oferece badges, certificados PDF e um CSV de auditoria.
3. Scripts caseiros e serviços genéricos de timestamping. Equipes às vezes conectam um cron job a um servidor de calendário, ou compram um serviço genérico de timestamping de documentos que não tem integração com o GitHub. Esses podem funcionar, mas geralmente significam ou uma base de código sob medida que alguém precisa manter, ou uma etapa de upload manual por release — que é exatamente o atrito que faz o timestamping parar silenciosamente depois de três meses.
Para ambientes air-gapped ou com requisitos rígidos de residência de dados, o Timestamp GIT também é distribuído como uma imagem Docker que você mesmo hospeda. Isso é abordado em profundidade em Self-Host Git Timestamping With Docker Compose; a comparação aqui é entre trabalho manual com o protocolo e um pipeline gerenciado e automatizado.
Critérios de Seleção: Como Escolher a Abordagem Certa
Facilidade de configuração
Com o protocolo bruto, a configuração é um projeto: instalar ferramentas em cada máquina que fará o stamping, documentar o processo, decidir uma estratégia de agrupamento em lotes e treinar a equipe. A configuração do Timestamp GIT é uma instalação de GitHub App. O modo padrão precisa de acesso somente leitura ao repositório de origem (o GitHub não tem um escopo de permissão de “apenas hash de commit”) e leitura-escrita no repositório de destino onde as provas são gravadas.
Não há nada para instalar nas máquinas dos desenvolvedores. Esse é o ponto principal: timestamping que depende de os desenvolvedores lembrarem de fazer algo é timestamping que eventualmente terá lacunas.
Automação
O stamping manual é um trabalho por commit ou por lote feito por um humano. O Timestamp GIT executa o pipeline por conta própria: webhooks detectam commits, os hashes entram na fila em um armazenamento chave-valor em memória, e um worker cron da meia-noite agrupa tudo em um manifesto por repositório, constrói uma árvore de Merkle, produz as provas OpenTimestamps e ancora a raiz de Merkle no Bitcoin.
Um detalhe operacional que vale a pena planejar: a confirmação do Bitcoin normalmente leva cerca de três horas, então as provas chegam algumas horas após o lote noturno — não às 00:01.
Segurança e privacidade
É aqui que os dois modelos divergem em natureza, não em grau. Operar o protocolo você mesmo lhe dá controle total, mas também exposição total: você é dono do material de chaves, da disponibilidade dos calendários, do armazenamento das provas e do risco de um processo que quebra silenciosamente. O modelo do Timestamp GIT é zero-knowledge por design — ele nunca vê, copia ou armazena seu código-fonte, apenas hashes de commit.
Se você não quer que o SaaS veja nem mesmo um hash de commit, o modo Enterprise ZK move o push para o seu próprio CI: uma GitHub Action de 12 linhas roda na sua infraestrutura e envia apenas o hash para a API do Timestamp GIT. Nesse modo, o serviço exige acesso de leitura-escrita apenas ao repositório de destino, e sua origem nunca sai do seu ambiente.
Integração e verificação
As provas brutas são arquivos .ots autônomos — portáveis, mas você precisa armazená-los, encontrá-los e explicá-los a um advogado. O Timestamp GIT grava o manifesto e os recibos em um branch dedicado de timestamps ou em um repositório sombra, e adiciona a camada de apresentação:
- Badges Shields.io incorporáveis para o seu README, com um link público de verificação.
- Um dashboard de status do repositório mostrando a longevidade das provas, a data de ancoragem mais antiga, a 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.
- Uma página de verificação passo a passo que calcula toda a cadeia de Merkle localmente no navegador — nada do que você verifica é enviado a lugar algum.
Os dados públicos de status podem ser consultados sem autenticação:
# Last anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/acme/payments-core
# Combined summary, suitable for Shields.io
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-core
E os artefatos de auditoria são uma única requisição cada:
# Full audit ledger as CSV
curl -sO https://timestampgit.dev/api/audit/acme/payments-core
# PDF certificate for a specific day
curl -sO https://timestampgit.dev/api/report/acme/payments-core/2026-11-13
Repositórios privados acrescentam um HMAC criptografado e específico da instância à URL, de modo que apenas usuários autorizados podem ler seu status.
Custo
O OpenTimestamps em si é gratuito. O custo real é o tempo de engenharia — a construção inicial, a manutenção contínua e o custo invisível de um pipeline que para silenciosamente. O Timestamp GIT é escalonado: Open Source 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 o modelo de GitHub Action. Item de linha previsível, sem backlog de manutenção.
Comparação Lado a Lado: OpenTimestamps vs Timestamp GIT
| Critério | OpenTimestamps (protocolo bruto) | Timestamp GIT (GitHub App gerenciado) |
|---|---|---|
| Esforço de configuração | Instalar ferramentas CLI, definir agrupamento em lotes, documentar o processo para a equipe | Instalar o GitHub App, conectar o repositório, pronto |
| Nível de automação | Stamping manual por commit ou lote | Detecção por webhook, agrupamento em lotes por cron noturno, ancoragem automática |
| Modelo de segurança | Autogerenciado: você é dono das chaves, do armazenamento, dos calendários, do uptime | Zero-knowledge: apenas hashes de commit processados; Enterprise ZK mantém os hashes dentro do seu CI |
| Método de verificação | Manuseio manual de provas com ferramentas do protocolo | Verificação de Merkle no navegador, badges, dashboard, certificados PDF, ledger de auditoria CSV |
| Integração com GitHub | Nenhuma nativa | GitHub App nativo; provas gravadas em um branch de timestamps ou repositório sombra |
| Custo | Software gratuito, pago em horas de engenharia | Gratuito (repositórios públicos), US$ 49/mês Pro Agency, US$ 199/mês Enterprise ZK |
| Suporte | Comunidade | Equipe do produto |
A linha que mais importa para compliance: o Timestamp GIT não inventa um formato de prova proprietário. Ele usa o mesmo protocolo OpenTimestamps e os mesmos dados de bloco Bitcoin, então seus recibos .ots permanecem independentes de fornecedor. Se o Timestamp GIT desaparecesse amanhã, as provas no seu repositório ainda seriam verificáveis com qualquer ferramenta compatível com OpenTimestamps.
Para equipes que precisam da experiência gerenciada em sua própria infraestrutura, a licença Docker auto-hospedada é a terceira opção. Uma configuração Docker Compose de início rápido é assim:
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 app sobe em http://localhost:8080, e um assistente de primeira execução orienta você a conectar seu GitHub App e configurar a instância. Uma licença de demonstração por tempo limitado está disponível pelo formulário de solicitação na página Docker License.
Veredito: Quem Deve Escolher Qual?
Escolha o protocolo bruto se você tem expertise dedicada em blockchain ou criptografia internamente, precisa controlar cada etapa do pipeline e está genuinamente confortável em assumir o risco operacional que vem com isso — incluindo o risco de o stamping manual parar de acontecer durante um período de correria.
Escolha o Timestamp GIT se você quer prior art criptográfico sem transformá-lo em um projeto paralelo. Concretamente:
- Startups e fundadores que precisam de prior art garantido antes de um pedido de patente e querem maturidade de PI que possam mostrar em due diligence.
- Agências e dev shops que precisam de datas de entrega defensáveis durante disputas de pagamento, além de certificados profissionais de autoria.
- Freelancers protegendo bibliotecas reutilizáveis e trabalhos de portfólio de serem reivindicados por outra pessoa.
- Equipes de compliance que precisam de evidência pronta para tribunal com uma trilha de auditoria, sem pedir que os desenvolvedores aprendam um protocolo.
O plano gratuito para repositórios open-source torna isso um experimento de baixo risco: conecte um repositório, espere uma noite e veja o que chega ao seu branch de timestamps.
FAQ
Posso verificar provas do Timestamp GIT sem o serviço deles?
Sim. O Timestamp GIT produz arquivos de recibo .ots padrão do OpenTimestamps ancorados na blockchain Bitcoin. Você pode verificá-los de forma independente usando qualquer ferramenta compatível com OpenTimestamps, garantindo independência de fornecedor.
O Timestamp GIT vê meu código-fonte?
Não. O Timestamp GIT opera em um modelo zero-knowledge: ele processa apenas hashes de commit, nunca seu código-fonte. No modo Enterprise ZK, uma GitHub Action envia hashes da sua infraestrutura, então o serviço nunca tem acesso de leitura aos seus repositórios.
O Timestamp GIT é admissível em tribunal?
As provas são criptograficamente verificáveis e ancoradas na blockchain Bitcoin, que é amplamente reconhecida por sua imutabilidade. A admissibilidade depende da jurisdição e do contexto legal; consulte um advogado. O Timestamp GIT fornece certificados PDF e trilhas de auditoria para apoiar necessidades probatórias. Para um passo a passo mais detalhado, veja Is a Bitcoin Timestamp Admissible as Evidence? A Compliance Guide.
E se eu parar de usar o Timestamp GIT?
Suas provas existentes permanecem válidas e verificáveis para sempre, porque estão embutidas na blockchain Bitcoin via OpenTimestamps. Você não fica preso; as provas são independentes de fornecedor.
Conclusão
Ambos os caminhos ancoram seu trabalho no Bitcoin. Apenas um deles continua rodando quando sua equipe está ocupada entregando. O protocolo é a parte durável; a disciplina operacional em torno dele é a parte frágil — e é exatamente essa peça que o Timestamp GIT tira das suas mãos.
Instale o GitHub App, aponte-o para o repositório que contém sua lógica mais valiosa e deixe o worker cron noturno fazer o resto. Sua primeira prova chega algumas horas depois da meia-noite e, a partir daí, é um registro permanente e verificável com o qual você nunca mais precisa se preocupar. Comece em timestampgit.dev.
Posts relacionados
- Self-Host Git Timestamping With Docker Compose
- Cryptographic Prior Art: The Startup Shield Against Patent Trolls
- Is a Bitcoin Timestamp Admissible as Evidence? A Compliance Guide
- Timestamp GIT Alternatives for Code Timestamping: Compared