Timestamp GIT

← Todos os artigos

2026-10-12

Como Verificar de Forma Independente o Carimbo de Data/Hora de um Commit Git

Como Verificar de Forma Independente o Carimbo de Data/Hora de um Commit Git
timestamp git blockchain proof

Como Verificar de Forma Independente o Carimbo de Data/Hora de um Commit do Git

Um carimbo de data/hora que você não pode verificar por conta própria não é uma prova — é uma promessa de um fornecedor. Essa distinção importa no momento em que outra pessoa pede que você comprove quando seu código existiu: um auditor de conformidade, a parte adversa em uma disputa de patente ou um adquirente fazendo due diligence técnica.

Este artigo mostra como verificar de forma independente o carimbo de data/hora de um commit do Git usando os artefatos de prova e as ferramentas do Timestamp GIT: a página de status pública, a página de verificação Merkle no navegador, a API REST, os selos de verificação e os relatórios para download. Nenhum código-fonte precisa sair do seu repositório, e ninguém — incluindo o fornecedor — precisa ser confiável para que o resultado seja válido.

Por que a Verificação Independente Importa

Todo carimbo de data/hora criptográfico é tão forte quanto a sua capacidade de auditá-lo nos seus próprios termos.

  • A verificação não pode depender de o fornecedor continuar existindo. As provas do Timestamp GIT dependem exclusivamente de SHA-256 e de dados de blocos do Bitcoin. Você pode verificá-las offline, mesmo que o serviço não exista mais.
  • Reguladores, auditores e tribunais esperam evidências reproduzíveis. “O painel disse que sim” não é evidência. Uma raiz de Merkle conferida contra um bloco do Bitcoin é.
  • A due diligence faz perguntas difíceis. Durante uma aquisição ou uma rodada de investimento, a maturidade da propriedade intelectual é examinada. Poder entregar uma cadeia de provas verificável é muito diferente de entregar uma captura de tela.
  • Seu código-fonte permanece privado. A verificação precisa de exatamente duas coisas: os arquivos de prova (manifesto e recibo .ots) e dados públicos da blockchain. Não da sua implementação, não dos seus segredos comerciais.

O restante deste artigo é a lista de verificação prática.

Como é uma Prova do Timestamp GIT

Um único dia de commits produz um conjunto pequeno e bem definido de artefatos:

  • Um arquivo de manifesto diário (.txt) contendo os hashes de commit coletados para aquele repositório naquele dia.
  • Uma raiz de Merkle calculada sobre o manifesto. A raiz é o valor único que representa todos os commits do lote.
  • Um arquivo de recibo .ots — uma prova OpenTimestamps que vincula criptograficamente essa raiz de Merkle a um bloco específico do Bitcoin.

Esses artefatos ficam em um branch de carimbos de data/hora dedicado ou em um repositório sombra, deliberadamente separados do seu código-fonte. Essa separação é o ponto central: a prova viaja independentemente do código que ela protege.

Junto com os arquivos, o registro inclui a altura do bloco do Bitcoin e o ID da transação que ancorou o lote. Esses dois valores são o que permitem que qualquer pessoa — você, um advogado, um auditor externo — confirme que os dados existiam quando o bloco foi minerado.

Passo a Passo: Verificando com as Ferramentas do Timestamp GIT

Os carimbos de data/hora são produzidos automaticamente: instale o GitHub App uma vez, conecte o repositório e cada commit é ancorado todas as noites, sem etapas manuais. A verificação é onde você assume o controle — e você tem cinco formas de fazê-la.

1. A página de status pública

Abra https://timestampgit.dev/status/{user}/{repo}. Este painel mostra:

  • a longevidade da prova e a data da âncora mais antiga,
  • a regularidade diária (um mapa de calor em calendário torna as lacunas óbvias),
  • a altura do bloco do Bitcoin e o ID da transação para cada âncora.

É a verificação rápida mais veloz. Se uma contraparte questionar a continuidade, o mapa de calor é a resposta.

2. A página de verificação no navegador

Para um dia específico, acesse https://timestampgit.dev/verification/{user}/{repo}/{date}. Esta página percorre a cadeia de Merkle multinível passo a passo e realiza toda a computação localmente no seu navegador — zero-knowledge. Ninguém vê o que você verifica, o que é útil quando o próprio repositório é confidencial.

Esta é a página a abrir na frente de um auditor, porque cada nível da cadeia é mostrado, não resumido.

3. A API de verificação

Quando a verificação precisa ser automatizada ou arquivada, obtenha a cadeia bruta:

curl -s "https://timestampgit.dev/api/verify/acme-corp/payments-api/2026-10-05" \
  -H "Accept: application/json" | jq .

A resposta contém os dados completos da cadeia de Merkle para o carimbo de data/hora daquele dia, para que você possa recalculá-la localmente em vez de confiar na página renderizada.

4. Selos de verificação

Na página de conexão do repositório, você recebe um selo Shields.io incorporável, além do seu trecho de markdown. Coloque-o no seu README:

[![Timestamped with Bitcoin](BADGE_URL)](BADGE_LINK)

Qualquer pessoa que clicar no selo chega à visualização de verificação do seu repositório. É uma alegação pública e sempre atualizada de prova de existência — e, como o link leva a dados verificáveis em vez de uma imagem estática, não é apenas decoração.

5. Relatórios e exportações de auditoria

Dois endpoints cobrem a parte burocrática:

# Per-day PDF certificate
curl -sL "https://timestampgit.dev/api/report/acme-corp/payments-api/2026-10-05" \
  -o certificate-2026-10-05.pdf

# Full audit ledger as CSV
curl -sL "https://timestampgit.dev/api/audit/acme-corp/payments-api" \
  -o audit-ledger.csv

O PDF é o que você anexa a uma petição judicial. O CSV é o que você insere em um arquivo de auditoria interna ou em uma planilha que entrega a uma equipe de due diligence.

Observe que repositórios privados acrescentam um HMAC criptografado às suas URLs, de modo que apenas usuários autorizados podem abrir suas páginas de status e verificação. A prova por baixo permanece inalterada — ela continua ancorada no Bitcoin e continua verificável por qualquer pessoa que tenha o arquivo de prova.

Interpretando Resultados de Verificação e Casos Limítrofes

Uma verificação bem-sucedida significa uma coisa específica: a raiz de Merkle que você recalculou a partir do manifesto corresponde ao valor ancorado no bloco do Bitcoin referenciado pelo recibo .ots. Essa correspondência prova que o conjunto de hashes de commit existia não depois do carimbo de data/hora daquele bloco. Não importa quem executa a verificação nem onde.

Vale conhecer quatro casos limítrofes antes de prometer a alguém um resultado de verificação:

  • O dia atual provavelmente ainda não é verificável. A ancoragem é executada todas as noites, e a confirmação do Bitcoin leva várias horas (normalmente cerca de 3 horas). Uma prova para os commits de hoje pode ainda não existir, e o lote da noite anterior pode ainda estar pendente de confirmação. Planeje auditorias em torno dessa janela.
  • Repositórios privados exigem o HMAC. A verificação funciona exatamente como para repositórios públicos, mas a URL carrega um HMAC criptografado específico da instância do servidor. Sem HMAC, sem página de status.
  • Um carimbo de data/hora prova existência, não autoria. A prova diz que um hash de commit existia em um momento específico. Ela não estabelece, por si só, quem escreveu o código nem que o código é inédito. Use-a como evidência de anterioridade, não como substituto de uma cadeia de titularidade.
  • Qualquer pessoa pode verificar, mesmo sem o Timestamp GIT. Como a prova é construída sobre padrões abertos, um engenheiro suficientemente motivado pode verificar o arquivo .ots com ferramentas OpenTimestamps padrão contra a blockchain do Bitcoin. Isso é uma vantagem: significa que sua evidência sobrevive ao fornecedor.

Verificando sem o SaaS: Do Jeito Difícil (e Por que Você Não Precisa Disso)

Em princípio, você poderia montar esse pipeline sozinho — executar as ferramentas OpenTimestamps, consultar nós do Bitcoin, reconciliar provas de Merkle manualmente. Na prática, isso significa manter infraestrutura e expertise para uma tarefa que não é o seu produto.

O Timestamp GIT existe para que você não precise fazer isso. Instale o GitHub App uma vez em um repositório monitorado e cada commit é ancorado no Bitcoin automaticamente todas as noites — sem CLI, sem etapas manuais, sem conhecimento de protocolo. A verificação passa a ser um link, um selo ou uma chamada de API. Para organizações que precisam manter tudo em seu próprio hardware, o self-hosting está disponível como imagem Docker:

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 acessível 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 na primeira inicialização.

Automatizando a Verificação no Seu Fluxo de Trabalho

A verificação manual é suficiente para disputas. Para conformidade contínua, automatize-a.

Condicione seu CI/CD ao status da âncora. O endpoint de resumo combinado foi projetado exatamente para isso:

curl -sf "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api" -o summary.json
cat summary.json

Um pequeno script de verificação transforma isso em um portão de build:

import json
import sys
import urllib.request

URL = "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api"

with urllib.request.urlopen(URL) as response:
    summary = json.load(response)

print(json.dumps(summary, indent=2))

# Fail loudly if the summary reports no anchored Bitcoin block yet.
if not any("block" in key.lower() for key in summary):
    sys.exit("No Bitcoin anchor reported for this repository yet.")

Conecte-o a um fluxo de trabalho agendado para que uma âncora ausente se torne um chamado em vez de uma surpresa durante uma auditoria:

name: Timestamp anchor check
on:
  schedule:
    - cron: "0 8 * * *"
  workflow_dispatch:

jobs:
  verify-anchor:
    runs-on: ubuntu-latest
    steps:
      - name: Check anchor status
        run: |
          curl -sf "https://timestampgit.dev/api/statusSummary/${{ github.repository_owner }}/${{ github.event.repository.name }}" \
            -o summary.json
          cat summary.json

Archive as provas em uma agenda. Baixe o CSV de auditoria mensalmente e armazene-o no seu sistema de registros:

curl -sL "https://timestampgit.dev/api/audit/acme-corp/payments-api" \
  -o "audit-ledger-$(date +%Y-%m).csv"

Publique o selo. Custa uma linha no seu README e dá às contrapartes uma forma de autoatendimento para verificar suas alegações.

Se manter o conteúdo do repositório fora do serviço for um requisito, o modo de implantação Enterprise ZK executa uma pequena GitHub Action na sua própria infraestrutura que envia os hashes de commit para a API do Timestamp GIT. A verificação se comporta da mesma forma; apenas o caminho de ingestão muda.

Perguntas Frequentes

Preciso confiar no Timestamp GIT para verificar um carimbo de data/hora? Não. A prova depende exclusivamente de SHA-256 e de dados de blocos do Bitcoin. Você pode verificá-la de forma independente usando o arquivo .ots e ferramentas OpenTimestamps padrão contra a blockchain do Bitcoin, mesmo que o Timestamp GIT não exista mais.

Quanto tempo leva para um carimbo de data/hora de commit se tornar verificável? Após o processo de ancoragem noturno, a prova é gravada no seu repositório. A confirmação do Bitcoin normalmente leva cerca de 3 horas, após as quais o carimbo de data/hora é imutável e verificável.

Posso verificar um carimbo de data/hora de um repositório privado? Sim. Repositórios privados usam um HMAC criptografado anexado à URL, de modo que apenas usuários autorizados podem acessar a página de status e as ferramentas de verificação. A prova subjacente continua ancorada no Bitcoin e pode ser verificada por qualquer pessoa que tenha o arquivo de prova.

Quais ferramentas o Timestamp GIT oferece para verificação? Uma página de status pública, uma página de verificação no navegador que calcula tudo localmente, endpoints de API REST para dados da cadeia de Merkle e relatórios de auditoria, e selos Shields.io incorporáveis. Todas são projetadas para verificação independente sem envolvimento do fornecedor.

Conclusão

A verificação independente é o que separa um carimbo de data/hora de uma alegação de marketing. Com o Timestamp GIT, você obtém a cadeia de provas na página de status, recalcula o caminho de Merkle no seu navegador, automatiza a mesma verificação no CI e exporta um certificado em PDF para o arquivo — tudo sem expor uma única linha de código-fonte.

Se você quer isso rodando nos seus repositórios, o serviço gerenciado é uma configuração única: instale o GitHub App, conecte o repositório e deixe a ancoragem noturna fazer o resto. Para requisitos de rede isolada ou self-hosted, a licença de self-hosting via Docker também cobre esse caminho. Comece em timestampgit.dev e verifique um repositório você mesmo.

Posts relacionados

EU label: AI-generated content