Timestamp GIT

← Todos los artículos

2026-11-19

Cómo verificar una prueba de sello de tiempo de Bitcoin para tu código

Cómo verificar una prueba de sello de tiempo de Bitcoin para tu código
timestamp git blockchain proof

Cómo verificar una prueba de marca de tiempo de Bitcoin para tu código

Una prueba de marca de tiempo que no puedes comprobar tú mismo no es más que la promesa de un proveedor con mejor imagen de marca. Tarde o temprano alguien —un abogado en un litigio de patentes, un auditor durante la debida diligencia o un CTO que sospecha que tu “implementación independiente” no era independiente— te pedirá que demuestres que un hash de commit concreto existía en una fecha concreta. Ese momento es el paso de verificación, y es el que la mayoría de los equipos nunca ensaya.

La buena noticia: con Timestamp GIT, la verificación no es un proyecto de investigación. La GitHub App ancla los hashes de tus commits cada noche, y comprobar una prueba requiere un clic, una URL o un curl. Este artículo recorre las rutas de verificación exactas, qué significan los resultados y dónde se esconden los casos límite.

Por qué importa la verificación: de la confianza a la prueba

Hay una diferencia entre una afirmación y una evidencia:

  • Una afirmación es “escribimos esto en marzo”. Vive en una base de datos que tú controlas y que se puede editar.
  • Una evidencia es “este hash de commit concreto se incluyó en un árbol de Merkle cuya raíz está incrustada en el bloque N de Bitcoin”. Cualquiera puede recalcularlo.

Para el cumplimiento normativo, las auditorías y los litigios, la evidencia tiene un requisito adicional: debe ser repetible e independiente del proveedor. Si tu prueba solo se verifica mientras los servidores de una empresa concreta están activos, en realidad no es una prueba: es una suscripción.

El diseño de Timestamp GIT tiene esto en cuenta. El recibo .ots más los datos públicos de los bloques de Bitcoin constituyen la prueba completa. No hay ningún componente propietario en la ruta de verificación, ni nada que instalar en las máquinas de tus desarrolladores. Este artículo se centra en el paso de verificación; si todavía estás decidiendo si usar marcas de tiempo, el argumento estratégico está en nuestra guía del fundador sobre técnica anterior.

Qué contiene realmente una prueba de marca de tiempo de Bitcoin

La prueba de un solo día consta de dos artefactos, almacenados en una rama timestamps dedicada o en un repositorio en la sombra, de modo que se versionan junto a tu código:

  1. Un archivo de manifiesto (.txt) que enumera los hashes de commit recopilados para ese repositorio en ese día.
  2. Un archivo de recibo .ots que contiene la ruta de Merkle que enlaza tu hash hasta la raíz de Merkle anclada en Bitcoin.

La cadena tiene este aspecto:

commit hash ─┐
commit hash ─┼─ Merkle tree ─ Merkle root ─ Bitcoin transaction ─ block
commit hash ─┘        │
                 .ots receipt (Merkle path from your hash to the root)

Dos propiedades importan cuando verificas:

  • El manifiesto demuestra qué hashes se incluyeron.
  • El recibo .ots demuestra cuándo entró la raíz de Merkle en la cadena.

Como el anclaje usa el protocolo OpenTimestamps y nada más que sea propietario, la prueba nos sobrevive: es SHA-256 más datos de bloques de Bitcoin, verificable sin conexión, para siempre.

Paso a paso: verificar una prueba de marca de tiempo con Timestamp GIT

1. Empieza por la insignia de tu README

Cada repositorio monitorizado puede mostrar una insignia de verificación de Shields.io. Es un puntero en vivo, no una imagen estática: enlaza a la página de estado pública de ese repositorio. Generas el fragmento de inserción en la página de repositorio conectado (https://timestampgit.dev/connected/{user}/{repo}), que muestra una vista previa en vivo antes de que lo pegues.

<!-- Paste the snippet generated at /connected/{user}/{repo} -->
[![Timestamp GIT status](BADGE_URL_FROM_CONNECTED_PAGE)](https://timestampgit.dev/status/OWNER/REPO)

Cuando un revisor hace clic en la insignia, llega a la evidencia, no a una página de marketing.

2. Lee la página de estado del repositorio

Abre:

https://timestampgit.dev/status/{user}/{repo}

Este panel público te ofrece el resumen apto para auditorías:

  • Longevidad de la prueba: hasta dónde se remonta tu historial de anclaje.
  • Fecha del anclaje más antiguo: el primer día en que tus hashes llegaron a Bitcoin.
  • Regularidad diaria: prueba de que el trabajo nocturno se ejecutó realmente, día tras día.
  • Datos de bloques y transacciones de Bitcoin de los anclajes.
  • Un mapa de calor de calendario para que los huecos sean visualmente obvios.
  • Descargas: el CSV de auditoría y un certificado PDF.

Para un auditor, el mapa de calor junto con el CSV suele bastar para una primera pasada. Los cuadrados que faltan son lo que hay que investigar.

3. Verifica un día concreto localmente

Para una prueba a nivel de fecha, abre:

https://timestampgit.dev/verification/{user}/{repo}/{date}

Esta página recorre la cadena de Merkle paso a paso y realiza el cálculo localmente en tu navegador. No se transmite nada de lo que verificas: la propiedad de conocimiento cero se aplica también a la verificación, no solo a la ingesta.

Eso importa más de lo que parece. Un revisor de cumplimiento puede comprobar una prueba que implique repositorios internos sensibles sin entregar al proveedor ninguna información adicional.

4. Obtén la cadena de Merkle mediante la API

Si prefieres verificar mediante programación (o guardar la evidencia en tu propio sistema de cumplimiento), la API devuelve los datos completos de la cadena de Merkle para un día concreto:

curl -s "https://timestampgit.dev/api/verify/OWNER/REPO/2026-11-18" | jq

También puedes obtener el último bloque anclado y el recuento acumulado de commits:

curl -s "https://timestampgit.dev/api/statusLast/OWNER/REPO" | jq
curl -s "https://timestampgit.dev/api/statusCount/OWNER/REPO" | jq

Sin herramientas de CLI, sin comandos de protocolo, sin software de cartera. El trabajo pesado —la detección de commits mediante el webhook de la GitHub App, el agrupamiento por lotes, la construcción del árbol de Merkle y el anclaje en Bitcoin— ya se hizo durante la noche.

Interpretar los resultados y los casos límite

Una prueba válida significa algo concreto y contundente: este hash de commit existía en el momento de este bloque de Bitcoin o antes. No te dice que el código sea bueno, que hayas escrito cada línea ni quién lo tecleó. La autoría más allá del hash es una cuestión aparte; nuestro análisis de si las marcas de tiempo de los commits de Git se sostienen como prueba cubre esa distinción.

Otras cosas que conviene tener en cuenta:

  • Variación de la marca de tiempo del bloque. Las marcas de tiempo de los bloques de Bitcoin pueden desviarse ligeramente del tiempo real. La prueba sigue siendo criptográficamente sólida en cualquier caso, porque el bloque en sí es inmutable: nadie puede volver a minar el historial para mover tu anclaje.
  • Falta la prueba de una fecha. Las pruebas se escriben unas horas después de la medianoche: el worker de cron agrupa los hashes, construye el árbol de Merkle, lo envía a los calendarios públicos de OTS y luego espera la confirmación de Bitcoin, normalmente unas tres horas. Puede que la prueba de un día simplemente aún no se haya escrito. Si es más antigua que eso, comprueba si el repositorio estaba realmente monitorizado durante ese periodo.
  • Repositorios privados. Las URL de estado de los repositorios privados llevan un HMAC cifrado, y solo quienes poseen esa URL pueden ver el estado. La verificación en sí sigue ocurriendo localmente en el navegador.
  • Instancias autoalojadas. Cada instancia genera su propio HMAC. Si migras una insignia de una instancia SaaS a tu propio despliegue Docker, regenera el enlace de la insignia: un HMAC de una instancia no se validará en otra.

Verificar sin el SaaS: Docker autoalojado y comprobaciones sin conexión

Para entornos aislados o de máxima paranoia, Timestamp GIT se distribuye como imagen de 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

Luego:

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

La aplicación está disponible en http://localhost:8080, y un asistente de configuración en el primer arranque te guía para conectar tu GitHub App y configurar la instancia. Hay una licencia de demostración por tiempo limitado disponible en la página de licencias de Docker si quieres evaluarla antes de comprometerte.

El autoalojamiento no cambia las matemáticas de la verificación. Los archivos .ots y los datos de bloques de Bitcoin son los mismos artefactos, y se verifican sin conexión. Puedes hacerlo totalmente a mano y pasar el archivo .ots a las herramientas estándar de verificación de OpenTimestamps contra un nodo local de Bitcoin; esa es la vía difícil, y funciona precisamente porque la prueba es independiente del proveedor. El visor y la API del producto simplemente lo convierten en una cuestión de un clic en lugar de un proyecto de fin de semana.

Automatizar la verificación para el cumplimiento normativo

Si la verificación es una casilla en una revisión trimestral, automatízala:

  • Exporta el registro. GET /api/audit/{user}/{repo} devuelve el registro de auditoría completo en CSV: el artefacto que tu auditor realmente quiere en el archivo.
  • Genera certificados por día. GET /api/report/{user}/{repo}/{date} produce un certificado PDF para una fecha concreta, útil cuando hay que adjuntar una prueba individual a un contrato o a una presentación en un litigio.
  • Consulta la frescura periódicamente. Un breve trabajo de cron por tu parte detecta el modo de fallo que importa: que el anclaje se detenga en silencio.
#!/usr/bin/env bash
set -euo pipefail

REPOS=("acme/api" "acme/web" "acme/infra")

for repo in "${REPOS[@]}"; do
  printf '%-14s ' "$repo"
  curl -s "https://timestampgit.dev/api/statusLast/${repo}" | jq -c '.'
done

Ejecútalo a diario; si el último bloque anclado deja de avanzar, lo sabrás antes que un auditor.

  • Muestra el estado públicamente. Inserta la insignia de Shields.io para que los usuarios y clientes posteriores puedan ver el estado de verificación sin pedirte nada.

Para los equipos que quieren la máxima separación, los planes Enterprise ZK incluyen una breve GitHub Action que se ejecuta dentro de tu propia CI y no transmite nada más que hashes de commit: el modelo de anclaje y verificación sigue siendo el mismo, y la verificación sigue ocurriendo localmente.

Preguntas frecuentes

¿Necesito ejecutar algún comando de OpenTimestamps para verificar una prueba?

No. Timestamp GIT ofrece una página de verificación web y una API REST que realizan toda la comprobación. También puedes descargar el archivo .ots y usar herramientas de verificación estándar si lo prefieres, pero no es necesario.

¿Cuánto tarda una prueba en ser verificable?

Las pruebas se anclan cada noche y se confirman en la cadena de bloques de Bitcoin tras unas horas, normalmente alrededor de tres. Un commit hecho hoy tendrá una prueba verificable al día siguiente.

¿Puedo verificar una prueba de un repositorio privado?

Sí, pero las páginas de estado de repositorios privados requieren un HMAC cifrado añadido a la URL. Los usuarios autorizados pueden acceder a ellas, y la verificación en sí sigue ocurriendo localmente en tu navegador.

¿Y si Timestamp GIT desaparece? ¿Puedo seguir verificando?

Sí. La prueba es independiente del proveedor: se basa únicamente en SHA-256 y en datos de bloques de Bitcoin. Puedes verificar el archivo .ots sin conexión con las herramientas estándar de OpenTimestamps incluso si nuestro servicio ya no existe.

Conclusión

La verificación es donde el uso de marcas de tiempo deja de ser una buena idea y se convierte en evidencia defendible. El flujo de trabajo es breve: haz clic en la insignia, lee la página de estado, abre la vista de verificación a nivel de día o llama a /api/verify/{user}/{repo}/{date} y comprueba tú mismo la cadena de Merkle. Todas las rutas terminan en el mismo lugar: un hash de commit que existía antes de un bloque de Bitcoin concreto, demostrable para siempre, sin confiar en la base de datos de nadie.

Si aún no has empezado, la configuración es la parte aburrida: instala la GitHub App en un repositorio y deja que el trabajo nocturno se ejecute. Mañana tendrás tu primera prueba verificable. Dirígete a timestampgit.dev para conectar tu primer repositorio.

Entradas relacionadas

EU label: AI-generated content