Timestamp GIT

← Todos los artículos

2026-11-06

OpenTimestamps sin CLI: sellado de tiempo Bitcoin gestionado

OpenTimestamps sin CLI: sellado de tiempo Bitcoin gestionado
timestamp git blockchain proof

OpenTimestamps sin la CLI: sellado de tiempo con Bitcoin gestionado

Si alguna vez te has planteado demostrar que un fragmento de código existía en una fecha concreta, probablemente te hayas topado con OpenTimestamps. También te habrás topado con la parte que nadie pone en el titular: la línea de comandos, los calendarios, los archivos .ots y una vaga sensación de que ahora necesitas entender las transacciones de Bitcoin.

Este artículo es OpenTimestamps explicado sin la CLI. No porque el protocolo sea malo —es genuinamente excelente—, sino porque la línea de comandos es un detalle de implementación, no un requisito. Existe una vía gestionada en la que una GitHub App vigila tu repositorio y ancla cada commit en Bitcoin mientras duermes. La instalas una vez. Nunca escribes un comando de sellado de tiempo.

Veremos qué hace realmente OpenTimestamps, por qué la analogía con un notario encaja casi a la perfección, qué ocurre bajo el capó cada noche y los conceptos erróneos que frenan a los equipos a la hora de adoptarlo. La mecánica bruta del protocolo se trata aquí como contexto; el foco está en el flujo de trabajo automatizado y en lo que te aporta.

¿Qué es OpenTimestamps sin la CLI?

OpenTimestamps es un protocolo para demostrar que ciertos datos existían en un momento determinado o antes. Lo hace agregando datos en un árbol de Merkle, calculando el hash de la raíz y registrando esa raíz en un bloque de Bitcoin. Como los bloques de Bitcoin son inmutables y se replican globalmente, el anclaje se convierte en un registro público de existencia a prueba de manipulaciones.

La CLI es solo una interfaz de ese protocolo. Un servicio web, una GitHub App o un worker programado pueden hacer exactamente lo mismo, y hacerlo mejor, porque el agrupamiento por lotes y la gestión de calendarios son precisamente las partes en las que los humanos somos malos.

El enfoque gestionado funciona así: instalas la GitHub App Timestamp GIT en un repositorio. A partir de ese momento, cada commit se detecta automáticamente, se agrupa por lotes cada noche y se ancla en Bitcoin mediante OpenTimestamps. Las pruebas vuelven a tu repositorio como archivos de recibo y manifiestos. Sin comandos, sin herramientas locales, sin nodo de Bitcoin.

Para ser explícitos sobre el alcance: este artículo explica el concepto y el flujo de trabajo gestionado. No te guía por las operaciones brutas del protocolo. Si quieres profundizar en temas adyacentes, consulta cómo verificar una prueba de sello de tiempo de Bitcoin en tu navegador y por qué tu Git log no es una prueba.

Una analogía sencilla: el notario de tu código

Imagina un notario. Le entregas un documento. No lo lee. Calcula un sello a prueba de manipulaciones sobre él, lo fechó y registra ese sello en un libro público que cualquiera puede inspeccionar. Más tarde, si alguien cuestiona la fecha, presentas el documento, recalculas el sello y señalas la entrada del libro.

OpenTimestamps es ese notario, con dos mejoras:

  • El «documento» es un hash, no tu código. Git ya genera un hash único e irreversible (SHA-1 o SHA-256) para cada commit, que representa el estado exacto de tu repositorio en ese momento. Ese hash es la huella. Timestamp GIT solo maneja la huella.
  • El libro es la blockchain de Bitcoin. En lugar del libro encuadernado de un notario en un archivador, el sello se registra en un bloque que miles de nodos independientes replican. Nadie —ni tú, ni nosotros, ni una orden judicial— puede reescribirlo.

La tercera mejora es la que importa en el día a día: con Timestamp GIT, el notario te visita automáticamente cada noche. Sin cita, sin cola, sin papeleo. Tú haces commits; el sellado ocurre según un calendario en el que nunca piensas.

Cómo funciona bajo el capó (en breve)

Tres pasos, y solo el intermedio implica algo parecido a infraestructura.

Paso 1 — La huella. Cuando haces un commit, Git genera un hash único para ese commit. Timestamp GIT solo recopila estos hashes. Tu código fuente nunca se lee, se copia ni se almacena.

Paso 2 — El anclaje. Un worker cron de medianoche agrupa todos los hashes pendientes, construye un árbol de Merkle nativo por repositorio, crea un archivo manifiesto .txt y ancla la raíz de Merkle en Bitcoin usando calendarios públicos de OpenTimestamps.

Paso 3 — La prueba. El manifiesto y los archivos de recibo .ots se envían de vuelta a tu repositorio, en una rama dedicada de timestamps o en un repositorio sombra separado. Desde ahí, cualquiera puede verificar sin conexión contra los datos de los bloques de Bitcoin.

Dos detalles operativos que conviene conocer:

  • La confirmación de Bitcoin tarda varias horas, normalmente unas tres. Por tanto, la escritura de las pruebas se completa unas horas después del lote nocturno, no al instante.
  • La verificación es independiente del proveedor. La prueba depende solo de SHA-256 y de los datos de los bloques de Bitcoin. Sin formato propietario, sin dependencia de un proveedor.

Esta es la forma, conceptualmente, de lo que produce un lote nocturno:

timestamps/
├── 2026-11-05/
│   ├── manifest.txt        # commit hashes for the day
│   └── manifest.txt.ots    # OpenTimestamps receipt for the Merkle root
└── 2026-11-06/
    ├── manifest.txt
    └── manifest.txt.ots

Los recibos son el artefacto que conservas. Todo lo demás es comodidad.

Por qué importa el sellado de tiempo gestionado

Ejecutar el protocolo por tu cuenta es posible. También es un proyecto de mantenimiento: fiabilidad de los calendarios, lógica de agrupamiento por lotes, gestión de la confirmación de Bitcoin, almacenamiento de recibos y una historia de verificación para los auditores. Para la mayoría de los equipos, eso es una distracción del producto real.

Un servicio gestionado elimina esas piezas móviles:

  • No se requieren conocimientos del protocolo. No necesitas aprender sobre servidores de calendario, pruebas de Merkle ni la estructura de las transacciones de Bitcoin. La vía difícil existe; tienes permiso para saltártela.
  • Pruebas válidas ante un tribunal e independientes del proveedor. La evidencia vive en Bitcoin, no en nuestra base de datos. Cualquiera puede comprobarla sin confiar en nosotros.
  • Encaje en el flujo de trabajo. Instala la GitHub App una vez. Cada commit posterior se ancla automáticamente. Sin hábitos que cambiar, nada que instalar en las máquinas de los desarrolladores.
  • Superficie de cumplimiento. Insignias públicas de verificación para archivos README, CSV de auditoría descargables y certificados PDF por fecha dan a los auditores algo concreto que examinar.

Para agencias y freelancers, ese último punto hace un trabajo real durante disputas de pago y reclamaciones de autoría. Para las empresas, es un escudo contra los trolls de patentes que reclaman derechos sobre cosas que ya se ejecutan en sistemas internos.

Conceptos erróneos habituales sobre OpenTimestamps

«Necesitas ser un experto en Bitcoin.» Necesitas confiar en las matemáticas, no en la experiencia. Con un servicio gestionado, la complejidad está resuelta: el agrupamiento por lotes, el anclaje y la entrega de pruebas ocurren según un calendario. Tú interactúas con un panel y con una rama de tu repositorio.

«El sellado de tiempo expone mi código fuente.» No lo hace. Solo se anclan los hashes de los commits. El servicio nunca ve, copia ni almacena tu código: el principio de conocimiento cero es arquitectónico, no una promesa de política. En el modo Enterprise ZK, el envío del hash se ejecuta como una GitHub Action en tu propia infraestructura, enviando solo el hash a la API, de modo que el servicio no tiene acceso de lectura al repositorio de origen en absoluto.

«Las pruebas son tan fiables como el proveedor.» Las pruebas son nativas de Bitcoin. Puedes descargar los archivos de recibo .ots y verificarlos sin conexión usando la verificación estándar de OpenTimestamps contra la blockchain. Si Timestamp GIT desapareciera mañana, tus pruebas seguirían siendo válidas.

«Es caro y lento.» El agrupamiento diario por lotes hace que muchos commits compartan un único anclaje en Bitcoin, y por eso funcionan las cuentas. La confirmación tarda unas horas, algo aceptable para evidencia de estado de la técnica, que se juzga en meses y años, no en minutos.

Cómo empezar sin la CLI

Hay dos modos de despliegue, y ninguno requiere una terminal en las máquinas de los desarrolladores.

Modo estándar (GitHub App). Instala la GitHub App en los repositorios que quieras monitorizar. Lee automáticamente el hash del commit HEAD y escribe las pruebas en una rama dedicada, ya sea en el mismo repositorio o en un repositorio de destino separado. El modelo de permisos de GitHub exige al menos acceso de solo lectura al repositorio de origen (no existe un permiso solo para el hash del commit), además de acceso de lectura y escritura al repositorio de destino.

Modo Enterprise ZK. Una GitHub Action de 12 líneas se ejecuta en tu infraestructura y envía solo el hash del commit a la API de Timestamp GIT. Aquí solo necesitas acceso de lectura y escritura al repositorio de destino, y ningún acceso de lectura al de origen. Elige esta opción cuando incluso la visibilidad del hash deba permanecer dentro de tu perímetro.

En cualquier caso, la secuencia tras la instalación es tranquila: se detectan los commits, los hashes se ponen en cola, el worker nocturno los ancla y las pruebas aparecen en tu rama de timestamps unas horas después de la confirmación de Bitcoin.

Autoalojamiento con Docker

Para entornos aislados o de máxima seguridad, Timestamp GIT se distribuye como imagen de Docker. 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

Levántalo:

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 inicio, un asistente de configuración te guía para conectar tu GitHub App y configurar la instancia. Puedes solicitar una licencia de demostración por tiempo limitado para evaluación 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.

Lo que obtienes una vez en marcha

  • Un panel de estado público por repositorio: longevidad de las pruebas, fecha del anclaje más antiguo, regularidad diaria, datos de bloques y transacciones de Bitcoin, un mapa de calor tipo calendario y CSV de auditoría y certificado PDF descargables.
  • Insignias de verificación para tu README, con un enlace que cualquiera puede seguir para comprobar el sello de tiempo. Los repositorios privados añaden un HMAC cifrado a la URL para que solo los usuarios autorizados puedan ver el estado.
  • Un verificador basado en navegador que realiza la comprobación de la cadena de Merkle multinivel localmente, de modo que nadie ve lo que verificas.
  • Una API REST si quieres automatizar las comprobaciones de estado: /api/statusLast/{user}/{repo}, /api/statusCount/{user}/{repo}, /api/audit/{user}/{repo} y similares.
# Check the last anchored Bitcoin block for a repo
curl https://timestampgit.dev/api/statusLast/youruser/yourrepo

Los planes se ajustan a cuánta privacidad necesitas: Open Source para repositorios públicos, Pro Agency para repositorios privados y Enterprise ZK para el aislamiento basado en GitHub Action. Los detalles están en la página de precios.

Preguntas frecuentes

¿Necesito instalar algún software o ejecutar comandos para usar OpenTimestamps con Timestamp GIT?

No. Timestamp GIT es una GitHub App gestionada. La instalas una vez y sella tus commits automáticamente cada noche. No hay herramientas de CLI que instalar ni comandos que ejecutar.

¿Cómo garantiza Timestamp GIT que mi código fuente siga siendo privado?

Timestamp GIT opera bajo un principio de conocimiento cero: solo procesa hashes de commits de Git, nunca tu código fuente real. En el modo Enterprise ZK, incluso los hashes se envían desde tu infraestructura mediante una GitHub Action, de modo que el servicio nunca tiene acceso de lectura a tu repositorio.

¿Puedo verificar los sellos de tiempo de forma independiente sin confiar en Timestamp GIT?

Sí. Las pruebas se anclan en la blockchain de Bitcoin usando el protocolo OpenTimestamps. Puedes descargar los archivos de recibo .ots y verificarlos sin conexión usando la verificación estándar de OpenTimestamps, o usar el verificador integrado basado en navegador que se ejecuta localmente.

¿Qué ocurre si Timestamp GIT cierra?

Tus pruebas siguen siendo válidas porque están incrustadas en la blockchain de Bitcoin. La verificación depende solo de Bitcoin y SHA-256, así que puedes seguir demostrando la existencia de tu código de forma independiente.

Conclusión

OpenTimestamps resuelve un problema real —demostrar que unos datos existían en un momento concreto— y lo resuelve con nada más que hashing y Bitcoin. La línea de comandos nunca fue lo importante. Solo fue la primera interfaz.

La interfaz gestionada encaja mejor con cómo trabajan realmente los equipos: instala una GitHub App, sigue haciendo commits y deja que un trabajo nocturno ancle los hashes. Obtienes recibos .ots, una rama de manifiestos, insignias de verificación, CSV de auditoría y certificados PDF, todo respaldado por pruebas que sobreviven al proveedor.

Si quieres la versión automatizada, instala Timestamp GIT en un repositorio y haz un commit. Esa es toda la configuración. El notario se presenta esta noche.

EU label: AI-generated content