Timestamp GIT

← Todos los artículos

2026-10-11

Anclaje automático nocturno de commits de Git a Bitcoin, sin pasos manuales

Anclaje automático nocturno de commits de Git a Bitcoin, sin pasos manuales
timestamp git blockchain proof

Anclaje automático nocturno de commits de Git a Bitcoin, cero pasos manuales

La forma más común en que los equipos “marcan con sello de tiempo” un commit es que un humano se acuerde de hacerlo.

Alguien termina una funcionalidad, recuerda que el commit debería anclarse, y ejecuta el flujo de trabajo de OpenTimestamps a mano — de la forma difícil — y luego guarda el recibo en algún lugar. Dos semanas después nadie recuerda si el recibo de ese martes existe. Se incorpora otro desarrollador, no conoce el ritual, y seis meses de commits quedan sin sellar.

Esa es la trampa del sellado de tiempo manual: una cobertura de prueba que depende de la memoria. Funciona bien en una demo y se desmorona a lo largo de un equipo, un ritmo de sprints y un año de rotación. El anclaje automático nocturno de commits de Git a Bitcoin le da la vuelta al problema: el anclaje deja de ser una tarea que una persona realiza y se convierte en una propiedad de tu repositorio. Instalas una GitHub App una vez, y cada commit se agrupa y se ancla mientras duermes.

Este artículo recorre esa vía automatizada de principio a fin — configuración, pipeline, monitorización, autoalojamiento — y está escrito para desarrolladores y responsables de cumplimiento a quienes les importa que la prueba sobreviva a una auditoría, no cuidar un cron job.

La trampa del sellado de tiempo manual (y cómo la automatización la elimina)

Sellar commits a mano tiene tres modos de fallo, y los tres son estructurales, no personales:

  • Dependencia de la memoria. Alguien tiene que acordarse de ejecutar las herramientas en el momento adecuado, idealmente antes de que el trabajo sea público. Tarde es lo mismo que nunca a efectos de técnica anterior.
  • Fallos silenciosos. Cuando una ejecución manual falla — un fallo de red, un calendario caducado, un directorio equivocado — nada se rompe. Simplemente tienes un hueco en la cobertura que descubres un año después, durante la disputa para la que necesitabas la prueba.
  • Dispersión de recibos. Los recibos acaban en portátiles, en hilos de Slack, en una unidad compartida que nadie posee. Una prueba que no puedes encontrar es una prueba que no tienes.

Nada de esto escala. Un desarrollador en solitario puede mantener vivo el ritual durante unos meses. Un equipo de diez no lo hará, y una agencia que gestiona trabajo de clientes en docenas de repos no tiene ninguna posibilidad. Cada noche perdida es un agujero permanente en el registro, porque no puedes anclar retroactivamente un hash que nunca se capturó.

Timestamp GIT es la alternativa gestionada de configuración cero: una GitHub App que captura los hashes de commit automáticamente, los agrupa y los ancla en la blockchain de Bitcoin mediante el protocolo OpenTimestamps cada noche. Sin herramientas de CLI, sin recibos manuales, nada instalado en las máquinas de los desarrolladores. Obtienes la propiedad criptográfica — una fecha inmutable e independientemente verificable — sin ejecutar tú mismo el protocolo subyacente.

Hay dos análisis más profundos en otras partes de este blog: How to Verify a Git Repository’s Bitcoin Timestamp cubre el lado de la verificación, y Git Commit Timestamp Proof for Patent Disputes cubre el encuadre legal. Este artículo se centra en la automatización en sí.

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

La configuración es una única acción, realizada una vez por repositorio o una vez por organización.

  1. Instala la GitHub App de Timestamp GIT en el repositorio (o en toda la organización, para que los repos nuevos queden cubiertos por defecto).
  2. Elige el repositorio de origen que contiene tu código.
  3. Elige el repositorio de destino donde se escribirán las pruebas — ya sea el mismo repo en una rama dedicada, o un repositorio sombra separado.

Esa es toda la configuración. No hay requisitos en las máquinas de los desarrolladores: ni daemon, ni hook que cada ingeniero tenga que instalar, ni lista de comprobación de incorporación. Los nuevos empleados quedan cubiertos en su primer commit porque la cobertura es una propiedad del repositorio, no una propiedad personal.

El modelo de permisos. El Modo Estándar necesita acceso de solo lectura al repositorio de origen más acceso de lectura-escritura al repositorio de destino. El requisito de solo lectura existe porque el sistema de permisos de GitHub no ofrece un alcance limitado únicamente al hash de commit — el acceso de lectura al origen es la concesión mínima que permite a la App ver el hash del commit HEAD. Solo lee ese hash.

Si ni siquiera un hash debería salir de tu entorno, el Modo Enterprise ZK sustituye el sondeo de la App por una GitHub Action de 12 líneas que se ejecuta en tu propia infraestructura y no envía nada más que el hash del commit a la API de Timestamp GIT. En ese modo, el servicio solo necesita acceso de lectura-escritura al repositorio de destino, y ningún acceso de lectura al repositorio de origen — instalas la Action en su lugar.

En cualquier caso, la garantía es la misma: nunca vemos, copiamos ni almacenamos tu código fuente real. Solo el hash entra en juego.

Dentro del pipeline automatizado: del commit al ancla en Bitcoin

Una vez instalado, el pipeline se ejecuta sin intervención. Esto es lo que ocurre entre tu git push y una prueba inmutable depositada en tu repositorio.

1. Detección de commits. En el Modo Estándar, la GitHub App detecta nuevos commits mediante webhooks. En el Modo Enterprise ZK, tu GitHub Action envía el hash del commit a la API. Cualquiera de las dos vías produce el mismo artefacto: una lista de hashes de commit.

2. Cola de hashes. Los hashes entrantes llegan a un almacén clave-valor en memoria usado puramente para el agrupamiento. Esta es la sala de espera — los commits se acumulan aquí hasta la siguiente ventana de lote.

3. Worker cron de medianoche. Cada noche, un worker toma cada hash pendiente y:

  • los agrupa por repositorio,
  • escribe un archivo manifiesto (.txt) para cada repo,
  • construye un árbol de Merkle de forma nativa sobre el lote,
  • crea pruebas de OpenTimestamps usando los calendarios públicos de OTS,
  • ancla la raíz de Merkle en la blockchain de Bitcoin.

El agrupamiento es lo que hace que esto sea barato y continuo. Ya sea que hayas hecho push de un commit o de cuatrocientos ese día, el coste y la cadencia son los mismos.

4. Entrega de pruebas. El manifiesto y los archivos de recibo .ots se envían de vuelta a tu repositorio — en una rama timestamps dedicada o en tu repositorio sombra — automáticamente.

Hay un detalle de tiempos que conviene planificar: la confirmación en la blockchain de Bitcoin tarda varias horas, normalmente alrededor de tres. Así que los commits enviados hoy se encolan esta noche, se anclan durante la noche, y los archivos de prueba aparecen unas horas después. No esperas por ello; simplemente los encuentras ahí a la mañana siguiente.

El resultado, por día y por repo, es una cadena a prueba de manipulaciones: tus hashes de commit → manifiesto → árbol de Merkle → raíz de Merkle → prueba de OpenTimestamps → bloque de Bitcoin.

Monitorización y gestión de fallos: mantener la cadena sin romperse

Una automatización que no monitorizas es solo una versión más bonita de la trampa manual. Timestamp GIT expone endpoints de estado públicos para que puedas comprobar la cadena tú mismo, sin iniciar sesión en un panel:

# Last anchored Bitcoin block info for a repo
curl -s https://timestampgit.dev/api/statusLast/{user}/{repo}

# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/{user}/{repo}

# Combined summary, used for Shields.io badges
curl -s https://timestampgit.dev/api/statusSummary/{user}/{repo}

Una comprobación de continuidad sencilla que encaja en cualquier planificador: llama a statusLast una vez al día, guarda la respuesta sin procesar, y alerta si no ha cambiado desde ayer. Si no se ha depositado ningún ancla nueva, has detectado el hueco en la misma semana en lugar de en la misma década.

Si prefieres no construir eso tú mismo, el panel de estado público en https://timestampgit.dev/status/{user}/{repo} hace el trabajo visualmente — longevidad de las pruebas, fecha del ancla más antigua, regularidad diaria, los datos del bloque y la transacción de Bitcoin detrás de cada ancla, y un mapa de calor de calendario que hace que las noches perdidas sean inmediatamente obvias. Desde la misma página puedes descargar el CSV de auditoría y un certificado en PDF.

Los repositorios privados siguen siendo privados. Las URL de estado para repos privados llevan un HMAC cifrado específico de la instancia del servidor, de modo que solo los usuarios autorizados pueden leer el estado de esos repositorios. Las pruebas siguen siendo públicamente verificables en el sentido de Bitcoin — el hash está on-chain — pero los metadatos que las rodean no son un libro abierto.

Insignias de verificación. Para los repos públicos, las insignias insertables muestran tu estado de verificación directamente en el README, con un enlace que cualquiera puede seguir para verificar el sello de tiempo en el sitio. La insignia hace visible la prueba para un cliente, un comprador o la parte contraria, sin que tengas que producir nada.

Cuando la App se reconecta. Si un repo se desconecta y se vuelve a conectar, la página de conexión te da el widget de inserción de la insignia con una vista previa en vivo para que puedas volver a verificar que el vínculo está intacto.

Buenas prácticas para un anclaje nocturno fiable

  • Pon a una persona sobre el mapa de calor una vez a la semana. La automatización nocturna elimina la tarea diaria, no la responsabilidad. Un vistazo semanal de cinco minutos al panel de estado detecta cualquier cosa que una alerta pueda pasar por alto.
  • Alerta por ausencia, no solo por errores. El estado peligroso es el silencio. Alerta cuando la fecha del ancla deje de avanzar.
  • Usa una rama timestamps dedicada o un repositorio sombra. Mantener las pruebas fuera de tu rama por defecto significa sin ruido de fusiones, sin interferencias accidentales con CI, y un rastro de auditoría que un revisor puede explorar sin clonar tu aplicación.
  • Inserta insignias donde miran los compradores. En el README, cerca del encabezado de licencia. La prueba pública de existencia es credibilidad barata.
  • Exporta el libro de auditoría de forma programada. Extrae el CSV con regularidad y archívalo junto a tus materiales de cumplimiento, y genera un certificado en PDF para cada hito de release. Los equipos de cumplimiento quieren un documento con una fecha; dales uno antes de que lo pidan.
  • Deja por escrito la historia de “quién puede ver qué”. Documenta tu modo — Estándar o Enterprise ZK — y los permisos exactos concedidos. Cuando compras o legal pregunten, estarás respondiendo una pregunta que ya respondiste.

Autoalojamiento para entornos aislados: inicio rápido con Docker Compose

Si tus restricciones descartan un servicio gestionado — entornos regulados, redes aisladas, reglas estrictas de residencia de datos — Timestamp GIT está disponible como imagen de Docker que ejecuta el mismo pipeline automatizado en tu propia infraestructura.

Una configuración de inicio rápido con 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 lanzamiento, un asistente de configuración te guía para conectar tu GitHub App y configurar tu instancia.

Para evaluación, hay disponible una licencia de demo con tiempo limitado: envía el formulario de solicitud en la página de licencia de Docker con tu nombre, empresa, correo electrónico y número de teléfono opcional, y podrás descargar un archivo de licencia de demo para empezar.

El autoalojamiento te da la máxima seguridad y control con el mismo comportamiento de agrupamiento y anclaje nocturno — el árbol de Merkle, las pruebas OTS y los archivos .ots escritos de vuelta en tus repositorios.

Preguntas frecuentes

¿Necesito ejecutar algún comando o instalar herramientas en mi máquina? No. Timestamp GIT es un servicio gestionado: instalas la GitHub App una vez, y cada commit se ancla automáticamente cada noche. No se instala nada en las máquinas de los desarrolladores.

¿Cuánto tarda un commit en anclarse en Bitcoin? El worker cron nocturno agrupa los commits y ancla la raíz de Merkle en Bitcoin mediante OpenTimestamps. La confirmación suele tardar alrededor de 3 horas, tras lo cual los archivos de prueba .ots se envían de vuelta a tu repositorio.

¿Puedo verificar el sello de tiempo de forma independiente? Sí. Puedes descargar el archivo .ots y usar las herramientas estándar de verificación de OpenTimestamps contra la blockchain de Bitcoin, o usar la página de verificación pública en https://timestampgit.dev/verification/{user}/{repo}/{date}, que ejecuta cada paso de la comprobación multinivel de la cadena de Merkle localmente en tu navegador — nadie ve lo que verificas.

¿Y si necesito mantener mi código fuente completamente privado? Usa el modo Enterprise ZK: una GitHub Action en tu infraestructura envía solo el hash del commit a la API de Timestamp GIT, de modo que tu código fuente nunca sale de tu entorno. Como alternativa, autoaloja con Docker para tener control total.

El ancla solo vale lo que vale su regularidad

Un sello de tiempo que hiciste una vez prueba una cosa sobre un momento. Un sello de tiempo hecho cada noche, automáticamente, prueba que un repositorio existió en un estado concreto en una línea temporal continua — y esa es la versión que se sostiene cuando alguien te cuestiona dieciocho meses después. El sellado manual no puede producir ese registro, porque el registro lo definen los días que no te saltaste.

Timestamp GIT está construido exactamente para eso: instala la GitHub App en tu repo u organización, elige dónde aterrizan las pruebas, y deja que el worker nocturno agrupe, construya el árbol de Merkle y ancle tus hashes de commit en Bitcoin. Verifica con una insignia, un panel o los propios archivos .ots. Si prefieres ejecutarlo dentro de tu propia red, la licencia de autoalojamiento con Docker te cubre.

Instálalo una vez. Luego deja de pensar en ello.

Entradas relacionadas

EU label: AI-generated content