Cómo los freelancers pueden demostrar la propiedad del código antes de una disputa
Mira entrega una librería billing-utils a un cliente en marzo. Hito aprobado, factura pagada, archivos de Figma archivados. La vida sigue.
Ocho meses después, mientras revisa el changelog de un competidor, lo ve: el mismo backoff con reintentos y jitter, el mismo manejo peculiar de casos límite para reembolsos parciales, los mismos nombres de funciones que eligió a las 2 de la mañana porque eran cortos. Prefijos de variables distintos, misma lógica.
Abre su portátil para comprobarlo. Su carpeta local .git tiene los commits, pero es su portátil. Su repositorio de GitHub muestra fechas de commit, pero esas viven en un servidor que no controla y que cualquiera con un token de administrador puede reescribir. Sus mensajes de Slack con el cliente demuestran que entregó algo, no lo que había dentro.
Ese es el dilema del freelancer en una sola escena: el trabajo es indiscutiblemente tuyo, y sin embargo no existe ningún artefacto que un abogado, un árbitro o un juez trataría como prueba.
Este artículo trata de cerrar esa brecha antes de que empiece la disputa. Porque la verdad incómoda es que, una vez que un competidor tiene tu lógica en su repositorio, lo único que importa es lo que puedas demostrar sobre una fecha del pasado.
El problema real: “él dijo, ella dijo” con pasos extra
Las disputas de código freelance rara vez se parecen a una revelación dramática en una sala de tribunal. Se parecen a esto:
- Un cliente afirma que un hito no se entregó a tiempo, así que retiene el pago final.
- Un antiguo cliente lanza un producto casi idéntico y lo llama “desarrollo independiente”.
- Una librería que publicaste en GitHub aparece, sin atribución, dentro del SaaS comercial de alguien.
- El nuevo desarrollador interno de un antiguo cliente “reescribe” tu módulo y el nuevo historial de commits empieza de cero, sin ningún vínculo con tu trabajo.
En todos los casos, la pregunta no es “¿escribiste esto?”. Es “¿puedes demostrar que esto existía en una fecha concreta, sin depender de un sistema que la otra parte también controla?”
Los logs locales de Git, los hilos de correo, las capturas de pantalla y las marcas de tiempo de Google Drive comparten una propiedad fatal: se pueden editar, falsificar o simplemente descartar por interesados. Por eso existe la prueba de anterioridad criptográfica — la misma idea que se cubre en ¿Qué es la prueba de anterioridad criptográfica? Una guía para equipos de software. Si quieres el contexto conceptual completo, lee ese artículo. Aquí nos mantenemos en lo práctico.
El objetivo de intentar proteger el código freelance del plagio no es el secreto. No estás ocultando nada. Se trata de producir una respuesta verificable matemáticamente a una sola pregunta: ¿existía este código exacto en este momento exacto?
La respuesta práctica en 2026 es Timestamp GIT: una GitHub App que ancla automáticamente tus hashes de commit en la blockchain de Bitcoin cada noche. Sin rituales de CLI, sin teoría de blockchain, sin cambios en cómo escribes código. La instalas una vez, y la prueba de autoría existente se acumula mientras duermes.
Por qué los freelancers están especialmente expuestos
Las agencias tienen contratos revisados por abogados. Las empresas tienen carteras de patentes y un equipo de cumplimiento. Los freelancers tienen una carpeta llamada contracts/ y un recuerdo vago de un PDF.
Esa asimetría crea cuatro riesgos específicos:
Sin departamento legal. No puedes justificar un registro de patente de 15.000 $ para un módulo utilitario, y desde luego no puedes financiar dos años de litigio. Lo que necesitas es evidencia barata y de alta garantía, creada como efecto secundario del trabajo normal — no una estrategia legal que tengas que financiar por adelantado.
Evidencia frágil. En una disputa, el abogado de la otra parte hará una pregunta: “¿Quién controla este log?”. Si la respuesta es “el demandante”, el peso probatorio cae. Las fechas de commit de GitHub son mutables; un propietario de repositorio con el token adecuado puede reescribir el historial. Los registros internos se caracterizan como interesados.
Riesgo de portafolio y librerías. Los freelancers reutilizan. Un helper de selector de fechas, un esquema de numeración de facturas, un wrapper de reintentos — viajan de proyecto en proyecto. Cuando reaparecen sin atribución en el producto de otra persona, no tienes ningún mecanismo para establecer prioridad. La atribución en GitHub es una convención social, no legal.
Disputas con clientes sobre fechas de entrega. “Nunca recibimos el código hasta el día 14” es una frase cara cuando tu factura dice el día 3. Un historial de commits verificado por hitos y anclado criptográficamente termina esa discusión con una sola captura de pantalla.
Tu manual previo a la disputa
Aquí está la lista de comprobación. Tarda unos diez minutos en configurarse, y luego se ejecuta solo.
Paso 1 — Instala la GitHub App
Instala la GitHub App de Timestamp GIT en los repositorios que quieras proteger. En el Modo Estándar, la App tiene acceso de solo lectura a tu repositorio de origen y acceso de lectura-escritura a un repositorio de destino dedicado (o a una rama timestamps dedicada en el mismo repositorio). Los artefactos de prueba aterrizan ahí, separados de tu historial de trabajo.
Eso significa que la App solo lee el hash del commit HEAD de tu repositorio monitorizado. No necesita copiar tu árbol de código fuente a ningún sitio.
Si trabajas en repositorios propiedad del cliente donde no puedes conceder ni siquiera acceso de lectura, para eso está el Modo Enterprise ZK — más sobre esto abajo.
Paso 2 — Sigue haciendo commits como siempre
Sin comandos nuevos. Sin hooks de pre-commit que recordar. Sin “¿habré sellado este?”.
Una vez instalada la App, detecta nuevos commits mediante webhooks y pone en cola los hashes de commit para su procesamiento. La granularidad de los commits sigue tu flujo de trabajo natural — incluidos los commits desordenados, los fixups y los “wip” que luego aplastas. Todos ellos son sellos de tiempo de código que existió.
Paso 3 — Deja que ocurra el anclaje nocturno
Cada noche, un worker cron recoge los hashes pendientes, los agrupa y, para cada repositorio, genera un archivo manifiesto (.txt) que contiene los hashes de commit de ese día. Construye un árbol de Merkle sobre ellos y ancla la raíz de Merkle en la blockchain de Bitcoin usando el protocolo OpenTimestamps a través de calendarios OTS públicos.
Como va por lotes, el coste y la huella on-chain se mantienen mínimos sin importar cuántos commits subas en un día. Como es nocturno y automático, no puedes olvidarlo — que es el mayor modo de fallo de cualquier rutina de sellado de tiempo manual.
Fíjate en el timing: la confirmación de Bitcoin normalmente tarda unas tres horas, así que los archivos de prueba se escriben de vuelta unas horas después de que se ejecute el trabajo nocturno. Nada que tengas que hacer tú.
Paso 4 — Recoge tus recibos
El manifiesto y los archivos de recibo .ots correspondientes se suben de vuelta a tu repositorio de destino — una rama timestamps dedicada o un repositorio en la sombra. Ese es tu paquete de evidencia:
- El manifiesto
.txtque lista los hashes de commit del día - Uno o más archivos de recibo
.otsque vinculan ese manifiesto a un bloque de Bitcoin - Una ruta de vuelta al bloque y la transacción específicos
Puedes regenerar el hash del manifiesto tú mismo a partir de la lista de commits, lo que significa que no estás confiando en una caja negra. La prueba se apoya en SHA-256 y en los datos de bloques de Bitcoin, no en un formato propietario.
Paso 5 — Demuéstralo públicamente
Incrusta una insignia de verificación en tu README. La insignia enlaza a una página de verificación pública de tu repositorio, que muestra la longevidad de la prueba, la fecha de anclaje más temprana, la regularidad diaria y los datos del bloque y la transacción de Bitcoin que hay detrás.
Los plagiarios eligen objetivos blandos. Un repositorio cuyo README muestra un historial de anclajes vivo y verificable de forma independiente no es un objetivo blando. También es una buena señal de portafolio para clientes potenciales: tu trabajo lleva una cadena de prueba, no solo un grafo de commits.
Puedes obtener el marcado de la insignia desde la página conectada de tu repositorio o vía la API:
curl -s "https://timestampgit.dev/api/statusSummary/your-user/your-repo"
Los repositorios privados añaden un HMAC cifrado a sus URLs de estado, de modo que solo los usuarios autorizados pueden inspeccionarlos — la insignia en sí es pública, las estadísticas subyacentes están acotadas a la instancia.
Qué evitar
No te fíes solo de los logs de Git ni de las fechas de commit alojadas. Viven en máquinas y cuentas que no controlas en exclusiva, y un oponente decidido puede editarlas o repudiarlas. Son útiles como contexto, no como prueba.
No implementes la criptografía a mano. Ejecutar las herramientas de OpenTimestamps en bruto y mover archivos .ots a mano es el camino difícil — requiere experiencia, es fácil equivocarse y un solo paso omitido invalida la cadena. Timestamp GIT existe precisamente para automatizar eso. Aun así puedes verificar las pruebas localmente con herramientas estándar, lo cual se cubre en Cómo verificar de forma independiente un sello de tiempo de commit de Git — pero no deberías tener que construirlas.
No esperes a la disputa. Un sello de tiempo es una fotografía del pasado. No se puede tomar de forma retroactiva. Si estás leyendo esto porque algo ya salió mal, instala la App hoy para que los próximos seis meses queden cubiertos, y comprueba si tu trabajo anterior está en un repositorio monitorizado.
No envíes tu código fuente a un servicio de sellado de tiempo. Algunos servicios piden acceso amplio al repositorio. No lo necesitas. La arquitectura de Timestamp GIT es de conocimiento cero: procesa hashes de commit, nunca tu código. En el modo Enterprise ZK, incluso el hash se envía desde tu propia infraestructura mediante una GitHub Action de 12 líneas, y el servicio nunca tiene acceso de lectura al repositorio de origen.
No selles el tiempo una vez y lo des por hecho. Una sola prueba protege un solo momento. El valor para un freelancer viene de la continuidad: un historial de anclajes diarios que muestra el código evolucionando bajo tus manos durante meses.
Cómo funciona, en concreto
Dos modos de despliegue
Modo Estándar — la GitHub App. La App solo lee el hash del commit HEAD de tu repositorio monitorizado, y luego escribe los artefactos de prueba en una rama separada o en un repositorio en la sombra. En cuanto a permisos, concedes solo lectura sobre el origen y lectura-escritura sobre el destino — lo cual refleja cómo funciona el sistema de permisos de GitHub, ya que no existe una concesión solo para el hash de commit.
Modo Enterprise ZK — la GitHub Action. Un workflow corto se ejecuta en tus propios runners y envía solo el hash del commit a la API de Timestamp GIT. El servicio necesita acceso de lectura-escritura únicamente al repositorio de destino, y ninguno al de origen. Tu código fuente nunca sale de tu entorno. Este es el modo que importa para repositorios propiedad del cliente bajo términos estrictos de confidencialidad o para configuraciones on-premises.
El pipeline, de principio a fin
- Detección de commits — la App captura nuevos commits por webhook, o tu Action envía los hashes directamente.
- Cola de hashes — los hashes esperan en un almacén clave-valor en memoria hasta la ventana de lote.
- Cron nocturno — los hashes pendientes se agrupan, se construyen manifiestos por repositorio, se construye un árbol de Merkle, se crean pruebas OTS contra calendarios públicos y se ancla la raíz de Merkle en Bitcoin.
- Entrega de pruebas — los manifiestos y los recibos
.otsse confirman de vuelta en tu repositorio de destino unas horas después, una vez que se confirma la transacción de Bitcoin.
Rutas de verificación
Tres formas de demostrar una fecha, en orden creciente de ceremonia:
- Panel público —
https://timestampgit.dev/status/{user}/{repo}para una vista rápida de los anclajes, la fecha más temprana y la regularidad, con un CSV de auditoría descargable y un certificado PDF. - Verificación en el navegador —
https://timestampgit.dev/verification/{user}/{repo}/{date}recorre la cadena de Merkle multinivel paso a paso. Todos los cálculos ocurren localmente en tu navegador; nadie — incluidos nosotros — ve lo que verificas. - Verificación local — descarga el archivo
.otsy compruébalo contra los datos de bloques de Bitcoin con las herramientas estándar de OpenTimestamps. Sin dependencia de proveedor.
Para flujos de trabajo basados en API, todo lo que necesitas es un simple GET:
# ¿Cuál es el último bloque de Bitcoin anclado para este repositorio?
curl -s "https://timestampgit.dev/api/statusLast/your-user/your-repo"
# Datos completos de la cadena de Merkle para un día concreto
curl -s "https://timestampgit.dev/api/verify/your-user/your-repo/2026-10-01"
# Descargar el libro de auditoría completo como CSV
curl -s -o audit.csv "https://timestampgit.dev/api/audit/your-user/your-repo"
Ese CSV es el artefacto que le entregas a un abogado. También es el artefacto que adjuntas a un correo de hito cuando un cliente se queda en silencio ante una factura.
Docker autoalojado: control máximo
Algunos freelancers trabajan bajo NDAs que hacen inviable cualquier SaaS de terceros, o operan en entornos genuinamente aislados. Para esos casos, Timestamp GIT está disponible como imagen de Docker con una licencia autoalojada.
Una configuración rápida de Docker Compose tiene este aspecto:
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
La aplicación está disponible en http://localhost:8080 tras el arranque. En el primer lanzamiento, un asistente de configuración te guía para conectar tu GitHub App y configurar la instancia.
Para evaluar antes de comprometerte, solicita una licencia de demostración por tiempo limitado desde la página de licencia de Docker con tu nombre, empresa, correo electrónico y número de teléfono opcional. El archivo de licencia se puede descargar de inmediato.
Preguntas frecuentes
¿Necesito cambiar mi flujo de trabajo de Git para usar Timestamp GIT? No. Una vez que instalas la GitHub App, cada commit a un repositorio monitorizado se ancla automáticamente en Bitcoin cada noche. Sigues trabajando como siempre — sin herramientas de CLI, sin pasos manuales.
¿Puedo demostrar la propiedad si ya entregué el código a un cliente?
Sí, siempre que hayas hecho commit del código a un repositorio monitorizado por Timestamp GIT antes de la disputa. El recibo .ots y el sello de tiempo del bloque de Bitcoin sirven como prueba inmutable de existencia en esa fecha.
¿Y si el cliente afirma que escribió él el código? Tu prueba criptográfica — anclada en la blockchain de Bitcoin — demuestra matemáticamente que tu hash de commit existía en un momento concreto, lo que hace extremadamente difícil que alguien afirme que lo escribió antes.
¿Está seguro mi código fuente con Timestamp GIT? Sí. Timestamp GIT usa una arquitectura de conocimiento cero: solo procesa hashes de commit, nunca tu código fuente real. En el modo Enterprise ZK, incluso el hash se envía desde tu propia infraestructura.
¿Cuánto cuesta? El nivel Open Source es gratuito para repositorios públicos. Pro Agency cuesta 49 $/mes y cubre repositorios privados — el plan relevante para la mayoría de los freelancers. Enterprise ZK cuesta 199 $/mes. Los detalles están en la página de precios.
Empieza antes de necesitarlo
La aritmética incómoda de las disputas de código freelance es que la evidencia solo existe si la creaste en su momento. No puedes demostrar retroactivamente que una función existía en marzo. Solo puedes demostrar que existía desde el momento en que empezaste a anclar.
Instala la GitHub App, conecta los repositorios que contienen tus librerías reutilizables y tus entregables de cliente, y deja que el trabajo nocturno haga el resto. En un mes tendrás un registro de autoría continuo y anclado en Bitcoin. En un año, tendrás algo con lo que ningún competidor puede discutir y que ningún cliente puede reescribir.
Diez minutos ahora frente a una pelea de “él dijo, ella dijo” después. Ese es todo el intercambio.
Artículos relacionados
- ¿Qué es la prueba de anterioridad criptográfica? Una guía para equipos de software
- Cómo verificar de forma independiente un sello de tiempo de commit de Git
- Anclaje nocturno automático de commits de Git en Bitcoin, cero pasos manuales