Skip to content

README.md

Latest commit

 

History

History
98 lines (70 loc) · 3.94 KB

README.md

File metadata and controls

98 lines (70 loc) · 3.94 KB

TrustHub OpenTimestamp POC

¿Qué es OpenTimestamp?

OpenTimestamps (OTS) es un protocolo abierto que permite demostrar criptográficamente que un contenido existía en o antes de una fecha determinada, usando Bitcoin como autoridad pública, sin subir el archivo completo a la blockchain.

En resumidas cuentas, su funcionamiento se puede describir de la siguiente manera:

  • Calcula el hash del archivo (ej. SHA-256).

  • Agrupa muchos hashes en un Merkle tree y publica la raíz como compromiso en Bitcoin (a través de calendarios/aggregadores).

  • El .ots es el fichero de prueba que contiene la ruta/operaciones necesarias para reconstruir y verificar la relación entre el hash del archivo y la raíz publicada.

  • workflow: stamp → (guardar .ots base) → upgrade (obtener attestations) → verify (comprobar on-chain).

Descripcion del proyecto

A la hora de realizar este proyecto, lo plantie en base a 4 métodos basicos, de los cuales luego realice algunas implementaciones más complejas haciendo uso de estos métodos. Los método basicos son:

stampFile

  • Como su nombre indica, se encarga de realizar el stamping de un archivo.

info

  • Muestra la información contenida en el archivo .ots

upgrade

  • Se encarga de “completar” el archivo .ots, cuando el hash de nuestro archivo se encuentra publicado en la chain

verify

  • Método por el cual se verifica la publicación de nuestro archivo en la chain

OpenTimestamps — Microservicio (UI mínima)

Microservicio Spring Boot para generar, upgradear, consultar y verificar timestamps con OpenTimestamps. Incluye una UI muy simple (index.html) para pruebas manuales (drag & drop + botones).

En resumen:

  • Servicio REST + UI para trabajar con OpenTimestamps.
  • Permite: stamp (generar .ots desde un PDF), upgrade (actualizar .ots), info (ver info legible de un .ots) y verify (verificar .ots contra el PDF original).
  • La UI está en src/main/resources/static/index.html y se sirve desde http://localhost:8080/index.html.
  • No almacenamos PDFs ni .ots en base de datos en esta versión; todo es temporal (termina siendo descargado en la pc del usuario).
  • Se intenta obtener la hora de minado del bloque (block_time) consultando Blockstream cuando es posible y se la devuelve en la respuesta JSON de verify CHEQUEAR si funciona como esperado .

Estructura principal

  • src/main/java/.../controller/OtsController.java — endpoints REST: /api/ots/{stamp,upgrade,info,verify}
  • src/main/java/.../service/OpenTimestampsService.java — lógica que llama a la librería com.eternitywall.ots
  • src/main/resources/static/index.html — UI para pruebas manuales
  • pom.xml — dependencias (Spring Boot, OpenTimestamps lib, etc.)

⚙️Endpoints

Todos los endpoints son POST y esperan multipart/form-data.

POST /api/ots/stamp

  • Parámetros:
    file → archivo PDF
  • Respuesta: application/octet-stream (descarga .ots)
  • Nombre del archivo devuelto: <NombreOriginalDelPDF>.ots
    (ej. documento.pdf → documento.pdf.ots)

POST /api/ots/upgrade

  • Parámetros:
    ots → archivo .ots
  • Respuesta: application/octet-stream (descarga .ots actualizado)
  • Nombre del archivo devuelto: <NombreOriginal>-Upgraded.ots
    (ej. documento.pdf.ots → documento.pdf-Upgraded.ots)

POST /api/ots/info

  • Parámetros:
    ots → archivo .ots
  • Respuesta: texto legible con la salida de OpenTimestamps.info()

POST /api/ots/verify

  • Parámetros:
    ots → archivo .ots
    file → PDF original
  • Respuesta: JSON con metadatos del bloque y estado de verificación 
    {
  "status": "OK" | "FAIL",
  "txid": "<txid|null>",
  "block_hash": "<hash|null>",
  "block_height": "<numero|null>",
  "block_time": "2025-09-21T12:34:56Z" | null,
}