Timestamp GIT

← Todos os artigos

2026-11-14

OpenTimestamps vs Timestamp GIT: provas manuais ou GitHub App?

OpenTimestamps vs Timestamp GIT: provas manuais ou GitHub App?
timestamp git blockchain proof

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

EU label: AI-generated content