@totemsdk/wots-lease 1.0.1 → 1.0.2

package/dist/replicated-backup.d.ts

@@ -0,0 +1,30 @@
+/**
+ * RFC-057 — replicated WOTS lease-journal backup.
+ *
+ * The local `LeaseJournal` remains authoritative for allocation. This adapter
+ * mirrors the physically append-only journal into a replicated log for audit
+ * and disaster recovery, and restores entries into a local journal in order.
+ * It never allocates or advances a signing slot.
+ */
+import type { ReplicatedLog } from '@totemsdk/replication';
+import type { JournalEntry } from './types.js';
+export interface LeaseJournalRestoreTarget {
+    append(entry: JournalEntry): Promise<void>;
+}
+export declare class ReplicatedLeaseJournalBackup {
+    private readonly log;
+    constructor(log: ReplicatedLog<JournalEntry>);
+    /** Mirror one local journal entry. */
+    append(entry: JournalEntry): Promise<{
+        length: number;
+        head: string;
+    }>;
+    /** Read all mirrored entries, verifying the local hash-chain links in order. */
+    readAll(): Promise<JournalEntry[]>;
+    /**
+     * Restore into a local journal. The local journal's own duplicate-slot and
+     * reservation checks remain the final guard; this method only preserves the
+     * replicated order and links.
+     */
+    restoreInto(target: LeaseJournalRestoreTarget): Promise<number>;
+}

package/dist/replicated-backup.js

@@ -0,0 +1,48 @@
+/**
+ * RFC-057 — replicated WOTS lease-journal backup.
+ *
+ * The local `LeaseJournal` remains authoritative for allocation. This adapter
+ * mirrors the physically append-only journal into a replicated log for audit
+ * and disaster recovery, and restores entries into a local journal in order.
+ * It never allocates or advances a signing slot.
+ */
+import { StorageError } from '@totemsdk/storage/errors';
+export class ReplicatedLeaseJournalBackup {
+    constructor(log) {
+        this.log = log;
+    }
+    /** Mirror one local journal entry. */
+    async append(entry) {
+        return this.log.append(entry);
+    }
+    /** Read all mirrored entries, verifying the local hash-chain links in order. */
+    async readAll() {
+        const entries = [];
+        for await (const entry of this.log.readSince())
+            entries.push(entry.record);
+        let previous;
+        for (const [index, entry] of entries.entries()) {
+            if (index === 0) {
+                if (entry.previousHash !== undefined) {
+                    throw new StorageError('replicated lease journal first entry has previousHash', 'corrupt');
+                }
+            }
+            else if (entry.previousHash !== previous?.hash) {
+                throw new StorageError(`replicated lease journal chain mismatch at ${index}`, 'corrupt');
+            }
+            previous = entry;
+        }
+        return entries;
+    }
+    /**
+     * Restore into a local journal. The local journal's own duplicate-slot and
+     * reservation checks remain the final guard; this method only preserves the
+     * replicated order and links.
+     */
+    async restoreInto(target) {
+        const entries = await this.readAll();
+        for (const entry of entries)
+            await target.append(entry);
+        return entries.length;
+    }
+}

package/dist/seed.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * @module @totemsdk/wots-lease/seed
  *
@@ -13,13 +12,10 @@
  * If none is available and the caller has not declared the keyspace fresh,
  * seeding **fails closed** — starting at 0 would reissue spent leaves.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.seedLeaseWatermark = seedLeaseWatermark;
-exports.exportLeaseWatermark = exportLeaseWatermark;
-const watermark_js_1 = require("./watermark.js");
-const errors_js_1 = require("./errors.js");
+import { flatIndex, fromFlatIndex } from './watermark.js';
+import { WatermarkSeedRequiredError } from './errors.js';
 function flatOf(w) {
-    return (0, watermark_js_1.flatIndex)({ addressIndex: w.addressCursor, l1: w.l1Cursor, l2: w.l2Cursor });
+    return flatIndex({ addressIndex: w.addressCursor, l1: w.l1Cursor, l2: w.l2Cursor });
 }
 /**
  * Seed a local watermark from the best available source, requiring at least one
@@ -30,7 +26,7 @@ function flatOf(w) {
  * @throws {WatermarkSeedRegressionError} when a supplied seed is behind the
  *   current cursor.
  */
-async function seedLeaseWatermark(params) {
+export async function seedLeaseWatermark(params) {
     const { local, treeId } = params;
     // 1. On-chain cursor — advances the same local watermark (monotonic).
     if (params.onchain) {
@@ -53,7 +49,7 @@ async function seedLeaseWatermark(params) {
     }
     // 3. Operator high-water mark.
     if (params.operatorHighWaterMark !== undefined) {
-        const indices = (0, watermark_js_1.fromFlatIndex)(params.operatorHighWaterMark);
+        const indices = fromFlatIndex(params.operatorHighWaterMark);
         const candidate = {
             version: 1,
             treeId,
@@ -74,11 +70,11 @@ async function seedLeaseWatermark(params) {
         !params.exported &&
         params.operatorHighWaterMark === undefined &&
         !params.fresh) {
-        throw new errors_js_1.WatermarkSeedRequiredError(treeId);
+        throw new WatermarkSeedRequiredError(treeId);
     }
     return local.getLocalWatermark(treeId);
 }
 /** Export a portable watermark blob for backup/restore. */
-function exportLeaseWatermark(local, treeId) {
+export function exportLeaseWatermark(local, treeId) {
     return local.exportWatermark(treeId);
 }

package/dist/stubs.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * Implementations for Layers 3–5 of the WotsLeaseProvider hierarchy.
  *
@@ -9,13 +8,9 @@
  * Layers 4–5 (P2PQuorumLeaseProvider, OnchainWatermarkProvider) — implemented in
  *   quorum.ts and onchain.ts; re-exported here for backward compatibility.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PersonalLeaseNodeProvider = exports.OnchainWatermarkProvider = exports.P2PQuorumLeaseProvider = void 0;
-const certificate_js_1 = require("./certificate.js");
-var quorum_js_1 = require("./quorum.js");
-Object.defineProperty(exports, "P2PQuorumLeaseProvider", { enumerable: true, get: function () { return quorum_js_1.P2PQuorumLeaseProvider; } });
-var onchain_js_1 = require("./onchain.js");
-Object.defineProperty(exports, "OnchainWatermarkProvider", { enumerable: true, get: function () { return onchain_js_1.OnchainWatermarkProvider; } });
+import { certificateSignatureVerified } from './certificate.js';
+export { P2PQuorumLeaseProvider } from './quorum.js';
+export { OnchainWatermarkProvider } from './onchain.js';
 /**
  * Layer 3 — personal lookup-node lease coordinator.
  *
@@ -35,7 +30,7 @@ Object.defineProperty(exports, "OnchainWatermarkProvider", { enumerable: true, g
  * });
  * ```
  */
-class PersonalLeaseNodeProvider {
+export class PersonalLeaseNodeProvider {
     constructor(config) {
         this.baseUrl = config.nodeUrl.replace(/\/$/, '');
         this.nodePubkey = config.nodePubkey;
@@ -119,7 +114,6 @@ class PersonalLeaseNodeProvider {
                     verify: this.verify,
                 }
                 : undefined;
-        return (0, certificate_js_1.certificateSignatureVerified)(cert, signer);
+        return certificateSignatureVerified(cert, signer);
     }
 }
-exports.PersonalLeaseNodeProvider = PersonalLeaseNodeProvider;

package/dist/types.js

@@ -1,5 +1,4 @@
-"use strict";
 /**
  * @totemsdk/wots-lease — canonical v3 watermark types and WotsLeaseProvider interface
  */
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/watermark.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * WotsWatermarkStore — canonical v3 implementation
  *
@@ -7,22 +6,17 @@
  * - Enforces monotonicity: unavailable map can only grow, cursors can only advance.
  * - Storage key unchanged ('totem_wots_watermark') to avoid storage churn.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WotsWatermarkStore = void 0;
-exports.flatIndex = flatIndex;
-exports.fromFlatIndex = fromFlatIndex;
-exports.assertValidSigningIndices = assertValidSigningIndices;
-const core_1 = require("@totemsdk/core");
-const errors_js_1 = require("./errors.js");
+import { NoopLogger } from '@totemsdk/core';
+import { WatermarkMonotonicityError, WatermarkExhaustedError, WatermarkSeedRegressionError, } from './errors.js';
 const STORAGE_KEY = 'totem_wots_watermark';
 const MAX_L = 64;
 const CAPACITY_PER_TREE = MAX_L * MAX_L * MAX_L;
 const DEFAULT_TREE = 'default';
-function flatIndex(idx) {
+export function flatIndex(idx) {
     assertValidSigningIndices(idx);
     return idx.addressIndex * MAX_L * MAX_L + idx.l1 * MAX_L + idx.l2;
 }
-function fromFlatIndex(flat) {
+export function fromFlatIndex(flat) {
     if (!Number.isSafeInteger(flat) || flat < 0 || flat >= CAPACITY_PER_TREE) {
         throw new RangeError(`WOTS flat index must be an integer in [0, ${CAPACITY_PER_TREE - 1}]`);
     }
@@ -32,7 +26,7 @@ function fromFlatIndex(flat) {
     const l2 = rem % MAX_L;
     return { addressIndex, l1, l2 };
 }
-function assertValidSigningIndices(indices) {
+export function assertValidSigningIndices(indices) {
     for (const name of ['addressIndex', 'l1', 'l2']) {
         const value = indices[name];
         if (!Number.isSafeInteger(value) || value < 0 || value >= MAX_L) {
@@ -131,8 +125,8 @@ function migrateToV3(raw) {
     tree.l2Cursor = v1.next_l2 ?? 0;
     return { version: 3, trees: { [DEFAULT_TREE]: tree } };
 }
-class WotsWatermarkStore {
-    constructor(storage, logger = new core_1.NoopLogger()) {
+export class WotsWatermarkStore {
+    constructor(storage, logger = new NoopLogger()) {
         this.storage = storage;
         this.state = null;
         this._initialized = false;
@@ -194,7 +188,7 @@ class WotsWatermarkStore {
             cur = nxt;
             attempts++;
         }
-        throw new errors_js_1.WatermarkExhaustedError(treeId);
+        throw new WatermarkExhaustedError(treeId);
     }
     async markUnavailable(treeId, indices, reason) {
         const tree = this.getOrCreateTree(treeId);
@@ -232,12 +226,12 @@ class WotsWatermarkStore {
         const existingFlat = flatIndex({ addressIndex: existing.addressCursor, l1: existing.l1Cursor, l2: existing.l2Cursor });
         const newFlat = flatIndex({ addressIndex: merged.addressCursor, l1: merged.l1Cursor, l2: merged.l2Cursor });
         if (newFlat < existingFlat) {
-            throw new errors_js_1.WatermarkMonotonicityError(`Cannot decrease watermark cursor for ${treeId}: ${existingFlat} → ${newFlat}`);
+            throw new WatermarkMonotonicityError(`Cannot decrease watermark cursor for ${treeId}: ${existingFlat} → ${newFlat}`);
         }
         const existingUnavailCount = Object.keys(existing.unavailable).length;
         const newUnavailCount = Object.keys(merged.unavailable).length;
         if (newUnavailCount < existingUnavailCount) {
-            throw new errors_js_1.WatermarkMonotonicityError(`Cannot shrink unavailable map for ${treeId}: ${existingUnavailCount} → ${newUnavailCount}`);
+            throw new WatermarkMonotonicityError(`Cannot shrink unavailable map for ${treeId}: ${existingUnavailCount} → ${newUnavailCount}`);
         }
         s.trees[treeId] = merged;
         await this.persist();
@@ -295,7 +289,7 @@ class WotsWatermarkStore {
             l2: existing.l2Cursor,
         });
         if (!options.allowRegression && seedCursor < existingCursor) {
-            throw new errors_js_1.WatermarkSeedRegressionError(seed.treeId, existingCursor, seedCursor);
+            throw new WatermarkSeedRegressionError(seed.treeId, existingCursor, seedCursor);
         }
         const unavailable = { ...existing.unavailable };
         for (const flat of seed.unavailable ?? []) {
@@ -325,4 +319,3 @@ class WotsWatermarkStore {
         await this.storage.remove(STORAGE_KEY);
     }
 }
-exports.WotsWatermarkStore = WotsWatermarkStore;

package/package.json

@@ -1,14 +1,19 @@
 {
   "name": "@totemsdk/wots-lease",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "WOTS key-use coordination — canonical v3 watermark, provider-based lease safety layers",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "dist/cjs/index.js",
+  "types": "dist/cjs/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
     }
   },
   "files": [
@@ -16,13 +21,16 @@
     "rust/pkg/",
     "rust/pkg-node/",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "NOTICE"
   ],
   "dependencies": {
-    "@totemsdk/core": "^1.2.11",
-    "@totemsdk/lookup-protocol": "^0.2.0",
-    "@totemsdk/txpow": "^1.0.2",
-    "@totemsdk/storage": "^0.1.0"
+    "@noble/hashes": "^1.8.0",
+    "@totemsdk/core": "^1.4.2",
+    "@totemsdk/txpow": "^1.1.1",
+    "@totemsdk/replication": "^0.2.0",
+    "@totemsdk/lookup-protocol": "^0.3.0",
+    "@totemsdk/storage": "^0.2.2"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
@@ -37,7 +45,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "license": "MIT",
+  "license": "Apache-2.0",
   "author": "Totem SDK",
   "homepage": "https://docs.totem.ing",
   "bugs": {
@@ -57,8 +65,9 @@
     "wots",
     "utxo"
   ],
+  "type": "module",
   "scripts": {
-    "build": "npm run build:wasm && tsc && node ../../scripts/clean-wasm-output-ignores.mjs",
+    "build": "tsc && tsc -p tsconfig.cjs.json && node -e \"require('fs').writeFileSync('dist/cjs/package.json', JSON.stringify({type:'commonjs'})+'\\n')\"",
     "build:wasm": "cd rust && wasm-pack build --target bundler --out-dir pkg && wasm-pack build --target nodejs --out-dir pkg-node",
     "clean": "rm -rf dist rust/pkg rust/pkg-node rust/target",
     "test": "jest"

package/rust/pkg/package.json

@@ -6,7 +6,7 @@
   ],
   "description": "WOTS key-use coordination — canonical v3 watermark, flat index computation, monotonicity enforcement, device keyspace partitioning (Rust/WASM)",
   "version": "0.1.0",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/Totem-Edge/totem-sdk"
@@ -24,4 +24,4 @@
     "./wots_lease_wasm.js",
     "./snippets/*"
   ]
-}
+}

package/rust/pkg-node/package.json

@@ -5,7 +5,7 @@
   ],
   "description": "WOTS key-use coordination — canonical v3 watermark, flat index computation, monotonicity enforcement, device keyspace partitioning (Rust/WASM)",
   "version": "0.1.0",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/Totem-Edge/totem-sdk"
@@ -18,4 +18,4 @@
   "main": "wots_lease_wasm.js",
   "homepage": "https://totem.ing",
   "types": "wots_lease_wasm.d.ts"
-}
+}