@sidhujag/sysweb3-keyring 2.1.13 → 2.1.14

package/esm/rpc-read-client.js

@@ -0,0 +1,389 @@
+import { isReadOnlyRpcMethod, requestJsonRpc, RpcResponseIntegrityError, } from './rpc-transport';
+class RpcBatchRefused extends Error {
+}
+class RpcPayloadTooLarge extends Error {
+}
+class RpcBatchLimit extends Error {
+}
+const aborted = (signal) => {
+    if (signal.reason instanceof Error)
+        return signal.reason;
+    return Object.assign(new Error('RPC read aborted'), { name: 'AbortError' });
+};
+const check = (signal) => {
+    if (signal.aborted)
+        throw aborted(signal);
+};
+const byteLength = (value) => new TextEncoder().encode(value).byteLength;
+const boundedInteger = (value, maximum, name) => {
+    if (!Number.isSafeInteger(value) || value < 1 || value > maximum)
+        throw new Error(`Invalid RPC ${name}`);
+    return value;
+};
+export class RpcReadError extends Error {
+    constructor(value) {
+        super(value.message);
+        this.name = 'RpcReadError';
+        this.code = value.code;
+        this.data = value.data;
+    }
+}
+const batchFailure = (value) => {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const { jsonrpc, result, error, id } = value;
+    if (jsonrpc !== '2.0' ||
+        result !== undefined ||
+        (id !== null && id !== undefined) ||
+        !error ||
+        !Number.isSafeInteger(error.code) ||
+        typeof error.message !== 'string')
+        return undefined;
+    if ((error.code === -32600 || error.code === -32005) &&
+        /batch|array/i.test(error.message)) {
+        if (/too (?:large|many)|more than|limit|maximum|max(?:imum)? size/i.test(error.message))
+            return new RpcBatchLimit();
+        if (/unsupported|not support|not allowed|invalid (?:request|batch|array)/i.test(error.message))
+            return new RpcBatchRefused();
+    }
+    return undefined;
+};
+async function responseText(response, maximum, signal) {
+    const declared = response.headers.get('content-length');
+    if (declared !== null &&
+        (!/^\d+$/.test(declared) || Number(declared) > maximum)) {
+        void response.body?.cancel().catch(() => undefined);
+        throw new RpcResponseIntegrityError('RPC response exceeded size limit', false);
+    }
+    if (!response.body?.getReader) {
+        const text = await response.text();
+        check(signal);
+        if (byteLength(text) > maximum)
+            throw new RpcResponseIntegrityError('RPC response exceeded size limit', false);
+        return text;
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder('utf-8', { fatal: true });
+    let size = 0;
+    let text = '';
+    try {
+        let complete = false;
+        while (!complete) {
+            check(signal);
+            const part = await reader.read();
+            if (part.done) {
+                complete = true;
+                continue;
+            }
+            size += part.value.byteLength;
+            if (size > maximum)
+                throw new RpcResponseIntegrityError('RPC response exceeded size limit', false);
+            text += decoder.decode(part.value, { stream: true });
+        }
+        return text + decoder.decode();
+    }
+    finally {
+        void reader.cancel().catch(() => undefined);
+    }
+}
+/** Bounded, read-only JSON-RPC transport. Each instance belongs to one endpoint generation. */
+export class JsonRpcReadClient {
+    constructor(url, options = {}) {
+        this.lifetime = new AbortController();
+        this.queue = [];
+        this.active = 0;
+        this.chainGeneration = 0;
+        this.endpoint = url;
+        const endpoint = new URL(url);
+        if (!['https:', 'http:'].includes(endpoint.protocol))
+            throw new Error('Invalid RPC URL');
+        this.fetcher =
+            options.fetch ??
+                ((address, init) => fetch(address, init));
+        this.options = {
+            requestInit: options.requestInit ?? {},
+            recoverResponse: options.recoverResponse ?? true,
+            maxBatchItems: boundedInteger(options.maxBatchItems ?? 40, 128, 'batch size'),
+            maxRequestBytes: boundedInteger(options.maxRequestBytes ?? 256 * 1024, 2 * 1024 * 1024, 'request size'),
+            maxResponseBytes: boundedInteger(options.maxResponseBytes ?? 2 * 1024 * 1024, 8 * 1024 * 1024, 'response size'),
+            maxConcurrency: boundedInteger(options.maxConcurrency ?? 4, 16, 'concurrency'),
+            timeoutMs: boundedInteger(options.timeoutMs ?? 12000, 30000, 'timeout'),
+        };
+        this.batchLimit = this.options.maxBatchItems;
+        if (options.signal?.aborted)
+            this.destroy();
+        else
+            options.signal?.addEventListener('abort', () => this.destroy(), {
+                once: true,
+            });
+    }
+    get url() {
+        return this.endpoint;
+    }
+    destroy() {
+        this.chainGeneration++;
+        this.chainCache = undefined;
+        this.chainRequest?.controller.abort();
+        this.lifetime.abort();
+    }
+    async slot(signal, work) {
+        check(signal);
+        await new Promise((resolve, reject) => {
+            const waiter = {
+                run: () => {
+                    signal.removeEventListener('abort', waiter.cancel);
+                    this.active++;
+                    resolve();
+                },
+                cancel: () => {
+                    const i = this.queue.indexOf(waiter);
+                    if (i >= 0)
+                        this.queue.splice(i, 1);
+                    reject(aborted(signal));
+                },
+            };
+            if (this.active < this.options.maxConcurrency)
+                waiter.run();
+            else {
+                this.queue.push(waiter);
+                signal.addEventListener('abort', waiter.cancel, { once: true });
+            }
+        });
+        try {
+            check(signal);
+            return await work();
+        }
+        finally {
+            this.active--;
+            this.queue.shift()?.run();
+        }
+    }
+    async readMany(inputs, options = {}) {
+        if (!Array.isArray(inputs) ||
+            inputs.length > 1024 ||
+            inputs.some((input) => !input ||
+                !isReadOnlyRpcMethod(input.method) ||
+                !Array.isArray(input.params)))
+            throw new Error('Invalid read-only RPC requests');
+        // Snapshot before any await so caller mutations cannot change dispatched reads.
+        const serialized = JSON.stringify(inputs);
+        if (byteLength(serialized) > this.options.maxRequestBytes * 16)
+            throw new Error('RPC read work exceeded request budget');
+        const snapshot = JSON.parse(serialized);
+        if (!Array.isArray(snapshot) ||
+            snapshot.length > 1024 ||
+            snapshot.some((input) => !input ||
+                !isReadOnlyRpcMethod(input.method) ||
+                !Array.isArray(input.params)))
+            throw new Error('Invalid read-only RPC requests');
+        const timeout = boundedInteger(options.timeoutMs ?? this.options.timeoutMs, 30000, 'timeout');
+        const maximum = boundedInteger(options.maxResponseBytes ?? this.options.maxResponseBytes, 8 * 1024 * 1024, 'response size');
+        const controller = new AbortController();
+        const abort = () => controller.abort(options.signal?.reason ?? this.lifetime.signal.reason);
+        const sources = [options.signal, this.lifetime.signal].filter((value) => !!value);
+        sources.forEach((source) => source.addEventListener('abort', abort, { once: true }));
+        if (sources.some((source) => source.aborted))
+            abort();
+        const timer = setTimeout(() => controller.abort(Object.assign(new Error('RPC read deadline exceeded'), {
+            name: 'AbortError',
+        })), timeout);
+        const signal = controller.signal;
+        let attempts = 0;
+        const request = (rows, batch) => requestJsonRpc(this.url, rows, batch, signal, async (url, body) => {
+            if (++attempts > 2048)
+                throw new Error('RPC attempt limit exceeded');
+            if (byteLength(body) > this.options.maxRequestBytes)
+                throw new RpcPayloadTooLarge();
+            return this.slot(signal, async () => {
+                const headers = new Headers(this.options.requestInit.headers);
+                headers.set('Content-Type', 'application/json');
+                headers.set('Accept', 'application/json');
+                const response = await this.fetcher(url, {
+                    ...this.options.requestInit,
+                    method: 'POST',
+                    headers,
+                    body,
+                    signal,
+                });
+                check(signal);
+                if (response.status === 413) {
+                    void response.body?.cancel().catch(() => undefined);
+                    throw new RpcPayloadTooLarge();
+                }
+                const contentType = response.headers.get('content-type');
+                if (contentType &&
+                    !/^(application\/json|application\/[a-z0-9!#$&^_.+-]+\+json)(?:\s*;|$)/i.test(contentType)) {
+                    void response.body?.cancel().catch(() => undefined);
+                    throw new RpcResponseIntegrityError('Invalid JSON-RPC content type', false);
+                }
+                const text = await responseText(response, maximum, signal);
+                let json;
+                try {
+                    json = JSON.parse(text);
+                }
+                catch {
+                    throw new RpcResponseIntegrityError('Invalid JSON-RPC JSON response', false);
+                }
+                const batchError = batch ? batchFailure(json) : undefined;
+                if (batchError)
+                    throw batchError;
+                if (!response.ok || response.status !== 200)
+                    throw Object.assign(new Error(`RPC HTTP ${response.status}`), {
+                        status: response.status,
+                    });
+                return json;
+            });
+        }, this.options.recoverResponse);
+        const execute = async (rows) => {
+            check(signal);
+            try {
+                const responses = await request(rows, rows.length > 1);
+                return responses.map((response) => {
+                    if (response.error)
+                        return {
+                            status: 'rejected',
+                            reason: new RpcReadError(response.error),
+                        };
+                    return { status: 'fulfilled', value: response.result };
+                });
+            }
+            catch (error) {
+                check(signal);
+                if (rows.length > 1 &&
+                    (error instanceof RpcBatchRefused ||
+                        error instanceof RpcPayloadTooLarge ||
+                        error instanceof RpcBatchLimit)) {
+                    this.batchLimit =
+                        error instanceof RpcBatchRefused
+                            ? 1
+                            : Math.min(this.batchLimit, Math.ceil(rows.length / 2));
+                    const results = [];
+                    let offset = 0;
+                    while (offset < rows.length) {
+                        const next = Math.min(rows.length, offset + this.batchLimit);
+                        const chunk = rows.slice(offset, next);
+                        offset = next;
+                        results.push(...(await execute(chunk)));
+                    }
+                    return results;
+                }
+                return rows.map(() => ({ status: 'rejected', reason: error }));
+            }
+        };
+        try {
+            check(signal);
+            const batches = [];
+            for (let i = 0; i < snapshot.length; i += this.batchLimit)
+                batches.push(snapshot.slice(i, i + this.batchLimit));
+            let next = 0;
+            const results = new Array(batches.length);
+            const workers = Array.from({ length: Math.min(batches.length, this.options.maxConcurrency) }, async () => {
+                while (next < batches.length) {
+                    const index = next++;
+                    results[index] = await execute(batches[index]);
+                }
+            });
+            const work = Promise.all(workers).then(() => results.flat());
+            return await new Promise((resolve, reject) => {
+                const cancelled = () => reject(aborted(signal));
+                signal.addEventListener('abort', cancelled, { once: true });
+                work
+                    .then(resolve, reject)
+                    .finally(() => signal.removeEventListener('abort', cancelled));
+            });
+        }
+        finally {
+            clearTimeout(timer);
+            sources.forEach((source) => source.removeEventListener('abort', abort));
+        }
+    }
+    async read(method, params, options) {
+        const [result] = await this.readMany([{ method, params }], options);
+        if (result.status === 'rejected')
+            throw result.reason;
+        return result.value;
+    }
+    getChainId(options = {}) {
+        const timeout = boundedInteger(options.timeoutMs ?? this.options.timeoutMs, 30000, 'timeout');
+        const maxResponseBytes = boundedInteger(options.maxResponseBytes ?? this.options.maxResponseBytes, 8 * 1024 * 1024, 'response size');
+        if (options.signal?.aborted)
+            return Promise.reject(aborted(options.signal));
+        if (this.lifetime.signal.aborted)
+            return Promise.reject(aborted(this.lifetime.signal));
+        if (!options.fresh &&
+            this.chainCache &&
+            this.chainCache.expires > Date.now())
+            return Promise.resolve(this.chainCache.value);
+        if (options.fresh) {
+            this.chainRequest = undefined;
+            this.chainCache = undefined;
+        }
+        let request = !options.fresh && this.chainRequest?.maxResponseBytes === maxResponseBytes
+            ? this.chainRequest
+            : undefined;
+        if (!request) {
+            const controller = new AbortController();
+            const generation = ++this.chainGeneration;
+            // Each subscriber owns its deadline. A short first subscriber must not
+            // impose that deadline on later subscribers sharing the wire response.
+            const promise = this.read('eth_chainId', [], {
+                signal: controller.signal,
+                timeoutMs: 30000,
+                maxResponseBytes,
+            }).then((value) => {
+                if (typeof value !== 'string' ||
+                    !/^0x(?:0|[1-9a-f][0-9a-f]*)$/i.test(value))
+                    throw new RpcResponseIntegrityError('Invalid chain ID', false);
+                if (generation === this.chainGeneration && !controller.signal.aborted)
+                    this.chainCache = { value, expires: Date.now() + 30000 };
+                return value;
+            });
+            request = {
+                promise,
+                controller,
+                maxResponseBytes,
+                subscribers: 0,
+                settled: false,
+            };
+            const captured = request;
+            void promise
+                .finally(() => {
+                captured.settled = true;
+                if (this.chainRequest === captured)
+                    this.chainRequest = undefined;
+            })
+                .catch(() => undefined);
+            if (!options.fresh)
+                this.chainRequest = request;
+        }
+        const subscribed = request;
+        subscribed.subscribers++;
+        return new Promise((resolve, reject) => {
+            let finished = false;
+            const finish = (error, value) => {
+                if (finished)
+                    return;
+                finished = true;
+                clearTimeout(timer);
+                options.signal?.removeEventListener('abort', cancel);
+                subscribed.subscribers--;
+                if (!subscribed.subscribers && !subscribed.settled) {
+                    if (this.chainRequest === subscribed)
+                        this.chainRequest = undefined;
+                    subscribed.controller.abort();
+                }
+                if (error !== undefined)
+                    reject(error);
+                else
+                    resolve(value);
+            };
+            const cancel = () => finish(aborted(options.signal));
+            options.signal?.addEventListener('abort', cancel, { once: true });
+            const timer = setTimeout(() => finish(Object.assign(new Error('RPC read deadline exceeded'), {
+                name: 'AbortError',
+            })), timeout);
+            subscribed.promise.then((value) => finish(undefined, value), (error) => finish(error));
+        });
+    }
+}
+//# sourceMappingURL=rpc-read-client.js.map

package/esm/rpc-read-client.js.map

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

package/esm/rpc-transport.js

@@ -0,0 +1,130 @@
+// A stale response must never be interpreted as the result of another RPC.
+// Keep the sentinel in the message for callers that serialize errors as text.
+export class RpcResponseIntegrityError extends Error {
+    constructor(message = 'JSON-RPC response does not match its request', retryable = true) {
+        super(`[SYSWEB3_RPC_RESPONSE_INVALID] ${message}`);
+        this.retryable = retryable;
+        this.code = 'SYSWEB3_RPC_RESPONSE_INVALID';
+        this.name = 'RpcResponseIntegrityError';
+    }
+}
+// Only these standard, side-effect-free reads may recover from a stale cache
+// entry. Never infer retry eligibility from an RPC method prefix.
+const RECOVERABLE_READ_METHODS = new Set([
+    'eth_chainId',
+    'net_version',
+    'web3_clientVersion',
+    'eth_blockNumber',
+    'eth_syncing',
+    'eth_getBalance',
+    'eth_getTransactionCount',
+    'eth_getCode',
+    'eth_getStorageAt',
+    'eth_getProof',
+    'eth_call',
+    'eth_estimateGas',
+    'eth_createAccessList',
+    'eth_gasPrice',
+    'eth_maxPriorityFeePerGas',
+    'eth_feeHistory',
+    'eth_getBlockByNumber',
+    'eth_getBlockByHash',
+    'eth_getBlockTransactionCountByNumber',
+    'eth_getBlockTransactionCountByHash',
+    'eth_getTransactionByHash',
+    'eth_getTransactionByBlockNumberAndIndex',
+    'eth_getTransactionByBlockHashAndIndex',
+    'eth_getTransactionReceipt',
+    'eth_getLogs',
+]);
+export const isReadOnlyRpcMethod = (method) => RECOVERABLE_READ_METHODS.has(method);
+let rpcRecoveryNonce = 0;
+// Shared across provider instances and seeded anew on process restart. These
+// numeric correlation IDs are not authorization tokens.
+let nextRpcWireId = Math.floor(Math.random() * 2 ** 51);
+const reserveRpcWireId = () => {
+    const id = ++nextRpcWireId;
+    if (!Number.isSafeInteger(id)) {
+        throw new RpcResponseIntegrityError('RPC request ID range exhausted', false);
+    }
+    return id;
+};
+const recoveryUrl = (original) => {
+    const url = new URL(original);
+    const token = `${Date.now()}-${++rpcRecoveryNonce}-${Math.random()
+        .toString(36)
+        .slice(2)}`;
+    // Append without reserializing existing query values (including auth data).
+    url.search += `${url.search ? '&' : '?'}sysweb3_rpc_request=${token}`;
+    return url.toString();
+};
+function validateRpcResponses(json, requests, batch) {
+    if (batch ? !Array.isArray(json) : Array.isArray(json)) {
+        throw new RpcResponseIntegrityError();
+    }
+    const responses = batch ? json : [json];
+    if (responses.length !== requests.length) {
+        throw new RpcResponseIntegrityError();
+    }
+    const expectedIds = new Set(requests.map((request) => request.id));
+    const byId = new Map();
+    for (const response of responses) {
+        if (!response ||
+            typeof response !== 'object' ||
+            Array.isArray(response) ||
+            typeof response.id !== 'number' ||
+            !expectedIds.has(response.id) ||
+            byId.has(response.id)) {
+            throw new RpcResponseIntegrityError();
+        }
+        const hasResult = Object.prototype.hasOwnProperty.call(response, 'result');
+        const hasError = Object.prototype.hasOwnProperty.call(response, 'error');
+        if (response.jsonrpc !== '2.0' ||
+            hasResult === hasError ||
+            (hasError &&
+                (!response.error ||
+                    typeof response.error.message !== 'string' ||
+                    !Number.isSafeInteger(response.error.code)))) {
+            throw new RpcResponseIntegrityError('Invalid JSON-RPC response envelope', false);
+        }
+        byId.set(response.id, response);
+    }
+    return requests.map((request) => byId.get(request.id));
+}
+/** Correlate exact wire responses and recover one stale read response. */
+export async function requestJsonRpc(url, inputs, batch, signal, transport, recoverResponse = true) {
+    const canRecover = recoverResponse &&
+        inputs.every(({ method }) => RECOVERABLE_READ_METHODS.has(method));
+    const serialized = JSON.stringify(inputs);
+    for (let attempt = 0; attempt < 2; attempt++) {
+        if (signal.aborted)
+            throw signal.reason || new Error('RPC request aborted');
+        const source = JSON.parse(serialized);
+        const requests = source.map(({ method, params }) => ({
+            jsonrpc: '2.0',
+            method,
+            params,
+            id: reserveRpcWireId(),
+        }));
+        const json = await transport(attempt === 0 ? url : recoveryUrl(url), JSON.stringify(batch ? requests : requests[0]), signal).catch((error) => {
+            if (attempt === 0 ||
+                error instanceof RpcResponseIntegrityError ||
+                signal.aborted ||
+                error?.name === 'AbortError')
+                throw error;
+            throw new RpcResponseIntegrityError('JSON-RPC response recovery failed', false);
+        });
+        try {
+            return validateRpcResponses(json, requests, batch);
+        }
+        catch (error) {
+            if (!(error instanceof RpcResponseIntegrityError) ||
+                !error.retryable ||
+                attempt !== 0 ||
+                !canRecover)
+                throw error;
+        }
+    }
+    throw new RpcResponseIntegrityError();
+}
+//# sourceMappingURL=rpc-transport.js.map

package/esm/rpc-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-transport.js","sourceRoot":"","sources":["../../src/rpc-transport.ts"],"names":[],"mappings":"AA0BA,2EAA2E;AAC3E,8EAA8E;AAC9E,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAGlD,YACE,OAAO,GAAG,8CAA8C,EAC/C,YAAY,IAAI;QAEzB,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;QAF1C,cAAS,GAAT,SAAS,CAAO;QAJlB,SAAI,GAAG,8BAA8B,CAAC;QAO7C,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,6EAA6E;AAC7E,kEAAkE;AAClE,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACvC,aAAa;IACb,aAAa;IACb,oBAAoB;IACpB,iBAAiB;IACjB,aAAa;IACb,gBAAgB;IAChB,yBAAyB;IACzB,aAAa;IACb,kBAAkB;IAClB,cAAc;IACd,UAAU;IACV,iBAAiB;IACjB,sBAAsB;IACtB,cAAc;IACd,0BAA0B;IAC1B,gBAAgB;IAChB,sBAAsB;IACtB,oBAAoB;IACpB,sCAAsC;IACtC,oCAAoC;IACpC,0BAA0B;IAC1B,yCAAyC;IACzC,uCAAuC;IACvC,2BAA2B;IAC3B,aAAa;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAc,EAAW,EAAE,CAC7D,wBAAwB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAEvC,IAAI,gBAAgB,GAAG,CAAC,CAAC;AACzB,6EAA6E;AAC7E,wDAAwD;AACxD,IAAI,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AACxD,MAAM,gBAAgB,GAAG,GAAW,EAAE;IACpC,MAAM,EAAE,GAAG,EAAE,aAAa,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,yBAAyB,CACjC,gCAAgC,EAChC,KAAK,CACN,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAU,EAAE;IAC/C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,gBAAgB,IAAI,IAAI,CAAC,MAAM,EAAE;SAC/D,QAAQ,CAAC,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACd,4EAA4E;IAC5E,GAAG,CAAC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,uBAAuB,KAAK,EAAE,CAAC;IACtE,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC,CAAC;AAEF,SAAS,oBAAoB,CAC3B,IAAS,EACT,QAA0B,EAC1B,KAAc;IAEd,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,yBAAyB,EAAE,CAAC;IACxC,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACzC,MAAM,IAAI,yBAAyB,EAAE,CAAC;IACxC,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAe,CAAC;IACpC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IACE,CAAC,QAAQ;YACT,OAAO,QAAQ,KAAK,QAAQ;YAC5B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YACvB,OAAO,QAAQ,CAAC,EAAE,KAAK,QAAQ;YAC/B,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EACrB,CAAC;YACD,MAAM,IAAI,yBAAyB,EAAE,CAAC;QACxC,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzE,IACE,QAAQ,CAAC,OAAO,KAAK,KAAK;YAC1B,SAAS,KAAK,QAAQ;YACtB,CAAC,QAAQ;gBACP,CAAC,CAAC,QAAQ,CAAC,KAAK;oBACd,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ;oBAC1C,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAChD,CAAC;YACD,MAAM,IAAI,yBAAyB,CACjC,oCAAoC,EACpC,KAAK,CACN,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,MAAsC,EACtC,KAAc,EACd,MAAmB,EACnB,SAA2B,EAC3B,eAAe,GAAG,IAAI;IAEtB,MAAM,UAAU,GACd,eAAe;QACf,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,wBAAwB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1C,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7C,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAA0B,CAAC;QAC/D,MAAM,QAAQ,GAAqB,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YACrE,OAAO,EAAE,KAAK;YACd,MAAM;YACN,MAAM;YACN,EAAE,EAAE,gBAAgB,EAAE;SACvB,CAAC,CAAC,CAAC;QACJ,MAAM,IAAI,GAAG,MAAM,SAAS,CAC1B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,EACtC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAC9C,MAAM,CACP,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAChB,IACE,OAAO,KAAK,CAAC;gBACb,KAAK,YAAY,yBAAyB;gBAC1C,MAAM,CAAC,OAAO;gBACd,KAAK,EAAE,IAAI,KAAK,YAAY;gBAE5B,MAAM,KAAK,CAAC;YACd,MAAM,IAAI,yBAAyB,CACjC,mCAAmC,EACnC,KAAK,CACN,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,OAAO,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IACE,CAAC,CAAC,KAAK,YAAY,yBAAyB,CAAC;gBAC7C,CAAC,KAAK,CAAC,SAAS;gBAChB,OAAO,KAAK,CAAC;gBACb,CAAC,UAAU;gBAEX,MAAM,KAAK,CAAC;QAChB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,yBAAyB,EAAE,CAAC;AACxC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sidhujag/sysweb3-keyring",
-  "version": "2.1.13",
+  "version": "2.1.14",
   "description": "Keyring Manager for UTXO and Web3 Wallets",
   "main": "cjs/index.js",
   "types": "types/index.d.ts",
@@ -149,6 +149,12 @@
       ],
       "cjs/utils/utxo-fee-rate.js": [
         "types/utils/utxo-fee-rate.d.ts"
+      ],
+      "cjs/rpc-read-client": [
+        "types/rpc-read-client.d.ts"
+      ],
+      "cjs/rpc-read-client.js": [
+        "types/rpc-read-client.d.ts"
       ]
     }
   },

package/types/index.d.ts

@@ -9,6 +9,8 @@ export type { KeyringHost, KeyringOptions } from './keyring-host';
 export { MAX_PRIVATE_RECORD_BYTES, MAX_PRIVATE_RECORD_LABEL_BYTES, } from './private-records';
 export type { IPrivateRecordAccess, PrivateRecordAccessOptions, IDecryptPrivateRecordParams, IEncryptedPrivateRecord, IEncryptPrivateRecordParams, } from './private-records';
 export * from './providers';
+export { JsonRpcReadClient, RpcReadError } from './rpc-read-client';
+export type { RpcReadRequest, RpcReadOptions, RpcReadClientOptions, } from './rpc-read-client';
 export * from './utils/derivation-paths';
 export * from './network-utils';
 export * from './hardware-wallet-manager';

package/types/keyring-core.d.ts

@@ -150,7 +150,7 @@ export declare class KeyringCore<TLedger extends KeyringLedgerSigner | undefined
     private isDescriptor;
     private isXpubLike;
     private isWatchOnlyAccount;
-    getEncryptedXprv: (hd: SyscoinHDSigner) => string;
+    getEncryptedXprv: (hd: SyscoinHDSigner) => any;
     getSeed: (pwd: string) => Promise<any>;
     deriveSLHDSASetupSecretForAccount: ({ accountIndex, }: {
         accountIndex: number;

package/types/providers.d.ts

@@ -1,10 +1,7 @@
 import { BigNumber, JsonRpcProvider, type Networkish } from './ethers-v6';
+import { type RpcReadOptions, type RpcReadRequest } from './rpc-read-client';
 import type { JsonRpcPayload } from 'ethers/providers';
-export declare class RpcResponseIntegrityError extends Error {
-    readonly retryable: boolean;
-    readonly code = "SYSWEB3_RPC_RESPONSE_INVALID";
-    constructor(message?: string, retryable?: boolean);
-}
+export { RpcResponseIntegrityError } from './rpc-transport';
 export declare const wrapTransactionReceipt: (receipt: any) => any;
 export declare const wrapTransactionResponse: (transaction: any) => any;
 declare class BaseProvider extends JsonRpcProvider {
@@ -18,6 +15,9 @@ declare class BaseProvider extends JsonRpcProvider {
     private feeDataPromise;
     private readonly configuredChainId?;
     private chainIdVerificationPromise;
+    private readonly readClient;
+    private chainIdReadPromise;
+    private chainIdGeneration;
     isInCooldown: boolean;
     errorMessage: any;
     serverHasAnError: boolean;
@@ -41,12 +41,14 @@ declare class BaseProvider extends JsonRpcProvider {
     private canMakeRequest;
     verifyConfiguredChainId(fresh?: boolean): Promise<void>;
     private fetchAndVerifyConfiguredChainId;
+    private readChainId;
     private cooldown;
-    private validateRpcResponses;
     private requestRpc;
+    readMany(inputs: readonly RpcReadRequest[], options?: RpcReadOptions): Promise<PromiseSettledResult<unknown>[]>;
     _send(payload: JsonRpcPayload | Array<JsonRpcPayload>): Promise<any[]>;
     send: (method: string, params: any[]) => Promise<any>;
     sendBatch(method: string, params: Array<any[]>): Promise<any[]>;
+    destroy(): void;
     getGasPrice(): Promise<BigNumber>;
     getFeeData(): Promise<any>;
     private readFeeData;
@@ -64,4 +66,3 @@ export declare class CustomJsonRpcProvider extends BaseProvider {
         url: string;
     }, network?: Networkish);
 }
-export {};