Timestamp GIT

← Todos os artigos

2026-10-21

Como provar a propriedade do código em uma disputa de pagamento com cliente

Como provar a propriedade do código em uma disputa de pagamento com cliente
timestamp git blockchain proof

Como Provar a Propriedade do Código em uma Disputa de Pagamento com um Cliente

Você entregou a build com a funcionalidade completa em uma sexta-feira. Três sprints, quatro meses, uma declaração de escopo assinada. Na segunda-feira o cliente fica em silêncio. Duas semanas depois, o gerente de operações deles escreve: “Nunca recebemos o código final, e o que vimos não funcionou conforme acordado.” Então as faturas param.

Este é o momento que todo freelancer e pequena agência teme, e é exatamente o momento em que saber como provar a propriedade do código durante uma disputa de pagamento com um cliente deixa de ser uma preocupação teórica e se torna a diferença entre receber e dar quatro meses de trabalho como perdidos.

O Pesadelo do Freelancer: Quando um Cliente se Recusa a Pagar

O cenário se repete com regularidade quase mecânica:

  • Você faz o commit final, entrega o acesso e envia a última fatura.
  • O cliente contesta o escopo, alega não entrega ou inventa uma lista de defeitos dois meses após a aprovação.
  • Eles têm um advogado contratado. Você tem uma conta do Gmail e uma página no Notion.

O problema central não é que você esteja errado. É que, sem prova independente do que foi entregue e quando, a disputa se resume a um concurso de credibilidade — e concursos de credibilidade são vencidos por quem tem bolsos mais fundos e melhor documentação.

Timestamp GIT é a rede de segurança automatizada para exatamente essa situação. É um GitHub App: você o instala uma vez em um repositório, e cada commit que você faz é ancorado criptograficamente na blockchain do Bitcoin durante a noite, sem ferramentas de CLI e sem etapas manuais. Você continua trabalhando normalmente; a prova se acumula em segundo plano. Quando uma disputa com o cliente começa, você não discute sobre datas — você entrega um recibo verificável.

Este artigo foca no caso de uso de disputa de pagamento. Para o panorama mais amplo de anterioridade — patent trolls, disputas trabalhistas, defesas de sala limpa — veja nossos posts relacionados no final.

Por Que Evidências Tradicionais Falham em uma Disputa de Pagamento

A maioria dos desenvolvedores presume que seu histórico do Git é prova. Não é, pelo menos não por si só:

  • Datas de commit do Git não são evidências confiáveis. As datas de committer e author são apenas metadados. Qualquer pessoa com acesso de escrita pode reescrever o histórico e, mesmo sem reescrever, um campo de data que um desenvolvedor digitou em sua própria máquina não prova nada para um terceiro.
  • O histórico vive em servidores que você não controla. O GitHub pode ser editado, sofrer force-push ou — no pior caso — perder o acesso completamente se o repositório pertencer ao cliente.
  • Threads de e-mail e logs de chat são fáceis de forjar ou apagar. Um print de uma mensagem do Slack tem muito pouco peso.
  • Logs internos são descartados como autointeressados. Em uma auditoria legal, “nosso próprio banco de dados diz que entregamos” é quase tão persuasivo quanto uma nota escrita à mão.

Tribunais, mediadores e árbitros procuram algo diferente: prova independente e à prova de adulteração que um terceiro possa verificar sem precisar confiar em nenhum dos lados.

É isso que uma âncora no Bitcoin oferece. As provas do Timestamp GIT são ancoradas na blockchain do Bitcoin através do protocolo OpenTimestamps. Uma vez que um hash é confirmado em um bloco, nenhuma entidade na Terra pode alterá-lo ou forjá-lo — incluindo a empresa que opera o serviço. O Timestamp GIT poderia desaparecer amanhã e sua prova ainda seria verificável, offline, por você ou por qualquer outra pessoa.

O Manual: Como se Proteger Antes e Durante uma Disputa

1. Antes do projeto começar: instale o GitHub App

Instale o Timestamp GIT GitHub App no repositório em que você vai trabalhar — seu, ou do cliente com a permissão dele (mais sobre isso nas perguntas frequentes). Essa é toda a configuração. Não há ferramentas de CLI para instalar nas máquinas dos seus desenvolvedores e nenhuma mudança no fluxo de trabalho.

No Modo Padrão, o app lê apenas o hash do commit HEAD dos repositórios monitorados. Ele requer acesso somente leitura ao repositório de origem e acesso leitura-escrita a um repositório de destino, que pode ser o mesmo repositório ou um separado.

2. Durante o projeto: apenas continue fazendo commits

Esta é a parte que importa para uma disputa: suas mensagens de commit são a narrativa da entrega. Referencie o contrato.

git checkout -b feature/checkout-flow

git add .
git commit -m "feat: complete checkout flow per SOW section 4.2"
git push origin feature/checkout-flow

Isso é tudo que você faz de diferente. A cada noite, o Timestamp GIT agrupa os hashes de commit pendentes, cria um manifesto (.txt) para cada repositório, constrói uma árvore de Merkle, gera provas OpenTimestamps usando calendários públicos e ancora a raiz de Merkle no Bitcoin. O manifesto e os arquivos de recibo .ots são enviados de volta ao seu repositório em um branch de timestamps dedicado ou repositório shadow.

Uma coisa a considerar no planejamento: a confirmação do Bitcoin normalmente leva cerca de 3 horas, então os arquivos de prova chegam algumas horas após a execução noturna. Não agende sua entrega para a mesma noite em que você precisa do recibo.

3. Se surgir uma disputa: extraia as evidências

A página de status do seu repositório mostra a longevidade das provas, a data da âncora mais antiga, a regularidade diária e os dados do bloco e da transação do Bitcoin por trás de cada dia. A partir daí, você pode exportar os dois documentos que importam em uma discussão de cobrança:

# Full audit ledger for the whole engagement, as CSV
curl -L "https://timestampgit.dev/api/audit/youruser/client-project" \
  -o audit-ledger.csv

# PDF certificate for one specific delivery date
curl -L "https://timestampgit.dev/api/report/youruser/client-project/2026-10-14" \
  -o certificate-2026-10-14.pdf

O CSV fornece os commits exatos e suas confirmações em blocos do Bitcoin — um registro de entrega data a data. O certificado em PDF empacota o timestamp de um único dia em um documento que você pode anexar a um e-mail ou entregar a um advogado.

4. Apresente as evidências, não discuta sobre elas

Envie os arquivos de recibo .ots e o link de verificação. O ponto é que o cliente — ou o advogado dele — não precisa confiar em você. Ele pode verificar o timestamp de forma independente contra a blockchain do Bitcoin usando ferramentas padrão do OpenTimestamps. O Timestamp GIT também oferece um visualizador web que percorre a cadeia de Merkle multinível passo a passo, computando tudo localmente no seu navegador para que ninguém veja o que você verifica.

5. Para garantia extra: incorpore um selo de verificação

As páginas de status do repositório fornecem selos incorporáveis para o seu README. Um selo visível de “commits ancorados no Bitcoin” sinaliza profissionalismo e avisa discretamente a uma fatura potencialmente contestada que o registro de entrega não é algo sobre o qual se possa discutir com você. As URLs dos selos e trechos de Markdown prontos vêm da página do repositório conectado após a instalação.

O Que Evitar em uma Disputa de Pagamento

  • Não confie apenas no histórico de commits do GitHub. Ele pode ser alterado, e será caracterizado como auto-relatado.
  • Não espere até que uma disputa comece para configurar o timestamping. A prova só é crível se existia antes do conflito — prova retroativa é impossível.
  • Não despeje toda a sua base de código no cliente no meio de uma disputa. O design de conhecimento zero do Timestamp GIT significa que você pode compartilhar as provas de hash e certificados em vez do código-fonte, a menos que um tribunal determine o contrário.
  • Não faça a criptografia por conta própria. Você poderia tentar montar uma cadeia de provas OpenTimestamps manualmente — esse é o caminho difícil, e um único erro no fluxo de trabalho deixa você sem nada. O GitHub App gerenciado cuida da detecção, agrupamento, ancoragem e entrega automaticamente.

Como o Timestamp GIT se Encaixa no Seu Fluxo de Trabalho

Modo Padrão (GitHub App). Instale uma vez, conecte o repositório, pronto. O app detecta novos commits via webhooks, e os hashes pendentes são enfileirados para o worker noturno. Você recebe a entrega automática das provas no seu branch de timestamps sem tocar em nada.

Modo Enterprise ZK. Para equipes que preferem que seus hashes nunca saiam da própria infraestrutura, uma GitHub Action de 12 linhas roda no seu ambiente e envia apenas o hash do commit para a API do Timestamp GIT. Neste modo, nenhum acesso de leitura ao repositório de origem é necessário — você apenas instala a Action.

Auto-hospedado. Para ambientes isolados ou altamente regulados, o Timestamp GIT é distribuído como uma imagem Docker com uma licença de demonstração por tempo limitado disponível através da página de Licença Docker. 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

O app fica então disponí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.

Verificação. Qualquer que seja o modo que você use, a verificação é a mesma: baixe o arquivo .ots e confira-o contra a blockchain do Bitcoin com ferramentas padrão do OpenTimestamps, ou use o visualizador e os relatórios em PDF. A prova se baseia apenas em SHA-256 e dados de blocos do Bitcoin — nenhuma tecnologia proprietária, nenhum aprisionamento tecnológico.

O preço segue o mesmo formato: Open Source é gratuito para repositórios públicos, Pro Agency é $49/mês para repositórios privados, e Enterprise ZK é $199/mês com o fluxo de trabalho da GitHub Action.

Perguntas Frequentes

Posso usar o Timestamp GIT se o cliente for dono do repositório?

Sim. Você pode instalar o GitHub App no repositório do cliente com a permissão dele, ou pode configurar um repositório shadow que você controla. No Modo Padrão, o app precisa de acesso somente leitura ao repositório de origem e acesso leitura-escrita a um repositório de destino (que pode ser o mesmo ou um repositório separado). No Modo Enterprise ZK, uma GitHub Action na sua infraestrutura envia apenas o hash do commit, então nenhum acesso de leitura ao repositório de origem é necessário.

E se o cliente apagar o repositório?

Suas provas estão seguras. O Timestamp GIT envia o manifesto e os arquivos de recibo .ots para um branch de timestamps dedicado ou repositório shadow que você controla. Além disso, o registro na blockchain do Bitcoin é permanente e imutável. Mesmo que o cliente apague o repositório dele, você mantém a prova criptográfica dos seus commits.

Quanto tempo leva para um timestamp ser confirmado?

A confirmação do Bitcoin normalmente leva cerca de 3 horas. O Timestamp GIT agrupa os commits à noite, ancora a raiz de Merkle em uma transação Bitcoin e então grava os arquivos de prova de volta no seu repositório. Você terá um timestamp verificável algumas horas após a execução noturna.

O Timestamp GIT é admissível em tribunal?

O Timestamp GIT fornece evidências prontas para tribunal usando padrões criptográficos globalmente reconhecidos: hashing SHA-256, o protocolo OpenTimestamps e a blockchain do Bitcoin. As provas são imutáveis e verificáveis de forma independente por qualquer pessoa. No entanto, a admissibilidade depende da jurisdição e do contexto legal específico, então consulte um advogado qualificado.

A Conclusão

Uma disputa de pagamento é um problema de documentação muito antes de ser um problema legal. Os desenvolvedores que recebem são aqueles que podem apontar para um registro que nenhum dos lados controla e dizer: aqui está o que existia, e aqui está o bloco que prova isso.

Esse é todo o argumento para instalar o GitHub App antes do seu próximo trabalho, em vez de depois da sua próxima fatura não paga. Leva uma instalação, não muda nada no seu fluxo de trabalho diário e transforma seu histórico normal de commits em evidência com a qual nenhum cliente, advogado ou mediador pode discutir.

Comece com seu próximo repositório — gratuito para repositórios públicos, e alguns minutos de configuração de qualquer forma.

Posts relacionados

EU label: AI-generated content