wowok 2.1.10 → 2.1.13

package/dist/cjs/experimental/core.js

@@ -0,0 +1,89 @@
+"use strict";
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Experimental_CoreClient = void 0;
+const type_tag_serializer_js_1 = require("../bcs/type-tag-serializer.js");
+const dynamic_fields_js_1 = require("../utils/dynamic-fields.js");
+const sui_types_js_1 = require("../utils/sui-types.js");
+const client_js_1 = require("./client.js");
+class Experimental_CoreClient extends client_js_1.Experimental_BaseClient {
+    core = this;
+    constructor(options) {
+        super(options);
+    }
+    async getObject(options) {
+        const { objectId } = options;
+        const { objects: [result], } = await this.getObjects({
+            objectIds: [objectId],
+            signal: options.signal,
+        });
+        if (result instanceof Error) {
+            throw result;
+        }
+        return { object: result };
+    }
+    async getDynamicField(options) {
+        const normalizedNameType = type_tag_serializer_js_1.TypeTagSerializer.parseFromStr(options.name.type);
+        const fieldId = (0, dynamic_fields_js_1.deriveDynamicFieldID)(options.parentId, normalizedNameType, options.name.bcs);
+        const { objects: [fieldObject], } = await this.getObjects({
+            objectIds: [fieldId],
+            signal: options.signal,
+        });
+        if (fieldObject instanceof Error) {
+            throw fieldObject;
+        }
+        const fieldType = (0, sui_types_js_1.parseStructTag)(fieldObject.type);
+        const content = await fieldObject.content;
+        return {
+            dynamicField: {
+                id: fieldObject.id,
+                digest: fieldObject.digest,
+                version: fieldObject.version,
+                type: fieldObject.type,
+                previousTransaction: fieldObject.previousTransaction,
+                name: {
+                    type: typeof fieldType.typeParams[0] === "string"
+                        ? fieldType.typeParams[0]
+                        : (0, sui_types_js_1.normalizeStructTag)(fieldType.typeParams[0]),
+                    bcs: options.name.bcs,
+                },
+                value: {
+                    type: typeof fieldType.typeParams[1] === "string"
+                        ? fieldType.typeParams[1]
+                        : (0, sui_types_js_1.normalizeStructTag)(fieldType.typeParams[1]),
+                    bcs: content.slice(sui_types_js_1.WOW_ADDRESS_LENGTH + options.name.bcs.length),
+                },
+            },
+        };
+    }
+    async waitForTransaction({ signal, timeout = 60 * 1000, ...input }) {
+        const abortSignal = signal
+            ? AbortSignal.any([AbortSignal.timeout(timeout), signal])
+            : AbortSignal.timeout(timeout);
+        const abortPromise = new Promise((_, reject) => {
+            abortSignal.addEventListener("abort", () => reject(abortSignal.reason));
+        });
+        abortPromise.catch(() => {
+            // Swallow unhandled rejections that might be thrown after early return
+        });
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            abortSignal.throwIfAborted();
+            try {
+                return await this.getTransaction({
+                    ...input,
+                    signal: abortSignal,
+                });
+            }
+            catch {
+                await Promise.race([
+                    new Promise((resolve) => setTimeout(resolve, 2_000)),
+                    abortPromise,
+                ]);
+            }
+        }
+    }
+}
+exports.Experimental_CoreClient = Experimental_CoreClient;
+//# sourceMappingURL=core.js.map

package/dist/cjs/experimental/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/experimental/core.ts"],"names":[],"mappings":"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"}

package/dist/cjs/experimental/errors.js

@@ -0,0 +1,32 @@
+"use strict";
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectError = exports.SuiClientError = void 0;
+class SuiClientError extends Error {
+}
+exports.SuiClientError = SuiClientError;
+class ObjectError extends SuiClientError {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+    static fromResponse(response, objectId) {
+        switch (response.code) {
+            case "notExists":
+                return new ObjectError(response.code, `Object ${response.object_id} does not exist`);
+            case "dynamicFieldNotFound":
+                return new ObjectError(response.code, `Dynamic field not found for object ${response.parent_object_id}`);
+            case "deleted":
+                return new ObjectError(response.code, `Object ${response.object_id} has been deleted`);
+            case "displayError":
+                return new ObjectError(response.code, `Display error: ${response.error}`);
+            case "unknown":
+            default:
+                return new ObjectError(response.code, `Unknown error while loading object${objectId ? ` ${objectId}` : ""}`);
+        }
+    }
+}
+exports.ObjectError = ObjectError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/experimental/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/experimental/errors.ts"],"names":[],"mappings":";AAAA,kCAAkC;AAClC,sCAAsC;;;AAItC,MAAa,cAAe,SAAQ,KAAK;CAAG;AAA5C,wCAA4C;AAE5C,MAAa,WAAY,SAAQ,cAAc;IAC9C,IAAI,CAAS;IAEb,YAAY,IAAY,EAAE,OAAe;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,YAAY,CAClB,QAA6B,EAC7B,QAAiB;QAEjB,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;YACvB,KAAK,WAAW;gBACf,OAAO,IAAI,WAAW,CACrB,QAAQ,CAAC,IAAI,EACb,UAAU,QAAQ,CAAC,SAAS,iBAAiB,CAC7C,CAAC;YACH,KAAK,sBAAsB;gBAC1B,OAAO,IAAI,WAAW,CACrB,QAAQ,CAAC,IAAI,EACb,sCAAsC,QAAQ,CAAC,gBAAgB,EAAE,CACjE,CAAC;YACH,KAAK,SAAS;gBACb,OAAO,IAAI,WAAW,CACrB,QAAQ,CAAC,IAAI,EACb,UAAU,QAAQ,CAAC,SAAS,mBAAmB,CAC/C,CAAC;YACH,KAAK,cAAc;gBAClB,OAAO,IAAI,WAAW,CACrB,QAAQ,CAAC,IAAI,EACb,kBAAkB,QAAQ,CAAC,KAAK,EAAE,CAClC,CAAC;YACH,KAAK,SAAS,CAAC;YACf;gBACC,OAAO,IAAI,WAAW,CACrB,QAAQ,CAAC,IAAI,EACb,qCAAqC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACrE,CAAC;QACJ,CAAC;IACF,CAAC;CACD;AAzCD,kCAyCC"}

package/dist/cjs/experimental/index.js

@@ -0,0 +1,15 @@
+"use strict";
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientCache = exports.Experimental_CoreClient = exports.Experimental_BaseClient = exports.parseTransactionEffectsBcs = exports.parseTransactionBcs = void 0;
+const client_js_1 = require("./client.js");
+Object.defineProperty(exports, "Experimental_BaseClient", { enumerable: true, get: function () { return client_js_1.Experimental_BaseClient; } });
+const core_js_1 = require("./core.js");
+Object.defineProperty(exports, "Experimental_CoreClient", { enumerable: true, get: function () { return core_js_1.Experimental_CoreClient; } });
+var utils_js_1 = require("./transports/utils.js");
+Object.defineProperty(exports, "parseTransactionBcs", { enumerable: true, get: function () { return utils_js_1.parseTransactionBcs; } });
+Object.defineProperty(exports, "parseTransactionEffectsBcs", { enumerable: true, get: function () { return utils_js_1.parseTransactionEffectsBcs; } });
+var cache_js_1 = require("./cache.js");
+Object.defineProperty(exports, "ClientCache", { enumerable: true, get: function () { return cache_js_1.ClientCache; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/experimental/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/experimental/index.ts"],"names":[],"mappings":";AAAA,kCAAkC;AAClC,sCAAsC;;;AAEtC,2CAAsD;AAiBrD,wGAjBQ,mCAAuB,OAiBR;AAZxB,uCAAoD;AAanD,wGAbQ,iCAAuB,OAaR;AAPxB,kDAG+B;AAF9B,+GAAA,mBAAmB,OAAA;AACnB,sHAAA,0BAA0B,OAAA;AAa3B,uCAAkE;AAAzD,uGAAA,WAAW,OAAA"}

package/dist/cjs/experimental/persistent-storage.js

@@ -0,0 +1,343 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiProcessKVStore = exports.Lock = exports.PersistentStorage = void 0;
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+/**
+ * A persistent storage module that supports multi-process access with file locking mechanism.
+ * This module ensures safe concurrent read/write operations across multiple processes.
+ */
+class PersistentStorage {
+    filePath;
+    lock;
+    /**
+     * Creates a new PersistentStorage instance.
+     * @param filePath Path to the storage file
+     */
+    constructor(filePath) {
+        this.filePath = filePath;
+        this.lock = new Lock(`${filePath}.lock`);
+        // Create the file if it doesn't exist
+        if (!(0, fs_1.existsSync)(filePath)) {
+            (0, fs_1.writeFileSync)(filePath, JSON.stringify({}));
+        }
+    }
+    /**
+     * Reads the entire storage content.
+     * @returns The parsed storage content
+     */
+    async readAll() {
+        await this.lock.acquireShared();
+        try {
+            const content = (0, fs_1.readFileSync)(this.filePath, "utf8");
+            return JSON.parse(content);
+        }
+        finally {
+            await this.lock.releaseShared();
+        }
+    }
+    /**
+     * Writes data to the storage.
+     * This operation is atomic and safe for multi-process access.
+     * @param data The data to write
+     */
+    async writeAll(data) {
+        await this.lock.acquireExclusive();
+        try {
+            // Write to a temporary file first
+            const tempFilePath = `${this.filePath}.tmp.${(0, crypto_1.randomBytes)(8).toString("hex")}`;
+            (0, fs_1.writeFileSync)(tempFilePath, JSON.stringify(data));
+            // Rename is atomic on most file systems
+            (0, fs_1.renameSync)(tempFilePath, this.filePath);
+        }
+        finally {
+            await this.lock.releaseExclusive();
+        }
+    }
+    /**
+     * Updates a specific key in the storage.
+     * This operation is atomic and safe for multi-process access.
+     * @param key The key to update
+     * @param value The new value
+     */
+    async set(key, value) {
+        await this.lock.acquireExclusive();
+        try {
+            const content = (0, fs_1.readFileSync)(this.filePath, "utf8");
+            const data = JSON.parse(content);
+            data[key] = value;
+            const tempFilePath = `${this.filePath}.tmp.${(0, crypto_1.randomBytes)(8).toString("hex")}`;
+            (0, fs_1.writeFileSync)(tempFilePath, JSON.stringify(data));
+            (0, fs_1.renameSync)(tempFilePath, this.filePath);
+        }
+        finally {
+            await this.lock.releaseExclusive();
+        }
+    }
+    /**
+     * Gets a specific key from the storage.
+     * @param key The key to get
+     * @returns The value associated with the key
+     */
+    async get(key) {
+        await this.lock.acquireShared();
+        try {
+            const content = (0, fs_1.readFileSync)(this.filePath, "utf8");
+            const data = JSON.parse(content);
+            return data[key];
+        }
+        finally {
+            await this.lock.releaseShared();
+        }
+    }
+    /**
+     * Updates the storage using a transaction function.
+     * This operation is atomic and safe for multi-process access.
+     * @param transactionFn A function that takes the current data and returns updated data
+     */
+    async transaction(transactionFn) {
+        await this.lock.acquireExclusive();
+        try {
+            const content = (0, fs_1.readFileSync)(this.filePath, "utf8");
+            const data = JSON.parse(content);
+            const updatedData = transactionFn(data);
+            const tempFilePath = `${this.filePath}.tmp.${(0, crypto_1.randomBytes)(8).toString("hex")}`;
+            (0, fs_1.writeFileSync)(tempFilePath, JSON.stringify(updatedData));
+            (0, fs_1.renameSync)(tempFilePath, this.filePath);
+        }
+        finally {
+            await this.lock.releaseExclusive();
+        }
+    }
+    /**
+     * Clears all data from the storage.
+     */
+    async clear() {
+        await this.lock.acquireExclusive();
+        try {
+            const tempFilePath = `${this.filePath}.tmp.${(0, crypto_1.randomBytes)(8).toString("hex")}`;
+            (0, fs_1.writeFileSync)(tempFilePath, JSON.stringify({}));
+            (0, fs_1.renameSync)(tempFilePath, this.filePath);
+        }
+        finally {
+            await this.lock.releaseExclusive();
+        }
+    }
+}
+exports.PersistentStorage = PersistentStorage;
+/**
+ * A file-based lock implementation that supports both shared and exclusive locks.
+ * This ensures safe concurrent access across multiple processes using atomic file operations.
+ */
+class Lock {
+    lockPath;
+    sharedLockPath;
+    lockFd = null;
+    sharedLockCount = 0;
+    exclusiveLockCount = 0;
+    constructor(lockPath) {
+        this.lockPath = lockPath;
+        this.sharedLockPath = `${lockPath}.shared`;
+    }
+    /**
+     * Acquires a shared lock. Multiple processes can hold a shared lock simultaneously.
+     */
+    async acquireShared() {
+        // If we already hold the exclusive lock, we can upgrade to shared
+        if (this.exclusiveLockCount > 0) {
+            this.sharedLockCount++;
+            this.exclusiveLockCount--;
+            return;
+        }
+        // If we already hold a shared lock, just increment the count
+        if (this.sharedLockCount > 0) {
+            this.sharedLockCount++;
+            return;
+        }
+        // Try to acquire a new shared lock
+        let attempts = 0;
+        const maxAttempts = 100;
+        const delay = 50; // milliseconds
+        while (attempts < maxAttempts) {
+            try {
+                // Check if exclusive lock exists
+                if ((0, fs_1.existsSync)(this.lockPath)) {
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                    attempts++;
+                    continue;
+                }
+                // Create shared lock file (atomic operation)
+                (0, fs_1.writeFileSync)(this.sharedLockPath, "");
+                this.sharedLockCount = 1;
+                return;
+            }
+            catch (error) {
+                // If we can't acquire the lock, wait before trying again
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                attempts++;
+            }
+        }
+        throw new Error("Failed to acquire shared lock after multiple attempts");
+    }
+    /**
+     * Acquires an exclusive lock. Only one process can hold an exclusive lock at a time.
+     */
+    async acquireExclusive() {
+        // If we already hold the exclusive lock, just increment the count
+        if (this.exclusiveLockCount > 0) {
+            this.exclusiveLockCount++;
+            return;
+        }
+        // Try to acquire a new exclusive lock
+        let attempts = 0;
+        const maxAttempts = 100;
+        const delay = 50; // milliseconds
+        while (attempts < maxAttempts) {
+            try {
+                // Check if shared lock exists
+                if ((0, fs_1.existsSync)(this.sharedLockPath)) {
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                    attempts++;
+                    continue;
+                }
+                // Create exclusive lock file (atomic operation)
+                const fd = (0, fs_1.openSync)(this.lockPath, fs_1.constants.O_CREAT | fs_1.constants.O_EXCL | fs_1.constants.O_WRONLY, 0o644);
+                (0, fs_1.closeSync)(fd);
+                this.exclusiveLockCount = 1;
+                return;
+            }
+            catch (error) {
+                // If we can't acquire the lock, wait before trying again
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                attempts++;
+            }
+        }
+        throw new Error("Failed to acquire exclusive lock after multiple attempts");
+    }
+    /**
+     * Releases a shared lock.
+     */
+    async releaseShared() {
+        if (this.sharedLockCount === 0) {
+            throw new Error("No shared lock to release");
+        }
+        this.sharedLockCount--;
+        // If this was the last shared lock, release the file lock
+        if (this.sharedLockCount === 0) {
+            try {
+                (0, fs_1.unlinkSync)(this.sharedLockPath);
+            }
+            catch (error) {
+                // Ignore errors if the file doesn't exist
+            }
+        }
+    }
+    /**
+     * Releases an exclusive lock.
+     */
+    async releaseExclusive() {
+        if (this.exclusiveLockCount === 0) {
+            throw new Error("No exclusive lock to release");
+        }
+        this.exclusiveLockCount--;
+        // If this was the last exclusive lock, release the file lock
+        if (this.exclusiveLockCount === 0) {
+            try {
+                (0, fs_1.unlinkSync)(this.lockPath);
+            }
+            catch (error) {
+                // Ignore errors if the file doesn't exist
+            }
+        }
+    }
+}
+exports.Lock = Lock;
+/**
+ * A simple key-value store that supports multi-process access and persistence.
+ * This is a higher-level API built on top of PersistentStorage for easier use.
+ */
+class MultiProcessKVStore {
+    storage;
+    /**
+     * Creates a new MultiProcessKVStore instance.
+     * @param filePath Path to the storage file
+     */
+    constructor(filePath) {
+        this.storage = new PersistentStorage(filePath);
+    }
+    /**
+     * Gets a value by key.
+     * @param key The key to get
+     * @returns The value associated with the key, or undefined if not found
+     */
+    async get(key) {
+        return this.storage.get(key);
+    }
+    /**
+     * Sets a value by key.
+     * @param key The key to set
+     * @param value The value to set
+     */
+    async set(key, value) {
+        return this.storage.set(key, value);
+    }
+    /**
+     * Deletes a key-value pair.
+     * @param key The key to delete
+     */
+    async delete(key) {
+        return this.storage.transaction((data) => {
+            delete data[key];
+            return data;
+        });
+    }
+    /**
+     * Checks if a key exists.
+     * @param key The key to check
+     * @returns True if the key exists, false otherwise
+     */
+    async has(key) {
+        const value = await this.storage.get(key);
+        return value !== undefined;
+    }
+    /**
+     * Gets all keys.
+     * @returns An array of all keys
+     */
+    async keys() {
+        const data = await this.storage.readAll();
+        return Object.keys(data);
+    }
+    /**
+     * Gets all values.
+     * @returns An array of all values
+     */
+    async values() {
+        const data = await this.storage.readAll();
+        return Object.values(data);
+    }
+    /**
+     * Gets all key-value pairs.
+     * @returns An array of all key-value pairs
+     */
+    async entries() {
+        const data = await this.storage.readAll();
+        return Object.entries(data);
+    }
+    /**
+     * Clears all key-value pairs.
+     */
+    async clear() {
+        return this.storage.clear();
+    }
+    /**
+     * Gets the number of key-value pairs.
+     * @returns The number of key-value pairs
+     */
+    async size() {
+        const data = await this.storage.readAll();
+        return Object.keys(data).length;
+    }
+}
+exports.MultiProcessKVStore = MultiProcessKVStore;
+//# sourceMappingURL=persistent-storage.js.map

package/dist/cjs/experimental/persistent-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-storage.js","sourceRoot":"","sources":["../../../src/experimental/persistent-storage.ts"],"names":[],"mappings":"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"}