Timestamp GIT

← Todos los artículos

2026-10-22

Sellado de tiempo automatizado de Git: ancla los commits a Bitcoin

Sellado de tiempo automatizado de Git: ancla los commits a Bitcoin
timestamp git blockchain proof

Sellado de tiempo automatizado de Git: Ancla tus commits a Bitcoin

Si tu protección de anterioridad depende de que alguien recuerde ejecutar una herramienta después de cada commit, no tienes protección de anterioridad: tienes un hábito. Y los hábitos se rompen la semana antes de una auditoría, durante un sprint de release o justo después de que la persona que “siempre lo hacía” cambie de equipo.

El sellado de tiempo manual tiene un bucle de fallo predecible. Haces el commit y luego te acuerdas de sellarlo. Copias el recibo en algún lugar donde no se pierda. Lo vuelves a hacer mañana, y pasado mañana, para cada repositorio que importa — y en el momento en que entras en un sprint con muchas ramas, el bucle se detiene en silencio. Un repositorio escala. Cinco repositorios con tres colaboradores cada uno, no.

Este artículo trata de eliminar ese bucle por completo: sellado de tiempo automatizado de Git en Bitcoin, donde la única acción recurrente es un commit que ya ibas a hacer de todos modos.

Puedes hacerlo a la manera difícil ejecutando tú mismo las herramientas de OpenTimestamps y cuidando los archivos de recibo. Timestamp GIT existe para que no tengas que hacerlo. Es un servicio gestionado que oculta el protocolo por completo: instala la GitHub App una vez y cada commit a un repositorio monitorizado se ancla en Bitcoin automáticamente cada noche. Sin herramientas CLI, sin comandos de protocolo, sin lista de tareas diaria. Para el propio tutorial de instalación, consulta GitHub App Blockchain Timestamp Setup: Install Once, Timestamp Forever — este artículo se centra en lo que ocurre después de la instalación.

La tarea manual repetitiva que puedes eliminar

Antes de decidirte por la automatización, merece la pena nombrar exactamente qué se está quitando de tu semana:

  • Un ritual por commit. Algo tiene que ejecutarse después de cada commit que merezca una prueba. Eso es un humano en el bucle, en cada commit, para siempre.
  • Dispersión de recibos. Los archivos de prueba acaban en una carpeta personal, un disco compartido o un hilo de Slack. Seis meses después, nadie puede relacionar un recibo con una fecha o un repositorio.
  • Deterioro de la cobertura. Proteges el repositorio insignia. El repositorio de herramientas internas, la librería de cliente, el servicio de secretos comerciales — nadie sella esos, y con frecuencia son los que importan en una disputa.
  • Huecos silenciosos. Perder un solo día es invisible hasta que necesitas la prueba, que es el peor momento posible para descubrir un agujero en tu cronología.

“Qué se automatiza” aquí es algo concreto y específico. Instalas la GitHub App una vez en los repositorios que quieres monitorizar. A partir de entonces, cada commit se detecta, se agrupa y se ancla en la blockchain de Bitcoin cada noche sin ninguna acción del desarrollador. Los desarrolladores siguen haciendo commits exactamente como lo hacen hoy. No hay nada que instalar en sus máquinas, ni hook de pre-commit, ni flujo de trabajo nuevo que aprender.

Esa es la diferencia entre un proceso y una propiedad en segundo plano de tus repositorios.

Configuración única: instala la GitHub App y olvídate

Timestamp GIT te ofrece dos formas de conectar un repositorio, ambas de configuración única.

Modo estándar (GitHub App). Instala la GitHub App en los repositorios que quieras monitorizar. Lee automáticamente solo el hash del commit HEAD de cada repositorio monitorizado. Las pruebas se escriben en una rama Git dedicada — ya sea en el mismo repositorio que el origen o en uno separado.

Merece la pena entender el modelo de permisos con claridad, porque es menos de lo que la gente espera:

  • Acceso de solo lectura al repositorio de origen. El sistema de permisos de GitHub no tiene un ámbito de “solo hash de commit”, así que solo lectura es el mínimo que la App puede solicitar para ver el hash HEAD.
  • Acceso de lectura y escritura al repositorio de destino, que es donde se suben los archivos de manifiesto y de recibo.

Modo Enterprise ZK. Una GitHub Action de 12 líneas se ejecuta en tu propia infraestructura y envía solo el hash del commit a la API de Timestamp GIT. Esa configuración requiere acceso de lectura y escritura solo al repositorio de destino — no se necesita acceso de lectura al repositorio de origen, y tu código fuente nunca sale de tu entorno.

Elijas el modo que elijas, la experiencia del desarrollador es idéntica para tu equipo: nada que instalar en las máquinas de los desarrolladores, ningún cambio en cómo cada persona crea ramas, hace commits o fusiona.

Si necesitas autoalojarlo. Para máxima seguridad o entornos aislados, Timestamp GIT también está disponible como imagen 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
docker compose pull
docker compose up -d
docker compose logs -f timestampgit

La aplicación está disponible en http://localhost:8080 tras el arranque, y un asistente de configuración te guía para conectar tu GitHub App y configurar tu instancia en el primer inicio. La licencia, el formulario de solicitud de licencia de demostración y el tutorial completo de autoalojamiento están en Self-Hosted Git Timestamps: Docker Setup & License Guide.

El pipeline automatizado: del commit al ancla en Bitcoin

Una vez conectado, el pipeline se ejecuta sin ti. Esta es la secuencia real.

1. Detección de commits. O bien la GitHub App detecta nuevos commits mediante webhooks, o bien — en Modo Enterprise ZK — tu GitHub Action envía los hashes de commit a la API.

2. Cola de hashes. Los hashes de commit llegan a un almacén clave-valor en memoria para su agrupación. No se almacena nada más, porque no se envió nada más.

3. El worker cron de medianoche. Cada noche, un worker:

  • Agrupa todos los hashes pendientes
  • Crea archivos de manifiesto por repositorio (.txt)
  • Construye un árbol de Merkle de forma nativa
  • Crea pruebas de OpenTimestamps usando los calendarios públicos de OTS
  • Ancla la raíz de Merkle en la blockchain de Bitcoin

4. Entrega de pruebas. Los archivos de manifiesto y de recibo .ots se suben de vuelta a tu repositorio en una rama de sellado de tiempo dedicada o en un repositorio sombra.

Todo el flujo tiene este aspecto:

commit ──▶ hash queue ──▶ midnight cron ──▶ Merkle root ──▶ Bitcoin block
                                                 │
                                                 └──▶ manifest.txt + .ots receipt
                                                              │
                                                              ▼
                                                  timestamps branch / shadow repo

En Modo Enterprise ZK, tu GitHub Action se comunica con la ZK Commit API, que se autentica con un HMAC de la URL firmada que la API devuelve para tu repositorio:

# The signed URL (and its HMAC) is returned by the API for your repo.
# {target} is the destination repo, {hash} is the HMAC from that URL.
curl -X POST \
  "https://timestampgit.dev/api/timestamp/acme/payments-api/timestamps/<hmac>/<commitHash>/<commitId>"

Expectativa de tiempos. La confirmación de Bitcoin tarda varias horas — normalmente unas 3 —, así que la escritura de pruebas se completa unas horas después de la ejecución nocturna, no a medianoche en punto. Si consultas tu rama de sellado de tiempo a las 00:05 y no ves nada, ese es el comportamiento esperado, no un fallo.

Monitorización y gestión de fallos

La automatización que no puedes observar es indistinguible de la automatización que dejó de funcionar. Timestamp GIT expone endpoints de estado públicos para que puedas vigilar el pipeline sin iniciar sesión:

# Last anchored Bitcoin block
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api

# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api

# Combined summary (Shields.io friendly)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api

Insignias. Hay insignias de verificación integrables disponibles para tu README, de modo que el estado del ancla sea visible para cualquiera que navegue por el repositorio. Cualquiera puede seguir el enlace de la insignia para verificar el sellado de tiempo — hay un visor dedicado y un informe en PDF. También se admiten repositorios privados: sus URLs de estado añaden un HMAC cifrado específico de la instancia del servidor, de modo que solo los usuarios autorizados pueden ver el estado.

Panel de estado del repositorio. En /status/{user}/{repo} obtienes la longevidad de las pruebas, la fecha del ancla más antigua, la regularidad diaria, los datos de bloque y transacción de Bitcoin, y un mapa de calor de calendario — la forma más rápida de detectar visualmente un hueco en la cobertura.

Endpoints de auditoría e informes. Cuando necesitas evidencias en lugar de un panel:

# Full audit ledger as CSV
curl -sO https://timestampgit.dev/api/audit/acme/payments-api

# PDF certificate for one specific date
curl -sO https://timestampgit.dev/api/report/acme/payments-api/2026-10-21

Cuando parece que falta una noche, sigue este orden:

  1. Comprueba statusLast y statusCount. Si el último ancla es varias horas más antigua de lo esperado, puede que la confirmación siga en curso.
  2. Confirma que la GitHub App todavía tiene acceso al repositorio. Una App desinstalada, un permiso revocado o un repositorio renombrado detendrán la detección en silencio.
  3. En Modo Enterprise ZK, revisa el historial de ejecuciones de la Action por tu parte — el envío a la API es el único eslabón que puede romperse localmente.
  4. Vuelve a comprobar después de que se complete la confirmación de Bitcoin antes de dar nada por perdido.

Buenas prácticas para el sellado de tiempo automatizado

  • Monitoriza todos los repositorios que importan, no solo el insignia. La cobertura es todo el valor de la automatización; un único repositorio protegido todavía deja el resto de tu trabajo expuesto.
  • Mantén commits significativos. La automatización sella lo que tú confirmas, así que la higiene de commits sigue dando forma a la historia que cuenta tu historial anclado. Cien commits de “wip” prueban menos que un historial limpio y descriptivo.
  • Pon la insignia en el README y guarda el CSV de auditoría y los informes PDF por fecha con tus registros de propiedad intelectual. Esos artefactos son lo que entregas a un auditor o a la parte contraria.
  • Verifica de forma independiente cuando importe. Descarga el archivo .ots y compruébalo con las herramientas estándar de OpenTimestamps contra Bitcoin. La prueba es independiente del proveedor por diseño — usa solo SHA-256 y datos de bloques de Bitcoin. El tutorial paso a paso está en How to Verify a Bitcoin Timestamp Proof Locally.
  • Recuerda la garantía de conocimiento cero. Solo se sellan los hashes de commit, nunca el código fuente, así que automatizar en todos los repositorios no amplía tu exposición en absoluto — es el mismo hash tanto si tienes un repositorio como cincuenta.

Preguntas frecuentes

¿El sellado de tiempo automatizado de Git llega a leer o almacenar mi código fuente?

No. Timestamp GIT solo procesa hashes de commit. En Modo estándar, la GitHub App lee el hash del commit HEAD, y en Modo Enterprise ZK una GitHub Action en tu infraestructura envía solo el hash a la API. Tu código fuente nunca sale de tu entorno en modo ZK y el servicio nunca lo copia ni lo almacena.

¿Cuánto tiempo después de mi commit se confirma el ancla en Bitcoin?

Los commits se agrupan y se anclan mediante un worker cron nocturno. La confirmación de Bitcoin tarda varias horas, normalmente unas 3 horas, así que el recibo .ots y los archivos de manifiesto aparecen en tu rama de sellado de tiempo o repositorio sombra unas horas después de la ejecución nocturna.

¿Qué pasa con mis pruebas si Timestamp GIT cierra?

Las pruebas siguen siendo válidas. Dependen solo de SHA-256 y de datos de bloques de Bitcoin a través del protocolo OpenTimestamps, así que cualquiera puede descargar el archivo .ots y verificarlo de forma independiente contra la blockchain de Bitcoin usando las herramientas estándar de OpenTimestamps — sin tecnología propietaria, sin dependencia de proveedor.

¿Puedo usar el sellado de tiempo automatizado con repositorios privados?

Sí. Se admiten los repositorios privados, y las URLs de estado añaden un HMAC cifrado específico de la instancia del servidor para que solo los usuarios autorizados puedan ver el estado. Las insignias de verificación públicas y el panel de estado funcionan igual una vez concedido el acceso.

Conclusión: configúralo una vez, pruébalo para siempre

El cambio aquí es pequeño en esfuerzo y grande en consecuencias. Dejas de mantener una tarea diaria y empiezas a poseer una propiedad de tus repositorios: cada commit, anclado en Bitcoin, automáticamente, cada noche, con un recibo que puedes entregar a un abogado, un auditor o un tribunal. La prueba está incrustada en Bitcoin, lista para los tribunales y verificable por cualquiera sin herramientas propietarias — y todo lo impulsa Timestamp GIT en el backend, no tus desarrolladores.

Si tu equipo no puede usar un servicio gestionado en absoluto, la opción autoalojada con Docker cubre entornos de máxima seguridad y aislados con la configuración de Compose mostrada arriba.

Instala la GitHub App en tu primer repositorio hoy y deja que el pipeline se ejecute esta noche. Mañana, comprueba statusLast — tendrás un ancla que, de otro modo, habrías pasado un año intentando recordar crear.

Entradas relacionadas

EU label: AI-generated content