Timestamp GIT

← Todos los artículos

2026-10-26

Automatiza el sellado de tiempo con Bitcoin para cada commit de GitHub

Automatiza el sellado de tiempo con Bitcoin para cada commit de GitHub
timestamp git blockchain proof

Automatiza el sellado de tiempo con Bitcoin para cada commit de GitHub

Has decidido que tus commits merecen una prueba criptográfica de existencia. Bien. Ahora llega la parte aburrida: hacerlo otra vez mañana, y pasado mañana, para cada repositorio que toque tu equipo.

Ahí es donde la mayoría de los esfuerzos de sellado de tiempo mueren en silencio. No porque la idea sea errónea, sino porque la tarea manual —agrupar hashes de commits, enviarlos a un servicio de calendario, vigilar un archivo de prueba, hacer commit de vuelta— no sobrevive al contacto con un sprint real. Si quieres automatizar el sellado de tiempo con blockchain para repositorios de GitHub, el sello de tiempo tiene que ser un efecto secundario de git push, no una tarea que alguien recuerda hacer los viernes.

Este artículo recorre el camino automatizado de principio a fin: una instalación, un pipeline nocturno que nunca tocas y una monitorización que te dice si las pruebas llegaron realmente a Bitcoin.

Por qué el sellado de tiempo manual no escala

La forma difícil de sellar un commit es hacerlo a mano cada vez. Serías responsable de:

  • Decidir qué commits merecen sellarse (todos lo merecen, y ese es el problema).
  • Agrupar los hashes tú mismo para no crear una transacción de Bitcoin por commit.
  • Enviarlos a un calendario público y seguir la prueba pendiente hasta que se confirme.
  • Almacenar el archivo de prueba resultante en algún lugar duradero y vinculado al commit correcto.
  • Repetir todo mañana, y después de cada force-push, hotfix y tren de merges.

Incluso con scripts, eso es un trabajo a tiempo parcial. Alguien tiene que ser dueño del script, del ejecutor de cron, de la ubicación de almacenamiento y del incidente «por qué falta la prueba de la semana pasada». Y en el momento en que esa persona cambia de equipo, el pipeline se pudre.

El protocolo OpenTimestamps en bruto es genuinamente elegante — puedes leer cómo funciona en Alternativa a OpenTimestamps: GitHub App gestionada para cada commit. Este artículo trata del otro problema: hacerlo funcionar sin supervisión, para siempre.

El objetivo es configurar y olvidarse: cada commit a un repositorio monitorizado se ancla cada noche, sin intervención de los desarrolladores y sin nada instalado en el portátil de nadie.

Configuración única: instala la GitHub App

Timestamp GIT es un servicio gestionado construido en torno a una GitHub App. La configuración lleva minutos y se hace una vez por cuenta u organización.

1. Instala la app. Desde el panel de Timestamp GIT, instala la GitHub App en tu cuenta personal o en tu organización.

2. Selecciona repositorios. Elige todos los repositorios o un subconjunto específico. Puedes ajustar la selección más adelante sin reinstalar.

3. Confirma los permisos. El modelo de permisos es deliberadamente limitado:

Acceso Ámbito Motivo
Solo lectura Repositorio de origen El sistema de permisos de GitHub no tiene un ámbito de «solo hash de commit», así que la app necesita acceso de lectura para ver los hashes de commit de HEAD
Lectura y escritura Repositorio de destino Las pruebas se escriben de vuelta como archivos de manifiesto y recibos .ots en una rama dedicada o en un repositorio sombra

4. Olvídate. No hay YAML que añadir, ni secreto que rotar, ni CLI que instalar. Tus desarrolladores siguen haciendo commits exactamente como ahora; la app reacciona a los webhooks en segundo plano.

Si tus repositorios son públicos, el nivel Open Source cubre esto de serie. Los repositorios privados empiezan en el nivel Pro Agency — el desglose de precios cubre qué nivel encaja con cada tipo de equipo.

La alternativa más estricta: modo Enterprise ZK

El modo estándar requiere acceso de lectura a tu repositorio de origen. Si tu política lo prohíbe —o simplemente no quieres que ningún tercero pueda leer tu código— el modo Enterprise ZK invierte la dirección. En lugar de tirar (pull), tu lado empuja (push): 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. Tu código fuente nunca sale de tu entorno, y el servicio no necesita ningún acceso de lectura al repositorio de origen. Solo el repositorio de destino (donde se escriben las pruebas) necesita acceso de escritura.

El pipeline automatizado: del commit a Bitcoin

Esto es lo que ocurre tras la configuración, sin que hagas nada.

1. Detección de commits. Los nuevos commits llegan a través de los webhooks de la GitHub App (modo estándar) o a través de hashes enviados por tu GitHub Action (modo Enterprise ZK).

2. Cola de hashes. Los hashes de commit llegan a un almacén clave-valor en memoria y esperan al lote nocturno. Fíjate en lo que no hay en ese almacén: tu código. Solo hashes.

3. Worker de cron a medianoche. Una vez por noche, un worker:

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

4. Entrega de pruebas. El manifiesto y los archivos de recibo .ots se envían de vuelta a tu repositorio — ya sea en una rama dedicada timestamps junto a tu código o en un repositorio sombra separado.

Expectativas de tiempo. Bitcoin no confirma al instante. La transacción de anclaje suele confirmarse en unas tres horas, así que espera que las pruebas aparezcan unas horas después de la medianoche UTC. Si estás mirando a las 00:05 UTC y no ves nada, no hay ningún problema.

La superficie de API para flujos de trabajo personalizados

El pipeline se ejecuta solo, pero la API te permite conectar los datos de prueba a tus propias herramientas. Todos los endpoints están autenticados donde se indica.

# Último bloque de Bitcoin anclado para un repositorio (público)
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api

# Total de commits sellados (público)
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api

# Resumen combinado, útil para Shields.io
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api

# Datos completos de la cadena de Merkle para un día concreto, para verificación local
curl -s https://timestampgit.dev/api/verify/acme/payments-api/2026-10-25

# Libro de auditoría en CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/acme/payments-api

# Certificado PDF para una fecha
curl -s -o certificate.pdf https://timestampgit.dev/api/report/acme/payments-api/2026-10-25

Las instalaciones Enterprise ZK también usan el endpoint de commits autenticado con HMAC, donde {hash} es el valor HMAC devuelto por la URL firmada que solicita tu Action:

curl -X POST \
  "https://timestampgit.dev/api/timestamp/acme/payments-api/timestamps/<hmac>/<commitId>"

Esa es toda la superficie de integración. No hay ninguna llamada de «iniciar un lote» que programar — el agrupamiento es trabajo del servicio.

Monitorización y gestión de fallos

La automatización que no monitorizas es solo optimismo. Timestamp GIT te da tres formas independientes de confirmar que el pipeline está sano.

El panel de estado público

Cada repositorio tiene un panel público en /status/{user}/{repo} que muestra:

  • La longevidad de las pruebas y la fecha de anclaje más antigua — hasta dónde llega tu cadena de prueba.
  • La regularidad diaria, representada como un mapa de calor de calendario, para que una noche perdida sea visualmente obvia.
  • Los datos de bloque y transacción de Bitcoin de cada anclaje.

Insignias de verificación

Incrusta una insignia de Shields.io en tu README para hacer pública la prueba:

![Timestamped](https://timestampgit.dev/api/statusSummary/acme/payments-api)

La página /connected/{user}/{repo} te da un widget para incrustar la insignia con una vista previa en vivo, incluido el fragmento de markdown. Para repositorios privados, las URL de estado llevan un HMAC cifrado específico de la instancia del servidor — el estado solo es visible para quienes tienen el enlace firmado.

Comprobación de salud autoalojada

Como los endpoints de estado son JSON simple, un pequeño script en tu propio CI detecta un pipeline atascado antes que un auditor:

import requests

BASE = "https://timestampgit.dev"
USER, REPO = "acme", "payments-api"

r = requests.get(f"{BASE}/api/statusLast/{USER}/{REPO}", timeout=15)
r.raise_for_status()

last = r.json()  # last anchored Bitcoin block info for this repository
print(last)
# Compare against yesterday's stored value in your own job to detect a stalled batch.

¿Y si un lote nocturno no se completa? La señal observable es la misma en todos los casos: el mapa de calor muestra un hueco y el último bloque anclado deja de avanzar. Como el anclaje se agrupa por día, una ejecución perdida es visible en 24 horas en lugar de en el momento de la auditoría — y como la cola de hashes y los manifiestos están indexados por fecha, una reejecución produce una prueba distinta y fechada en lugar de una ambigua. Revisa primero el panel y luego la rama timestamps del repositorio para confirmar si se escribieron el manifiesto y los recibos.

El rastro de auditoría

Para las revisiones de cumplimiento, dos artefactos hacen el trabajo pesado:

  • GET /api/audit/{user}/{repo} — el libro completo en CSV.
  • GET /api/report/{user}/{repo}/{date} — un certificado PDF para una sola fecha.

Y cuando alguien quiere comprobar las cuentas en lugar de confiar en un PDF, la página /verification/{user}/{repo}/{date} recorre la cadena de Merkle multinivel paso a paso. Todo ese cálculo ocurre localmente en el navegador — nada de lo que verificas se envía al servidor.

Buenas prácticas para el sellado de tiempo automatizado

Una vez que el pipeline está en marcha, unos cuantos hábitos mantienen la evidencia útil:

  • Haz commits pronto y a menudo. Cada commit es un punto de datos para el estado de la técnica. Aplastar un mes de trabajo en un solo commit justo antes de una presentación te da un anclaje en lugar de cuarenta.
  • Mantén las pruebas en su propia rama. La rama automatizada timestamps la escribe la máquina; mantenerla separada de las ramas de funcionalidad mantiene git log legible y evita ruido de merges.
  • Verifica periódicamente, no solo en el momento de la disputa. Comprueba una fecha reciente a través del verificador web cada trimestre. Descubrir una cadena de verificación rota durante un litigio es un mal momento para descubrirlo.
  • Distribuye las pruebas con las releases. Adjunta el manifiesto y los recibos de la fecha de tu release a los artefactos de la release, y haz referencia a la fecha en tu documentación legal.
  • Etiqueta todo lo que podrías patentar. Los commits se capturan automáticamente; en el momento en que empieces a hablar de una idea patentable, asegúrate de que el trabajo esté en un commit en lugar de quedarse en una rama local.

Automatización autoalojada con Docker

El alojamiento gestionado es lo predeterminado, pero algunos entornos no pueden usarlo: redes aisladas, requisitos estrictos de residencia de datos o políticas internas que prohíben que cualquier servicio externo toque los metadatos del repositorio.

Para esos casos, Timestamp GIT se distribuye como imagen de Docker. La automatización es idéntica —el mismo agrupamiento nocturno, la misma construcción del árbol de Merkle y el mismo anclaje en Bitcoin, solo que ejecutándose en tu infraestructura.

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 una vez que arranca. En el primer inicio, 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 licencias de Docker —nombre, empresa, correo electrónico y un número de teléfono opcional. Hay un archivo de licencia de demostración por tiempo limitado disponible para descargar, y lo subes durante la fase de configuración on-premises.

Preguntas frecuentes

¿Necesito ejecutar comandos o instalar herramientas en las máquinas de mis desarrolladores? No. Timestamp GIT funciona enteramente a través de la GitHub App. Una vez instalada, cada commit a un repositorio monitorizado se sella automáticamente cada noche. Sin herramientas CLI, sin comandos de OpenTimestamps, sin pasos manuales.

¿Cuánto tarda un commit en sellarse? Los commits se agrupan y se anclan una vez por noche. La transacción de Bitcoin suele confirmarse en unas 3 horas, así que las pruebas suelen estar disponibles unas horas después de la medianoche UTC.

¿Puedo verificar el sello de tiempo de forma independiente sin confiar en Timestamp GIT? Sí. Los archivos de recibo .ots se pueden verificar con las herramientas estándar de OpenTimestamps contra la blockchain de Bitcoin. La prueba depende solo de SHA-256 y de los datos de bloque de Bitcoin, así que puedes verificar sin conexión incluso si nuestro servicio desaparece.

¿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 nuestra API. Nunca tenemos acceso de lectura a tu código fuente. Como alternativa, autoaloja con Docker para tener control total.

¿El pipeline de sellado de tiempo toca mi código fuente? No. El modo estándar lee hashes de commit; el modo Enterprise ZK nunca ve el contenido de tu repositorio. El servicio solo maneja hashes SHA-256 y datos de bloque de Bitcoin.

El sello de tiempo en el que no tienes que pensar

El valor del estado de la técnica criptográfico proviene de la cobertura, no de una única prueba impresionante. Un commit sellado de una tarde heroica no prueba casi nada; dieciocho meses de anclajes nocturnos prueban una cronología. Eso es un problema de volumen, y los problemas de volumen se resuelven con automatización.

Ese es todo el argumento de Timestamp GIT: instala la GitHub App una vez, elige tus repositorios y deja que el trabajo nocturno haga el resto. Las pruebas llegan a una rama timestamps, las insignias llegan a tu README y el CSV de auditoría está ahí cuando lo pide legal. Si necesitas aislamiento, el modo Enterprise ZK o Docker te llevan allí sin renunciar a la automatización.

Instala la app, haz push de un commit y revisa el panel mañana por la mañana.


Artículos relacionados

EU label: AI-generated content