@totemsdk/core 1.2.6 → 1.2.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/MiniNumber.js +9 -1
- package/dist/canonical.d.ts +3 -0
- package/dist/canonical.js +22 -0
- package/dist/cjs/MiniNumber.d.ts +47 -0
- package/dist/cjs/MiniNumber.js +310 -0
- package/dist/cjs/Streamable.d.ts +268 -0
- package/dist/cjs/Streamable.js +439 -0
- package/dist/cjs/adapters/index.d.ts +190 -0
- package/dist/cjs/adapters/index.js +118 -0
- package/dist/cjs/adapters/types.d.ts +150 -0
- package/dist/cjs/adapters/types.js +81 -0
- package/dist/cjs/binio.d.ts +9 -0
- package/dist/cjs/binio.js +25 -0
- package/dist/cjs/bip39.d.ts +91 -0
- package/dist/cjs/bip39.js +434 -0
- package/dist/cjs/canonical.d.ts +3 -0
- package/dist/cjs/canonical.js +27 -0
- package/dist/cjs/derive.d.ts +2 -0
- package/dist/cjs/derive.js +13 -0
- package/dist/cjs/index.d.ts +49 -0
- package/dist/cjs/index.js +231 -0
- package/dist/cjs/javaStreamables.d.ts +254 -0
- package/dist/cjs/javaStreamables.js +391 -0
- package/dist/cjs/lease/LeaseMonitor.d.ts +44 -0
- package/dist/cjs/lease/LeaseMonitor.js +115 -0
- package/dist/cjs/lease/LeaseStore.d.ts +58 -0
- package/dist/cjs/lease/LeaseStore.js +151 -0
- package/dist/cjs/lease/WatermarkStore.d.ts +61 -0
- package/dist/cjs/lease/WatermarkStore.js +209 -0
- package/dist/cjs/lease/index.d.ts +14 -0
- package/dist/cjs/lease/index.js +22 -0
- package/dist/cjs/lease-client.d.ts +31 -0
- package/dist/cjs/lease-client.js +44 -0
- package/dist/cjs/legacy.d.ts +23 -0
- package/dist/cjs/legacy.js +163 -0
- package/dist/cjs/minima32.d.ts +18 -0
- package/dist/cjs/minima32.js +121 -0
- package/dist/cjs/minimaWireSerializer.d.ts +60 -0
- package/dist/cjs/minimaWireSerializer.js +77 -0
- package/dist/cjs/mmr.d.ts +157 -0
- package/dist/cjs/mmr.js +352 -0
- package/dist/cjs/mx.d.ts +1 -0
- package/dist/cjs/mx.js +10 -0
- package/dist/cjs/package.json +1 -0
- package/dist/cjs/params.d.ts +29 -0
- package/dist/cjs/params.js +20 -0
- package/dist/cjs/script.d.ts +7 -0
- package/dist/cjs/script.js +27 -0
- package/dist/cjs/scripts/contract-helpers.d.ts +252 -0
- package/dist/cjs/scripts/contract-helpers.js +407 -0
- package/dist/cjs/scripts/dapp-types.d.ts +119 -0
- package/dist/cjs/scripts/dapp-types.js +77 -0
- package/dist/cjs/scripts/index.d.ts +4 -0
- package/dist/cjs/scripts/index.js +38 -0
- package/dist/cjs/scripts/types.d.ts +81 -0
- package/dist/cjs/scripts/types.js +159 -0
- package/dist/cjs/scripts/witness-serializer.d.ts +29 -0
- package/dist/cjs/scripts/witness-serializer.js +306 -0
- package/dist/cjs/transaction.d.ts +106 -0
- package/dist/cjs/transaction.js +293 -0
- package/dist/cjs/treekey.d.ts +399 -0
- package/dist/cjs/treekey.js +827 -0
- package/dist/cjs/tx/TransactionLifecycle.d.ts +55 -0
- package/dist/cjs/tx/TransactionLifecycle.js +205 -0
- package/dist/cjs/tx/TransactionReceiptStore.d.ts +36 -0
- package/dist/cjs/tx/TransactionReceiptStore.js +93 -0
- package/dist/cjs/tx/TransactionService.d.ts +50 -0
- package/dist/cjs/tx/TransactionService.js +186 -0
- package/dist/cjs/tx/index.d.ts +13 -0
- package/dist/cjs/tx/index.js +20 -0
- package/dist/cjs/tx/types.d.ts +115 -0
- package/dist/cjs/tx/types.js +6 -0
- package/dist/cjs/util.d.ts +1 -0
- package/dist/cjs/util.js +5 -0
- package/dist/cjs/utils.d.ts +8 -0
- package/dist/cjs/utils.js +42 -0
- package/dist/cjs/verify.d.ts +18 -0
- package/dist/cjs/verify.js +174 -0
- package/dist/cjs/version.d.ts +12 -0
- package/dist/cjs/version.js +15 -0
- package/dist/cjs/wasm-sync.d.ts +71 -0
- package/dist/cjs/wasm-sync.js +97 -0
- package/dist/cjs/wots.d.ts +232 -0
- package/dist/cjs/wots.js +589 -0
- package/dist/index.d.ts +9 -3
- package/dist/index.js +25 -2
- package/dist/minimaWireSerializer.js +2 -2
- package/dist/mmr.js +1 -1
- package/dist/transaction.js +10 -10
- package/dist/treekey.js +14 -0
- package/dist/wasm-sync.d.ts +2 -2
- package/dist/wasm-sync.js +3 -1
- package/dist/wots.d.ts +1 -1
- package/package.json +84 -45
- package/dist/wasm-bridge.d.ts +0 -54
- package/dist/wasm-bridge.js +0 -303
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* @module LeaseStore
|
|
4
|
+
* WOTS lease lifecycle management with platform-agnostic storage
|
|
5
|
+
*
|
|
6
|
+
* Uses in-memory cache backed by persistent storage.
|
|
7
|
+
* Pattern:
|
|
8
|
+
* - initialize() loads from storage into memory cache
|
|
9
|
+
* - Sync getters read from memory cache (fast, no I/O)
|
|
10
|
+
* - Mutators update memory cache AND persist to storage
|
|
11
|
+
* - Caller MUST call initialize() before using sync getters
|
|
12
|
+
*/
|
|
13
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
14
|
+
exports.LeaseStore = void 0;
|
|
15
|
+
const index_js_1 = require("../adapters/index.js");
|
|
16
|
+
const DEFAULT_STORAGE_KEY = 'totem_wots_leases';
|
|
17
|
+
class LeaseStore {
|
|
18
|
+
leases = new Map();
|
|
19
|
+
_initialized = false;
|
|
20
|
+
storageKey;
|
|
21
|
+
storage;
|
|
22
|
+
logger;
|
|
23
|
+
constructor(storage, logger = new index_js_1.NoopLogger(), config = {}) {
|
|
24
|
+
this.storage = storage;
|
|
25
|
+
this.logger = logger;
|
|
26
|
+
this.storageKey = config.storageKey ?? DEFAULT_STORAGE_KEY;
|
|
27
|
+
}
|
|
28
|
+
async initialize() {
|
|
29
|
+
if (this._initialized)
|
|
30
|
+
return;
|
|
31
|
+
await this.load();
|
|
32
|
+
await this.cleanupExpired();
|
|
33
|
+
this._initialized = true;
|
|
34
|
+
}
|
|
35
|
+
isInitialized() {
|
|
36
|
+
return this._initialized;
|
|
37
|
+
}
|
|
38
|
+
async load() {
|
|
39
|
+
try {
|
|
40
|
+
const leasesArray = await this.storage.get(this.storageKey);
|
|
41
|
+
if (leasesArray) {
|
|
42
|
+
this.leases = new Map(leasesArray.map(lease => [lease.leaseId, lease]));
|
|
43
|
+
this.logger.debug(`Loaded ${this.leases.size} leases from storage`);
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
catch (error) {
|
|
47
|
+
this.logger.error('Failed to load leases:', error);
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
async persist() {
|
|
51
|
+
try {
|
|
52
|
+
const leasesArray = Array.from(this.leases.values());
|
|
53
|
+
await this.storage.set(this.storageKey, leasesArray);
|
|
54
|
+
}
|
|
55
|
+
catch (error) {
|
|
56
|
+
this.logger.error('Failed to persist leases:', error);
|
|
57
|
+
throw error;
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
async save(lease) {
|
|
61
|
+
const flatIndex = this.flattenIndex(lease.indices);
|
|
62
|
+
this.logger.debug(`Storing lease: ${lease.leaseId}`);
|
|
63
|
+
this.logger.debug(` indices: (addressIndex=${lease.indices.addressIndex}, l1=${lease.indices.l1}, l2=${lease.indices.l2}) [${flatIndex}/262,144]`);
|
|
64
|
+
this.logger.debug(` status: ${lease.status}, TTL: ${lease.leaseTTL}ms`);
|
|
65
|
+
this.leases.set(lease.leaseId, lease);
|
|
66
|
+
await this.persist();
|
|
67
|
+
}
|
|
68
|
+
get(leaseId) {
|
|
69
|
+
return this.leases.get(leaseId);
|
|
70
|
+
}
|
|
71
|
+
getByToken(leaseToken) {
|
|
72
|
+
return Array.from(this.leases.values()).find(lease => lease.leaseToken === leaseToken);
|
|
73
|
+
}
|
|
74
|
+
getAll() {
|
|
75
|
+
return Array.from(this.leases.values());
|
|
76
|
+
}
|
|
77
|
+
getActive() {
|
|
78
|
+
const now = Date.now();
|
|
79
|
+
return this.getAll().filter(lease => lease.status === 'active' && lease.expiresAt > now);
|
|
80
|
+
}
|
|
81
|
+
getExpiringSoon(thresholdMs = 5000) {
|
|
82
|
+
const now = Date.now();
|
|
83
|
+
return this.getAll().filter(lease => lease.status === 'active' &&
|
|
84
|
+
lease.expiresAt > now &&
|
|
85
|
+
lease.expiresAt <= now + thresholdMs);
|
|
86
|
+
}
|
|
87
|
+
async delete(leaseId) {
|
|
88
|
+
const lease = this.leases.get(leaseId);
|
|
89
|
+
if (lease) {
|
|
90
|
+
this.logger.debug(`Deleting lease: ${leaseId}, final status: ${lease.status}`);
|
|
91
|
+
}
|
|
92
|
+
const existed = this.leases.delete(leaseId);
|
|
93
|
+
if (existed) {
|
|
94
|
+
await this.persist();
|
|
95
|
+
}
|
|
96
|
+
return existed;
|
|
97
|
+
}
|
|
98
|
+
async deleteByToken(leaseToken) {
|
|
99
|
+
const lease = this.getByToken(leaseToken);
|
|
100
|
+
if (lease) {
|
|
101
|
+
return this.delete(lease.leaseId);
|
|
102
|
+
}
|
|
103
|
+
return false;
|
|
104
|
+
}
|
|
105
|
+
async updateStatus(leaseId, status) {
|
|
106
|
+
const lease = this.leases.get(leaseId);
|
|
107
|
+
if (lease) {
|
|
108
|
+
const oldStatus = lease.status;
|
|
109
|
+
this.logger.debug(`Lease status change: ${leaseId} ${oldStatus} → ${status}`);
|
|
110
|
+
lease.status = status;
|
|
111
|
+
await this.persist();
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
async cleanupExpired() {
|
|
115
|
+
const now = Date.now();
|
|
116
|
+
const expiredLeaseIds = [];
|
|
117
|
+
for (const [leaseId, lease] of this.leases.entries()) {
|
|
118
|
+
if (lease.expiresAt <= now && lease.status !== 'finalized') {
|
|
119
|
+
lease.status = 'expired';
|
|
120
|
+
expiredLeaseIds.push(leaseId);
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
if (expiredLeaseIds.length > 0) {
|
|
124
|
+
this.logger.debug(`Marked ${expiredLeaseIds.length} leases as expired`);
|
|
125
|
+
await this.persist();
|
|
126
|
+
}
|
|
127
|
+
return expiredLeaseIds.length;
|
|
128
|
+
}
|
|
129
|
+
async clear() {
|
|
130
|
+
this.leases.clear();
|
|
131
|
+
await this.storage.remove(this.storageKey);
|
|
132
|
+
this.logger.debug('Cleared all leases');
|
|
133
|
+
}
|
|
134
|
+
getMinimumTTL() {
|
|
135
|
+
const activeLeases = this.getActive();
|
|
136
|
+
if (activeLeases.length === 0)
|
|
137
|
+
return null;
|
|
138
|
+
return Math.min(...activeLeases.map(lease => lease.leaseTTL));
|
|
139
|
+
}
|
|
140
|
+
calculateMonitoringInterval() {
|
|
141
|
+
const minTTL = this.getMinimumTTL();
|
|
142
|
+
if (minTTL === null)
|
|
143
|
+
return 5000;
|
|
144
|
+
const calculatedInterval = Math.min(minTTL / 4, 5000);
|
|
145
|
+
return Math.max(calculatedInterval, 1000);
|
|
146
|
+
}
|
|
147
|
+
flattenIndex(indices) {
|
|
148
|
+
return (indices.addressIndex * 64 * 64) + (indices.l1 * 64) + indices.l2;
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
exports.LeaseStore = LeaseStore;
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module WatermarkStore
|
|
3
|
+
* WOTS index tracking with server synchronization
|
|
4
|
+
*
|
|
5
|
+
* Uses in-memory cache backed by persistent storage.
|
|
6
|
+
* Pattern:
|
|
7
|
+
* - initialize() loads from storage into memory cache (or creates default)
|
|
8
|
+
* - Sync getters read from memory cache (fast, no I/O)
|
|
9
|
+
* - Mutators update memory cache AND persist to storage
|
|
10
|
+
* - Caller MUST call initialize() before using sync getters
|
|
11
|
+
*/
|
|
12
|
+
import type { StorageAdapter, LoggerAdapter } from '../adapters/index.js';
|
|
13
|
+
export interface WotsIndices {
|
|
14
|
+
addressIndex: number;
|
|
15
|
+
l1: number;
|
|
16
|
+
l2: number;
|
|
17
|
+
}
|
|
18
|
+
export interface WatermarkState {
|
|
19
|
+
next_addressIndex: number;
|
|
20
|
+
next_l1: number;
|
|
21
|
+
next_l2: number;
|
|
22
|
+
usedIndices: Array<[number, number, number]>;
|
|
23
|
+
lastSyncTimestamp?: number;
|
|
24
|
+
serverWatermark?: WotsIndices;
|
|
25
|
+
}
|
|
26
|
+
export interface SyncResult {
|
|
27
|
+
updated: boolean;
|
|
28
|
+
drift: number;
|
|
29
|
+
hasConflict: boolean;
|
|
30
|
+
}
|
|
31
|
+
export interface WatermarkStoreConfig {
|
|
32
|
+
storageKey?: string;
|
|
33
|
+
}
|
|
34
|
+
export declare class WatermarkStore {
|
|
35
|
+
private state;
|
|
36
|
+
private _initialized;
|
|
37
|
+
private readonly storageKey;
|
|
38
|
+
private readonly storage;
|
|
39
|
+
private readonly logger;
|
|
40
|
+
constructor(storage: StorageAdapter, logger?: LoggerAdapter, config?: WatermarkStoreConfig);
|
|
41
|
+
initialize(): Promise<WatermarkState>;
|
|
42
|
+
isInitialized(): boolean;
|
|
43
|
+
load(): Promise<WatermarkState | null>;
|
|
44
|
+
save(watermark: WatermarkState): Promise<void>;
|
|
45
|
+
clear(): Promise<void>;
|
|
46
|
+
getCurrent(): WatermarkState | null;
|
|
47
|
+
getNextIndices(): WotsIndices | null;
|
|
48
|
+
isExhausted(): boolean;
|
|
49
|
+
hasAvailableIndices(): boolean;
|
|
50
|
+
markUsed(indices: WotsIndices): Promise<void>;
|
|
51
|
+
advanceWatermark(indices: WotsIndices): Promise<void>;
|
|
52
|
+
updateFromServer(serverWatermark: WotsIndices): Promise<SyncResult>;
|
|
53
|
+
getUsageStats(): {
|
|
54
|
+
used: number;
|
|
55
|
+
total: number;
|
|
56
|
+
percentage: number;
|
|
57
|
+
};
|
|
58
|
+
private calculateNextIndices;
|
|
59
|
+
private shouldUseServerWatermark;
|
|
60
|
+
private flattenIndex;
|
|
61
|
+
}
|
|
@@ -0,0 +1,209 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* @module WatermarkStore
|
|
4
|
+
* WOTS index tracking with server synchronization
|
|
5
|
+
*
|
|
6
|
+
* Uses in-memory cache backed by persistent storage.
|
|
7
|
+
* Pattern:
|
|
8
|
+
* - initialize() loads from storage into memory cache (or creates default)
|
|
9
|
+
* - Sync getters read from memory cache (fast, no I/O)
|
|
10
|
+
* - Mutators update memory cache AND persist to storage
|
|
11
|
+
* - Caller MUST call initialize() before using sync getters
|
|
12
|
+
*/
|
|
13
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
14
|
+
exports.WatermarkStore = void 0;
|
|
15
|
+
const index_js_1 = require("../adapters/index.js");
|
|
16
|
+
const DEFAULT_STORAGE_KEY = 'totem_wots_watermark';
|
|
17
|
+
const MAX_INDEX_PER_LEVEL = 64;
|
|
18
|
+
const TOTAL_INDICES = 64 * 64 * 64;
|
|
19
|
+
class WatermarkStore {
|
|
20
|
+
state = null;
|
|
21
|
+
_initialized = false;
|
|
22
|
+
storageKey;
|
|
23
|
+
storage;
|
|
24
|
+
logger;
|
|
25
|
+
constructor(storage, logger = new index_js_1.NoopLogger(), config = {}) {
|
|
26
|
+
this.storage = storage;
|
|
27
|
+
this.logger = logger;
|
|
28
|
+
this.storageKey = config.storageKey ?? DEFAULT_STORAGE_KEY;
|
|
29
|
+
}
|
|
30
|
+
async initialize() {
|
|
31
|
+
if (this._initialized && this.state) {
|
|
32
|
+
return this.state;
|
|
33
|
+
}
|
|
34
|
+
const existing = await this.load();
|
|
35
|
+
if (existing) {
|
|
36
|
+
this._initialized = true;
|
|
37
|
+
return existing;
|
|
38
|
+
}
|
|
39
|
+
const initialState = {
|
|
40
|
+
next_addressIndex: 0,
|
|
41
|
+
next_l1: 0,
|
|
42
|
+
next_l2: 0,
|
|
43
|
+
usedIndices: []
|
|
44
|
+
};
|
|
45
|
+
await this.save(initialState);
|
|
46
|
+
this._initialized = true;
|
|
47
|
+
return initialState;
|
|
48
|
+
}
|
|
49
|
+
isInitialized() {
|
|
50
|
+
return this._initialized;
|
|
51
|
+
}
|
|
52
|
+
async load() {
|
|
53
|
+
try {
|
|
54
|
+
const watermark = await this.storage.get(this.storageKey);
|
|
55
|
+
if (watermark) {
|
|
56
|
+
this.state = watermark;
|
|
57
|
+
this.logger.debug('Loaded watermark from storage');
|
|
58
|
+
return this.state;
|
|
59
|
+
}
|
|
60
|
+
return null;
|
|
61
|
+
}
|
|
62
|
+
catch (error) {
|
|
63
|
+
this.logger.error('Failed to load watermark:', error);
|
|
64
|
+
return null;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
async save(watermark) {
|
|
68
|
+
try {
|
|
69
|
+
this.state = watermark;
|
|
70
|
+
await this.storage.set(this.storageKey, watermark);
|
|
71
|
+
}
|
|
72
|
+
catch (error) {
|
|
73
|
+
this.logger.error('Failed to save watermark:', error);
|
|
74
|
+
throw error;
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
async clear() {
|
|
78
|
+
try {
|
|
79
|
+
this.state = null;
|
|
80
|
+
this._initialized = false;
|
|
81
|
+
await this.storage.remove(this.storageKey);
|
|
82
|
+
this.logger.debug('Cleared watermark');
|
|
83
|
+
}
|
|
84
|
+
catch (error) {
|
|
85
|
+
this.logger.error('Failed to clear watermark:', error);
|
|
86
|
+
throw error;
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
getCurrent() {
|
|
90
|
+
return this.state;
|
|
91
|
+
}
|
|
92
|
+
getNextIndices() {
|
|
93
|
+
if (!this.state || this.isExhausted()) {
|
|
94
|
+
return null;
|
|
95
|
+
}
|
|
96
|
+
return {
|
|
97
|
+
addressIndex: this.state.next_addressIndex,
|
|
98
|
+
l1: this.state.next_l1,
|
|
99
|
+
l2: this.state.next_l2
|
|
100
|
+
};
|
|
101
|
+
}
|
|
102
|
+
isExhausted() {
|
|
103
|
+
if (!this.state)
|
|
104
|
+
return false;
|
|
105
|
+
return this.state.next_addressIndex >= MAX_INDEX_PER_LEVEL;
|
|
106
|
+
}
|
|
107
|
+
hasAvailableIndices() {
|
|
108
|
+
return !this.isExhausted();
|
|
109
|
+
}
|
|
110
|
+
async markUsed(indices) {
|
|
111
|
+
if (!this.state) {
|
|
112
|
+
await this.load();
|
|
113
|
+
}
|
|
114
|
+
if (!this.state) {
|
|
115
|
+
throw new Error('Watermark not initialized');
|
|
116
|
+
}
|
|
117
|
+
const indexTuple = [indices.addressIndex, indices.l1, indices.l2];
|
|
118
|
+
const flatIndex = this.flattenIndex(indices.addressIndex, indices.l1, indices.l2);
|
|
119
|
+
const alreadyUsed = this.state.usedIndices.some(([addressIndex, l1, l2]) => addressIndex === indices.addressIndex && l1 === indices.l1 && l2 === indices.l2);
|
|
120
|
+
if (!alreadyUsed) {
|
|
121
|
+
this.logger.debug(`Marking indices as USED: (addressIndex=${indices.addressIndex}, l1=${indices.l1}, l2=${indices.l2}) [${flatIndex}/${TOTAL_INDICES}]`);
|
|
122
|
+
this.logger.debug(` total used: ${this.state.usedIndices.length + 1} / ${TOTAL_INDICES}`);
|
|
123
|
+
this.state.usedIndices.push(indexTuple);
|
|
124
|
+
}
|
|
125
|
+
else {
|
|
126
|
+
this.logger.warn(`Indices already marked as used: (addressIndex=${indices.addressIndex}, l1=${indices.l1}, l2=${indices.l2})`);
|
|
127
|
+
}
|
|
128
|
+
await this.save(this.state);
|
|
129
|
+
}
|
|
130
|
+
async advanceWatermark(indices) {
|
|
131
|
+
if (!this.state) {
|
|
132
|
+
await this.load();
|
|
133
|
+
}
|
|
134
|
+
if (!this.state) {
|
|
135
|
+
throw new Error('Watermark not initialized');
|
|
136
|
+
}
|
|
137
|
+
const currentFlat = this.flattenIndex(indices.addressIndex, indices.l1, indices.l2);
|
|
138
|
+
const nextIndices = this.calculateNextIndices(indices);
|
|
139
|
+
const nextFlat = this.flattenIndex(nextIndices.addressIndex, nextIndices.l1, nextIndices.l2);
|
|
140
|
+
this.logger.debug(`Advancing watermark...`);
|
|
141
|
+
this.logger.debug(` current: (addressIndex=${indices.addressIndex}, l1=${indices.l1}, l2=${indices.l2}) [${currentFlat}/${TOTAL_INDICES}]`);
|
|
142
|
+
this.logger.debug(` next: (addressIndex=${nextIndices.addressIndex}, l1=${nextIndices.l1}, l2=${nextIndices.l2}) [${nextFlat}/${TOTAL_INDICES}]`);
|
|
143
|
+
this.state.next_addressIndex = nextIndices.addressIndex;
|
|
144
|
+
this.state.next_l1 = nextIndices.l1;
|
|
145
|
+
this.state.next_l2 = nextIndices.l2;
|
|
146
|
+
await this.save(this.state);
|
|
147
|
+
this.logger.debug('Watermark advanced and persisted');
|
|
148
|
+
}
|
|
149
|
+
async updateFromServer(serverWatermark) {
|
|
150
|
+
if (!this.state) {
|
|
151
|
+
await this.load();
|
|
152
|
+
}
|
|
153
|
+
if (!this.state) {
|
|
154
|
+
await this.initialize();
|
|
155
|
+
}
|
|
156
|
+
const localIndexFlat = this.flattenIndex(this.state.next_addressIndex, this.state.next_l1, this.state.next_l2);
|
|
157
|
+
const serverIndexFlat = this.flattenIndex(serverWatermark.addressIndex, serverWatermark.l1, serverWatermark.l2);
|
|
158
|
+
const drift = serverIndexFlat - localIndexFlat;
|
|
159
|
+
const hasConflict = drift > 1;
|
|
160
|
+
const needsUpdate = this.shouldUseServerWatermark(this.state, serverWatermark);
|
|
161
|
+
if (needsUpdate) {
|
|
162
|
+
this.logger.debug(`Updating watermark from server (drift: ${drift})`);
|
|
163
|
+
this.state.next_addressIndex = serverWatermark.addressIndex;
|
|
164
|
+
this.state.next_l1 = serverWatermark.l1;
|
|
165
|
+
this.state.next_l2 = serverWatermark.l2;
|
|
166
|
+
this.state.serverWatermark = serverWatermark;
|
|
167
|
+
this.state.lastSyncTimestamp = Date.now();
|
|
168
|
+
await this.save(this.state);
|
|
169
|
+
return { updated: true, drift, hasConflict };
|
|
170
|
+
}
|
|
171
|
+
this.state.lastSyncTimestamp = Date.now();
|
|
172
|
+
await this.save(this.state);
|
|
173
|
+
return { updated: false, drift, hasConflict };
|
|
174
|
+
}
|
|
175
|
+
getUsageStats() {
|
|
176
|
+
const used = this.state?.usedIndices.length ?? 0;
|
|
177
|
+
return {
|
|
178
|
+
used,
|
|
179
|
+
total: TOTAL_INDICES,
|
|
180
|
+
percentage: (used / TOTAL_INDICES) * 100
|
|
181
|
+
};
|
|
182
|
+
}
|
|
183
|
+
calculateNextIndices(current) {
|
|
184
|
+
let { addressIndex, l1, l2 } = current;
|
|
185
|
+
l2++;
|
|
186
|
+
if (l2 >= MAX_INDEX_PER_LEVEL) {
|
|
187
|
+
l2 = 0;
|
|
188
|
+
l1++;
|
|
189
|
+
if (l1 >= MAX_INDEX_PER_LEVEL) {
|
|
190
|
+
l1 = 0;
|
|
191
|
+
addressIndex++;
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
return { addressIndex, l1, l2 };
|
|
195
|
+
}
|
|
196
|
+
shouldUseServerWatermark(local, server) {
|
|
197
|
+
if (server.addressIndex > local.next_addressIndex)
|
|
198
|
+
return true;
|
|
199
|
+
if (server.addressIndex === local.next_addressIndex && server.l1 > local.next_l1)
|
|
200
|
+
return true;
|
|
201
|
+
if (server.addressIndex === local.next_addressIndex && server.l1 === local.next_l1 && server.l2 > local.next_l2)
|
|
202
|
+
return true;
|
|
203
|
+
return false;
|
|
204
|
+
}
|
|
205
|
+
flattenIndex(addressIndex, l1, l2) {
|
|
206
|
+
return (addressIndex * MAX_INDEX_PER_LEVEL * MAX_INDEX_PER_LEVEL) + (l1 * MAX_INDEX_PER_LEVEL) + l2;
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
exports.WatermarkStore = WatermarkStore;
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module @totemsdk/core/lease
|
|
3
|
+
* WOTS lease lifecycle management
|
|
4
|
+
*
|
|
5
|
+
* This module provides:
|
|
6
|
+
* - LeaseStore: Persistent storage for lease records with in-memory cache
|
|
7
|
+
* - WatermarkStore: WOTS index tracking with server sync
|
|
8
|
+
* - LeaseMonitor: Expiry monitoring and renewal
|
|
9
|
+
*/
|
|
10
|
+
export { LeaseStore, type StoredLease, type LeaseStatus, type LeaseStoreConfig, type WotsIndices as LeaseWotsIndices, } from './LeaseStore.js';
|
|
11
|
+
export { WatermarkStore, type WatermarkState, type SyncResult, type WatermarkStoreConfig, } from './WatermarkStore.js';
|
|
12
|
+
export type { WotsIndices } from './WatermarkStore.js';
|
|
13
|
+
export { LeaseMonitor, type LeaseExpiryEvent, type LeaseExpiryCallback, type LeaseMonitorConfig, } from './LeaseMonitor.js';
|
|
14
|
+
export { prepareLease, finalizeLease, flatIndexFromLanes, type PrepareArgs, type PrepareResp } from '../lease-client.js';
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* @module @totemsdk/core/lease
|
|
4
|
+
* WOTS lease lifecycle management
|
|
5
|
+
*
|
|
6
|
+
* This module provides:
|
|
7
|
+
* - LeaseStore: Persistent storage for lease records with in-memory cache
|
|
8
|
+
* - WatermarkStore: WOTS index tracking with server sync
|
|
9
|
+
* - LeaseMonitor: Expiry monitoring and renewal
|
|
10
|
+
*/
|
|
11
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
12
|
+
exports.flatIndexFromLanes = exports.finalizeLease = exports.prepareLease = exports.LeaseMonitor = exports.WatermarkStore = exports.LeaseStore = void 0;
|
|
13
|
+
var LeaseStore_js_1 = require("./LeaseStore.js");
|
|
14
|
+
Object.defineProperty(exports, "LeaseStore", { enumerable: true, get: function () { return LeaseStore_js_1.LeaseStore; } });
|
|
15
|
+
var WatermarkStore_js_1 = require("./WatermarkStore.js");
|
|
16
|
+
Object.defineProperty(exports, "WatermarkStore", { enumerable: true, get: function () { return WatermarkStore_js_1.WatermarkStore; } });
|
|
17
|
+
var LeaseMonitor_js_1 = require("./LeaseMonitor.js");
|
|
18
|
+
Object.defineProperty(exports, "LeaseMonitor", { enumerable: true, get: function () { return LeaseMonitor_js_1.LeaseMonitor; } });
|
|
19
|
+
var lease_client_js_1 = require("../lease-client.js");
|
|
20
|
+
Object.defineProperty(exports, "prepareLease", { enumerable: true, get: function () { return lease_client_js_1.prepareLease; } });
|
|
21
|
+
Object.defineProperty(exports, "finalizeLease", { enumerable: true, get: function () { return lease_client_js_1.finalizeLease; } });
|
|
22
|
+
Object.defineProperty(exports, "flatIndexFromLanes", { enumerable: true, get: function () { return lease_client_js_1.flatIndexFromLanes; } });
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Totem <-> Axia hardened WOTS helpers (no deps on server internals).
|
|
3
|
+
*/
|
|
4
|
+
export type PrepareArgs = {
|
|
5
|
+
txId: string;
|
|
6
|
+
rootPublicKey: string;
|
|
7
|
+
to: string;
|
|
8
|
+
amount: string;
|
|
9
|
+
tokenId?: string;
|
|
10
|
+
burn?: string | null;
|
|
11
|
+
digestL2?: string | null;
|
|
12
|
+
digestL3?: string | null;
|
|
13
|
+
ttlMs?: number;
|
|
14
|
+
};
|
|
15
|
+
export type PrepareResp = {
|
|
16
|
+
leaseToken: string;
|
|
17
|
+
lease: {
|
|
18
|
+
addressIndex: number;
|
|
19
|
+
l1: number;
|
|
20
|
+
l2: number;
|
|
21
|
+
};
|
|
22
|
+
txId: string;
|
|
23
|
+
digestTx?: string | null;
|
|
24
|
+
};
|
|
25
|
+
export declare function prepareLease(apiUrl: string, apiKey: string, args: PrepareArgs): Promise<PrepareResp>;
|
|
26
|
+
export declare function finalizeLease(apiUrl: string, apiKey: string, leaseToken: string, signedHex: string): Promise<{
|
|
27
|
+
status: number;
|
|
28
|
+
body: string;
|
|
29
|
+
}>;
|
|
30
|
+
/** lane tuple -> flat WOTS index (64^3 space) */
|
|
31
|
+
export declare function flatIndexFromLanes(addressIndex: number, l1: number, l2: number): number;
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.prepareLease = prepareLease;
|
|
4
|
+
exports.finalizeLease = finalizeLease;
|
|
5
|
+
exports.flatIndexFromLanes = flatIndexFromLanes;
|
|
6
|
+
async function prepareLease(apiUrl, apiKey, args) {
|
|
7
|
+
const res = await fetch(`${apiUrl}/v1/wots-hardened/prepare`, {
|
|
8
|
+
method: 'POST',
|
|
9
|
+
headers: { 'content-type': 'application/json', 'x-api-key': apiKey },
|
|
10
|
+
body: JSON.stringify({
|
|
11
|
+
tokenId: "0x00",
|
|
12
|
+
burn: null,
|
|
13
|
+
digestL2: null,
|
|
14
|
+
digestL3: null,
|
|
15
|
+
ttlMs: 20000,
|
|
16
|
+
...args
|
|
17
|
+
})
|
|
18
|
+
});
|
|
19
|
+
if (!res.ok)
|
|
20
|
+
throw new Error(`prepareLease ${res.status}`);
|
|
21
|
+
const raw = await res.json();
|
|
22
|
+
const lease = raw.lease ?? { addressIndex: raw.addressIndex ?? 0, l1: raw.l1 ?? 0, l2: raw.l2 ?? 0 };
|
|
23
|
+
return {
|
|
24
|
+
leaseToken: raw.leaseToken,
|
|
25
|
+
lease,
|
|
26
|
+
txId: raw.txId,
|
|
27
|
+
digestTx: raw.digestTx ?? null
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
async function finalizeLease(apiUrl, apiKey, leaseToken, signedHex) {
|
|
31
|
+
const res = await fetch(`${apiUrl}/v1/wots-hardened/finalize`, {
|
|
32
|
+
method: 'POST',
|
|
33
|
+
headers: { 'content-type': 'application/json', 'x-api-key': apiKey },
|
|
34
|
+
body: JSON.stringify({ leaseToken, signedHex })
|
|
35
|
+
});
|
|
36
|
+
const text = await res.text();
|
|
37
|
+
return { status: res.status, body: text };
|
|
38
|
+
}
|
|
39
|
+
/** lane tuple -> flat WOTS index (64^3 space) */
|
|
40
|
+
function flatIndexFromLanes(addressIndex, l1, l2) {
|
|
41
|
+
if (addressIndex | l1 | l2 & ~63)
|
|
42
|
+
throw new Error('lane out of range');
|
|
43
|
+
return (addressIndex * 64 * 64) + (l1 * 64) + l2;
|
|
44
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Legacy JS implementations — backward compatibility.
|
|
3
|
+
*
|
|
4
|
+
* These are the original TypeScript implementations preserved for
|
|
5
|
+
* environments where WASM is not available. The main entry point
|
|
6
|
+
* (`@totemsdk/core`) now delegates to WASM by default.
|
|
7
|
+
*
|
|
8
|
+
* Import legacy implementations directly:
|
|
9
|
+
* import { wotsSign } from '@totemsdk/core/legacy';
|
|
10
|
+
*/
|
|
11
|
+
export { F, hex, fromHex, u16be, u32be, assert32, h, prfChainSeed, toWinternitzDigits, baseWWithChecksum, derivePKdigest as legacyDerivePKdigest, wotsKeypairFromSeed as legacyWotsKeypairFromSeed, wotsSign as legacyWotsSign, wotsSignLegacy, wotsPkFromSig as legacyWotsPkFromSig, wotsVerify as legacyWotsVerify, wotsVerifyDigest as legacyWotsVerifyDigest, wotsPublicKeyFromSeed as legacyWotsPublicKeyFromSeed, type WotsKeypair, type WotsSignature, } from './wots.js';
|
|
12
|
+
export { TreeKey, TreeKeyNode, verifyTreeSignature as legacyVerifyTreeSignature, serializeTreeSignature, deserializeTreeSignature, getRootPublicKey, DEFAULT_KEYS_PER_LEVEL, DEFAULT_LEVELS, createUnifiedChildTreeKey as legacyCreateUnifiedChildTreeKey, createUnifiedChildTreeKeyAsync, createUnifiedRootTreeKey as legacyCreateUnifiedRootTreeKey, deriveUnifiedAddressPublicKey as legacyDeriveUnifiedAddressPublicKey, createPerAddressTreeKey, createPerAddressTreeKeyAsync, type KeyGenProgress, type ProgressCallback, type SignatureProof, type TreeSignature, } from './treekey.js';
|
|
13
|
+
export { MMRTree, mmrLeafExact, mmrRootFromSingleLeaf, createMMRDataLeafNode, createMMRDataParentNode, calculateProofRoot, verifyMMRProof as legacyVerifyMMRProof, parseMMRProofFromHex, deserializeMMRProof, serializeMMRProof, serializeRealMMRProof, type MMRData, type MMREntry, type MMRProof, type MMRProofChunk, type Bytes, } from './mmr.js';
|
|
14
|
+
export { WORD_LIST, cleanSeedPhrase as legacyCleanSeedPhrase, validatePhrase as legacyValidatePhrase, convertStringToSeed, convertWordListToSeed, phraseToSeed as legacyPhraseToSeed, generateWordList as legacyGenerateWordList, generateSeedPhrase, } from './bip39.js';
|
|
15
|
+
export { type MinimaTransaction, type MinimaCoin, type ParsedMiniNumber, type MinimaToken, type StateVariable, type RawStateVariable, type CoinProofData, type SpendableCoinInput, type TransactionBuildResult, parseDecimalToMiniNumber, serializeCoin, serializeTransaction as legacySerializeTransaction, computeTransactionDigest as legacyComputeTransactionDigest, precomputeTransactionCoinID as legacyPrecomputeTransactionCoinID, createDefaultTransaction, buildMinimaCoin, } from './transaction.js';
|
|
16
|
+
export { scriptToAddress, addressToRoot } from './derive.js';
|
|
17
|
+
export { scriptFromWotsPk, wotsAddressFromKeypair as legacyWotsAddressFromKeypair } from './script.js';
|
|
18
|
+
export { encodeMxRadix32Frame, decodeMxRadix32Frame, makeMxAddress as legacyMakeMxAddress, parseMxAddress as legacyParseMxAddress, hexToMx, mxToHex, encodeMx, decodeMx, makeMinimaAddress, convertMinimaAddress, } from './minima32.js';
|
|
19
|
+
export { writeMiniNumber as legacyWriteMiniNumber, writeMiniData as legacyWriteMiniData, writeMiniByte, writeMMREntryNumber, concat, hexToBytes as legacyHexToBytes, bytesToHex as legacyBytesToHex, bigIntToByteArray, writeMiniString as legacyWriteMiniString, writeHashToStream, } from './Streamable.js';
|
|
20
|
+
export { serializeMiniNumber, serializeMiniData, hashAllObjects, deriveChainSeedJava as legacyDeriveChainSeedJava, deriveChildTreeSeedJava, hashObject, serializeMiniNumberZERO, serializeMiniNumberONE, javaHashAllObjects, indexToMiniDataBytes, derivePerAddressSeed as legacyDerivePerAddressSeed, deriveRootPrivSeed as legacyDeriveRootPrivSeed, deriveUnifiedChildSeed, createMMREntryNumber, serializeMMREntryNumber, serializeMMRData, serializeMMREntry, precomputeTransactionCoinID as legacyPrecomputeTransactionCoinIDTx, type MMREntryNumber as JavaMMREntryNumber, type MMRData as JavaMMRData, type MMREntry as JavaMMREntry, } from './javaStreamables.js';
|
|
21
|
+
export { concatBytes as legacyConcatBytes } from './utils.js';
|
|
22
|
+
export * from './params.js';
|
|
23
|
+
export { verifySignature, verifySignatureDetailed, verifyTreeSignatureDetailed, deriveAddressFromPublicKey, normalizeHex, createChallenge as legacyCreateChallenge, validateChallenge as legacyValidateChallenge, type VerificationResult, } from './verify.js';
|