Timestamp GIT

← Todos los artículos

2026-10-16

Cómo verificar localmente una prueba de sello de tiempo de Bitcoin

Cómo verificar localmente una prueba de sello de tiempo de Bitcoin
timestamp git blockchain proof

Cómo verificar localmente una prueba de marca de tiempo de Bitcoin

Tienes un archivo .ots en una rama de marcas de tiempo, y un abogado, un auditor o tu propio cerebro escéptico quiere saber: ¿esto realmente prueba algo, o es solo un archivo que me entregó un proveedor?

Esa pregunta es el punto central del sellado de tiempo criptográfico. Una prueba que solo el emisor puede validar no es una prueba: es una promesa. Este artículo explica cómo verificar localmente una prueba de marca de tiempo de Bitcoin, paso a paso, usando las herramientas de verificación integradas de Timestamp GIT. No se requieren herramientas de línea de comandos, no se requiere confiar en nuestros servidores y, si quieres ir más allá, no se requiere depender de que Timestamp GIT exista en absoluto.

Por qué importa la verificación local

La mayoría de las atestaciones de software son documentos de “confía en mí”. Un proveedor firma un PDF que dice “sí, este commit existía en esta fecha”. Si el proveedor quiebra, es adquirido o cambia silenciosamente sus claves de firma, tu evidencia se debilita. La prueba nunca fue realmente tuya.

Las pruebas ancladas en Bitcoin funcionan de otra manera. Timestamp GIT incorpora hashes de commits en la blockchain de Bitcoin mediante el protocolo OpenTimestamps, usando calendarios OTS públicos. La ruta de verificación usa únicamente SHA-256 y datos de bloques de Bitcoin: sin criptografía propietaria, sin fórmulas secretas. Eso significa:

  • La prueba sobrevive al proveedor. Incluso si Timestamp GIT desapareciera mañana, el recibo .ots y el bloque de Bitcoin al que hace referencia siguen siendo verificables por cualquiera.
  • La verificación es local por defecto. El verificador web de Timestamp GIT ejecuta todo el cálculo en tu navegador. Nadie ve lo que verificas, y no se requiere respuesta de ningún servidor para llegar a una conclusión.
  • Los equipos de cumplimiento lo aceptan. En una auditoría legal, “nuestros registros internos lo dicen” a menudo se descarta por interesado. Una ruta de Merkle que termina en un encabezado de bloque de Bitcoin específico es una categoría de evidencia distinta.

En resumen: todo el valor de la prueba de existencia se derrumba si la verificación requiere confiar en el emisor. Aquí no es así.

Si quieres los antecedentes conceptuales sobre por qué la técnica anterior necesita anclaje criptográfico, eso se cubre en ¿Qué es la técnica anterior criptográfica? Una guía para equipos de software. Este artículo trata sobre el acto mecánico de verificar.

Cómo se ve una prueba de Timestamp GIT

Cuando instalas la GitHub App y conectas un repositorio, cada commit entra en un lote nocturno. Esto es lo que obtienes:

  • Un archivo de recibo .ots. Una prueba criptográfica compacta de que un hash de commit de Git dado —o más bien, la raíz de Merkle que cubre el lote de hashes de un día— existía en un momento específico.
  • Un archivo manifiesto .txt por repositorio. La lista de hashes de commits agrupados para ese día.
  • Una rama de marcas de tiempo dedicada o un repositorio sombra. Las pruebas se envían de vuelta a tu propia infraestructura, ya sea dentro del repositorio de origen o en un repositorio de destino separado.

Cada prueba corresponde a un lote diario. El pipeline agrupa todos los hashes de commits pendientes, construye un árbol de Merkle de forma nativa, crea pruebas de OpenTimestamps contra calendarios OTS públicos y ancla la raíz de Merkle en una transacción de Bitcoin.

El archivo .ots es autocontenido a efectos de verificación: contiene la ruta de Merkle desde tu hash de commit hasta la raíz anclada, más una referencia al encabezado del bloque de Bitcoin que contiene el ancla. No necesitas la base de datos de Timestamp GIT para comprobarlo.

Una nota sobre los tiempos que suele confundir: la confirmación de Bitcoin tarda varias horas, normalmente alrededor de 3. Así que el paso de escritura de la prueba llega unas horas después de que se ejecute el worker cron de medianoche. Un commit reciente no es verificable al instante. Consulta Interpretación de resultados y casos límite más abajo.

Paso a paso: verificar tu prueba localmente

Paso 1: obtén el archivo .ots

Ya está en tu repositorio. Búscalo en la rama de marcas de tiempo, o en el repositorio sombra si configuraste las pruebas para que vivan separadas del código fuente. También puedes obtenerlo desde el panel de Timestamp GIT a través de tu lista de repositorios.

Paso 2: usa el verificador basado en navegador

Navega a la página de verificación de tu repositorio y fecha:

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

Esta es una verificación paso a paso de la cadena de Merkle en varios niveles. Cada cálculo de hash ocurre localmente en tu navegador: la página no envía tus datos a ningún sitio, y nadie ve lo que verificas. Verás la cadena desenvolverse desde tu hash de commit, pasando por nodos intermedios de Merkle, hasta la raíz y la referencia del bloque de Bitcoin.

Este es el camino que deberían tomar la mayoría de los desarrolladores y revisores de cumplimiento. No se requieren herramientas CLI, no se requiere un nodo de Bitcoin.

Paso 3 (opcional): verifica con las herramientas estándar de OpenTimestamps

El formato .ots es abierto. Si tu proceso exige una cadena de herramientas totalmente independiente —o simplemente lo prefieres—, puedes tomar el archivo de recibo y comprobarlo contra la blockchain de Bitcoin usando las herramientas de verificación estándar de OpenTimestamps y un nodo de Bitcoin o un cliente ligero. Esa es la “manera difícil”, y es completamente opcional. La prueba es independiente del proveedor por diseño: solo intervienen SHA-256 y datos de bloques de Bitcoin.

Paso 4: confirma el resultado

Una comprobación exitosa te da dos resultados concretos:

  • La altura del bloque de Bitcoin donde se ancló tu raíz de Merkle.
  • La marca de tiempo del bloque, que establece el límite superior de cuándo pudo haber existido tu hash de commit.

Esa es tu evidencia: no “Timestamp GIT lo dice”, sino “este hash está demostrablemente contenido en un árbol de Merkle cuya raíz está comprometida en el bloque N de Bitcoin”.

Uso de las herramientas de verificación integradas de Timestamp GIT

Además del verificador por fecha, hay tres herramientas que vale la pena conocer.

La página de estado pública

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

Este es un panel público que muestra la longevidad de las pruebas, tu fecha de anclaje más temprana, la regularidad diaria, los datos del bloque y la transacción de Bitcoin detrás de cada ancla, y un mapa de calor tipo calendario de la cobertura. Si estás haciendo diligencia debida sobre un repositorio —tuyo o de otro—, empieza aquí. También expone un CSV de auditoría descargable y un certificado en PDF.

La página de verificación

Cubierta arriba, pero vale la pena reiterarla como la herramienta principal:

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

Verificación de la cadena de Merkle, en el navegador, para la marca de tiempo de un día específico.

Insignias y certificados

Hay insignias embebibles disponibles para tu README para mostrar públicamente el estado de verificación. Cualquiera puede hacer clic en el enlace adjunto a la insignia y verificar la marca de tiempo a través del sitio web. Para los paquetes de auditoría, descarga el certificado en PDF de una fecha específica.

Si tu repositorio es privado, ten en cuenta que los repositorios privados añaden un HMAC cifrado a la URL: el HMAC es específico de la instancia del servidor, así que solo los usuarios autorizados pueden ver el estado de ese repositorio. Tu flujo de verificación no cambia; la URL simplemente está acotada.

Interpretación de resultados y casos límite

Qué significa realmente una verificación exitosa

Prueba que el hash del commit existía en o antes de la marca de tiempo del bloque de Bitcoin. No “exactamente en”, y no “el código se escribió entonces”: prueba que el hash existía a más tardar en ese bloque. Para fines de técnica anterior, esa es exactamente la afirmación que necesitas: tenías este artefacto en o antes de la fecha X.

Pruebas pendientes

Si revisas un repositorio a la mañana siguiente de un commit y la prueba parece incompleta, eso es lo esperado. El worker cron nocturno agrupa los hashes, construye el árbol y lo ancla; luego la confirmación de Bitcoin tarda unas horas (normalmente alrededor de 3). Una vez confirmada, la marca de tiempo es inmutable. Espera y vuelve a comprobar: nada está roto.

La frontera de conocimiento cero

La verificación opera sobre hashes de commits, nunca sobre tu código fuente. Timestamp GIT nunca ve, copia ni almacena tu código fuente real. La prueba confirma que un hash existía; no revela nada sobre lo que contenía el código. Eso es deliberado, y es por lo que el mismo flujo de verificación funciona para repositorios de código cerrado y de secretos comerciales.

Cuando algo sale mal

  • Falta el archivo .ots — recupéralo de la rama de marcas de tiempo, del repositorio sombra o de tu panel.
  • Recibo corrupto — vuelve a descargarlo del repositorio o del panel; los datos anclados del lado de Bitcoin no se ven afectados, así que una copia nueva del recibo restaura la verificación.

Equipos que quieren aún menos exposición

La GitHub App gestionada de Timestamp GIT es la vía sin configuración: acceso de solo lectura al repositorio de origen, lectura-escritura al repositorio de destino, y las pruebas llegan automáticamente. Para equipos que no quieren que el servicio lea ni siquiera un hash de commit, el Modo ZK Enterprise toma una ruta diferente: una GitHub Action de 12 líneas se ejecuta en tu infraestructura y solo envía el hash del commit a la API de Timestamp GIT. Tu código fuente nunca sale de tu entorno.

Automatización de la verificación para el cumplimiento

Las comprobaciones manuales están bien para una auditoría puntual. Si llevas un cumplimiento continuo, intégralo en CI o en tus herramientas internas.

Obtén los datos de verificación vía API

La cadena de Merkle completa para un día específico:

curl -s "https://timestampgit.dev/api/verify/acme-corp/payments-api/2026-09-14" \
  -o verify-2026-09-14.json

Endpoints de estado públicos (no requieren autenticación):

# Last anchored Bitcoin block info
curl -s "https://timestampgit.dev/api/statusLast/acme-corp/payments-api"

# Total stamped commit count
curl -s "https://timestampgit.dev/api/statusCount/acme-corp/payments-api"

# Combined summary, useful for Shields.io badges
curl -s "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api"

Extrae libros de auditoría y certificados

# Full audit ledger as CSV
curl -s "https://timestampgit.dev/api/audit/acme-corp/payments-api" -o audit.csv

# PDF certificate for a single date
curl -s "https://timestampgit.dev/api/report/acme-corp/payments-api/2026-09-14" \
  -o certificate-2026-09-14.pdf

Una barrera de protección mínima para CI —fallar la compilación si el ancla más reciente está desactualizada— se ve así:

#!/usr/bin/env bash
set -euo pipefail

REPO_PATH="acme-corp/payments-api"
LAST=$(curl -s "https://timestampgit.dev/api/statusLast/${REPO_PATH}")

BLOCK=$(echo "$LAST" | python3 -c "import sys,json; print(json.load(sys.stdin).get('blockHeight',''))")

if [ -z "$BLOCK" ]; then
  echo "No anchored Bitcoin block found for ${REPO_PATH}. Check nightly anchoring."
  exit 1
fi

echo "Latest anchor confirmed in Bitcoin block ${BLOCK}"

Verificación con aislamiento de red usando Docker

Para máxima seguridad y entornos con aislamiento de red, Timestamp GIT está disponible como imagen de Docker. Una configuración de inicio rápido con Docker Compose se ve así:

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 tras el arranque. En el primer inicio, un asistente de configuración te guía para conectar tu GitHub App y configurar tu instancia. Se puede solicitar una licencia de demostración por tiempo limitado desde la página de licencia de Docker con tu nombre, empresa, correo electrónico y número de teléfono opcional, y el archivo de licencia de demostración se puede descargar una vez emitido.

Preguntas frecuentes

¿Necesito ejecutar alguna herramienta de línea de comandos para verificar una prueba de Timestamp GIT? No. Timestamp GIT proporciona un verificador basado en web que realiza todos los cálculos localmente en tu navegador. También puedes usar las herramientas estándar de OpenTimestamps si lo prefieres, pero no es obligatorio.

¿Cuánto tarda una prueba en volverse verificable? Después del anclaje nocturno, la transacción de Bitcoin tarda unas horas (normalmente alrededor de 3) en confirmarse. Una vez confirmada, la prueba es verificable de inmediato.

¿Puedo verificar una prueba sin confiar en Timestamp GIT? Sí. El archivo .ots contiene todos los datos criptográficos necesarios, y puedes verificarlo contra la blockchain de Bitcoin usando herramientas de código abierto. El verificador de Timestamp GIT también se ejecuta localmente, así que no se necesita confiar en nuestros servidores.

¿Y si pierdo el archivo .ots? Puedes recuperarlo de la rama de marcas de tiempo de tu repositorio o del repositorio sombra. Si eres usuario de Timestamp GIT, también puedes descargarlo desde tu panel.

Conclusión

La verificación local es la diferencia entre “una empresa me lo dijo” y “lo comprobé yo mismo contra la blockchain de Bitcoin”. Con Timestamp GIT, la parte de comprobación lleva cuatro pasos y cero herramientas CLI: toma el archivo .ots, abre la página de verificación, lee la altura del bloque, listo. El trabajo pesado —detección de commits, agrupación nocturna, construcción del árbol de Merkle, envío al calendario OTS, anclaje en Bitcoin y envío de las pruebas de vuelta a tu repositorio— ocurre automáticamente una vez instalada la GitHub App.

Empieza en timestampgit.dev, instala la GitHub App en un repositorio y verifica tu primera prueba mañana. Para repositorios privados y flujos de cumplimiento continuo, los planes Pro Agency y Enterprise ZK cubren el resto.

Publicaciones relacionadas

EU label: AI-generated content