@totemsdk/wots-lease 0.1.1 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Totem SDK Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# @totemsdk/wots-lease
+
+**WOTS key safety — prevents catastrophic signature slot reuse.**
+
+> ⚠️ **WOTS keys are one-time use.** Reusing a signing slot leaks the private key and permanently destroys the security of that address. This package is the guardian that prevents it from happening.
+
+Coordinates key-use watermarks across devices and sessions so no signing slot is ever allocated twice.
+
+## Install
+
+```bash
+npm install @totemsdk/wots-lease
+```
+
+## What's inside
+
+### Core stores
+
+| Class | What it does |
+|-------|-------------|
+| `WotsWatermarkStore` | Canonical v3 watermark tracking; `flatIndex` maps `(l1, l2)` → flat slot number |
+| `LeaseJournal` | Append-only audit log of every signing slot allocation |
+
+### Provider tiers
+
+| Provider | Use case |
+|----------|----------|
+| `LocalLeaseProvider` | Single-device, in-process coordination |
+| `AxiaLeaseProvider` | Cloud-coordinated leases via Axia API |
+| `HybridLeaseProvider` | Local-first with Axia sync fallback |
+| `PersonalLeaseNodeProvider` | Coordinates through your personal lookup node *(ready for implementation)* |
+| `P2PQuorumLeaseProvider` | Multi-device quorum consensus *(stub)* |
+| `OnchainWatermarkProvider` | On-chain watermark anchoring *(stub)* |
+
+### Device range splitting
+
+```typescript
+import { allocateDeviceRange } from '@totemsdk/wots-lease';
+
+// Split 262,144 signing slots across 4 devices without overlap
+const range = allocateDeviceRange({ deviceIndex: 0, totalDevices: 4 });
+// { start: 0, end: 65535 }
+```
+
+### Error types
+
+| Error | Meaning |
+|-------|---------|
+| `WatermarkMonotonicityError` | Attempted to use a slot at or before the current watermark |
+| `WatermarkExhaustedError` | All 262,144 signing slots for this address have been used |
+| `DeviceRangeViolationError` | Slot is outside this device's allocated range |
+
+## Usage
+
+### Local (single device)
+
+```typescript
+import { LocalLeaseProvider, WotsWatermarkStore } from '@totemsdk/wots-lease';
+
+const store    = new WotsWatermarkStore(storageAdapter);
+const provider = new LocalLeaseProvider(store);
+
+// Allocate the next available signing slot
+const slot = await provider.allocateSlot({ addressIndex: 0 });
+console.log('Use flat slot:', slot.flatIndex); // e.g. 42
+
+// After signing, commit the watermark
+await provider.commitSlot(slot);
+```
+
+### Hybrid (local + Axia cloud backup)
+
+```typescript
+import { HybridLeaseProvider } from '@totemsdk/wots-lease';
+
+const provider = new HybridLeaseProvider({
+  local: new LocalLeaseProvider(store),
+  remote: new AxiaLeaseProvider({ baseUrl: 'https://api.axia.to', projectId: '...' }),
+  syncIntervalMs: 60_000,
+});
+```
+
+### Audit log
+
+```typescript
+import { LeaseJournal } from '@totemsdk/wots-lease';
+
+const journal = new LeaseJournal(storageAdapter);
+const entries = await journal.getEntries({ addressIndex: 0 });
+entries.forEach(e => console.log(e.flatIndex, e.allocatedAt, e.committedAt));
+```
+
+## See also
+
+- [`@totemsdk/core`](https://www.npmjs.com/package/@totemsdk/core) — WOTS primitives this package protects
+- [`@totemsdk/lookup-node`](https://www.npmjs.com/package/@totemsdk/lookup-node) — `LeaseCoordinator` for multi-client setups
+- [`@totemsdk/omnia`](https://www.npmjs.com/package/@totemsdk/omnia) — integrates wots-lease to protect channel signing slots

package/dist/axia.js

@@ -1,23 +1,26 @@
+"use strict";
 /**
  * AxiaLeaseProvider — wraps the Axia API's /v1/wots-hardened endpoints.
  *
  * Callers do NOT need to call /finalize separately — commitKeyUse() does it.
  */
-import { NoopLogger, LeaseStore } from '@totemsdk/core';
-import { prepareLease, finalizeLease } from '@totemsdk/core';
-import { WotsWatermarkStore, flatIndex } from './watermark.js';
-import { LeaseJournal } from './journal.js';
-import { LeaseNotFoundError } from './errors.js';
-export class AxiaLeaseProvider {
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AxiaLeaseProvider = void 0;
+const core_1 = require("@totemsdk/core");
+const core_2 = require("@totemsdk/core");
+const watermark_js_1 = require("./watermark.js");
+const journal_js_1 = require("./journal.js");
+const errors_js_1 = require("./errors.js");
+class AxiaLeaseProvider {
     constructor(config) {
         this._initialized = false;
         this.apiUrl = config.apiUrl;
         this.apiKey = config.apiKey;
         this.rootPublicKey = config.rootPublicKey;
-        this.logger = config.logger ?? new NoopLogger();
-        this.watermark = new WotsWatermarkStore(config.storage, this.logger);
-        this.leaseStore = new LeaseStore(config.storage, this.logger);
-        this.journal = new LeaseJournal(config.storage, this.logger);
+        this.logger = config.logger ?? new core_1.NoopLogger();
+        this.watermark = new watermark_js_1.WotsWatermarkStore(config.storage, this.logger);
+        this.leaseStore = new core_1.LeaseStore(config.storage, this.logger);
+        this.journal = new journal_js_1.LeaseJournal(config.storage, this.logger);
     }
     async initialize() {
         if (this._initialized)
@@ -31,7 +34,7 @@ export class AxiaLeaseProvider {
         if (!this._initialized)
             await this.initialize();
         const txId = params.payloadHash ?? `tx-${Date.now()}`;
-        const resp = await prepareLease(this.apiUrl, this.apiKey, {
+        const resp = await (0, core_2.prepareLease)(this.apiUrl, this.apiKey, {
             txId,
             rootPublicKey: this.rootPublicKey,
             to: params.treeId,
@@ -54,7 +57,7 @@ export class AxiaLeaseProvider {
         await this.journal.append({
             treeId: params.treeId,
             branchId: params.branchId ?? 'default',
-            wotsIndex: flatIndex(indices),
+            wotsIndex: (0, watermark_js_1.flatIndex)(indices),
             indices,
             status: 'reserved',
             payloadHash: params.payloadHash,
@@ -68,15 +71,15 @@ export class AxiaLeaseProvider {
             await this.initialize();
         const lease = this.leaseStore.get(reservationId);
         if (!lease)
-            throw new LeaseNotFoundError(reservationId);
-        await finalizeLease(this.apiUrl, this.apiKey, lease.leaseToken, txId);
+            throw new errors_js_1.LeaseNotFoundError(reservationId);
+        await (0, core_2.finalizeLease)(this.apiUrl, this.apiKey, lease.leaseToken, txId);
         const indices = lease.indices;
         await this.watermark.markUnavailable(lease.indices.addressIndex.toString(), indices, 'committed');
         await this.leaseStore.updateStatus(reservationId, 'finalized');
         await this.journal.append({
             treeId: reservationId,
             branchId: 'default',
-            wotsIndex: flatIndex(indices),
+            wotsIndex: (0, watermark_js_1.flatIndex)(indices),
             indices,
             status: 'committed',
             txId,
@@ -89,7 +92,7 @@ export class AxiaLeaseProvider {
             await this.initialize();
         const lease = this.leaseStore.get(reservationId);
         if (!lease)
-            throw new LeaseNotFoundError(reservationId);
+            throw new errors_js_1.LeaseNotFoundError(reservationId);
         const indices = lease.indices;
         await this.watermark.markUnavailable(lease.indices.addressIndex.toString(), indices, 'burned');
         await this.leaseStore.updateStatus(reservationId, 'cancelled');
@@ -97,7 +100,7 @@ export class AxiaLeaseProvider {
         await this.journal.append({
             treeId: reservationId,
             branchId: 'default',
-            wotsIndex: flatIndex(indices),
+            wotsIndex: (0, watermark_js_1.flatIndex)(indices),
             indices,
             status: 'burned',
             timestamp: Date.now(),
@@ -121,3 +124,4 @@ export class AxiaLeaseProvider {
         return false;
     }
 }
+exports.AxiaLeaseProvider = AxiaLeaseProvider;

package/dist/device.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Device keyspace partitioning — Layer 2.
  *
@@ -10,9 +11,12 @@
  *   device 2 → addressIndex 16–23
  *   ...
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allocateDeviceRange = allocateDeviceRange;
+exports.deviceSlotForAddressIndex = deviceSlotForAddressIndex;
 const ADDRESSES_PER_DEVICE = 8;
 const MAX_DEVICE_SLOTS = 8;
-export function allocateDeviceRange(params) {
+function allocateDeviceRange(params) {
     if (params.deviceSlot < 0 || params.deviceSlot >= MAX_DEVICE_SLOTS) {
         throw new RangeError(`Device slot must be 0–${MAX_DEVICE_SLOTS - 1}, got ${params.deviceSlot}`);
     }
@@ -25,6 +29,6 @@ export function allocateDeviceRange(params) {
         addressCount: ADDRESSES_PER_DEVICE,
     };
 }
-export function deviceSlotForAddressIndex(addressIndex) {
+function deviceSlotForAddressIndex(addressIndex) {
     return Math.floor(addressIndex / ADDRESSES_PER_DEVICE);
 }

package/dist/errors.js

@@ -1,43 +1,52 @@
-export class WatermarkMonotonicityError extends Error {
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeviceRangeViolationError = exports.OnchainWatermarkNotImplementedError = exports.P2PQuorumNotImplementedError = exports.PersonalLeaseNodeNotConfiguredError = exports.LeaseNotFoundError = exports.WatermarkExhaustedError = exports.WatermarkMonotonicityError = void 0;
+class WatermarkMonotonicityError extends Error {
     constructor(message) {
         super(message);
         this.name = 'WatermarkMonotonicityError';
     }
 }
-export class WatermarkExhaustedError extends Error {
+exports.WatermarkMonotonicityError = WatermarkMonotonicityError;
+class WatermarkExhaustedError extends Error {
     constructor(treeId) {
         super(`WOTS keyspace exhausted for tree: ${treeId}`);
         this.treeId = treeId;
         this.name = 'WatermarkExhaustedError';
     }
 }
-export class LeaseNotFoundError extends Error {
+exports.WatermarkExhaustedError = WatermarkExhaustedError;
+class LeaseNotFoundError extends Error {
     constructor(reservationId) {
         super(`Lease reservation not found: ${reservationId}`);
         this.reservationId = reservationId;
         this.name = 'LeaseNotFoundError';
     }
 }
-export class PersonalLeaseNodeNotConfiguredError extends Error {
+exports.LeaseNotFoundError = LeaseNotFoundError;
+class PersonalLeaseNodeNotConfiguredError extends Error {
     constructor() {
         super('PersonalLeaseNodeProvider requires a running lookup node. ' +
             'Deploy @totemsdk/lookup-node and configure { nodeUrl, nodePubkey }.');
         this.name = 'PersonalLeaseNodeNotConfiguredError';
     }
 }
-export class P2PQuorumNotImplementedError extends Error {
+exports.PersonalLeaseNodeNotConfiguredError = PersonalLeaseNodeNotConfiguredError;
+class P2PQuorumNotImplementedError extends Error {
     constructor() {
         super('P2PQuorumLeaseProvider is not yet implemented.');
         this.name = 'P2PQuorumNotImplementedError';
     }
 }
-export class OnchainWatermarkNotImplementedError extends Error {
+exports.P2PQuorumNotImplementedError = P2PQuorumNotImplementedError;
+class OnchainWatermarkNotImplementedError extends Error {
     constructor() {
         super('OnchainWatermarkProvider is not yet implemented.');
         this.name = 'OnchainWatermarkNotImplementedError';
     }
 }
-export class DeviceRangeViolationError extends Error {
+exports.OnchainWatermarkNotImplementedError = OnchainWatermarkNotImplementedError;
+class DeviceRangeViolationError extends Error {
     constructor(addressIndex, allowedStart, allowedEnd) {
         super(`Address index ${addressIndex} is outside device range [${allowedStart}, ${allowedEnd}]`);
         this.addressIndex = addressIndex;
@@ -46,3 +55,4 @@ export class DeviceRangeViolationError extends Error {
         this.name = 'DeviceRangeViolationError';
     }
 }
+exports.DeviceRangeViolationError = DeviceRangeViolationError;

package/dist/hybrid.js

@@ -1,10 +1,13 @@
+"use strict";
 /**
  * HybridLeaseProvider — recommended production default.
  *
  * Always uses local first, then gates on node cert and/or quorum attestation
  * for transactions above a configurable value threshold.
  */
-export class HybridLeaseProvider {
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HybridLeaseProvider = void 0;
+class HybridLeaseProvider {
     constructor(config) {
         this.local = config.local;
         this.node = config.node;
@@ -62,3 +65,4 @@ export class HybridLeaseProvider {
         return false;
     }
 }
+exports.HybridLeaseProvider = HybridLeaseProvider;

package/dist/index.js

@@ -1,8 +1,30 @@
-export { WotsWatermarkStore, flatIndex, fromFlatIndex, } from './watermark.js';
-export { LeaseJournal } from './journal.js';
-export { LocalLeaseProvider } from './local.js';
-export { AxiaLeaseProvider } from './axia.js';
-export { HybridLeaseProvider } from './hybrid.js';
-export { PersonalLeaseNodeProvider, P2PQuorumLeaseProvider, OnchainWatermarkProvider, } from './stubs.js';
-export { allocateDeviceRange, deviceSlotForAddressIndex } from './device.js';
-export { WatermarkMonotonicityError, WatermarkExhaustedError, LeaseNotFoundError, PersonalLeaseNodeNotConfiguredError, P2PQuorumNotImplementedError, OnchainWatermarkNotImplementedError, DeviceRangeViolationError, } from './errors.js';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeviceRangeViolationError = exports.OnchainWatermarkNotImplementedError = exports.P2PQuorumNotImplementedError = exports.PersonalLeaseNodeNotConfiguredError = exports.LeaseNotFoundError = exports.WatermarkExhaustedError = exports.WatermarkMonotonicityError = exports.deviceSlotForAddressIndex = exports.allocateDeviceRange = exports.OnchainWatermarkProvider = exports.P2PQuorumLeaseProvider = exports.PersonalLeaseNodeProvider = exports.HybridLeaseProvider = exports.AxiaLeaseProvider = exports.LocalLeaseProvider = exports.LeaseJournal = exports.fromFlatIndex = exports.flatIndex = exports.WotsWatermarkStore = void 0;
+var watermark_js_1 = require("./watermark.js");
+Object.defineProperty(exports, "WotsWatermarkStore", { enumerable: true, get: function () { return watermark_js_1.WotsWatermarkStore; } });
+Object.defineProperty(exports, "flatIndex", { enumerable: true, get: function () { return watermark_js_1.flatIndex; } });
+Object.defineProperty(exports, "fromFlatIndex", { enumerable: true, get: function () { return watermark_js_1.fromFlatIndex; } });
+var journal_js_1 = require("./journal.js");
+Object.defineProperty(exports, "LeaseJournal", { enumerable: true, get: function () { return journal_js_1.LeaseJournal; } });
+var local_js_1 = require("./local.js");
+Object.defineProperty(exports, "LocalLeaseProvider", { enumerable: true, get: function () { return local_js_1.LocalLeaseProvider; } });
+var axia_js_1 = require("./axia.js");
+Object.defineProperty(exports, "AxiaLeaseProvider", { enumerable: true, get: function () { return axia_js_1.AxiaLeaseProvider; } });
+var hybrid_js_1 = require("./hybrid.js");
+Object.defineProperty(exports, "HybridLeaseProvider", { enumerable: true, get: function () { return hybrid_js_1.HybridLeaseProvider; } });
+var stubs_js_1 = require("./stubs.js");
+Object.defineProperty(exports, "PersonalLeaseNodeProvider", { enumerable: true, get: function () { return stubs_js_1.PersonalLeaseNodeProvider; } });
+Object.defineProperty(exports, "P2PQuorumLeaseProvider", { enumerable: true, get: function () { return stubs_js_1.P2PQuorumLeaseProvider; } });
+Object.defineProperty(exports, "OnchainWatermarkProvider", { enumerable: true, get: function () { return stubs_js_1.OnchainWatermarkProvider; } });
+var device_js_1 = require("./device.js");
+Object.defineProperty(exports, "allocateDeviceRange", { enumerable: true, get: function () { return device_js_1.allocateDeviceRange; } });
+Object.defineProperty(exports, "deviceSlotForAddressIndex", { enumerable: true, get: function () { return device_js_1.deviceSlotForAddressIndex; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "WatermarkMonotonicityError", { enumerable: true, get: function () { return errors_js_1.WatermarkMonotonicityError; } });
+Object.defineProperty(exports, "WatermarkExhaustedError", { enumerable: true, get: function () { return errors_js_1.WatermarkExhaustedError; } });
+Object.defineProperty(exports, "LeaseNotFoundError", { enumerable: true, get: function () { return errors_js_1.LeaseNotFoundError; } });
+Object.defineProperty(exports, "PersonalLeaseNodeNotConfiguredError", { enumerable: true, get: function () { return errors_js_1.PersonalLeaseNodeNotConfiguredError; } });
+Object.defineProperty(exports, "P2PQuorumNotImplementedError", { enumerable: true, get: function () { return errors_js_1.P2PQuorumNotImplementedError; } });
+Object.defineProperty(exports, "OnchainWatermarkNotImplementedError", { enumerable: true, get: function () { return errors_js_1.OnchainWatermarkNotImplementedError; } });
+Object.defineProperty(exports, "DeviceRangeViolationError", { enumerable: true, get: function () { return errors_js_1.DeviceRangeViolationError; } });

package/dist/journal.js

@@ -1,11 +1,14 @@
+"use strict";
 /**
  * LeaseJournal — append-only audit log for WOTS key-use events.
  * Preserves the full history: reserved → committed | burned | reserved-expired.
  */
-import { NoopLogger } from '@totemsdk/core';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LeaseJournal = void 0;
+const core_1 = require("@totemsdk/core");
 const STORAGE_KEY = 'totem_wots_journal';
-export class LeaseJournal {
-    constructor(storage, logger = new NoopLogger()) {
+class LeaseJournal {
+    constructor(storage, logger = new core_1.NoopLogger()) {
         this.storage = storage;
         this.logger = logger;
         this.entries = [];
@@ -37,3 +40,4 @@ export class LeaseJournal {
         await this.storage.remove(STORAGE_KEY);
     }
 }
+exports.LeaseJournal = LeaseJournal;

package/dist/local.js

@@ -1,29 +1,32 @@
+"use strict";
 /**
  * LocalLeaseProvider — Layer 1: local durable ledger.
  *
  * Single-device, no network coordination.
  * All WOTS safety guaranteed by the local WotsWatermarkStore + LeaseJournal.
  */
-import { NoopLogger } from '@totemsdk/core';
-import { LeaseStore } from '@totemsdk/core';
-import { WotsWatermarkStore, flatIndex } from './watermark.js';
-import { LeaseJournal } from './journal.js';
-import { LeaseNotFoundError, DeviceRangeViolationError } from './errors.js';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalLeaseProvider = void 0;
+const core_1 = require("@totemsdk/core");
+const core_2 = require("@totemsdk/core");
+const watermark_js_1 = require("./watermark.js");
+const journal_js_1 = require("./journal.js");
+const errors_js_1 = require("./errors.js");
 function randomId() {
     if (typeof crypto !== 'undefined' && crypto.randomUUID) {
         return crypto.randomUUID();
     }
     return Math.random().toString(36).slice(2) + Date.now().toString(36);
 }
-export class LocalLeaseProvider {
-    constructor(storage, logger = new NoopLogger(), deviceId = 'local') {
+class LocalLeaseProvider {
+    constructor(storage, logger = new core_1.NoopLogger(), deviceId = 'local') {
         this.logger = logger;
         this._initialized = false;
         /** In-memory map: reservationId → treeId (lost on restart; watermark survives). */
         this._treeIdByReservation = new Map();
-        this.watermark = new WotsWatermarkStore(storage, logger);
-        this.leaseStore = new LeaseStore(storage, logger);
-        this.journal = new LeaseJournal(storage, logger);
+        this.watermark = new watermark_js_1.WotsWatermarkStore(storage, logger);
+        this.leaseStore = new core_2.LeaseStore(storage, logger);
+        this.journal = new journal_js_1.LeaseJournal(storage, logger);
         this.deviceId = deviceId;
     }
     async initialize() {
@@ -45,7 +48,7 @@ export class LocalLeaseProvider {
                 await this.journal.append({
                     treeId,
                     branchId: 'default',
-                    wotsIndex: flatIndex(lease.indices),
+                    wotsIndex: (0, watermark_js_1.flatIndex)(lease.indices),
                     indices: lease.indices,
                     status: 'reserved-expired',
                     timestamp: now,
@@ -63,7 +66,7 @@ export class LocalLeaseProvider {
         if (params.deviceId) {
             const range = this.getDeviceRange(params.deviceId);
             if (range && (indices.addressIndex < range.start || indices.addressIndex > range.end)) {
-                throw new DeviceRangeViolationError(indices.addressIndex, range.start, range.end);
+                throw new errors_js_1.DeviceRangeViolationError(indices.addressIndex, range.start, range.end);
             }
         }
         const reservationId = randomId();
@@ -83,7 +86,7 @@ export class LocalLeaseProvider {
         await this.journal.append({
             treeId,
             branchId: params.branchId ?? 'default',
-            wotsIndex: flatIndex(indices),
+            wotsIndex: (0, watermark_js_1.flatIndex)(indices),
             indices,
             status: 'reserved',
             payloadHash: params.payloadHash,
@@ -97,7 +100,7 @@ export class LocalLeaseProvider {
             await this.initialize();
         const lease = this.leaseStore.get(reservationId);
         if (!lease)
-            throw new LeaseNotFoundError(reservationId);
+            throw new errors_js_1.LeaseNotFoundError(reservationId);
         const treeId = this._treeIdByReservation.get(reservationId) ?? 'default';
         const indices = lease.indices;
         await this.watermark.markUnavailable(treeId, indices, 'committed');
@@ -106,7 +109,7 @@ export class LocalLeaseProvider {
         await this.journal.append({
             treeId,
             branchId: 'default',
-            wotsIndex: flatIndex(indices),
+            wotsIndex: (0, watermark_js_1.flatIndex)(indices),
             indices,
             status: 'committed',
             txId,
@@ -119,7 +122,7 @@ export class LocalLeaseProvider {
             await this.initialize();
         const lease = this.leaseStore.get(reservationId);
         if (!lease)
-            throw new LeaseNotFoundError(reservationId);
+            throw new errors_js_1.LeaseNotFoundError(reservationId);
         const treeId = this._treeIdByReservation.get(reservationId) ?? 'default';
         const indices = lease.indices;
         await this.watermark.markUnavailable(treeId, indices, 'burned');
@@ -129,7 +132,7 @@ export class LocalLeaseProvider {
         await this.journal.append({
             treeId,
             branchId: 'default',
-            wotsIndex: flatIndex(indices),
+            wotsIndex: (0, watermark_js_1.flatIndex)(indices),
             indices,
             status: 'burned',
             timestamp: Date.now(),
@@ -161,3 +164,4 @@ export class LocalLeaseProvider {
         return { start: slot * 8, end: slot * 8 + 7 };
     }
 }
+exports.LocalLeaseProvider = LocalLeaseProvider;

package/dist/stubs.js

@@ -1,8 +1,11 @@
+"use strict";
 /**
  * Stub implementations for Layers 3–5.
  * These throw descriptive errors until the full implementations land.
  */
-import { PersonalLeaseNodeNotConfiguredError, P2PQuorumNotImplementedError, OnchainWatermarkNotImplementedError, } from './errors.js';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnchainWatermarkProvider = exports.P2PQuorumLeaseProvider = exports.PersonalLeaseNodeProvider = void 0;
+const errors_js_1 = require("./errors.js");
 /**
  * Layer 3 — personal p2p lease node.
  *
@@ -10,27 +13,27 @@ import { PersonalLeaseNodeNotConfiguredError, P2PQuorumNotImplementedError, Onch
  * Reserve/commit throws until the node is reachable — callers should
  * wrap with HybridLeaseProvider using a LocalLeaseProvider as the local layer.
  */
-export class PersonalLeaseNodeProvider {
+class PersonalLeaseNodeProvider {
     constructor(config) {
         this.config = config;
     }
     reserveKeyUse(_params) {
-        throw new PersonalLeaseNodeNotConfiguredError();
+        throw new errors_js_1.PersonalLeaseNodeNotConfiguredError();
     }
     commitKeyUse(_reservationId, _txId) {
-        throw new PersonalLeaseNodeNotConfiguredError();
+        throw new errors_js_1.PersonalLeaseNodeNotConfiguredError();
     }
     burnReservation(_reservationId, _reason) {
-        throw new PersonalLeaseNodeNotConfiguredError();
+        throw new errors_js_1.PersonalLeaseNodeNotConfiguredError();
     }
     getLocalWatermark(_treeId) {
-        throw new PersonalLeaseNodeNotConfiguredError();
+        throw new errors_js_1.PersonalLeaseNodeNotConfiguredError();
     }
     publishWatermark(_treeId) {
-        throw new PersonalLeaseNodeNotConfiguredError();
+        throw new errors_js_1.PersonalLeaseNodeNotConfiguredError();
     }
     syncLeaseJournal() {
-        throw new PersonalLeaseNodeNotConfiguredError();
+        throw new errors_js_1.PersonalLeaseNodeNotConfiguredError();
     }
     async verifyLeaseCertificate(cert) {
         if (!cert)
@@ -42,51 +45,54 @@ export class PersonalLeaseNodeProvider {
         return true;
     }
 }
+exports.PersonalLeaseNodeProvider = PersonalLeaseNodeProvider;
 /** Layer 4 — p2p replicated lease witnesses. */
-export class P2PQuorumLeaseProvider {
+class P2PQuorumLeaseProvider {
     reserveKeyUse(_params) {
-        throw new P2PQuorumNotImplementedError();
+        throw new errors_js_1.P2PQuorumNotImplementedError();
     }
     commitKeyUse(_reservationId, _txId) {
-        throw new P2PQuorumNotImplementedError();
+        throw new errors_js_1.P2PQuorumNotImplementedError();
     }
     burnReservation(_reservationId, _reason) {
-        throw new P2PQuorumNotImplementedError();
+        throw new errors_js_1.P2PQuorumNotImplementedError();
     }
     getLocalWatermark(_treeId) {
-        throw new P2PQuorumNotImplementedError();
+        throw new errors_js_1.P2PQuorumNotImplementedError();
     }
     publishWatermark(_treeId) {
-        throw new P2PQuorumNotImplementedError();
+        throw new errors_js_1.P2PQuorumNotImplementedError();
     }
     syncLeaseJournal() {
-        throw new P2PQuorumNotImplementedError();
+        throw new errors_js_1.P2PQuorumNotImplementedError();
     }
     verifyLeaseCertificate(_cert) {
-        throw new P2PQuorumNotImplementedError();
+        throw new errors_js_1.P2PQuorumNotImplementedError();
     }
 }
+exports.P2PQuorumLeaseProvider = P2PQuorumLeaseProvider;
 /** Layer 5 — on-chain watermark coin. */
-export class OnchainWatermarkProvider {
+class OnchainWatermarkProvider {
     reserveKeyUse(_params) {
-        throw new OnchainWatermarkNotImplementedError();
+        throw new errors_js_1.OnchainWatermarkNotImplementedError();
     }
     commitKeyUse(_reservationId, _txId) {
-        throw new OnchainWatermarkNotImplementedError();
+        throw new errors_js_1.OnchainWatermarkNotImplementedError();
     }
     burnReservation(_reservationId, _reason) {
-        throw new OnchainWatermarkNotImplementedError();
+        throw new errors_js_1.OnchainWatermarkNotImplementedError();
     }
     getLocalWatermark(_treeId) {
-        throw new OnchainWatermarkNotImplementedError();
+        throw new errors_js_1.OnchainWatermarkNotImplementedError();
     }
     publishWatermark(_treeId) {
-        throw new OnchainWatermarkNotImplementedError();
+        throw new errors_js_1.OnchainWatermarkNotImplementedError();
     }
     syncLeaseJournal() {
-        throw new OnchainWatermarkNotImplementedError();
+        throw new errors_js_1.OnchainWatermarkNotImplementedError();
     }
     verifyLeaseCertificate(_cert) {
-        throw new OnchainWatermarkNotImplementedError();
+        throw new errors_js_1.OnchainWatermarkNotImplementedError();
     }
 }
+exports.OnchainWatermarkProvider = OnchainWatermarkProvider;

package/dist/types.js

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