OTSkit.ts
OpenTimestamps · Bitcoin · TypeScript

Preserva pruebas digitales verificables en Bitcoin. No confíes en nadie.

OTSkit crea pruebas OpenTimestamps para archivos y carpetas: hash local, prueba .ots, actualización hasta confirmación Bitcoin y verificación portable. Sin cuentas, sin API keys, sin servidores de confianza.

MIT LicenseZero dependenciasSin registroSin feesNode.js ≥ 20

Fundamentos

Inmutable

Bitcoin blockchain. Sin servidores tuyos, sin base de datos, sin punto de fallo central. El proof existe independientemente de OTSkit.

Verificable

Cualquiera puede verificar el proof sin depender de ti ni de nosotros. La prueba es autocontenida y offline-capable.

{}

TypeScript-first

Zero dependencias externas. Tipos estrictos, ESM/CJS dual build, Node.js ≥ 20. Fail-closed by design — rechaza inputs malformados.

Mecanismo

Cómo funciona

Del hash local a la confirmación de Bitcoin. Sin infraestructura propia, sin fees.

  1. 01

    Hash local

    El archivo nunca sale de tu máquina. OTSkit calcula su SHA-256 localmente.

  2. 02

    Calendars

    El hash se envía a calendarios OpenTimestamps públicos. No hay servidor de OTSkit en medio.

  3. 03

    Prueba pendiente

    Recibes un .ots pending en milisegundos. Pendiente no es un fallo: es el estado normal antes de Bitcoin.

    estado: pending
  4. 04

    Atestación Bitcoin

    El calendario agrega tu hash a un árbol Merkle y lo ancla en un bloque. Confirmación típica: ~60 min.

  5. 05

    Verify

    La prueba final es autocontenida. Cualquiera la verifica offline contra Bitcoin — sin depender de OTSkit.

El estado pending no es un fallo: es el ciclo normal de Bitcoin. La prueba se actualiza sola cuando aparece la atestación.

Tres comandos. Prueba permanente.

Instala el servidor MCP, sella tu archivo y verifica contra el bloque de Bitcoin. Sin cuentas, sin API keys, sin suscripciones.

bash
# instalar el servidor MCP
$ npm install -g @otskit/mcp
✓ @otskit/mcp@0.8.2 installed
# sellar un archivo
$ ots-mcp stamp contrato.pdf
→ hash: a3f8b2c9d1e4...
→ submitted to 4 calendars
✓ proof saved: contrato.pdf.ots
# verificar (en cualquier momento)
$ ots-mcp verify contrato.pdf.ots
→ Bitcoin block #840,291
→ 2024-03-15T14:23:01Z
✓ valid. permanently anchored in Bitcoin.

Casos

Qué puedes preservar

Cualquier archivo cuyo estado quieras poder demostrar mañana, dentro de un año o dentro de diez.

Contratos
Datasets
Carpetas completas
Releases y repos
Evidencias digitales
Informes
Publicaciones
Entregables

Ecosistema

Cuatro paquetes. Un ecosistema.

Usa solo una capa o el stack completo: desde primitivas TypeScript de bajo nivel hasta skills de preservación activadas por lenguaje natural. Cada paquete es independiente, sin dependencias cruzadas.

Code
Issues0
Pull requests0
README
README.md

# @otskit/core

Implementación TypeScript pura del protocolo OpenTimestamps. La base del ecosistema — sin dependencias externas, validación estricta fail-closed en cada frontera.

## Features

  • Create, serialize, deserialize, merge y verify
  • Merkle tree batching — miles de docs en una TX
  • SHA-1, SHA-256 y RIPEMD-160 integrados
  • Strict validation, fail-closed by design

## Installation

$ npm install @otskit/core
Code
Issues0
Pull requests0
README
README.md

# @otskit/client

SDK de alto nivel sobre core. Circuit breaker por calendario, retry con backoff exponencial, timeouts duales y threshold submissions. Para producción desde el día uno.

## Features

  • stamp(), upgrade(), verify() — API limpia
  • hashFile() — streaming SHA-256 para archivos grandes
  • Circuit breaker por calendario — sin cascade failures
  • AbortController, logger interface, zero dependencias

## Installation

$ npm install @otskit/client
Code
Issues0
Pull requests0
README
README.md

# @otskit/mcp

Servidor MCP que expone 8 herramientas para agentes AI. Sella, verifica y monitorea timestamps desde una conversación. SQLite local, scheduler automático, setup en un comando.

## Features

  • 8 tools: stamp, upgrade, verify, inspect, watch...
  • SQLite local en ~/.ots-mcp/
  • Setup con un comando: ots-mcp setup claude-code
  • Compatible con Claude Desktop, Claude Code y Codex

## Installation

$ npm install -g @otskit/mcp
Code
Issues0
Pull requests0
README
README.md

# @otskit/skills

Skills para agentes AI. Con "preserve this" genera un paquete BagIt completo (RFC 8493, OAIS, PREMIS 3.0) anclado en Bitcoin. Produce .zip, .sha256, .ots y .stamp-id.txt.

## Features

  • Produce .zip, .sha256, .ots y .stamp-id.txt
  • BagIt RFC 8493, OAIS ISO 14721, PREMIS 3.0
  • Lenguaje natural: "preserve this", "stamp this"
  • Compatible con Claude Code y Codex

## Installation

$ npx -y skills add https://smithery.ai/skills/otskit/preserve

Resultado · @otskit/skills

Qué obtienes al preservar

Con el skill de preservación ("preserve this"), cada preservación deja cuatro piezas portables. El sellado básico con el SDK o el MCP produce solo la prueba .ots — el paquete BagIt es exclusivo de la capa de skills.

.zip

Paquete BagIt

Paquete portable RFC 8493 con tu contenido y los metadatos de preservación.

.sha256

Hash del contenido

El SHA-256 del paquete, para comprobar integridad en cualquier momento.

.ots

Prueba OpenTimestamps

La prueba criptográfica, verificable offline contra Bitcoin.

.stamp-id.txt

Identificador local

Un id para seguir la confirmación del timestamp con el tiempo.

Audiencia

Para quién es

Tres públicos reales, una misma base criptográfica.

Developers

SDK production-ready sobre un core sin dependencias.

  • Circuit breaker por calendario — sin cascade failures
  • Retries con backoff exponencial y timeouts duales
  • Fail-closed: rechaza inputs malformados en cada frontera

Agentes AI

Tu agente calcula el hash, sella, guarda la prueba, monitoriza la confirmación y la verifica después.

  • Servidor MCP con 8 tools (Claude, Codex, Desktop)
  • Skills por lenguaje natural: "preserve this"
  • SQLite local y scheduler automático

Preservación / evidencia

Prueba de existencia a largo plazo, sin depender de terceros.

  • Paquetes BagIt / OAIS / PREMIS 3.0
  • Portable y verificable sin cuentas
  • Pensado para legal, compliance, archivo e investigación

Modelo de confianza

No hace falta confiar en OTSkit

OTSkit no es una autoridad certificadora. Solo crea y gestiona pruebas que cualquiera puede verificar.

No subimos tus archivos. Nunca salen de tu máquina.
Solo sale el hash, calculado localmente.
No custodiamos nada, no hay cuenta, no hay vendor lock-in.
La prueba .ots se verifica sin OTSkit — solo con el archivo y Bitcoin.
Si OTSkit desaparece mañana, cada prueba generada sigue siendo válida para siempre.