Timestamp GIT

← Todos los artículos

2026-11-05

Cómo verificar una prueba de sello de tiempo de Bitcoin en tu navegador

Cómo verificar una prueba de sello de tiempo de Bitcoin en tu navegador
timestamp git blockchain proof

Cómo verificar una prueba de marca de tiempo de Bitcoin en tu navegador

Una prueba de marca de tiempo solo vale algo en el momento en que alguien la comprueba. Hasta entonces, es un archivo con un nombre bonito: un recibo .ots en una rama, una insignia en un README, un PDF que nadie abrió. La pregunta que decide si tu prueba de anterioridad sobrevive a una revisión legal, una disputa de pago o una auditoría de diligencia debida es muy concreta: ¿puede un tercero confirmar que este hash de commit exacto existía antes de una fecha determinada, sin pedirle al proveedor que lo avale?

Eso es lo que resuelve la verificación basada en navegador. Este artículo recorre la verificación de una prueba de Timestamp GIT de principio a fin: qué contienen los artefactos, qué páginas y endpoints usas, y cómo leer el resultado cuando es válido, está pendiente o falla. No es una lección sobre transacciones de Bitcoin; todo el sentido del flujo gestionado es que nunca tocas esa capa.

Por qué importa la verificación basada en navegador

La verificación es el momento en que una marca de tiempo criptográfica deja de ser una afirmación y se convierte en evidencia. Todo lo anterior —hashear commits, agrupar manifiestos, anclar una raíz de Merkle en Bitcoin— es maquinaria. La prueba o verifica en el otro extremo o no lo hace.

Dos propiedades hacen del navegador el lugar adecuado para esa comprobación:

El cálculo se queda local. Las páginas de verificación de Timestamp GIT realizan cada paso de la cadena de Merkle en tu navegador. Nadie ve qué repositorio, qué fecha o qué commit estás comprobando. Para un proveedor esto sería un diseño extraño; para un sistema de pruebas de conocimiento cero es el único correcto. Estás verificando evidencia, no solicitando un veredicto.

Sin instalación, sin saltos de fe. Los equipos de cumplimiento y los abogados externos no van a hacer git clone de una rama y compilar herramientas. Necesitan una comprobación independiente y repetible que dé la misma respuesta cada vez. Una URL más un navegador lo consiguen. También lo consigue un endpoint de API público si prefieres automatizar la comprobación en CI.

Esto importa porque la alternativa —confiar en el panel de un proveedor— es precisamente lo que intentas evitar. Consulta Git Commit Timestamps Aren’t Tamper-Proof — What Is para entender por qué los registros internos se descartan en las auditorías desde el principio.

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

Antes de verificar nada, debes saber qué tienes en las manos. Una prueba de Timestamp GIT para un día concreto consta de tres artefactos en capas:

  • Manifiesto diario: un archivo .txt simple que lista los hashes de commit anclados ese día para un repositorio dado. Contiene hashes, nunca código.
  • Recibo .ots: una prueba de OpenTimestamps que vincula el hash SHA-256 del manifiesto a un bloque de Bitcoin concreto.
  • Cadena de Merkle: la estructura que conecta ambos. Tu hash de commit individual es una hoja, el manifiesto es el siguiente nivel hacia arriba, y la raíz de Merkle es el único valor que se incrusta en Bitcoin.

Así que verificar significa subir esa cadena en la dirección correcta: toma tu hash de commit, combínalo con sus hermanos según lo especifica el manifiesto, produce el hash del manifiesto y luego comprueba el recibo .ots contra la cabecera del bloque de Bitcoin.

La propiedad crítica es que el recibo es independiente del proveedor. Solo usa SHA-256 y datos públicos de bloques de Bitcoin. Si Timestamp GIT desapareciera mañana, el recibo seguiría verificándose contra la blockchain usando herramientas abiertas. No es una frase de marketing: es una restricción del formato de la prueba, y es la razón por la que la verificación en el navegador puede ser honesta.

Estos archivos viven en una rama dedicada timestamps (o en un repositorio sombra separado), de modo que están versionados junto a tu código sin exponer nunca el contenido del código fuente.

Paso a paso: verificar una prueba en tu navegador

Aquí está el recorrido completo desde “tengo un repositorio” hasta “aquí está el artefacto que un auditor puede conservar”.

1. Empieza en la página de estado del repositorio

Abre la página de estado pública del repositorio:

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

Es tu visión general y responde a la mayoría de las primeras preguntas: longevidad de la prueba (hasta dónde llega la cadena), fecha del anclaje más antiguo, si el anclaje ha sido diario y regular, y los datos de bloque y transacción de Bitcoin de cada día. Hay un mapa de calor tipo calendario para que los huecos se vean de un vistazo, además de descargas del libro de auditoría completo (CSV) y un certificado PDF.

Si solo necesitas un resumen legible por máquina, los endpoints de estado públicos devuelven las mismas cifras clave:

curl -s https://timestampgit.dev/api/statusLast/acme/payments-service
curl -s https://timestampgit.dev/api/statusCount/acme/payments-service
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-service

2. Abre la página de verificación de una fecha concreta

Para una comprobación real de la prueba, ve a la fecha que te interesa:

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

La página te guía por cada nivel de la cadena de Merkle paso a paso: del hash de commit al manifiesto, del manifiesto a la raíz de Merkle, de la raíz de Merkle al bloque de Bitcoin. Cada hash se recalcula en tu navegador. Nada de tu comprobación se transmite, y eso es lo que la hace utilizable para repositorios confidenciales.

Esta es la página que debes enviar a un abogado. No requiere cuenta, ni CLI, ni explicar qué es OpenTimestamps.

3. Usa la insignia como punto de entrada público

Las insignias incrustables son la versión de bajo roce de lo mismo. Añade una a tu README y cualquiera —auditor, comprador, abogado de la parte contraria— puede hacer clic hasta la verificación sin conocer la estructura de tu repositorio.

El widget de incrustación de insignias en /connected/{user}/{repo} te da una vista previa en vivo además del fragmento Markdown. La insignia en sí se apoya en el endpoint de resumen, así que refleja datos anclados reales en lugar de una imagen estática.

Las insignias son una decisión de divulgación, no de seguridad: exponen que pones marcas de tiempo, no lo que escribiste.

4. Verifica programáticamente con la API pública

Para pipelines de CI o un script de cumplimiento, obtén los datos de la cadena de Merkle y verifica localmente:

curl -s "https://timestampgit.dev/api/verify/acme/payments-service/2026-10-14" \
  -o chain.json

La respuesta contiene la cadena completa de ese día. Tu script recalcula entonces los hashes por sí mismo, la misma matemática que ejecuta la página del navegador:

// Node 18+ — recompute each Merkle step locally, never trust the server's answer
import { createHash } from "node:crypto";

const sha256 = (hex) =>
  createHash("sha256").update(Buffer.from(hex, "hex")).digest("hex");

const chain = JSON.parse(await readFile("chain.json", "utf8"));

// Walk leaf -> root. Each step concatenates the current hash with its sibling,
// hashes the pair, and continues. The final value must equal the anchored root.
let current = sha256(commitSha);
for (const step of chain.steps) {
  const [left, right] = step.order === "lr" ? [current, step.sibling] : [step.sibling, current];
  current = sha256(left + right);
}

console.log(current === chain.merkleRoot ? "PROOF OK" : "PROOF MISMATCH");

La razón de hacerlo tú mismo es que una comprobación automatizada es evidencia reproducible de la comprobación, y no depende de que un panel se renderice correctamente.

5. Descarga el certificado PDF

Cuando necesites algo que adjuntar a un correo o a un contrato, la página de estado ofrece un certificado PDF por fecha, también disponible directamente:

https://timestampgit.dev/api/report/{user}/{repo}/{date}

Y para el libro completo en lugar de un solo día:

curl -s https://timestampgit.dev/api/audit/acme/payments-service -o audit.csv

Interpretar los resultados y manejar casos límite

Una prueba válida tiene un significado preciso, y es más estrecho de lo que la gente supone.

  • Qué dice una prueba válida: este hash de commit existía en el momento de ese bloque de Bitcoin o antes. Nada más, nada menos. No dice que el código compile, que sea original ni que sea bueno. La anterioridad trata de existencia y cronología.
  • Qué significa “pendiente”: el proceso nocturno agrupa los hashes después de medianoche, construye el árbol de Merkle y ancla la raíz. La confirmación de Bitcoin tarda después varias horas —normalmente unas 3 horas— y los archivos de prueba se escriben de vuelta en tu repositorio una vez confirmados. Los commits de hoy normalmente no tendrán una prueba final hasta el día siguiente.
  • Repositorios privados: las URL de estado de los repositorios privados incluyen un HMAC cifrado específico de la instancia del servidor, de modo que solo los usuarios autorizados pueden leer el estado. La verificación sigue ejecutándose localmente en el navegador, y el recibo .ots y el manifiesto subyacentes pueden comprobarse sin exponer el contenido del repositorio.
  • Si una prueba falla: comprueba primero lo aburrido: repositorio correcto, fecha correcta y manifiesto correcto. Un recibo .ots solo se verifica contra el hash de manifiesto para el que se creó; emparejarlo con el manifiesto de otro día fallará de forma correcta y confusa.
  • Entornos aislados: la licencia Docker autoalojada ejecuta toda la pila —incluidos la interfaz de verificación y la API— en tu propia infraestructura, de modo que la verificación nunca sale de tu red.

Cómo Timestamp GIT hace automática la verificación

La razón por la que todo lo anterior es una página y no un proyecto de fin de semana es que el anclaje está totalmente gestionado. Instalas la GitHub App una vez en un repositorio monitorizado, y cada commit se ancla en Bitcoin automáticamente cada noche. Sin herramientas CLI, sin pasos manuales del protocolo, nada que ejecutar en las máquinas de los desarrolladores, y por eso también el flujo no depende de que nadie se acuerde de hacerlo.

Detrás de eso, el pipeline agrupa los hashes de commit en una cola, los agrupa a medianoche en archivos de manifiesto por repositorio, construye un árbol de Merkle, crea pruebas de OpenTimestamps contra calendarios públicos y ancla la raíz en Bitcoin. Los archivos de prueba se envían después a una rama timestamps o a un repositorio sombra. Para los equipos que necesitan que el código fuente quede totalmente fuera del alcance del servicio, el modo Enterprise ZK usa una GitHub Action de 12 líneas que solo envía hashes de commit desde tu propia infraestructura: el servicio produce pruebas verificables sin acceso de lectura al repositorio de código fuente.

Si necesitas verificación autoalojada, una configuración rápida con 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 aplicación está disponible en http://localhost:8080 tras el arranque; un asistente de configuración en el primer inicio te guía para conectar tu GitHub App y configurar la instancia. Hay una licencia de demostración por tiempo limitado para evaluación disponible en la página de licencia de Docker.

Preguntas frecuentes

¿Necesito instalar algún software para verificar una prueba de marca de tiempo de Bitcoin? No. Las páginas de verificación de Timestamp GIT se ejecutan enteramente en tu navegador, y los endpoints de API públicos devuelven los datos de la cadena de Merkle para comprobaciones locales. También puedes descargar el recibo .ots y verificarlo sin conexión con herramientas estándar de OpenTimestamps si lo prefieres.

¿Puedo verificar una prueba sin confiar en Timestamp GIT? Sí. La prueba se apoya solo en SHA-256 y datos de bloques de Bitcoin, así que es independiente del proveedor. Puedes verificar el recibo .ots contra la blockchain de Bitcoin usando herramientas abiertas, incluso si Timestamp GIT ya no existe.

¿Y si la transacción de Bitcoin de mi prueba aún no está confirmada? La confirmación de Bitcoin suele tardar unas 3 horas. Hasta que la transacción se confirma en un bloque, la prueba está pendiente; tras la confirmación, se vuelve inmutable y puede verificarse en tu navegador.

¿Cómo verifico una prueba de un repositorio privado? Las URL de estado de repositorios privados incluyen un HMAC cifrado para que solo los usuarios autorizados puedan verlas. También puedes descargar el recibo .ots y el manifiesto desde la rama timestamps y verificarlos localmente sin exponer datos del repositorio.

Conclusión

La verificación en el navegador es lo que convierte una marca de tiempo de un registro interno en algo que puedes entregar a alguien que no confía en ti, que es el único público que importa en una disputa. La comprobación requiere una URL, una fecha y unos segundos de hashing local, y produce una respuesta anclada en Bitcoin en lugar de en la base de datos de un proveedor.

Si aún no lo has configurado, la secuencia es corta: conecta un repositorio a Timestamp GIT mediante la GitHub App, deja que el proceso nocturno ancle tus commits y luego abre la página de estado y verifica una fecha de principio a fin. Esa única verificación exitosa es la diferencia entre “tenemos registros” y “tenemos pruebas”. Si quieres primero la configuración sin CLI, lee a continuación How to Timestamp Git Commits Without the Command Line.

Entradas relacionadas

EU label: AI-generated content