Automatiza el sellado de tiempo con Bitcoin de cada commit de Git
El sellado de tiempo manual tiene el mismo modo de fallo que las copias de seguridad manuales: funciona a la perfección hasta la semana en la que estás ocupado. Y la semana en la que estás ocupado es exactamente la semana en la que publicas la funcionalidad que más adelante necesitarás demostrar que publicaste.
Este artículo trata de eliminar al humano de ese bucle. No “acuérdate de sellar antes de hacer merge”, no un elemento de una lista de verificación en tu runbook de publicación, sino una instalación única que convierte cada commit de un repositorio monitorizado en una prueba anclada en Bitcoin y agrupada en un árbol de Merkle, automáticamente, cada noche, tanto si alguien del equipo está pensando en la protección de la propiedad intelectual como si no.
Si todavía estás decidiendo si la prueba criptográfica de arte previo importa en tu situación, consulta Prove Prior Art Before You File: A Founder’s Guide. Este artículo da por hecho que ya lo has decidido y que ahora quieres que funcione en piloto automático.
La trampa del sellado de tiempo manual (y por qué gana la automatización)
Hacerlo a mano parece engañosamente sencillo. En la práctica, un flujo de trabajo manual significa que alguien del equipo debe:
- Acordarse de sellar después de cada commit significativo, antes de que la rama se reescriba, se aplaste (squash) o se fuerce el push.
- Gestionar el material de claves y los archivos de prueba localmente, en un lugar que sobreviva a formateos de portátiles y a la rotación de personal.
- Guardar los recibos resultantes en algún sitio duradero, versionado y localizable dos años después durante la due diligence.
- Repetirlo para cada commit, en cada repositorio, para siempre.
Ese último punto es donde mueren los procesos manuales. La cobertura es inconsistente, y una cobertura inconsistente es peor de lo que parece: en una disputa, un hueco en tu cadena de pruebas invita al argumento de que este commit, el que importa, fue la excepción. Un push olvidado un viernes por la tarde puede convertir una cronología limpia en un signo de interrogación.
El protocolo OpenTimestamps subyacente está genuinamente bien diseñado, y puedes manejarlo tú mismo con herramientas de línea de comandos en bruto y anclaje manual en Bitcoin: a las duras, por tu cuenta y tu tiempo. Para un equipo que publica a diario y no tiene a una persona dedicada a criptografía, eso es un proyecto de mantenimiento disfrazado de control de seguridad.
La automatización gana porque convierte una decisión recurrente en una configuración única. Instala una GitHub App una vez y, desde ese momento, cada commit del repositorio monitorizado se captura, se encola, se agrupa, se ancla y se archiva de vuelta en tu repositorio sin que ningún desarrollador toque nada.
Configuración única: instala la GitHub App y olvídate
La configuración es la parte más corta de este artículo, y esa es la idea.
- Instala la GitHub App de Timestamp GIT. Elige un único repositorio o concédela a toda tu organización: cada repositorio monitorizado obtiene sus propias pruebas independientes.
- Elige el origen y el destino. La App lee los hashes de commit de tu repositorio de origen y escribe las pruebas en un repositorio de destino, ya sea una rama
timestampsdedicada en el mismo repositorio o un repositorio sombra separado. - Confirma los permisos. El modo estándar necesita acceso de solo lectura al repositorio de origen, porque el modelo de permisos de GitHub no tiene un ámbito de “solo hashes de commit”. Se necesita acceso de escritura en el repositorio de destino para que las pruebas puedan confirmarse de vuelta. Esa es toda la superficie de permisos.
No se instala nada en las máquinas de los desarrolladores. Ni herramientas de CLI, ni hooks de pre-commit, ni archivos de claves que distribuir, ni un paso de incorporación para los nuevos fichajes. Los desarrolladores siguen ejecutando git commit y git push exactamente como antes.
Para las organizaciones que no quieren que el servicio alojado tenga acceso de lectura al código fuente en absoluto, existe el modo Enterprise ZK: una breve GitHub Action (12 líneas) se ejecuta dentro de tu propia infraestructura y envía solo el hash del commit a la API, de modo que el código fuente nunca sale de tu entorno. En este modo, la App no necesita acceso de lectura al repositorio de origen: simplemente instalas la Action. La mayoría de los equipos empiezan con el modo gestionado estándar y tratan el modo ZK como una opción para sus repositorios más sensibles. El recorrido completo de permisos está en Set Up IP Protection With a Single GitHub App Install.
Dentro del pipeline automatizado: del commit al anclaje en Bitcoin
Una vez instalado, el pipeline se ejecuta según su propio calendario. Esto es lo que ocurre entre tu git push y una prueba verificable:
- Detección de commits. La GitHub App recoge los nuevos commits mediante webhooks. En el modo Enterprise ZK, tu GitHub Action envía los hashes de commit a la API en su lugar.
- Cola de hashes. Los hashes de commit llegan a un almacén clave-valor en memoria, a la espera del lote nocturno. Fíjate en lo que llega aquí: hashes, no código.
- Worker cron de medianoche. Un worker se despierta, agrupa todos los hashes pendientes y escribe un archivo manifiesto
.txtpor repositorio. - Construcción del árbol de Merkle. El worker construye un árbol de Merkle de forma nativa sobre el lote de ese día y luego genera pruebas de OpenTimestamps contra los calendarios públicos de OTS.
- Anclaje en Bitcoin. La raíz de Merkle se ancla en un bloque de Bitcoin. La confirmación suele tardar unas tres horas, así que la entrega de pruebas llega unas horas después de que se ejecute el lote.
- Entrega de pruebas. El manifiesto y los archivos de recibo
.otsse confirman de vuelta en tu repositorio de destino automáticamente.
Dos propiedades de este diseño importan más que la mecánica:
- Conocimiento cero por construcción. El servicio nunca ve, copia ni almacena tu código fuente. Maneja hashes de commit y una raíz de Merkle. El estado de tu repositorio nunca entra en el pipeline.
- Independencia del proveedor. Las pruebas se apoyan únicamente en SHA-256 y en los datos de los bloques de Bitcoin. Si Timestamp GIT desapareciera mañana, los recibos de tu repositorio seguirían siendo verificables contra la blockchain de Bitcoin con las herramientas estándar de OpenTimestamps. Para el trabajo diario usarás la página de verificación o la API: consulta How to Verify a Bitcoin Timestamp Proof for Your Code.
Monitorización y gestión de fallos: garantizar que cada commit se ancle
La automatización que no monitorizas no es más que un cron job esperanzado. Timestamp GIT expone suficiente superficie para hacer observable la cobertura.
Panel de estado. Cada repositorio monitorizado tiene una página de estado pública en https://timestampgit.dev/status/{user}/{repo} que muestra la longevidad de las pruebas, la fecha del primer anclaje, la regularidad diaria, los datos del bloque y de la transacción de Bitcoin, un mapa de calor de calendario con los días anclados y exportaciones de auditoría descargables.
Insignias embebibles. Las insignias de Shields.io pueden ir directamente en tu README, con fragmentos de markdown generados justo después de conectar el repositorio. Cualquiera puede hacer clic para verificar el sello de tiempo públicamente.
API para alertas personalizadas. Consulta el estado y concilia los recuentos desde tus propias herramientas:
# Latest anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api | jq
# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api | jq
# Combined summary (what the badge uses)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api | jq
Una comprobación nocturna mínima que señala un hueco antes de que se convierta en un problema de pruebas:
import datetime, requests
REPO = "https://timestampgit.dev/api"
USER, SLUG = "acme", "payments-api"
summary = requests.get(f"{REPO}/statusSummary/{USER}/{SLUG}", timeout=30).json()
last = requests.get(f"{REPO}/statusLast/{USER}/{SLUG}", timeout=30).json()
# Alert if nothing has been anchored in the last 48 hours
print("summary:", summary)
print("last anchor:", last)
Apunta eso a tu canal de alertas y habrás cerrado el bucle: un día perdido se convierte en una notificación en lugar de un descubrimiento durante la due diligence.
Escenarios de fallo. Los webhooks se pierden, los calendarios a veces se caen y las redes tienen hipos. Como los hashes esperan en una cola en lugar de sellarse en línea, un hash sin anclar simplemente pasa al siguiente lote nocturno. No se pierde nada; se aplaza. El síntoma visible es un día que falta en el mapa de calor o un valor de statusLast estancado, que es exactamente lo que detectan las comprobaciones anteriores.
Exportaciones de cumplimiento. Para las auditorías, descarga el libro mayor completo como CSV o un certificado PDF por día:
curl -sO https://timestampgit.dev/api/audit/acme/payments-api
curl -sO https://timestampgit.dev/api/report/acme/payments-api/2026-11-22
Los repositorios privados añaden un HMAC cifrado a sus URL de estado, de modo que solo los usuarios autorizados pueden leer su estado; el HMAC es específico de la instancia del servidor.
Buenas prácticas para el sellado de tiempo automatizado
- Vigila la rama de timestamps, no solo el panel. La aparición de nuevos manifiestos y archivos
.otses tu fuente de verdad de que la entrega funcionó de principio a fin. - Usa un repositorio de destino dedicado para las pruebas cuando puedas. Mantiene limpio el historial de tu código fuente y facilita entregar las pruebas a tus abogados sin exportar tu base de código.
- Verifica periódicamente, no solo una vez. Programa una comprobación trimestral contra la página de verificación pública o
/api/verify/{user}/{repo}/{date}. Todo el cálculo de verificación ocurre localmente en el navegador: nadie ve lo que verificas. - Ancla la cobertura en tu proceso, no en tu memoria. Si un repositorio es crítico para el negocio, instala la App en toda la organización en lugar de repositorio por repositorio; el modo de fallo de la instalación selectiva es un repositorio que nadie recuerda incorporar.
- Ajusta el despliegue a tu modelo de amenazas. Para entornos aislados (air-gapped) o de máxima seguridad, Timestamp GIT se ejecuta como una imagen Docker autoalojada. 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 instancia está disponible en http://localhost:8080, y un asistente de primer arranque te guía para conectar tu GitHub App. Hay una licencia de demostración por tiempo limitado disponible a través del formulario de solicitud en la página Docker License (nombre, empresa, correo electrónico, teléfono opcional).
Preguntas frecuentes
¿Tengo que instalar algún software en las máquinas de mis desarrolladores? No. Timestamp GIT funciona enteramente mediante una GitHub App o una GitHub Action. Los desarrolladores solo hacen commit como de costumbre; la automatización se encarga del resto.
¿Qué pasa si se hace un commit después del corte nocturno? Se incluirá en el lote de la noche siguiente. El sistema encola todos los hashes pendientes y los ancla juntos.
¿Puedo automatizar el sellado de tiempo para varios repositorios? Sí. Puedes instalar la GitHub App en varios repositorios o en toda una organización, y cada repositorio obtiene sus propias pruebas.
¿Cómo verifico que un commit tiene sello de tiempo? Puedes usar la página de verificación pública o la API para comprobar la prueba de Merkle contra la blockchain de Bitcoin. Las insignias también muestran el estado.
¿Qué pasa si hago push de varios commits en un día? Todos se recogen en el lote del día, se pliegan en un único árbol de Merkle y se anclan juntos bajo una sola transacción de Bitcoin. Aun así obtienes manifiestos por repositorio, de modo que los hashes de commit individuales siguen siendo rastreables dentro del lote.
¿Puedo sellar commits de repositorios privados? Sí: los repositorios privados son compatibles con el plan Pro Agency (49 $/mes) y con Enterprise ZK (199 $/mes, GitHub Actions). Los repositorios públicos son gratuitos en el nivel Open Source.
¿Cuánto tarda un commit en anclarse? Normalmente unas horas después de que se ejecute el lote nocturno. La propia confirmación de Bitcoin suele tardar unas tres horas, así que las pruebas llegan a tu repositorio unas horas después de medianoche.
¿La prueba es verificable sin Timestamp GIT? Sí. Las pruebas se basan solo en SHA-256 y en los datos de los bloques de Bitcoin, así que pueden comprobarse de forma independiente contra la blockchain: sin tecnología propietaria y sin dependencia de proveedor.
Conclusión
El valor de la prueba de arte previo proviene de la cobertura, y la cobertura proviene de la automatización. Un proceso de sellado de tiempo que depende de que una persona se acuerde de ejecutar algo tendrá agujeros, y los agujeros son lo que busca la parte contraria.
Timestamp GIT gestiona el protocolo OpenTimestamps por ti: instala la GitHub App una vez, deja que el cron nocturno ancle cada commit en Bitcoin, vigila las insignias y los endpoints de estado, y guarda los recibos .ots en un repositorio que tú controlas. La configuración lleva minutos; después, la única tarea continua es echar un vistazo a una alerta que nunca debería dispararse.
Empieza con el nivel gratuito Open Source en un repositorio público, o conecta uno privado en Pro Agency y deja que el primer lote se ejecute esta noche. Para una visión más amplia de lo que cuesta esto frente a montarlo por tu cuenta, lee Code Timestamping Costs Compared: Managed vs DIY.
Entradas relacionadas
- Code Timestamping Costs Compared: Managed vs DIY
- Set Up IP Protection With a Single GitHub App Install
- How to Verify a Bitcoin Timestamp Proof for Your Code