@totemsdk/wots-lease 0.1.4 → 0.1.6

package/dist/stubs.js

@@ -6,12 +6,15 @@
  *   that has lease coordination enabled ({ lease: { enabled: true } }).
  *   The node exposes REST endpoints under /v1/lease/*.
  *
- * Layers 4–5 (P2PQuorumLeaseProvider, OnchainWatermarkProvider) — require
- *   distributed infrastructure not yet available; they throw descriptive errors.
+ * 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.OnchainWatermarkProvider = exports.P2PQuorumLeaseProvider = exports.PersonalLeaseNodeProvider = void 0;
-const errors_js_1 = require("./errors.js");
+exports.PersonalLeaseNodeProvider = exports.OnchainWatermarkProvider = exports.P2PQuorumLeaseProvider = void 0;
+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; } });
 /**
  * Layer 3 — personal lookup-node lease coordinator.
  *
@@ -104,53 +107,3 @@ class PersonalLeaseNodeProvider {
     }
 }
 exports.PersonalLeaseNodeProvider = PersonalLeaseNodeProvider;
-/** Layer 4 — p2p replicated lease witnesses. */
-class P2PQuorumLeaseProvider {
-    reserveKeyUse(_params) {
-        throw new errors_js_1.P2PQuorumNotImplementedError();
-    }
-    commitKeyUse(_reservationId, _txId) {
-        throw new errors_js_1.P2PQuorumNotImplementedError();
-    }
-    burnReservation(_reservationId, _reason) {
-        throw new errors_js_1.P2PQuorumNotImplementedError();
-    }
-    getLocalWatermark(_treeId) {
-        throw new errors_js_1.P2PQuorumNotImplementedError();
-    }
-    publishWatermark(_treeId) {
-        throw new errors_js_1.P2PQuorumNotImplementedError();
-    }
-    syncLeaseJournal() {
-        throw new errors_js_1.P2PQuorumNotImplementedError();
-    }
-    verifyLeaseCertificate(_cert) {
-        throw new errors_js_1.P2PQuorumNotImplementedError();
-    }
-}
-exports.P2PQuorumLeaseProvider = P2PQuorumLeaseProvider;
-/** Layer 5 — on-chain watermark coin. */
-class OnchainWatermarkProvider {
-    reserveKeyUse(_params) {
-        throw new errors_js_1.OnchainWatermarkNotImplementedError();
-    }
-    commitKeyUse(_reservationId, _txId) {
-        throw new errors_js_1.OnchainWatermarkNotImplementedError();
-    }
-    burnReservation(_reservationId, _reason) {
-        throw new errors_js_1.OnchainWatermarkNotImplementedError();
-    }
-    getLocalWatermark(_treeId) {
-        throw new errors_js_1.OnchainWatermarkNotImplementedError();
-    }
-    publishWatermark(_treeId) {
-        throw new errors_js_1.OnchainWatermarkNotImplementedError();
-    }
-    syncLeaseJournal() {
-        throw new errors_js_1.OnchainWatermarkNotImplementedError();
-    }
-    verifyLeaseCertificate(_cert) {
-        throw new errors_js_1.OnchainWatermarkNotImplementedError();
-    }
-}
-exports.OnchainWatermarkProvider = OnchainWatermarkProvider;

package/dist/types.d.ts

@@ -1,6 +1,7 @@
 /**
  * @totemsdk/wots-lease — canonical v3 watermark types and WotsLeaseProvider interface
  */
+import type { LocalLeaseProvider } from './local.js';
 export type UnavailableReason = 'reserved' | 'committed' | 'burned' | 'reserved-expired';
 export interface SigningIndices {
     addressIndex: number;
@@ -22,6 +23,12 @@ export interface WotsWatermarkState {
     version: 3;
     trees: Record<string, TreeWatermark>;
 }
+export interface QuorumAttestation {
+    peerId: string;
+    indices: SigningIndices;
+    expiresAt: number;
+    signature?: string;
+}
 export interface LeaseCertificate {
     reservationId: string;
     treeId: string;
@@ -34,6 +41,10 @@ export interface LeaseCertificate {
     issuedAt: number;
     expiresAt: number;
     signature: string;
+    /** Layer 4 — quorum attestations collected from P2P peers. */
+    attestations?: QuorumAttestation[];
+    /** Layer 5 — content hash of the on-chain watermark TX (sha3-256 of TxPoW bytes). */
+    txpowid?: string;
 }
 export interface LeaseReservation {
     reservationId: string;
@@ -105,3 +116,84 @@ export interface PersonalLeaseNodeConfig {
     nodePubkey: string;
     authToken?: string;
 }
+/**
+ * Layer 4 — P2P quorum lease coordination.
+ *
+ * `peers` is the set of quorum members this device coordinates with. Each
+ * entry is a transport-agnostic RPC handle: the provider sends the same
+ * LEASE_RESERVE / LEASE_COMMIT / LEASE_BURN wire messages used by the
+ * lookup protocol, so any peer that speaks that protocol can participate
+ * (lookup nodes, other devices, or in-memory test peers).
+ */
+export interface QuorumPeer {
+    peerId: string;
+    request(message: {
+        type: 'LEASE_RESERVE' | 'LEASE_COMMIT' | 'LEASE_BURN' | 'LEASE_WATERMARK';
+        payload: Record<string, unknown>;
+    }, timeoutMs?: number): Promise<{
+        type: string;
+        payload: Record<string, unknown>;
+    }>;
+}
+export interface P2PQuorumLeaseProviderConfig {
+    /** Quorum members to coordinate with (excluding self). */
+    peers: QuorumPeer[];
+    /** Minimum attestations required for a reservation to be considered quorum-approved. Default: 1. */
+    minAttestations?: number;
+    /** Local provider used for the authoritative local watermark + journal. */
+    local: LocalLeaseProvider;
+    /** Timeout per peer request. Default: 5_000. */
+    requestTimeoutMs?: number;
+    /** Require quorum approval on commit as well as reserve. Default: false. */
+    requireQuorumOnCommit?: boolean;
+}
+/**
+ * Layer 5 — on-chain watermark anchoring.
+ *
+ * `chain` is any ChainStateProvider (hosted, Minima RPC, or lookup node).
+ * The provider spends a dedicated watermark coin whose STATE(0) holds the
+ * flat watermark cursor; every publish advances it on-chain so the watermark
+ * is verifiable by third parties without trusting this device.
+ */
+export interface OnchainWatermarkProviderConfig {
+    /** Chain access for coin queries, proofs, and broadcasting. */
+    chain: {
+        getCoin(coinId: string): Promise<{
+            coinid: string;
+            address: string;
+            amount: string;
+            tokenid: string;
+            state?: unknown[];
+        } | null>;
+        getProof(coinId: string): Promise<{
+            data: unknown;
+        }>;
+        broadcastTxPoW(txpowHex: string): Promise<{
+            success: boolean;
+            txpowid?: string;
+            message?: string;
+        }>;
+        getTip?(): Promise<{
+            block: number;
+        }>;
+    };
+    /** Coin ID of the dedicated watermark coin. */
+    watermarkCoinId: string;
+    /** Address the watermark coin currently sits at (spending address). */
+    watermarkAddress: string;
+    /** Token ID of the watermark coin. Default: '0x00'. */
+    tokenId?: string;
+    /** Amount of the watermark coin in MIN base units. Default: '1'. */
+    amount?: string;
+    /** Local provider used for the authoritative local watermark + journal. */
+    local: LocalLeaseProvider;
+    /** Signer for the watermark coin's script (SIGNEDBY digest). */
+    signer: {
+        publicKeyDigest: string;
+        sign(message: Uint8Array): Promise<Uint8Array>;
+    };
+    /** Port holding the flat watermark cursor in the coin state. Default: 0. */
+    statePort?: number;
+    /** Minimum blocks between on-chain publishes (rate limit). Default: 1. */
+    minBlocksBetweenPublishes?: number;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@totemsdk/wots-lease",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "WOTS key-use coordination — canonical v3 watermark, provider-based lease safety layers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,20 +11,17 @@
       "import": "./dist/index.js"
     }
   },
-  "scripts": {
-    "build": "tsc",
-    "prepare": "tsc",
-    "clean": "rm -rf dist",
-    "test": "jest --passWithNoTests"
-  },
   "files": [
     "dist",
+    "rust/pkg/",
+    "rust/pkg-node/",
     "README.md",
     "LICENSE"
   ],
   "dependencies": {
-    "@totemsdk/core": "^1.1.0",
-    "@totemsdk/lookup-protocol": "^0.1.3"
+    "@totemsdk/lookup-protocol": "^0.1.6",
+    "@totemsdk/core": "^1.2.8",
+    "@totemsdk/txpow": "^0.1.7"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
@@ -48,7 +45,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/totem-sdk/totem-sdk.git",
-    "directory": "packages/totem-sdk/packages/wots-lease"
+    "directory": "packages/wots-lease"
   },
   "keywords": [
     "totem",
@@ -57,7 +54,12 @@
     "blockchain",
     "quantum-resistant",
     "wots",
-    "kissvm",
     "utxo"
-  ]
-}
+  ],
+  "scripts": {
+    "build": "npm run build:wasm && tsc && node ../../scripts/clean-wasm-output-ignores.mjs",
+    "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

@@ -0,0 +1,27 @@
+{
+  "name": "wots-lease-wasm",
+  "type": "module",
+  "collaborators": [
+    "Totem SDK Contributors"
+  ],
+  "description": "WOTS key-use coordination — canonical v3 watermark, flat index computation, monotonicity enforcement, device keyspace partitioning (Rust/WASM)",
+  "version": "0.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/totem-sdk/totem-sdk"
+  },
+  "files": [
+    "wots_lease_wasm_bg.wasm",
+    "wots_lease_wasm.js",
+    "wots_lease_wasm_bg.js",
+    "wots_lease_wasm.d.ts"
+  ],
+  "main": "wots_lease_wasm.js",
+  "homepage": "https://totem.ing",
+  "types": "wots_lease_wasm.d.ts",
+  "sideEffects": [
+    "./wots_lease_wasm.js",
+    "./snippets/*"
+  ]
+}

package/rust/pkg/wots_lease_wasm.d.ts

@@ -0,0 +1,24 @@
+/* tslint:disable */
+/* eslint-disable */
+
+export function allocate_device_range_wasm(device_slot: number, device_id: string): any;
+
+export function device_slot_for_address_index_wasm(address_index: number): number;
+
+export function flat_index_wasm(address_index: number, l1: number, l2: number): number;
+
+export function from_flat_index_wasm(flat: number): any;
+
+export function get_capacity_per_tree_wasm(): number;
+
+export function get_local_watermark_wasm(state_js: any, tree_id: string): any;
+
+export function get_next_indices_wasm(state_js: any, tree_id: string): any;
+
+export function init(): void;
+
+export function is_unavailable_wasm(state_js: any, tree_id: string, indices_js: any): boolean;
+
+export function mark_unavailable_wasm(state_js: any, tree_id: string, indices_js: any, reason: string): any;
+
+export function new_watermark_state_wasm(): any;

package/rust/pkg/wots_lease_wasm.js

@@ -0,0 +1,9 @@
+/* @ts-self-types="./wots_lease_wasm.d.ts" */
+import * as wasm from "./wots_lease_wasm_bg.wasm";
+import { __wbg_set_wasm } from "./wots_lease_wasm_bg.js";
+
+__wbg_set_wasm(wasm);
+wasm.__wbindgen_start();
+export {
+    allocate_device_range_wasm, device_slot_for_address_index_wasm, flat_index_wasm, from_flat_index_wasm, get_capacity_per_tree_wasm, get_local_watermark_wasm, get_next_indices_wasm, init, is_unavailable_wasm, mark_unavailable_wasm, new_watermark_state_wasm
+} from "./wots_lease_wasm_bg.js";