Cómo verificar de forma independiente la marca de tiempo de un commit de Git
Una marca de tiempo que no puedes comprobar por ti mismo no es una prueba: es una promesa de un proveedor. Esa distinción importa en el momento en que alguien más te pide demostrar cuándo existió tu código: un auditor de cumplimiento, la parte contraria en una disputa de patentes o un adquirente realizando la debida diligencia técnica.
Este artículo muestra cómo verificar de forma independiente la marca de tiempo de un commit de Git usando los artefactos de prueba y las herramientas de Timestamp GIT: la página de estado pública, la página de verificación Merkle basada en navegador, la API REST, las insignias de verificación y los informes descargables. No es necesario que ningún código fuente salga de tu repositorio, y no hay que confiar en nadie —incluido el proveedor— para que el resultado sea válido.
Por qué importa la verificación independiente
Toda marca de tiempo criptográfica es tan sólida como tu capacidad de auditarla en tus propios términos.
- La verificación no debe depender de que el proveedor siga existiendo. Las pruebas de Timestamp GIT se basan únicamente en SHA-256 y en datos de bloques de Bitcoin. Puedes verificarlas sin conexión, incluso si el servicio ya no existe.
- Los reguladores, auditores y tribunales esperan evidencia reproducible. “El panel lo decía” no es evidencia. Una raíz de Merkle que coincide con un bloque de Bitcoin sí lo es.
- La debida diligencia plantea preguntas difíciles. Durante una adquisición o una ronda de financiación, se examina la madurez de la propiedad intelectual. Poder entregar una cadena de prueba verificable es muy distinto de entregar una captura de pantalla.
- Tu código fuente permanece privado. La verificación necesita exactamente dos cosas: los archivos de prueba (el manifiesto y el recibo
.ots) y datos públicos de la blockchain. No tu implementación, no tus secretos comerciales.
El resto de este artículo es la lista de comprobación práctica.
Cómo se ve una prueba de Timestamp GIT
Un solo día de commits produce un conjunto pequeño y bien definido de artefactos:
- Un archivo de manifiesto diario (
.txt) que contiene los hashes de commit recopilados para ese repositorio en ese día. - Una raíz de Merkle calculada sobre el manifiesto. La raíz es el único valor que representa todos los commits del lote.
- Un archivo de recibo
.ots: una prueba de OpenTimestamps que vincula criptográficamente esa raíz de Merkle a un bloque específico de Bitcoin.
Estos artefactos residen en una rama de marcas de tiempo dedicada o un repositorio en la sombra, deliberadamente separados de tu código fuente. Esa separación es precisamente el punto: la prueba viaja de forma independiente del código que protege.
Junto con los archivos, el registro incluye la altura del bloque de Bitcoin y el ID de transacción que ancló el lote. Esos dos valores son los que permiten que cualquiera —tú, un abogado, un auditor externo— confirme que los datos existían cuando se minó el bloque.
Paso a paso: verificar con las herramientas de Timestamp GIT
Las marcas de tiempo se producen automáticamente: instala la GitHub App una vez, conecta el repositorio y cada commit se ancla cada noche sin pasos manuales. La verificación es donde tomas el control, y tienes cinco formas de hacerlo.
1. La página de estado pública
Abre https://timestampgit.dev/status/{user}/{repo}. Este panel muestra:
- la longevidad de la prueba y la fecha de anclaje más antigua,
- la regularidad diaria (un mapa de calor en calendario hace evidentes las lagunas),
- la altura del bloque de Bitcoin y el ID de transacción de cada anclaje.
Es la comprobación rápida más veloz. Si una contraparte cuestiona la continuidad, el mapa de calor es la respuesta.
2. La página de verificación basada en navegador
Para un día concreto, ve a https://timestampgit.dev/verification/{user}/{repo}/{date}. Esta página recorre la cadena de Merkle multinivel paso a paso y realiza todos los cálculos localmente en tu navegador: conocimiento cero. Nadie ve lo que verificas, lo cual es útil cuando el propio repositorio es confidencial.
Esta es la página que hay que abrir delante de un auditor, porque se muestra cada nivel de la cadena, no un resumen.
3. La API de verificación
Cuando la verificación necesita automatizarse o archivarse, obtén la cadena sin procesar:
curl -s "https://timestampgit.dev/api/verify/acme-corp/payments-api/2026-10-05" \
-H "Accept: application/json" | jq .
La respuesta contiene los datos completos de la cadena de Merkle para la marca de tiempo de ese día, de modo que puedes recalcularla localmente en lugar de confiar en la página renderizada.
4. Insignias de verificación
En la página de conexión del repositorio obtienes una insignia de Shields.io insertable junto con su fragmento de markdown. Colócala en tu README:
[](BADGE_LINK)
Cualquiera que haga clic en la insignia llega a la vista de verificación de tu repositorio. Es una afirmación pública y siempre actualizada de prueba de existencia, y como el enlace resuelve a datos verificables en lugar de a una imagen estática, no es solo decoración.
5. Informes y exportaciones de auditoría
Dos endpoints cubren la parte documental:
# Per-day PDF certificate
curl -sL "https://timestampgit.dev/api/report/acme-corp/payments-api/2026-10-05" \
-o certificate-2026-10-05.pdf
# Full audit ledger as CSV
curl -sL "https://timestampgit.dev/api/audit/acme-corp/payments-api" \
-o audit-ledger.csv
El PDF es lo que adjuntas a una presentación legal. El CSV es lo que introduces en un archivo de auditoría interna o en una hoja de cálculo que entregas a un equipo de debida diligencia.
Ten en cuenta que los repositorios privados añaden un HMAC cifrado a sus URL, de modo que solo los usuarios autorizados pueden abrir sus páginas de estado y verificación. La prueba subyacente no cambia: sigue anclada en Bitcoin y sigue siendo verificable por cualquiera que tenga el archivo de prueba.
Interpretar los resultados de verificación y los casos límite
Una verificación exitosa significa una cosa concreta: la raíz de Merkle que recalculaste a partir del manifiesto coincide con el valor anclado en el bloque de Bitcoin al que hace referencia el recibo .ots. Esa coincidencia demuestra que el conjunto de hashes de commit existía a más tardar en la marca de tiempo de ese bloque. No importa quién ejecute la comprobación ni dónde.
Vale la pena conocer cuatro casos límite antes de prometer a alguien un resultado de verificación:
- El día actual probablemente aún no sea verificable. El anclaje se ejecuta cada noche y la confirmación de Bitcoin tarda varias horas (normalmente unas 3 horas). Puede que aún no exista una prueba para los commits de hoy, y que el lote de la noche anterior siga pendiente de confirmación. Planifica las auditorías teniendo en cuenta esta ventana.
- Los repositorios privados requieren el HMAC. La verificación funciona exactamente igual que para los repositorios públicos, pero la URL lleva un HMAC cifrado específico de la instancia del servidor. Sin HMAC, no hay página de estado.
- Una marca de tiempo prueba la existencia, no la autoría. La prueba dice que un hash de commit existía en un momento concreto. No establece, por sí sola, quién escribió el código ni que el código sea novedoso. Úsala como evidencia de estado de la técnica anterior, no como sustituto de una cadena de titularidad.
- Cualquiera puede verificar, incluso sin Timestamp GIT. Como la prueba se basa en estándares abiertos, un ingeniero suficientemente motivado puede verificar el archivo
.otscon las herramientas estándar de OpenTimestamps contra la blockchain de Bitcoin. Eso es una ventaja: significa que tu evidencia sobrevive al proveedor.
Verificar sin el SaaS: la vía difícil (y por qué no la necesitas)
En principio podrías montar este pipeline tú mismo: ejecutar las herramientas de OpenTimestamps, consultar nodos de Bitcoin, reconciliar las pruebas de Merkle a mano. En la práctica, eso significa mantener infraestructura y experiencia para una tarea que no es tu producto.
Timestamp GIT existe para que no tengas que hacerlo. Instala la GitHub App una vez en un repositorio monitorizado y cada commit se ancla en Bitcoin automáticamente cada noche: sin CLI, sin pasos manuales, sin necesidad de conocer el protocolo. La verificación es entonces un enlace, una insignia o una llamada a la API. Para las organizaciones que necesitan mantenerlo todo en su propio hardware, el autoalojamiento está disponible como imagen de Docker:
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
Se puede acceder a la instancia en http://localhost:8080, y un asistente de configuración te guía para conectar tu GitHub App y configurar la instancia en el primer arranque.
Automatizar la verificación en tu flujo de trabajo
La verificación manual está bien para disputas. Para el cumplimiento continuo, automatízala.
Condiciona tu CI/CD al estado del anclaje. El endpoint de resumen combinado está diseñado exactamente para esto:
curl -sf "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api" -o summary.json
cat summary.json
Un pequeño script de comprobación lo convierte en una barrera de compilación:
import json
import sys
import urllib.request
URL = "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api"
with urllib.request.urlopen(URL) as response:
summary = json.load(response)
print(json.dumps(summary, indent=2))
# Fail loudly if the summary reports no anchored Bitcoin block yet.
if not any("block" in key.lower() for key in summary):
sys.exit("No Bitcoin anchor reported for this repository yet.")
Conéctalo a un flujo de trabajo programado para que un anclaje ausente se convierta en un ticket en lugar de una sorpresa durante una auditoría:
name: Timestamp anchor check
on:
schedule:
- cron: "0 8 * * *"
workflow_dispatch:
jobs:
verify-anchor:
runs-on: ubuntu-latest
steps:
- name: Check anchor status
run: |
curl -sf "https://timestampgit.dev/api/statusSummary/${{ github.repository_owner }}/${{ github.event.repository.name }}" \
-o summary.json
cat summary.json
Archiva las pruebas de forma programada. Descarga el CSV de auditoría mensualmente y guárdalo en tu sistema de registros:
curl -sL "https://timestampgit.dev/api/audit/acme-corp/payments-api" \
-o "audit-ledger-$(date +%Y-%m).csv"
Publica la insignia. Cuesta una línea en tu README y da a las contrapartes una forma de autoservicio para comprobar tus afirmaciones.
Si mantener el contenido del repositorio fuera del servicio es un requisito, el modo de despliegue Enterprise ZK ejecuta una breve GitHub Action en tu propia infraestructura que envía los hashes de commit a la API de Timestamp GIT. La verificación se comporta igual; solo cambia la vía de ingesta.
Preguntas frecuentes
¿Necesito confiar en Timestamp GIT para verificar una marca de tiempo?
No. La prueba se basa únicamente en SHA-256 y en datos de bloques de Bitcoin. Puedes verificarla de forma independiente usando el archivo .ots y las herramientas estándar de OpenTimestamps contra la blockchain de Bitcoin, incluso si Timestamp GIT ya no existe.
¿Cuánto tarda una marca de tiempo de commit en volverse verificable? Tras el proceso de anclaje nocturno, la prueba se escribe en tu repositorio. La confirmación de Bitcoin suele tardar unas 3 horas, tras lo cual la marca de tiempo es inmutable y verificable.
¿Puedo verificar una marca de tiempo de un repositorio privado? Sí. Los repositorios privados usan un HMAC cifrado añadido a la URL, de modo que solo los usuarios autorizados pueden acceder a la página de estado y a las herramientas de verificación. La prueba subyacente sigue anclada en Bitcoin y puede ser verificada por cualquiera que tenga el archivo de prueba.
¿Qué herramientas proporciona Timestamp GIT para la verificación? Una página de estado pública, una página de verificación basada en navegador que calcula todo localmente, endpoints de la API REST para datos de la cadena de Merkle e informes de auditoría, e insignias de Shields.io insertables. Todas están diseñadas para la verificación independiente sin intervención del proveedor.
Conclusión
La verificación independiente es lo que separa una marca de tiempo de una afirmación de marketing. Con Timestamp GIT, obtienes la cadena de prueba desde la página de estado, recalculas la ruta de Merkle en tu navegador, automatizas la misma comprobación en CI y exportas un certificado PDF para el expediente, todo sin exponer una sola línea de código fuente.
Si quieres que esto funcione en tus repositorios, el servicio gestionado es una configuración única: instala la GitHub App, conecta el repositorio y deja que el anclaje nocturno haga el resto. Para requisitos de aislamiento de red o autoalojamiento, la licencia de autoalojamiento con Docker también cubre esa vía. Empieza en timestampgit.dev y verifica un repositorio por ti mismo.
Entradas relacionadas
- Anclaje nocturno automático de commits de Git a Bitcoin, cero pasos manuales
- Precios del servicio de sellado de tiempo de código para repositorios privados
- Alternativas a OpenTimestamps: sellado de tiempo gestionado para Git