Timestamp GIT

← Todos os artigos

2026-10-14

Como Freelancers Podem Provar a Propriedade do Código Antes de uma Disputa

Como Freelancers Podem Provar a Propriedade do Código Antes de uma Disputa
timestamp git blockchain proof

Como Freelancers Podem Provar a Propriedade do Código Antes de uma Disputa

Mira entrega uma biblioteca billing-utils para um cliente em março. Marco aprovado, fatura paga, arquivos do Figma arquivados. A vida segue.

Oito meses depois, ela está rolando o changelog de um concorrente e vê: o mesmo backoff de retry com jitter, o mesmo tratamento estranho de casos extremos para reembolsos parciais, os mesmos nomes de função que ela escolheu às 2 da manhã porque eram curtos. Prefixos de variáveis diferentes, mesma lógica.

Ela abre o laptop para verificar. A pasta .git local tem os commits — mas é o laptop dela. O repositório dela no GitHub mostra as datas dos commits, mas elas ficam em um servidor que ela não controla e podem ser reescritas por qualquer pessoa com um token de admin. As mensagens dela no Slack com o cliente provam que ela entregou algo, não o que havia dentro.

Esse é o dilema do freelancer em uma cena: o trabalho é inegavelmente seu, e ainda assim não existe um artefato que um advogado, um árbitro ou um juiz trataria como evidência.

Este artigo é sobre fechar essa lacuna antes que a disputa comece. Porque a verdade honesta é que, uma vez que um concorrente tem a sua lógica no repositório dele, a única coisa que importa é o que você consegue provar sobre uma data no passado.

O Problema Real: “Ele Disse, Ela Disse” Com Etapas Extras

Disputas de código freelance raramente se parecem com uma revelação dramática em um tribunal. Elas se parecem com isto:

  • Um cliente alega que um marco não foi entregue no prazo, então retém o pagamento final.
  • Um ex-cliente lança um produto quase idêntico e chama isso de “desenvolvimento independente.”
  • Uma biblioteca que você publicou no GitHub aparece, sem atribuição, dentro do SaaS comercial de alguém.
  • O novo desenvolvedor interno de um ex-cliente “reescreve” o seu módulo e o novo histórico de commits começa do zero, sem nenhum link de volta para o seu trabalho.

Em todos os casos, a pergunta não é “você escreveu isto?” É “você consegue provar que isto existia em uma data específica, sem depender de um sistema que o outro lado também controla?”

Logs locais do Git, threads de e-mail, capturas de tela e timestamps do Google Drive compartilham uma propriedade fatal: eles podem ser editados, forjados ou simplesmente descartados como interesse próprio. É por isso que a anterioridade criptográfica existe — a mesma ideia abordada em O Que É Anterioridade Criptográfica? Um Guia para Equipes de Software. Se você quer todo o contexto conceitual, leia aquele. Aqui, ficamos no prático.

O objetivo de tentar proteger código freelance contra plágio não é sigilo. Você não está escondendo nada. É sobre produzir uma resposta matematicamente verificável para uma única pergunta: este código exato existia neste momento exato?

A resposta prática em 2026 é o Timestamp GIT: um GitHub App que ancora automaticamente os hashes dos seus commits na blockchain do Bitcoin toda noite. Sem rituais de CLI, sem teoria de blockchain, sem mudanças na forma como você escreve código. Você instala uma vez, e a prova de autoria existente se acumula enquanto você dorme.

Por Que Freelancers Estão Singularmente Expostos

Agências têm contratos revisados por advogados. Empresas têm portfólios de patentes e uma equipe de compliance. Freelancers têm uma pasta chamada contracts/ e uma vaga lembrança de um PDF.

Essa assimetria cria quatro riscos específicos:

Sem departamento jurídico. Você não consegue justificar um pedido de patente de $15.000 para um módulo utilitário, e definitivamente não consegue financiar dois anos de litígio. O que você precisa é de evidência barata e de alta confiabilidade criada como efeito colateral do trabalho normal — não uma estratégia jurídica que você tem que financiar antecipadamente.

Evidência frágil. Em uma disputa, o advogado do outro lado vai fazer uma pergunta: “Quem controla este log?” Se a resposta for “o reclamante”, o peso probatório cai. As datas de commit do GitHub são mutáveis; um dono de repositório com o token certo pode reescrever o histórico. Registros internos são caracterizados como interesse próprio.

Risco de portfólio e biblioteca. Freelancers reutilizam. Um helper de date-picker, um esquema de numeração de faturas, um wrapper de retry — esses viajam de projeto em projeto. Quando ressurgem sem atribuição no produto de outra pessoa, você não tem mecanismo para estabelecer prioridade. A atribuição no GitHub é uma convenção social, não legal.

Disputas com clientes sobre datas de entrega. “Nunca recebemos o código até o dia 14” é uma frase cara quando a sua fatura diz dia 3. Um histórico de commits verificado por marco e ancorado criptograficamente encerra essa discussão com uma captura de tela.

Seu Manual Pré-Disputa

Aqui está a checklist. Leva cerca de dez minutos para configurar, e depois roda sozinha.

Passo 1 — Instale o GitHub App

Instale o GitHub App do Timestamp GIT nos repositórios que você quer proteger. No Modo Standard, o App tem acesso somente leitura ao seu repositório de origem e acesso leitura-escrita a um repositório de destino dedicado (ou um branch timestamps dedicado no mesmo repositório). Os artefatos de prova ficam lá, separados do seu histórico de trabalho.

Isso significa que o App lê apenas o hash do commit HEAD do seu repositório monitorado. Ele não precisa copiar sua árvore de código para lugar nenhum.

Se você trabalha em repositórios de propriedade do cliente onde não pode conceder nem acesso de leitura, é para isso que serve o Modo Enterprise ZK — mais sobre isso abaixo.

Passo 2 — Continue Commitando Como Você Sempre Faz

Sem novos comandos. Sem hooks de pre-commit para lembrar. Sem “eu carimbei este?”

Uma vez que o App está instalado, ele detecta novos commits via webhooks e enfileira os hashes dos commits para processamento. A granularidade dos commits segue o seu fluxo natural de trabalho — incluindo os commits bagunçados, os fixups e os “wip” que você faz squash depois. Todos eles são timestamps de código que existiu.

Passo 3 — Deixe a Ancoragem Noturna Acontecer

Toda noite, um worker cron coleta os hashes pendentes, agrupa-os e, para cada repositório, gera um arquivo de manifesto (.txt) contendo os hashes de commit daquele dia. Ele constrói uma árvore de Merkle sobre eles e ancora a raiz de Merkle na blockchain do Bitcoin usando o protocolo OpenTimestamps através de calendários OTS públicos.

Como é em lote, o custo e a pegada on-chain permanecem minúsculos, não importa quantos commits você faça push em um dia. Como é noturno e automático, você não pode esquecer — que é o maior modo de falha de qualquer rotina manual de timestamping.

Observe o timing: a confirmação do Bitcoin normalmente leva cerca de três horas, então os arquivos de prova são gravados de volta algumas horas depois que o job noturno roda. Nada para você fazer.

Passo 4 — Pegue Seus Recibos

O manifesto e os arquivos de recibo .ots correspondentes são enviados de volta para o seu repositório de destino — um branch timestamps dedicado ou um repositório sombra. Esse é o seu pacote de evidências:

  • O manifesto .txt listando os hashes de commit do dia
  • Um ou mais arquivos de recibo .ots que vinculam esse manifesto a um bloco do Bitcoin
  • Um caminho de volta para o bloco e a transação específicos

Você pode regenerar o hash do manifesto você mesmo a partir da lista de commits, o que significa que você não está confiando em uma caixa preta. A prova repousa em SHA-256 e dados de blocos do Bitcoin, não em um formato proprietário.

Passo 5 — Prove Publicamente

Incorpore um selo de verificação no seu README. O selo leva a uma página pública de verificação do seu repositório, mostrando a longevidade da prova, a data da ancoragem mais antiga, a regularidade diária e os dados do bloco e da transação do Bitcoin por trás delas.

Plagiadores escolhem alvos fáceis. Um repositório cujo README exibe um histórico de ancoragem ao vivo e verificável de forma independente não é um alvo fácil. Também é um bom sinal de portfólio para clientes em potencial: seu trabalho carrega uma cadeia de prova, não apenas um grafo de commits.

Você pode pegar a marcação do selo na página conectada do seu repositório ou via API:

curl -s "https://timestampgit.dev/api/statusSummary/your-user/your-repo"

Repositórios privados acrescentam um HMAC criptografado às suas URLs de status, então apenas usuários autorizados podem inspecioná-los — o selo em si é público, as estatísticas subjacentes são restritas à instância.

O Que Evitar

Não confie apenas em logs do Git ou datas de commit hospedadas. Elas vivem em máquinas e contas que você não controla exclusivamente, e um oponente determinado pode editá-las ou renegá-las. São úteis como contexto, não como prova.

Não faça a criptografia por conta própria. Rodar ferramentas brutas do OpenTimestamps e ficar movendo arquivos .ots manualmente é o caminho difícil — exige expertise, é fácil errar, e um passo perdido invalida a cadeia. O Timestamp GIT existe exatamente para automatizar isso. Você ainda pode verificar provas localmente com ferramentas padrão, o que é abordado em Como Verificar Independentemente um Timestamp de Commit do Git — mas você não deveria ter que construí-las.

Não espere pela disputa. Um timestamp é uma fotografia do passado. Não pode ser tirada retroativamente. Se você está lendo isto porque algo já deu errado, instale o App hoje para que os próximos seis meses estejam cobertos, e verifique se o seu trabalho anterior está em um repositório monitorado.

Não envie seu código-fonte para um serviço de timestamping. Alguns serviços pedem acesso amplo ao repositório. Você não precisa disso. A arquitetura do Timestamp GIT é zero-knowledge: ele processa hashes de commit, nunca o seu código. No modo Enterprise ZK, até o hash é enviado de fora da sua própria infraestrutura via uma GitHub Action de 12 linhas, e o serviço nunca tem acesso de leitura ao repositório de origem.

Não faça timestamp uma vez e considere pronto. Uma única prova protege um único momento. O valor para um freelancer vem da continuidade: um histórico de ancoragem diário que mostra o código evoluindo sob suas mãos ao longo dos meses.

Como Funciona, Concretamente

Dois Modos de Implantação

Modo Standard — o GitHub App. O App lê apenas o hash do commit HEAD do seu repositório monitorado, e então grava artefatos de prova em um branch separado ou repositório sombra. Em termos de permissão, você concede somente leitura na origem e leitura-escrita no destino — o que espelha como o sistema de permissões do GitHub funciona, já que não existe uma concessão apenas de hash de commit.

Modo Enterprise ZK — a GitHub Action. Um workflow curto roda nos seus próprios runners e envia apenas o hash do commit para a API do Timestamp GIT. O serviço precisa de acesso leitura-escrita apenas ao repositório de destino, e nenhum à origem. Sua origem nunca sai do seu ambiente. Este é o modo que importa para repositórios de propriedade do cliente sob termos estritos de confidencialidade ou para configurações on-premises.

O Pipeline, de Ponta a Ponta

  1. Detecção de commits — o App captura novos commits por webhook, ou sua Action envia hashes diretamente.
  2. Fila de hashes — os hashes ficam em um armazenamento chave-valor em memória aguardando a janela de lote.
  3. Cron noturno — hashes pendentes são agrupados, manifestos por repositório são construídos, uma árvore de Merkle é montada, provas OTS são criadas contra calendários públicos, e a raiz de Merkle é ancorada no Bitcoin.
  4. Entrega de provas — manifestos e recibos .ots são commitados de volta no seu repositório de destino algumas horas depois, quando a transação do Bitcoin confirma.

Caminhos de Verificação

Três formas de provar uma data, em ordem crescente de cerimônia:

  • Dashboard público — https://timestampgit.dev/status/{user}/{repo} para uma visão rápida das ancoragens, data mais antiga e regularidade, com um CSV de auditoria e certificado PDF para download.
  • Verificação no navegador — https://timestampgit.dev/verification/{user}/{repo}/{date} percorre a cadeia de Merkle multinível passo a passo. Toda a computação acontece localmente no seu navegador; ninguém — incluindo nós — vê o que você verifica.
  • Verificação local — baixe o arquivo .ots e confira-o contra os dados do bloco do Bitcoin com ferramentas padrão do OpenTimestamps. Sem vendor lock-in.

Para workflows orientados por API, tudo o que você precisa é um GET simples:

# Qual é o último bloco do Bitcoin ancorado para este repositório?
curl -s "https://timestampgit.dev/api/statusLast/your-user/your-repo"

# Dados completos da cadeia de Merkle para um dia específico
curl -s "https://timestampgit.dev/api/verify/your-user/your-repo/2026-10-01"

# Baixe o livro-razão de auditoria completo como CSV
curl -s -o audit.csv "https://timestampgit.dev/api/audit/your-user/your-repo"

Esse CSV é o artefato que você entrega a um advogado. Também é o artefato que você anexa a um e-mail de marco quando um cliente fica em silêncio sobre uma fatura.

Docker Auto-Hospedado: Controle Máximo

Alguns freelancers trabalham sob NDAs que tornam qualquer SaaS de terceiros inviável, ou operam em ambientes genuinamente air-gapped. Para esses casos, o Timestamp GIT está disponível como imagem Docker com licença auto-hospedada.

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 guia você pela conexão do seu GitHub App e configuração da instância.

Para avaliar antes de se comprometer, 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. O arquivo de licença é baixável imediatamente.

FAQ

Preciso mudar meu fluxo de trabalho do Git para usar o Timestamp GIT? Não. Uma vez que você instala o GitHub App, todo commit em um repositório monitorado é automaticamente ancorado no Bitcoin toda noite. Você continua trabalhando como de costume — sem ferramentas de CLI, sem passos manuais.

Posso provar a propriedade se já entreguei o código a um cliente? Sim, desde que você tenha commitado o código em um repositório monitorado pelo Timestamp GIT antes da disputa. O recibo .ots e o timestamp do bloco do Bitcoin servem como prova imutável de existência naquela data.

E se o cliente alegar que escreveu o código? Sua prova criptográfica — ancorada na blockchain do Bitcoin — demonstra matematicamente que o seu hash de commit existia em um momento específico, tornando extremamente difícil para qualquer um alegar que escreveu primeiro.

Meu código-fonte está seguro com o Timestamp GIT? Sim. O Timestamp GIT usa uma arquitetura zero-knowledge: ele processa apenas hashes de commit, nunca o seu código-fonte real. No modo Enterprise ZK, até o hash é enviado da sua própria infraestrutura.

Quanto custa? O nível Open Source é gratuito para repositórios públicos. O Pro Agency custa $49/mês e cobre repositórios privados — o plano relevante para a maioria dos freelancers. O Enterprise ZK custa $199/mês. Detalhes estão na página de preços.

Comece Antes de Precisar

A aritmética desconfortável das disputas de código freelance é que a evidência só existe se você a criou na época. Você não pode provar retroativamente que uma função existia em março. Você só pode provar que ela existia a partir do momento em que você começou a ancorar.

Instale o GitHub App, conecte os repositórios que guardam suas bibliotecas reutilizáveis e entregas de clientes, e deixe o job noturno fazer o resto. Em um mês você terá um registro contínuo de autoria ancorado no Bitcoin. Em um ano, você terá algo com que nenhum concorrente pode discutir e nenhum cliente pode reescrever.

Dez minutos agora versus uma briga de “ele disse, ela disse” depois. Essa é toda a troca.

Posts relacionados

EU label: AI-generated content