@fhevm/sdk 0.0.1 → 1.0.0-alpha.1

package/_esm/core/base/errors/InvalidTypeError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidTypeError.js","sourceRoot":"","sources":["../../../../core/base/errors/InvalidTypeError.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAc3C,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C,YACE,EACE,OAAO,EACP,KAAK,EACL,IAAI,EACJ,YAAY,EACZ,YAAY,GAMQ,EACtB,OAA4B;QAE5B,MAAM,MAAM,GAAG,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,WAAW,CAAC;QAEhF,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QAE/F,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,IAAI,GAAG,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,GAAG,OAAO,GAAG,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,OAAO,IAAI,YAAY,kBAAkB,EAAE,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,SAAS,IAAI,EAAE,CAAC;QAC7B,CAAC;QAED,KAAK,CAAC;YACJ,GAAG,OAAO;YACV,OAAO;YACP,IAAI,EAAE,kBAAkB;YACxB,YAAY;SACb,CAAC,CAAC;IACL,CAAC;CACF"}

package/_esm/core/base/errors/utils.js

@@ -0,0 +1,36 @@
+import { InternalError } from './InternalError.js';
+export function ensureError(e) {
+    if (e instanceof Error) {
+        return e;
+    }
+    const message = e.message ?? 'Non-Error value caught in exception handler';
+    const name = e.name ?? 'ErrorWrapper';
+    const cause = e.cause ?? e;
+    const err = new Error(message, { cause });
+    err.name = name;
+    return err;
+}
+export function assertNever(_value, message) {
+    throw new InternalError({ message });
+}
+export function getErrorMessage(e) {
+    let msg;
+    if (typeof e === 'string') {
+        msg = e;
+    }
+    else if (e instanceof Error) {
+        msg = e.message;
+    }
+    else {
+        msg = String(e);
+    }
+    // Strip leading and trailing quotes (" or ')
+    while (msg.startsWith('"') || msg.startsWith("'")) {
+        msg = msg.slice(1);
+    }
+    while (msg.endsWith('"') || msg.endsWith("'")) {
+        msg = msg.slice(0, -1);
+    }
+    return msg;
+}
+//# sourceMappingURL=utils.js.map

package/_esm/core/base/errors/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../core/base/errors/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,UAAU,WAAW,CAAC,CAAU;IACpC,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAI,CAA0B,CAAC,OAAO,IAAI,6CAA6C,CAAC;IACrG,MAAM,IAAI,GAAI,CAAuB,CAAC,IAAI,IAAI,cAAc,CAAC;IAC7D,MAAM,KAAK,GAAI,CAAwB,CAAC,KAAK,IAAI,CAAC,CAAC;IAEnD,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1C,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAEhB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAa,EAAE,OAAe;IACxD,MAAM,IAAI,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAU;IACxC,IAAI,GAAW,CAAC;IAChB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,GAAG,GAAG,CAAC,CAAC;IACV,CAAC;SAAM,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;QAC9B,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,6CAA6C;IAC7C,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/_esm/core/base/fetch.js

@@ -0,0 +1,210 @@
+import { normalizeBytes } from './bytes.js';
+import { abortableSleep } from './timeout.js';
+/**
+ * Extracts the response body as a Uint8Array.
+ *
+ * Uses `Response.bytes()` when available, falling back to `Response.arrayBuffer()`
+ * for compatibility. The `bytes()` method is a newer addition to the Fetch API
+ * and may not be supported in all environments. (older browsers, some JS runtimes, or polyfills).
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Response/bytes
+ */
+export async function getResponseBytes(response) {
+    const bytes = typeof response.bytes === 'function'
+        ? normalizeBytes(await response.bytes())
+        : normalizeBytes(await response.arrayBuffer());
+    return bytes;
+}
+/**
+ * Extracts structured error information from a fetch error's cause chain.
+ *
+ * Node.js fetch (undici) wraps network errors in a TypeError with a `cause`
+ * property pointing to the underlying error. This function traverses the
+ * cause chain and extracts:
+ * - `name`: The error name (e.g., "TypeError", "Error")
+ * - `message`: The error message
+ * - `props`: All string/number properties (e.g., code, errno, syscall, hostname)
+ *
+ * Uses duck typing (checks for `message` property) rather than `instanceof`
+ * to handle cross-realm errors.
+ *
+ * @example
+ * // For a DNS lookup failure:
+ * // TypeError: fetch failed
+ * //   cause: Error: getaddrinfo ENOTFOUND example.com
+ * //          { code: 'ENOTFOUND', errno: -3008, syscall: 'getaddrinfo', hostname: 'example.com' }
+ * //
+ * // Returns:
+ * // [
+ * //   {
+ * //     name: 'TypeError',
+ * //     message: 'fetch failed',
+ * //     props: {}
+ * //   },
+ * //   {
+ * //     name: 'Error',
+ * //     message: 'getaddrinfo ENOTFOUND example.com',
+ * //     props: {
+ * //       code: 'ENOTFOUND',
+ * //       errno: -3008,
+ * //       syscall: 'getaddrinfo',
+ * //       hostname: 'example.com'
+ * //     }
+ * //   }
+ * // ]
+ */
+const FETCH_ERROR_SKIP_PROPS = new Set(['message', 'cause', 'stack', 'name']);
+function getFetchErrorInfo(error) {
+    const errors = [];
+    let current = error;
+    while (current !== null && typeof current === 'object') {
+        const obj = current;
+        if (typeof obj.message !== 'string') {
+            break;
+        }
+        const name = typeof obj.name === 'string' ? obj.name : 'Error';
+        const props = {};
+        for (const key of Object.keys(obj)) {
+            if (FETCH_ERROR_SKIP_PROPS.has(key))
+                continue;
+            const value = obj[key];
+            if (typeof value === 'string' || typeof value === 'number') {
+                props[key] = value;
+            }
+        }
+        errors.push({ name, message: obj.message, props });
+        current = obj.cause;
+    }
+    return errors;
+}
+/**
+ * Formats a fetch error into an array of human-readable messages.
+ *
+ * Traverses the error's cause chain and formats each error with its message
+ * and properties. The root error uses standard "Name: message" format, while
+ * nested causes are prefixed with "Cause: " and include name in the props.
+ *
+ * @param error - The error to format (typically from a failed fetch call)
+ * @returns An array of formatted error messages, one per error in the cause chain
+ *
+ * @example
+ * // For a DNS lookup failure (ENOTFOUND):
+ * // Input error structure:
+ * //   TypeError: fetch failed
+ * //     cause: Error: getaddrinfo ENOTFOUND api.example.com
+ * //            { code: 'ENOTFOUND', errno: -3008, syscall: 'getaddrinfo', hostname: 'api.example.com' }
+ * //
+ * // Output:
+ * // [
+ * //   "TypeError: fetch failed",
+ * //   "Cause: getaddrinfo ENOTFOUND api.example.com [name=Error, code=ENOTFOUND, errno=-3008, syscall=getaddrinfo, hostname=api.example.com]"
+ * // ]
+ *
+ * @example
+ * // For a connection refused error (ECONNREFUSED):
+ * // Output:
+ * // [
+ * //   "TypeError: fetch failed",
+ * //   "Cause: connect ECONNREFUSED 127.0.0.1:3000 [name=Error, code=ECONNREFUSED, errno=-61, syscall=connect, address=127.0.0.1, port=3000]"
+ * // ]
+ */
+export function formatFetchErrorMetaMessages(error) {
+    const infos = getFetchErrorInfo(error);
+    if (infos.length === 0) {
+        return [String(error)];
+    }
+    return infos.map((info, index) => {
+        const isRoot = index === 0;
+        const propEntries = Object.entries(info.props);
+        if (isRoot) {
+            // Root error: "TypeError: fetch failed [props...]" or "TypeError: fetch failed"
+            const propsStr = propEntries.length > 0 ? ` [${propEntries.map(([k, v]) => `${k}=${v}`).join(', ')}]` : '';
+            return `${info.name}: ${info.message}${propsStr}`;
+        }
+        else {
+            // Cause errors: "Cause: message [name=Error, props...]"
+            const allProps = [['name', info.name], ...propEntries];
+            const propsStr = ` [${allProps.map(([k, v]) => `${k}=${v}`).join(', ')}]`;
+            return `Cause: ${info.message}${propsStr}`;
+        }
+    });
+}
+/**
+ * Fetches a URL with automatic retry on network failures.
+ *
+ * Retries are triggered only for network-level errors (e.g., ECONNREFUSED, ENOTFOUND, UND_ERR_xxx (undici errors)
+ * connection timeouts). HTTP error responses (4xx, 5xx) are NOT retried - the response
+ * is returned as-is for the caller to handle.
+ *
+ * The operation is abortable via `init.signal`. If the signal is aborted, an AbortError
+ * is thrown immediately without further retries.
+ *
+ * @param url - The URL to fetch
+ * @param init - Optional fetch init options (method, headers, body, etc.)
+ * @param retries - Number of retry attempts on network failure (default: 3)
+ * @param retryDelayMs - Delay in milliseconds between retries (default: 1000)
+ * @returns The fetch Response
+ * @throws The last network error if all retries are exhausted
+ * @throws {Error} An error with name 'AbortError' if the signal is aborted
+ */
+export async function fetchWithRetry(args) {
+    let lastError;
+    const retries = args.retries ?? 3;
+    const retryDelayMs = args.retryDelayMs ?? 1000;
+    const { url, init } = args;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        // Check if already aborted before fetching
+        init?.signal?.throwIfAborted();
+        try {
+            return await fetch(url, init);
+        }
+        catch (error) {
+            // AbortError should not be retried - propagate immediately
+            if (error.name === 'AbortError') {
+                throw error;
+            }
+            lastError = error;
+            if (attempt < retries) {
+                // Abortable delay between retries
+                await abortableSleep(retryDelayMs, init?.signal ?? undefined);
+            }
+        }
+    }
+    throw lastError;
+}
+/**
+ * Smoke-tests whether `fetch("data:...base64,...")` works and returns correct bytes.
+ *
+ * This is critical because {@link isomorphicCompileWasmFromBase64} relies on
+ * `fetch("data:application/octet-stream;base64,...")` to decode a base64 WASM
+ * binary into an `ArrayBuffer` before passing it to `WebAssembly.compile`.
+ * If any step in this pipeline fails, WASM compilation will silently produce
+ * corrupt bytes or throw.
+ *
+ * Known failure cases:
+ * - CSP `connect-src` without `data:` blocks data URL fetches
+ * - Sandboxed iframes without `allow-same-origin`
+ * - Older Node.js versions (< 18.13) with limited data URL fetch support
+ *
+ * When this returns `false`, callers should fall back to `atob` decoding
+ * or URL-based WASM loading via {@link isomorphicCompileWasm}.
+ */
+let _isDataUrlFetchSupportedPromise;
+export function isDataUrlFetchSupported() {
+    _isDataUrlFetchSupportedPromise ??= _isDataUrlFetchSupported();
+    return _isDataUrlFetchSupportedPromise;
+}
+async function _isDataUrlFetchSupported() {
+    try {
+        const res = await fetch('data:text/plain;base64,YQ==');
+        if (!res.ok) {
+            return false;
+        }
+        const buf = await res.arrayBuffer();
+        return buf.byteLength === 1 && new Uint8Array(buf)[0] === 0x61; // 'a'
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/_esm/core/base/fetch.js.map

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

package/_esm/core/base/index.js

@@ -0,0 +1,2 @@
+export { createTypedValue, createTypedValueArray } from './typedValue.js';
+//# sourceMappingURL=index.js.map

package/_esm/core/base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/base/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/_esm/core/base/isomorphicWorker.js

@@ -0,0 +1,235 @@
+function isNodePort(target) {
+    return typeof target.on === 'function';
+}
+export function isBrowserLike() {
+    return typeof addEventListener === 'function' && typeof removeEventListener === 'function';
+}
+/**
+ * This function is called from inside a worker to get the messaging target
+ * It's the communication channel between a worker thread and its parent (main) thread.
+ */
+export async function getIsomorphicTarget() {
+    if (isBrowserLike())
+        return self;
+    const nodeWorkerModuleName = 'worker_threads';
+    const nodeWorkerModuleId = `node:${nodeWorkerModuleName}`;
+    const { parentPort: nodeParentPort } = (await import(/* @vite-ignore */ nodeWorkerModuleId));
+    if (!nodeParentPort) {
+        throw new Error('Not running inside a worker thread');
+    }
+    return nodeParentPort;
+}
+export async function createIsomorphicWorker(url) {
+    if (isBrowserLike()) {
+        return createBrowserLikeWorker(url);
+    }
+    return createNodeLikeWorker(url);
+}
+export async function createIsomorphicWorkerFromCode(jsCode) {
+    if (isBrowserLike()) {
+        const blob = new Blob([jsCode], { type: 'application/javascript' });
+        const blobUrl = URL.createObjectURL(blob);
+        try {
+            const browserWorker = new Worker(blobUrl);
+            return browserWorker;
+        }
+        finally {
+            URL.revokeObjectURL(blobUrl);
+        }
+    }
+    const nodeWorkerModuleName = 'worker_threads';
+    const nodeWorkerModuleId = `node:${nodeWorkerModuleName}`;
+    const { Worker: NodeWorker } = (await import(/* @vite-ignore */ nodeWorkerModuleId));
+    return new NodeWorker(jsCode, { eval: true });
+}
+/**
+ * Runs code in an isomorphic worker thread and returns the result.
+ *
+ * The `code` string is wrapped in an async IIFE that receives `data` as input.
+ * Use `return` to send the result back to the main thread.
+ *
+ * @example
+ * const module = await runCodeInIsomorphicWorker<WebAssembly.Module>(
+ *   `const res = await fetch("data:application/octet-stream;base64," + data);
+ *    const bytes = new Uint8Array(await res.arrayBuffer());
+ *    return WebAssembly.compile(bytes);`,
+ *   base64,
+ * );
+ *
+ * @param code - JS code to execute. Receives `data` as input, must `return` the result.
+ * @param input - Value sent to the worker via postMessage (must be structured-cloneable).
+ * @param timeoutMs - Max execution time before the worker is killed. Default: 30s.
+ */
+export async function runCodeInIsomorphicWorker(code, input, timeoutMs = 30_000) {
+    const browserCode = `
+    self.onmessage = async ({ data }) => {
+      try {
+        const result = await (async (data) => { ${code} })(data);
+        self.postMessage({ result });
+      } catch (e) {
+        self.postMessage({ error: String(e) });
+      }
+    };
+  `;
+    const nodeCode = `
+    const { parentPort } = require("worker_threads");
+    parentPort.on("message", async (data) => {
+      try {
+        const result = await (async (data) => { ${code} })(data);
+        parentPort.postMessage({ result });
+      } catch (e) {
+        parentPort.postMessage({ error: String(e) });
+      }
+    });
+  `;
+    const workerCode = isBrowserLike() ? browserCode : nodeCode;
+    const worker = await createIsomorphicWorkerFromCode(workerCode);
+    return new Promise((resolve, reject) => {
+        // Guards against double-settle (e.g. "exit" firing after "message")
+        let settled = false;
+        // Terminates the worker, clears the timer, and prevents further settles
+        const cleanup = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            // fire and forget. Do not await the promise (only in Nodejs)
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-floating-promises
+                worker.terminate();
+            }
+            catch (_) {
+                /* already dead */
+            }
+        };
+        // Normalizes any error and rejects the promise
+        const fail = (e) => {
+            cleanup();
+            reject(e instanceof Error ? e : new Error(String(e)));
+        };
+        // Processes the worker's { result, error } envelope
+        const handle = (msg) => {
+            cleanup();
+            if (msg.error !== undefined) {
+                reject(new Error(typeof msg.error === 'string' ? msg.error : JSON.stringify(msg.error)));
+            }
+            else {
+                resolve(msg.result);
+            }
+        };
+        // Rejects if the worker takes too long (e.g. infinite loop, hung fetch)
+        // Declared after fail/handle so all references are resolved before the timer can fire
+        const timer = setTimeout(() => {
+            if (!settled)
+                fail(new Error(`Worker timed out after ${String(timeoutMs)}ms`));
+        }, timeoutMs);
+        // Bind listeners and send input to the worker
+        if ('on' in worker) {
+            // Node: EventEmitter API
+            worker.on('message', (data) => {
+                handle(data);
+            });
+            worker.on('error', (e) => {
+                fail(e);
+            });
+            worker.on('exit', (exitCode) => {
+                if (!settled)
+                    fail(new Error(`Worker exited with code ${String(exitCode)}`));
+            });
+            worker.postMessage(input);
+        }
+        else {
+            // Browser: DOM event API
+            worker.onmessage = ({ data }) => {
+                handle(data);
+            };
+            worker.onerror = (e) => {
+                fail(new Error(e.message));
+            };
+            worker.postMessage(input);
+        }
+    });
+}
+/**
+ * Smoke-tests the full inline worker pipeline (Blob URL in browser, eval in Node).
+ *
+ * Sends `"hello"` as input, executes `data + " world!"` in a worker, and verifies
+ * the result is `"hello world!"`. This validates:
+ * - Worker creation (Blob URL or eval mode)
+ * - postMessage input delivery
+ * - Code execution inside the worker
+ * - Result returned via postMessage
+ *
+ * Returns `false` (instead of throwing) when inline workers are blocked:
+ *
+ * Browser:
+ * - CSP `worker-src` does not allow `blob:` — the most common failure case.
+ *   @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy/worker-src
+ * - CSP `script-src` blocks `unsafe-eval` (some engines treat Blob workers as eval).
+ *   @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy/script-src
+ * - Sandboxed iframe without `allow-scripts`.
+ *   @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/iframe#sandbox
+ *
+ * Node.js:
+ * - `--disallow-code-generation-from-strings` flag blocks `{ eval: true }` workers.
+ *   @see https://nodejs.org/api/cli.html#--disallow-code-generation-from-strings
+ * - Experimental permission model restricts worker creation.
+ *   @see https://nodejs.org/api/permissions.html
+ *
+ * When this returns `false`, fall back to URL-based workers via `createIsomorphicWorker()`.
+ */
+let _blobWorkerSupportedPromise;
+export function isBlobWorkerSupported() {
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-arguments
+    _blobWorkerSupportedPromise ??= runCodeInIsomorphicWorker(`return data + " world!";`, 'hello', 5000).then((res) => res === 'hello world!', () => false);
+    return _blobWorkerSupportedPromise;
+}
+function createBrowserLikeWorker(url) {
+    return new Worker(url, {
+        type: 'module',
+        name: 'wasm_bindgen_worker',
+    });
+}
+async function createNodeLikeWorker(url) {
+    const nodeWorkerModuleName = 'worker_threads';
+    const nodeWorkerModuleId = `node:${nodeWorkerModuleName}`;
+    const { Worker: NodeWorker } = (await import(/* @vite-ignore */ nodeWorkerModuleId));
+    // Node's Worker doesn't support data: or blob: URLs.
+    // For data: URLs, extract the code and use eval mode.
+    if (url.startsWith('data:')) {
+        const base64 = url.split(',')[1];
+        if (base64 === undefined) {
+            throw new Error('Invalid data url');
+        }
+        const nodeBufferModuleName = 'buffer';
+        const nodeBufferModuleId = `node:${nodeBufferModuleName}`;
+        const { Buffer: NodeBuffer } = (await import(/* @vite-ignore */ nodeBufferModuleId));
+        //const res = await fetch("data:application/octet-stream;base64," + data);
+        const code = NodeBuffer.from(base64, 'base64').toString('utf-8');
+        return new NodeWorker(code, { eval: true });
+    }
+    return new NodeWorker(url);
+}
+export function waitForMsgType(target, type) {
+    return new Promise((resolve) => {
+        if (isNodePort(target)) {
+            // Node: EventEmitter, data passed directly
+            target.on('message', function onMsg(data) {
+                if (data.type !== type)
+                    return;
+                target.off('message', onMsg);
+                resolve(data);
+            });
+        }
+        else {
+            // Browser: DOM events, data wrapped in MessageEvent
+            target.addEventListener('message', function onMsg({ data }) {
+                if (data.type !== type)
+                    return;
+                target.removeEventListener('message', onMsg);
+                resolve(data);
+            });
+        }
+    });
+}
+//# sourceMappingURL=isomorphicWorker.js.map

package/_esm/core/base/isomorphicWorker.js.map

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

package/_esm/core/base/object.js

@@ -0,0 +1,36 @@
+/** Wraps a single value in an array, or returns the array as-is. */
+export function toArray(value) {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    return [value];
+}
+export function simpleDeepFreeze(obj) {
+    Object.freeze(obj);
+    for (const value of Object.values(obj)) {
+        if (value !== null && typeof value === 'object' && !Array.isArray(value) && !Object.isFrozen(value)) {
+            simpleDeepFreeze(value);
+        }
+    }
+    return obj;
+}
+/**
+ * Defines a non-enumerable, non-writable, non-configurable property on the target object.
+ * The property is hidden from `Object.keys()` / `Object.entries()` and cannot be
+ * overwritten or reconfigured after creation.
+ *
+ * @param target - The object to define the property on.
+ * @param fnName - The property name.
+ * @param fn - The value to assign.
+ * @returns The target object, typed with the added property.
+ */
+export function addInternalFunction(target, fnName, fn) {
+    Object.defineProperty(target, fnName, {
+        value: fn,
+        writable: false,
+        configurable: false,
+        enumerable: false,
+    });
+    return target;
+}
+//# sourceMappingURL=object.js.map

package/_esm/core/base/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../core/base/object.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,MAAM,UAAU,OAAO,CAAI,KAAuB;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAqB,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,KAAU,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAmB,GAAM;IACvD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAS,EACT,MAAc,EACd,EAAM;IAEN,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE;QACpC,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;IACH,OAAO,MAA0C,CAAC;AACpD,CAAC"}

package/_esm/core/base/promise.js

@@ -0,0 +1,31 @@
+/**
+ * Executes promise factories with control over batching behavior.
+ * @param factories - Array of functions that create promises (not promises themselves)
+ * @param parallel - If true, executes all concurrently. If false, executes one at a time (default `false`).
+ *
+ * @example
+ * ```typescript
+ *  const rpcCalls = [
+ *    () => contract.balanceOf(address1),
+ *    () => contract.balanceOf(address2),
+ *    () => contract.totalSupply(),
+ *. ];
+ *
+ *  // Sequential: one RPC call at a time
+ *  const resultsSeq = await executeWithBatching(rpcCalls, false);
+ *
+ *  // Concurrent: all fire together (lets ethers batch them)
+ *  const resultsConcurrent = await executeWithBatching(rpcCalls, true);
+ * ```
+ */
+export async function executeWithBatching(factories, parallel) {
+    if (parallel === true) {
+        return Promise.all(factories.map((f) => f()));
+    }
+    const results = [];
+    for (const factory of factories) {
+        results.push(await factory());
+    }
+    return results;
+}
+//# sourceMappingURL=promise.js.map

package/_esm/core/base/promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.js","sourceRoot":"","sources":["../../../core/base/promise.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAI,SAAkC,EAAE,QAAkB;IACjG,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}