Configure a Proteção de PI com uma Única Instalação do GitHub App
Você não precisa de um orçamento jurídico, de uma cadeia de ferramentas de CLI nem de mudar a forma como sua equipe escreve código para obter prova criptográfica de que seu repositório existia em um momento específico. Você precisa de uma instalação.
Este guia percorre toda a configuração de um github app para proteção de propriedade intelectual: instale o Timestamp GIT GitHub App, escolha seus repositórios, deixe a automação noturna agrupar os hashes dos seus commits e ancorá-los no Bitcoin, e então confirme que a prova é real. Cada passo abaixo é um clique, uma configuração ou um pequeno arquivo de configuração. Nenhum desenvolvedor da sua equipe digita um novo comando, e nenhum código-fonte sai da sua organização do GitHub.
O que você obtém ao final: um recibo .ots imutável por dia, uma página de status pública respaldada por dados de blocos do Bitcoin, um selo no seu README e um certificado de auditoria em CSV ou PDF que você pode entregar a um advogado ou auditor.
Por que um GitHub App é o Caminho Mais Rápido para a Proteção de PI
O jeito difícil de fazer isso é ancorar os commits manualmente — executando as ferramentas do OpenTimestamps à mão e acompanhando as confirmações do Bitcoin para cada lote. Funciona, mas é propenso a erros, depende de uma pessoa lembrar de fazê-lo e desmorona no momento em que você tem cinco desenvolvedores e cem commits por dia.
O jeito gerenciado é uma única instalação do GitHub App. O Timestamp GIT fica sobre as mesmas primitivas criptográficas, mas esconde o protocolo por trás da automação:
- Instale uma vez. Sem CLI, sem ferramentas locais, nada para instalar nas máquinas dos desenvolvedores.
- Detecção automática. Todo novo commit em um repositório monitorado é capturado via webhooks.
- Ancoragem noturna. Os hashes são agrupados à meia-noite, organizados em uma raiz de Merkle e ancorados no Bitcoin por meio do OpenTimestamps.
- Entregue de volta para você. Os manifestos e recibos
.otschegam a um branch dedicado ou a um repositório sombra separado. - Zero-knowledge. Apenas hashes de commits são processados. Seu código-fonte nunca é lido, copiado ou armazenado.
Se você quiser o contexto estratégico sobre por que isso importa legalmente antes de começar a clicar, leia Prove Prior Art Before You File: A Founder’s Guide. Este artigo se concentra na configuração.
Pré-requisitos: O Que Você Precisa Antes de Começar
- Uma conta do GitHub com direitos de administrador no repositório — ou na organização — que você quer proteger. Você não pode instalar um GitHub App em um repositório no qual tem apenas acesso de escrita.
- Uma conta no Timestamp GIT. O nível Open Source é gratuito para repositórios públicos; repositórios privados exigem um plano pago.
- Um modelo mental básico de Git. Você deve saber que um commit tem um hash SHA-1 ou SHA-256. Esse é o limite do conhecimento de criptografia necessário.
- Uma decisão sobre onde as provas ficam. No mesmo repositório, em um branch dedicado, ou em um repositório sombra separado. Um repositório sombra mantém seu repositório principal limpo, mas exige um repositório de destino ao qual você possa conceder acesso de escrita.
- Opcional: Docker. Apenas se você planeja hospedar por conta própria mais tarde — abordado em uma seção posterior.
Passo 1: Instale o Timestamp GIT GitHub App
- Acesse timestampgit.dev e entre com o GitHub.
- Clique em Install GitHub App.
- Escolha All repositories ou Only select repositories e selecione os repositórios que deseja monitorar.
- Revise as permissões que o GitHub exibe. No modo padrão, o app precisa de:
- Acesso somente leitura aos seus repositórios de origem — o GitHub não oferece acesso apenas a hashes de commits, então o acesso de leitura é o mínimo.
- Acesso de leitura e escrita a um repositório de destino onde as provas são gravadas.
- Confirme. Você chega ao painel com seus repositórios conectados listados.
Você pode revisitar e alterar a seleção de repositórios a qualquer momento na página de configurações do GitHub App; o app não exige reinstalação para captar repositórios recém-adicionados.
Passo 2: Configure as Definições do Seu Repositório
Selecione o repositório que você acabou de conectar. Duas decisões importam aqui:
Para onde vão as provas? Para um branch timestamps dedicado no mesmo repositório, ou para um repositório sombra separado. Se você está registrando o timestamp de um repositório que planeja tornar open-source mais tarde, um repositório sombra mantém o histórico de provas fora da árvore pública até você querer que ele fique visível.
Quando a ancoragem é executada? Noturnamente à meia-noite é o padrão e a configuração recomendada — agrupar muitos commits em uma única raiz de Merkle é o que torna as provas diárias baratas e consistentes. Deixar o agendamento como está é quase sempre a escolha certa.
Em seguida, copie o código de incorporação do seu selo. Abra a página do repositório conectado (/connected/{user}/{repo}) para uma prévia ao vivo do selo de verificação Shields.io e o Markdown exato para colar.
Uma observação sobre privacidade: as URLs de status para repositórios privados carregam um HMAC criptografado específico da sua instância do servidor, então apenas usuários autorizados podem ler o status de um repositório privado. Não remova esse parâmetro ao copiar uma URL.
Salve as configurações. Os hashes de commits começam a fluir para a fila imediatamente.
Passo 3: Deixe a Automação Rodar
Não há nada a fazer aqui além de enviar código. Nos bastidores:
- Detecção de commits — o GitHub App vê novos commits via webhooks.
- Fila de hashes — os hashes de commits se acumulam em um armazenamento chave-valor em memória para agrupamento.
- Worker cron da meia-noite — um worker agrupa todos os hashes pendentes, grava um arquivo de manifesto em texto por repositório, constrói uma árvore de Merkle nativamente, gera provas do OpenTimestamps contra calendários públicos do OTS e ancora a raiz de Merkle no Bitcoin.
- Entrega das provas — o manifesto e os arquivos de recibo
.otssão enviados de volta ao seu branch de timestamps ou repositório sombra.
Considere a janela de confirmação do Bitcoin. O lote é enviado à meia-noite, mas a inclusão em um bloco normalmente leva cerca de três horas. Na prática, as provas de um commit enviado hoje ficam disponíveis amanhã de manhã.
De novo sobre o ponto zero-knowledge, porque é o que os auditores perguntam: o serviço só lida com hashes de commits. Seu diff, seus arquivos, seus segredos — nada disso é transmitido.
Passo 4: Adicione o Selo de Verificação ao Seu README
Cole o trecho da página do repositório conectado no seu README. Ele se parece mais ou menos com isto — use a URL exata que o app fornece, não o placeholder:
<!-- Copy the real snippet from timestampgit.dev/connected/{user}/{repo} -->
[](https://timestampgit.dev/status/your-user/your-repo)
Qualquer pessoa que clicar chega à página de status pública e pode reverificar o timestamp a partir do arquivo .ots por conta própria. Esse caminho público de verificação por clique é o que transforma uma alegação proprietária em evidência que um terceiro aceitará.
Como Confirmar Que Funcionou
Dê uma noite e depois verifique três coisas.
1. A página de status do repositório. Abra /status/{user}/{repo}. Você deve ver a longevidade das provas, a data da âncora mais antiga, a regularidade diária, os dados do bloco e da transação do Bitcoin para cada âncora e um mapa de calor do calendário. Uma lacuna no mapa de calor significa um dia sem commits — não uma falha.
2. A API, se você quiser isso em um painel.
# Last anchored Bitcoin block
curl https://timestampgit.dev/api/statusLast/your-user/your-repo
# Total stamped commit count
curl https://timestampgit.dev/api/statusCount/your-user/your-repo
# Full audit ledger as CSV
curl -O https://timestampgit.dev/api/audit/your-user/your-repo
3. Um certificado em PDF para uma data específica. Baixe-o para qualquer dia ancorado:
curl -O https://timestampgit.dev/api/report/your-user/your-repo/2026-11-19
Para o passo a passo completo de como é, na prática, a verificação de uma cadeia de Merkle — tudo calculado localmente no seu navegador — veja How to Verify a Bitcoin Timestamp Proof for Your Code. A versão curta: o arquivo .ots e o manifesto são provas padrão do OpenTimestamps, verificáveis contra os dados de blocos do Bitcoin por qualquer ferramenta compatível. Sem aprisionamento tecnológico, sem dependência de nós continuarmos no negócio.
Opcional: Auto-hospedagem com Docker para Ambientes Air-Gapped
Para controle máximo — ambientes regulados, redes air-gapped ou equipes que querem o serviço na própria infraestrutura — 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
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.
Para avaliá-lo, solicite uma licença de demonstração por tempo limitado na página de Licença Docker com seu nome, empresa, e-mail e telefone opcional; você recebe um arquivo de licença para baixar. A auto-hospedagem significa gerenciar seu próprio GitHub App e infraestrutura, mas as garantias zero-knowledge são idênticas.
Solução de Problemas Comuns de Configuração
- A instalação falha ou as permissões parecem erradas. Você precisa de direitos de administrador no repositório ou na organização, e no modo padrão o app também deve receber acesso ao repositório de destino onde as provas são gravadas. Um repositório de destino ausente é a causa mais comum de “conectado, mas nada acontecendo”.
- Nenhuma prova após 24 horas. Confirme se o repositório está de fato recebendo commits e se o app não foi pausado do lado do GitHub. Verifique a página de status em busca de erros antes de abrir qualquer chamado — um repositório ocioso não produz manifesto, o que é o comportamento esperado.
- O selo aparece como uma imagem quebrada. Copie novamente a URL do selo na página do repositório conectado. Para repositórios privados, a URL deve incluir o HMAC criptografado; uma URL truncada falhará.
- A âncora está atrasada. Os tempos de bloco do Bitcoin variam. Uma confirmação atrasada ainda ancora — uma vez que o bloco existe, a prova é imutável. Nada precisa ser executado novamente.
- As provas aparecem em um lugar inesperado. Verifique se o repositório está configurado para um branch no mesmo repositório ou para um repositório sombra; alternar os modos não reescreve provas históricas.
Perguntas Frequentes
Preciso mudar meu fluxo de trabalho com Git para usar o Timestamp GIT? Não. Uma vez instalado o GitHub App, ele detecta automaticamente novos commits e os ancora à noite. Os desenvolvedores continuam usando o Git normalmente — sem novos comandos ou ferramentas para aprender.
Quais permissões do GitHub o Timestamp GIT exige? No modo padrão, o app precisa de acesso somente leitura aos seus repositórios de origem (para ler hashes de commits) e acesso de leitura e escrita a um repositório de destino onde as provas são armazenadas. O modo Enterprise ZK inverte isso com uma GitHub Action que envia apenas o hash do commit a partir da sua própria infraestrutura, de modo que o serviço não precisa de nenhum acesso de leitura ao repositório de origem.
Quanto tempo leva para um commit receber timestamp no Bitcoin? Os hashes de commits são agrupados e ancorados uma vez por dia, à meia-noite. Depois que o lote é enviado à blockchain do Bitcoin via OpenTimestamps, a confirmação normalmente leva cerca de 3 horas — então as provas geralmente ficam disponíveis na manhã seguinte.
Posso verificar a prova de timestamp de forma independente, sem o Timestamp GIT?
Sim. O arquivo de recibo .ots e o manifesto são provas padrão do OpenTimestamps. Você pode verificá-los usando qualquer ferramenta compatível com OpenTimestamps contra a blockchain do Bitcoin, garantindo independência de fornecedor.
A Instalação É o Projeto Inteiro
Uma instalação do GitHub App, uma seleção de repositório, uma página de configurações. Depois disso, a proteção de PI se torna uma propriedade de fundo do seu repositório em vez de uma tarefa trimestral: todo hash de commit agrupado à noite, todo lote com raiz de Merkle ancorada em um bloco do Bitcoin, toda prova gravada de volta em um branch que você controla e verificável por qualquer pessoa com o arquivo .ots.
Esse é o custo total de adoção. Se você vem adiando a proteção de anterioridade porque ela parecia um processo jurídico com uma taxa de engenharia acoplada, comece com o nível Open Source gratuito em um repositório público hoje e veja a primeira prova chegar amanhã de manhã — comece aqui. Para equipes que primeiro avaliam o panorama de ferramentas, Best Tools to Timestamp Source Code for Auditors compara as opções.
Posts relacionados
- How to Verify a Bitcoin Timestamp Proof for Your Code
- Prove Prior Art Before You File: A Founder’s Guide
- Best Tools to Timestamp Source Code for Auditors