Timestamp GIT

← Todos los artículos

2026-10-18

Configuración de la GitHub App para sellado de tiempo en blockchain: instala una vez, sella para siempre

Configuración de la GitHub App para sellado de tiempo en blockchain: instala una vez, sella para siempre
timestamp git blockchain proof

Configuración de sellado de tiempo en blockchain con GitHub App: instala una vez, sella para siempre

Aquí está la tarea en una frase: instala la GitHub App de Timestamp GIT en un repositorio para que cada commit que subas quede anclado automáticamente en la blockchain de Bitcoin cada noche — sin herramientas CLI, sin pasos manuales, sin cambios en cómo trabaja tu equipo.

Puedes hacerlo por las malas: ejecutar tú mismo las herramientas de OpenTimestamps, gestionar calendarios, construir tu propio batching de Merkle y estar pendiente de las confirmaciones de Bitcoin. Eso es un trabajo a tiempo parcial. Timestamp GIT existe para que no sea tu trabajo en absoluto. Esta guía recorre la ruta de configuración que recomendamos: una instalación, una selección de repositorio, una pantalla de configuración y, después, un pipeline nocturno en el que nunca más tendrás que pensar.

Al final tendrás un recibo .ots diario para tus commits, una insignia de verificación en tu README y un panel de estado público que cualquiera — un abogado, un auditor, un cliente — puede consultar sin necesidad de cuenta.

Qué vas a configurar (y por qué es una tarea única)

La tarea exacta: conectar un repositorio a la GitHub App para que la detección de commits, el batching de hashes, el anclaje en Bitcoin y la entrega de pruebas ocurran sin ti.

Lo que obtienes:

  • Un recibo .ots inmutable por día — una prueba criptográfica de que un conjunto específico de hashes de commit existía en una fecha concreta.
  • Una insignia de verificación que puedes colocar en tu README para que el estado de la prueba sea público.
  • Un panel de estado con fechas de anclaje, datos de bloques y transacciones de Bitcoin, regularidad diaria y exportaciones de auditoría descargables.

Vale la pena interiorizar el reparto de tareas, porque explica por qué la configuración es una tarea única:

  1. La GitHub App detecta commits mediante webhooks.
  2. Timestamp GIT agrupa los hashes de commit a medianoche, construye un árbol de Merkle y ancla la raíz de Merkle en Bitcoin usando el protocolo OpenTimestamps.
  3. Los archivos de manifiesto y del recibo .ots se suben de vuelta a una rama dedicada timestamps o a un repositorio sombra que tú controlas.

Existen dos modos de despliegue, y esta guía sigue el primero:

  • Modo estándar (GitHub App) — totalmente gestionado, sin código en tu CI, lee únicamente el hash del commit HEAD de los repositorios monitorizados.
  • Modo Enterprise ZK — una pequeña GitHub Action que se ejecuta en tu propia infraestructura envía solo los hashes de commit a la API de Timestamp GIT, y solo se requiere acceso de lectura-escritura al repositorio de pruebas de destino.

Si necesitas el contexto conceptual sobre por qué todo esto importa — trolls de patentes, disputas con empleados, reclamaciones de “clean room” — lee primero ¿Qué es el prior art criptográfico?. Este artículo asume que ya has decidido que lo quieres y que ahora quieres que funcione.

Requisitos previos antes de instalar

  • Una cuenta de GitHub con permisos de administrador sobre el repositorio de destino (público o privado).
  • Una cuenta de Timestamp GIT con un plan acorde a la visibilidad de tu repositorio: Open Source (gratis, repositorios públicos), Pro Agency ($49/mes, repositorios privados) o Enterprise ZK ($199/mes, GitHub Actions).
  • Una decisión sobre dónde deben vivir las pruebas: una rama dedicada timestamps en el mismo repositorio, o un repositorio sombra separado.
  • Claridad sobre el modelo de permisos: el modo estándar requiere acceso de solo lectura al repositorio de origen y acceso de lectura-escritura al repositorio de destino. El modo Enterprise ZK requiere acceso de lectura-escritura solo al repositorio de destino, más una GitHub Action instalada en tu repositorio de origen.
  • Básicamente nada más. No hay nada que instalar en las máquinas de los desarrolladores. Sin configuración local, sin hooks, sin variables de entorno por desarrollador.

Paso 1 — Instala la GitHub App de Timestamp GIT

  1. Ve al listado de la GitHub App de Timestamp GIT y haz clic en Install.
  2. Elige la cuenta u organización de GitHub propietaria del repositorio.
  3. Selecciona Only select repositories y elige el/los repositorio(s) que quieres monitorizar — o concede acceso a todos los repositorios de la cuenta.
  4. Aprueba los permisos solicitados. En el modo estándar eso significa acceso de solo lectura al repositorio de origen (el sistema de permisos de GitHub no tiene un alcance de “solo hash de commit”) y acceso de lectura-escritura al repositorio de destino donde se escriben las pruebas.
  5. Confirma la redirección de vuelta a Timestamp GIT y espera el mensaje de éxito.

Eso es la instalación. Es un flujo normal de tipo OAuth de GitHub App y tarda alrededor de un minuto.

Paso 2 — Conecta y configura tu repositorio

Ve a Your Repositories (/repos) y confirma que el repositorio recién accesible aparece en la lista. Si no aparece, casi con seguridad seleccionaste la cuenta equivocada durante la instalación.

Después abre la página de conexión del repositorio y configura el destino de tus pruebas:

  • Mismo repositorio, rama dedicada — las pruebas aterrizan en una rama timestamps junto a tu código. Simple, autocontenido, fácil de encontrar.
  • Repositorio sombra separado — las pruebas aterrizan en un repositorio de tu elección. Útil cuando el repositorio de origen tiene una audiencia restringida o cuando quieres un libro de pruebas centralizado para muchos proyectos.

Si usas un repositorio sombra, créalo o selecciónalo y confirma que Timestamp GIT tiene acceso de lectura-escritura sobre él. Un permiso ausente o revocado aquí es la causa más común de “por qué no aparece nada” más adelante.

Mientras estás en esta página, activa la insignia del README. La página de conexión muestra una vista previa en vivo de la insignia de Shields.io y te entrega el fragmento de markdown exacto — no escribas las URLs a mano, ya que los repositorios privados requieren un componente HMAC específico de la instancia.

Guarda la configuración. La app ya está armada: a partir de este momento, los webhooks le informan de cada nuevo commit en la rama monitorizada.

Paso 3 — Deja que se ejecute el anclaje nocturno (y sabe qué esperar)

No se requiere nada más de tu parte. Esto es lo que ocurre a medianoche:

  1. Detección de commits — la GitHub App ya ha capturado los nuevos hashes de commit mediante webhooks.
  2. Cola de hashes — los hashes esperan en un almacén clave-valor en memoria, aguardando la ventana de batching.
  3. Worker cron de medianoche — los hashes pendientes se agrupan, se genera un archivo de manifiesto .txt por repositorio, se construye un árbol de Merkle de forma nativa, se crean las pruebas de OpenTimestamps usando los calendarios públicos de OTS y la raíz de Merkle se ancla en la blockchain de Bitcoin.
  4. Entrega de pruebas — los archivos de manifiesto y del recibo .ots se suben de vuelta a la rama timestamps de tu repositorio o al repositorio sombra.

Lo que aparece en el repositorio de destino tiene más o menos este aspecto:

timestamps/
  manifests/
    2026-10-18.txt        # the commit hashes batched that day
  proofs/
    2026-10-18.txt.ots    # the OpenTimestamps receipt for that manifest

Expectativas de tiempos. El lote se ejecuta a medianoche, y la confirmación de Bitcoin tarda varias horas — normalmente alrededor de tres. Así que si subes a las 09:00, espera que las pruebas aterricen a media mañana del día siguiente. Esto es una propiedad de Bitcoin, no un fallo del pipeline.

Qué sale de tu repositorio: solo hashes de commit. Timestamp GIT nunca lee, copia ni almacena tu código fuente. El código permanece en GitHub (o, en el modo Enterprise ZK, enteramente en tu propio entorno) y solo se sella el hash.

Y luego se repite. Cada noche, para siempre, para cada commit futuro. Instalaste una vez; el pipeline se encarga del resto.

Paso 4 — Añade la insignia de verificación a tu README

Coge el fragmento de markdown de la página de conexión del repositorio — los mismos datos están disponibles programáticamente desde el endpoint autenticado GET /api/badgeLink/{user}/{repo}, que devuelve URLs de insignia y fragmentos de markdown.

El fragmento tiene esta forma (usa el botón de copiar; las URLs reales son específicas de la instancia y del repositorio, especialmente para repositorios privados):

[![Bitcoin timestamped](<badge-url-from-badgeLink>)](<status-page-url>)

Pégalo en tu README, haz commit y súbelo. Cualquiera que haga clic en la insignia llega a la vista pública de verificación — sin cuenta, sin login, sin conocimientos especiales.

Una nota sobre repositorios privados. Las URLs de estado para repositorios privados añaden un HMAC cifrado. Eso significa que solo los usuarios autorizados pueden ver el estado de la prueba, mientras que el anclaje subyacente en Bitcoin sigue siendo verificable públicamente por cualquiera que tenga el archivo .ots. El HMAC es específico de tu instancia de servidor, por lo que debes copiar la URL de la insignia en lugar de construirla.

Opcional pero recomendable: incrusta la misma insignia en un sitio de documentación interno o en un panel de ingeniería. Es solo una URL de imagen más un enlace.

Paso 5 — (Opcional) Autoaloja con Docker para entornos aislados

Elige el autoalojamiento cuando quieras máxima seguridad, una red aislada o garantías estrictas de residencia de datos que un servicio gestionado no puede satisfacer.

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

Después descárgalo e inícialo:

docker compose pull
docker compose up -d
docker compose logs -f timestampgit

Tras el arranque, la aplicación está disponible en http://localhost:8080. En el primer inicio, un asistente de configuración te guía para conectar tu GitHub App y configurar tu instancia.

Hay disponible una licencia de demostración por tiempo limitado para evaluación enviando el formulario de solicitud en la página de licencia de Docker (/docker-license) con tu nombre, empresa, correo electrónico y un número de teléfono opcional. Una vez aprobada, se puede descargar un archivo de licencia de demostración por tiempo limitado.

Cómo confirmar que funcionó

Dale un ciclo completo (lote de medianoche más unas tres horas) y luego verifica:

  • Panel de estado — abre /status/{user}/{repo}. Deberías ver la longevidad de las pruebas, la fecha de anclaje más temprana, la regularidad diaria, datos de bloques y transacciones de Bitcoin, y un mapa de calor de calendario.
  • CSV de auditoría — GET /api/audit/{user}/{repo} descarga el libro de auditoría completo.
  • Certificado PDF — GET /api/report/{user}/{repo}/{date} genera un certificado para un día concreto.
  • Recorrido de la cadena de Merkle — /verification/{user}/{repo}/{date} muestra la verificación multinivel paso a paso. Todo el cálculo ocurre localmente en tu navegador, así que nadie — incluidos nosotros — ve lo que verificas.
  • Endpoints públicos de estado — comprobaciones rápidas:
curl -s https://timestampgit.dev/api/statusLast/{user}/{repo}
curl -s https://timestampgit.dev/api/statusCount/{user}/{repo}
curl -s https://timestampgit.dev/api/statusSummary/{user}/{repo}

statusLast devuelve el último bloque de Bitcoin anclado, statusCount devuelve el recuento total de commits confirmados y sellados, y statusSummary agrupa los datos para Shields.io.

Si quieres el recorrido más profundo y offline para convertir un archivo .ots en una altura de bloque de Bitcoin verificada, lo cubrimos por separado en Cómo verificar localmente una prueba de sellado de tiempo en Bitcoin.

Solución de problemas comunes de configuración

No aparecen pruebas después de 24 horas. Confirma que la app realmente tiene acceso al repositorio correcto (revisa /repos) y confirma que se subió al menos un commit después de la instalación. Los commits anteriores a la instalación nunca se enviaron a la cola de hashes.

La insignia se muestra como “unknown”. Comprueba el slug del repositorio en la URL de la insignia. Para repositorios privados, asegúrate de que el componente HMAC cifrado está presente — una URL reducida fallará la autorización y no devolverá ningún estado.

Fallan los push al repositorio sombra. Timestamp GIT necesita acceso de lectura-escritura al repositorio de destino. Vuelve a comprobar los permisos de instalación específicamente en el repositorio sombra; los permisos del repositorio de origen no se extienden a él.

El modo Enterprise ZK no produce nada. En ese modo no hay detección de commits basada en webhooks. Si la GitHub Action no está instalada en el repositorio de origen y enviando hashes activamente a la API, ningún hash llega nunca al servicio.

Las pruebas llegan con unas horas de retraso. Es lo esperado. El lote se ejecuta a medianoche y la confirmación de Bitcoin suele tardar alrededor de tres horas. Los retrasos aquí son cuestión de los tiempos de la blockchain, no un fallo.

FAQ

¿Necesito instalar alguna herramienta CLI o ejecutar comandos de OpenTimestamps?

No. Timestamp GIT es una GitHub App gestionada: la instalas una vez y cada commit a un repositorio monitorizado se ancla automáticamente en Bitcoin cada noche. No hay herramientas CLI, ni comandos de OpenTimestamps, ni nada que instalar en las máquinas de los desarrolladores.

¿Puedo usar la GitHub App con repositorios privados?

Sí. Los repositorios privados son compatibles con el plan Pro Agency. Las URLs de estado para repositorios privados añaden un HMAC cifrado para que solo los usuarios autorizados puedan ver el estado de la prueba.

¿Cuánto tarda en aparecer mi primera prueba de sellado de tiempo?

Los commits se agrupan y se anclan mediante un worker cron de medianoche. La confirmación de Bitcoin suele tardar alrededor de tres horas, así que los archivos de manifiesto y del recibo .ots se suben de vuelta a tu repositorio unas horas después de que se ejecute el lote.

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

Las pruebas son independientes del proveedor. Se basan solo en SHA-256 y en datos de bloques de Bitcoin a través del protocolo OpenTimestamps, así que puedes verificarlas offline usando herramientas estándar incluso si el servicio ya no existe.

Conclusión

Todo el sentido de una configuración de sellado de tiempo en blockchain con GitHub App es que debería ser aburrida: instala una vez, selecciona un repositorio, elige dónde van las pruebas y deja que un trabajo nocturno haga el resto. Todo lo que viene después del paso dos es esperar a que Bitcoin confirme.

En ese momento tienes algo que la mayoría de los equipos no tiene — prueba matemáticamente indiscutible de cuándo existió tu código, verificable offline, sin que tu código fuente salga nunca de tu repositorio. Eso es prior art que puedes entregar a un abogado, un auditor o un cliente sin que un solo desarrollador cambie su flujo de trabajo.

Instala la GitHub App primero en tu repositorio más valioso y luego expande desde ahí. Si prefieres ejecutarlo dentro de tu propio perímetro, la licencia autoalojada de Docker es el mismo producto con tu infraestructura debajo.

Entradas relacionadas

EU label: AI-generated content