web3util 4.3.2

package/lib/commonjs/uint8array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uint8array.js","sourceRoot":"","sources":["../../src/uint8array.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;EAeE;;;AAEF,SAAgB,YAAY,CAAC,IAA0B;;IACtD,OAAO,CACN,IAAI,YAAY,UAAU;QAC1B,CAAA,MAAC,IAA0C,aAA1C,IAAI,uBAAJ,IAAI,CAAwC,WAAW,0CAAE,IAAI,MAAK,YAAY;QAC/E,CAAA,MAAC,IAA0C,aAA1C,IAAI,uBAAJ,IAAI,CAAwC,WAAW,0CAAE,IAAI,MAAK,QAAQ,CAC3E,CAAC;AACH,CAAC;AAND,oCAMC;AAED,SAAgB,gBAAgB,CAAC,GAAG,KAAmB;IACtD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/B,OAAO,GAAG,CAAC;IACZ,CAAC,EAAE,CAAC,CAAC,CAAC;IACN,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;QACzB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzB,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;KACtB;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAZD,4CAYC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,CAAa,EAAE,CAAa;IAC5D,IAAI,CAAC,KAAK,CAAC,EAAE;QACZ,OAAO,IAAI,CAAC;KACZ;IAED,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAAE;QAClC,OAAO,KAAK,CAAC;KACb;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE;QACzC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;YAClB,OAAO,KAAK,CAAC;SACb;KACD;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAhBD,4CAgBC"}

package/lib/commonjs/uuid.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generate a version 4 (random) uuid
+ * https://github.com/uuidjs/uuid/blob/main/src/v4.js#L5
+ * @returns - A version 4 uuid of the form xxxxxxxx-xxxx-4xxx-xxxx-xxxxxxxxxxxx
+ * @example
+ * ```ts
+ * console.log(web3.utils.uuidV4());
+ * > "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed"
+ * ```
+ */
+export declare const uuidV4: () => string;

package/lib/commonjs/uuid.js

@@ -0,0 +1,57 @@
+"use strict";
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js.  If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uuidV4 = void 0;
+/**
+ * @module Utils
+ */
+const converters_js_1 = require("./converters.js");
+const random_js_1 = require("./random.js");
+/**
+ * Generate a version 4 (random) uuid
+ * https://github.com/uuidjs/uuid/blob/main/src/v4.js#L5
+ * @returns - A version 4 uuid of the form xxxxxxxx-xxxx-4xxx-xxxx-xxxxxxxxxxxx
+ * @example
+ * ```ts
+ * console.log(web3.utils.uuidV4());
+ * > "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed"
+ * ```
+ */
+const uuidV4 = () => {
+    const bytes = (0, random_js_1.randomBytes)(16);
+    // https://github.com/ethers-io/ethers.js/blob/ce8f1e4015c0f27bf178238770b1325136e3351a/packages/json-wallets/src.ts/utils.ts#L54
+    // Section: 4.1.3:
+    // - time_hi_and_version[12:16] = 0b0100
+    /* eslint-disable-next-line */
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    // Section 4.4
+    // - clock_seq_hi_and_reserved[6] = 0b0
+    // - clock_seq_hi_and_reserved[7] = 0b1
+    /* eslint-disable-next-line */
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hexString = (0, converters_js_1.bytesToHex)(bytes);
+    return [
+        hexString.substring(2, 10),
+        hexString.substring(10, 14),
+        hexString.substring(14, 18),
+        hexString.substring(18, 22),
+        hexString.substring(22, 34),
+    ].join('-');
+};
+exports.uuidV4 = uuidV4;
+//# sourceMappingURL=uuid.js.map

package/lib/commonjs/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../src/uuid.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;EAeE;;;AAEF;;GAEG;AAEH,mDAA6C;AAC7C,2CAA0C;AAE1C;;;;;;;;;GASG;AACI,MAAM,MAAM,GAAG,GAAW,EAAE;IAClC,MAAM,KAAK,GAAG,IAAA,uBAAW,EAAC,EAAE,CAAC,CAAC;IAE9B,iIAAiI;IACjI,kBAAkB;IAClB,wCAAwC;IACxC,8BAA8B;IAC9B,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAEpC,cAAc;IACd,uCAAuC;IACvC,uCAAuC;IACvC,8BAA8B;IAC9B,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAEpC,MAAM,SAAS,GAAG,IAAA,0BAAU,EAAC,KAAK,CAAC,CAAC;IAEpC,OAAO;QACN,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1B,SAAS,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC;KAC3B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACb,CAAC,CAAC;AAxBW,QAAA,MAAM,UAwBjB"}

package/lib/commonjs/validation.d.ts

@@ -0,0 +1,82 @@
+import { BlockNumberOrTag, ContractInitOptions } from 'web3-types';
+/**
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+export declare const isHexStrict: (hex: import("web3-validator").ValidInputTypes) => boolean;
+/**
+ * returns true if input is a hexstring, number or bigint
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+export declare const isHex: (hex: import("web3-validator").ValidInputTypes) => boolean;
+/**
+ * Checks the checksum of a given address. Will also return false on non-checksum addresses.
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+export declare const checkAddressCheckSum: (data: string) => boolean;
+/**
+ * Checks if a given string is a valid Ethereum address. It will also check the checksum, if the address has upper and lowercase letters.
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+export declare const isAddress: (value: import("web3-validator").ValidInputTypes, checkChecksum?: boolean | undefined) => boolean;
+/**
+ * Returns true if the bloom is a valid bloom
+ * https://github.com/joshstevens19/ethereum-bloom-filters/blob/fbeb47b70b46243c3963fe1c2988d7461ef17236/src/index.ts#L7
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+export declare const isBloom: (bloom: import("web3-validator").ValidInputTypes) => boolean;
+/**
+ * Returns true if the value is part of the given bloom
+ * note: false positives are possible.
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+export declare const isInBloom: (bloom: string, value: string | Uint8Array) => boolean;
+/**
+ * Returns true if the ethereum users address is part of the given bloom note: false positives are possible.
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+export declare const isUserEthereumAddressInBloom: (bloom: string, ethereumAddress: string) => boolean;
+/**
+ * Returns true if the contract address is part of the given bloom.
+ * note: false positives are possible.
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+export declare const isContractAddressInBloom: (bloom: string, contractAddress: string) => boolean;
+/**
+ * Checks if its a valid topic
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+export declare const isTopic: (topic: string) => boolean;
+/**
+ * Returns true if the topic is part of the given bloom.
+ * note: false positives are possible.
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+export declare const isTopicInBloom: (bloom: string, topic: string) => boolean;
+/**
+ * Compares between block A and block B
+ * @param blockA - Block number or string
+ * @param blockB - Block number or string
+ *
+ * @returns - Returns -1 if a \< b, returns 1 if a \> b and returns 0 if a == b
+ *
+ * @example
+ * ```ts
+ * console.log(web3.utils.compareBlockNumbers('latest', 'pending'));
+ * > -1
+ *
+ * console.log(web3.utils.compareBlockNumbers(12, 11));
+ * > 1
+ * ```
+ */
+export declare const compareBlockNumbers: (blockA: BlockNumberOrTag, blockB: BlockNumberOrTag) => 0 | 1 | -1;
+export declare const isContractInitOptions: (options: unknown) => options is ContractInitOptions;
+export declare const isNullish: (item: unknown) => item is null | undefined;

package/lib/commonjs/validation.js

@@ -0,0 +1,163 @@
+"use strict";
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js.  If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNullish = exports.isContractInitOptions = exports.compareBlockNumbers = exports.isTopicInBloom = exports.isTopic = exports.isContractAddressInBloom = exports.isUserEthereumAddressInBloom = exports.isInBloom = exports.isBloom = exports.isAddress = exports.checkAddressCheckSum = exports.isHex = exports.isHexStrict = void 0;
+/**
+ * @module Utils
+ */
+const web3_errors_1 = require("web3-errors");
+const web3_validator_1 = require("web3-validator");
+const web3_types_1 = require("web3-types");
+/**
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+exports.isHexStrict = web3_validator_1.isHexStrict;
+/**
+ * returns true if input is a hexstring, number or bigint
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+exports.isHex = web3_validator_1.isHex;
+/**
+ * Checks the checksum of a given address. Will also return false on non-checksum addresses.
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+exports.checkAddressCheckSum = web3_validator_1.checkAddressCheckSum;
+/**
+ * Checks if a given string is a valid Ethereum address. It will also check the checksum, if the address has upper and lowercase letters.
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+exports.isAddress = web3_validator_1.isAddress;
+/**
+ * Returns true if the bloom is a valid bloom
+ * https://github.com/joshstevens19/ethereum-bloom-filters/blob/fbeb47b70b46243c3963fe1c2988d7461ef17236/src/index.ts#L7
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+exports.isBloom = web3_validator_1.isBloom;
+/**
+ * Returns true if the value is part of the given bloom
+ * note: false positives are possible.
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+exports.isInBloom = web3_validator_1.isInBloom;
+/**
+ * Returns true if the ethereum users address is part of the given bloom note: false positives are possible.
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+exports.isUserEthereumAddressInBloom = web3_validator_1.isUserEthereumAddressInBloom;
+/**
+ * Returns true if the contract address is part of the given bloom.
+ * note: false positives are possible.
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+exports.isContractAddressInBloom = web3_validator_1.isContractAddressInBloom;
+/**
+ * Checks if its a valid topic
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+exports.isTopic = web3_validator_1.isTopic;
+/**
+ * Returns true if the topic is part of the given bloom.
+ * note: false positives are possible.
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+exports.isTopicInBloom = web3_validator_1.isTopicInBloom;
+/**
+ * Compares between block A and block B
+ * @param blockA - Block number or string
+ * @param blockB - Block number or string
+ *
+ * @returns - Returns -1 if a \< b, returns 1 if a \> b and returns 0 if a == b
+ *
+ * @example
+ * ```ts
+ * console.log(web3.utils.compareBlockNumbers('latest', 'pending'));
+ * > -1
+ *
+ * console.log(web3.utils.compareBlockNumbers(12, 11));
+ * > 1
+ * ```
+ */
+const compareBlockNumbers = (blockA, blockB) => {
+    const isABlockTag = typeof blockA === 'string' && (0, web3_validator_1.isBlockTag)(blockA);
+    const isBBlockTag = typeof blockB === 'string' && (0, web3_validator_1.isBlockTag)(blockB);
+    if (blockA === blockB ||
+        ((blockA === 'earliest' || blockA === 0) && (blockB === 'earliest' || blockB === 0)) // only exception compare blocktag with number
+    ) {
+        return 0;
+    }
+    if (blockA === 'earliest' && blockB > 0) {
+        return -1;
+    }
+    if (blockB === 'earliest' && blockA > 0) {
+        return 1;
+    }
+    if (isABlockTag && isBBlockTag) {
+        // Increasing order:  earliest, finalized , safe, latest, pending
+        const tagsOrder = {
+            [web3_types_1.BlockTags.EARLIEST]: 1,
+            [web3_types_1.BlockTags.FINALIZED]: 2,
+            [web3_types_1.BlockTags.SAFE]: 3,
+            [web3_types_1.BlockTags.LATEST]: 4,
+            [web3_types_1.BlockTags.PENDING]: 5,
+        };
+        if (tagsOrder[blockA] < tagsOrder[blockB]) {
+            return -1;
+        }
+        return 1;
+    }
+    if ((isABlockTag && !isBBlockTag) || (!isABlockTag && isBBlockTag)) {
+        throw new web3_errors_1.InvalidBlockError('Cannot compare blocktag with provided non-blocktag input.');
+    }
+    const bigIntA = BigInt(blockA);
+    const bigIntB = BigInt(blockB);
+    if (bigIntA < bigIntB) {
+        return -1;
+    }
+    if (bigIntA === bigIntB) {
+        return 0;
+    }
+    return 1;
+};
+exports.compareBlockNumbers = compareBlockNumbers;
+const isContractInitOptions = (options) => typeof options === 'object' &&
+    !(0, web3_validator_1.isNullish)(options) &&
+    Object.keys(options).length !== 0 &&
+    [
+        'input',
+        'data',
+        'from',
+        'gas',
+        'gasPrice',
+        'gasLimit',
+        'address',
+        'jsonInterface',
+        'syncWithContext',
+        'dataInputFill',
+    ].some(key => key in options);
+exports.isContractInitOptions = isContractInitOptions;
+exports.isNullish = web3_validator_1.isNullish;
+//# sourceMappingURL=validation.js.map

package/lib/commonjs/validation.js.map

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

package/lib/commonjs/web3_deferred_promise.d.ts

@@ -0,0 +1,67 @@
+import { Web3DeferredPromiseInterface } from 'web3-types';
+/**
+ * The class is a simple implementation of a deferred promise with optional timeout functionality,
+ * which can be useful when dealing with asynchronous tasks.
+ *
+ */
+export declare class Web3DeferredPromise<T> implements Promise<T>, Web3DeferredPromiseInterface<T> {
+    [Symbol.toStringTag]: 'Promise';
+    private readonly _promise;
+    private _resolve;
+    private _reject;
+    private _state;
+    private _timeoutId?;
+    private readonly _timeoutInterval?;
+    private readonly _timeoutMessage;
+    /**
+     *
+     * @param timeout - (optional) The timeout in milliseconds.
+     * @param eagerStart - (optional) If true, the timer starts as soon as the promise is created.
+     * @param timeoutMessage - (optional) The message to include in the timeout erro that is thrown when the promise times out.
+     */
+    constructor({ timeout, eagerStart, timeoutMessage, }?: {
+        timeout: number;
+        eagerStart: boolean;
+        timeoutMessage: string;
+    });
+    /**
+     * Returns the current state of the promise.
+     * @returns 'pending' | 'fulfilled' | 'rejected'
+     */
+    get state(): 'pending' | 'fulfilled' | 'rejected';
+    /**
+     *
+     * @param onfulfilled - (optional) The callback to execute when the promise is fulfilled.
+     * @param onrejected  - (optional) The callback to execute when the promise is rejected.
+     * @returns
+     */
+    then<TResult1, TResult2>(onfulfilled?: (value: T) => TResult1 | PromiseLike<TResult1>, onrejected?: (reason: unknown) => TResult2 | PromiseLike<TResult2>): Promise<TResult1 | TResult2>;
+    /**
+     *
+     * @param onrejected - (optional) The callback to execute when the promise is rejected.
+     * @returns
+     */
+    catch<TResult>(onrejected?: (reason: any) => TResult | PromiseLike<TResult>): Promise<T | TResult>;
+    /**
+     *
+     * @param onfinally - (optional) The callback to execute when the promise is settled (fulfilled or rejected).
+     * @returns
+     */
+    finally(onfinally?: (() => void) | undefined): Promise<T>;
+    /**
+     * Resolves the current promise.
+     * @param value - The value to resolve the promise with.
+     */
+    resolve(value: T | PromiseLike<T>): void;
+    /**
+     * Rejects the current promise.
+     * @param reason - The reason to reject the promise with.
+     */
+    reject(reason?: unknown): void;
+    /**
+     * Starts the timeout timer for the promise.
+     */
+    startTimer(): void;
+    private _checkTimeout;
+    private _clearTimeout;
+}

package/lib/commonjs/web3_deferred_promise.js

@@ -0,0 +1,141 @@
+"use strict";
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js.  If not, see <http://www.gnu.org/licenses/>.
+*/
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Web3DeferredPromise = void 0;
+const web3_errors_1 = require("web3-errors");
+/**
+ * The class is a simple implementation of a deferred promise with optional timeout functionality,
+ * which can be useful when dealing with asynchronous tasks.
+ *
+ */
+class Web3DeferredPromise {
+    /**
+     *
+     * @param timeout - (optional) The timeout in milliseconds.
+     * @param eagerStart - (optional) If true, the timer starts as soon as the promise is created.
+     * @param timeoutMessage - (optional) The message to include in the timeout erro that is thrown when the promise times out.
+     */
+    constructor({ timeout, eagerStart, timeoutMessage, } = {
+        timeout: 0,
+        eagerStart: false,
+        timeoutMessage: 'DeferredPromise timed out',
+    }) {
+        // public tag to treat object as promise by different libs
+        // eslint-disable-next-line @typescript-eslint/prefer-as-const
+        this[_a] = 'Promise';
+        this._state = 'pending';
+        this._promise = new Promise((resolve, reject) => {
+            this._resolve = resolve;
+            this._reject = reject;
+        });
+        this._timeoutMessage = timeoutMessage;
+        this._timeoutInterval = timeout;
+        if (eagerStart) {
+            this.startTimer();
+        }
+    }
+    /**
+     * Returns the current state of the promise.
+     * @returns 'pending' | 'fulfilled' | 'rejected'
+     */
+    get state() {
+        return this._state;
+    }
+    /**
+     *
+     * @param onfulfilled - (optional) The callback to execute when the promise is fulfilled.
+     * @param onrejected  - (optional) The callback to execute when the promise is rejected.
+     * @returns
+     */
+    then(onfulfilled, onrejected) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._promise.then(onfulfilled, onrejected);
+        });
+    }
+    /**
+     *
+     * @param onrejected - (optional) The callback to execute when the promise is rejected.
+     * @returns
+     */
+    catch(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    onrejected) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._promise.catch(onrejected);
+        });
+    }
+    /**
+     *
+     * @param onfinally - (optional) The callback to execute when the promise is settled (fulfilled or rejected).
+     * @returns
+     */
+    finally(onfinally) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._promise.finally(onfinally);
+        });
+    }
+    /**
+     * Resolves the current promise.
+     * @param value - The value to resolve the promise with.
+     */
+    resolve(value) {
+        this._resolve(value);
+        this._state = 'fulfilled';
+        this._clearTimeout();
+    }
+    /**
+     * Rejects the current promise.
+     * @param reason - The reason to reject the promise with.
+     */
+    reject(reason) {
+        this._reject(reason);
+        this._state = 'rejected';
+        this._clearTimeout();
+    }
+    /**
+     * Starts the timeout timer for the promise.
+     */
+    startTimer() {
+        if (this._timeoutInterval && this._timeoutInterval > 0) {
+            this._timeoutId = setTimeout(this._checkTimeout.bind(this), this._timeoutInterval);
+        }
+    }
+    _checkTimeout() {
+        if (this._state === 'pending' && this._timeoutId) {
+            this.reject(new web3_errors_1.OperationTimeoutError(this._timeoutMessage));
+        }
+    }
+    _clearTimeout() {
+        if (this._timeoutId) {
+            clearTimeout(this._timeoutId);
+        }
+    }
+}
+exports.Web3DeferredPromise = Web3DeferredPromise;
+_a = Symbol.toStringTag;
+//# sourceMappingURL=web3_deferred_promise.js.map

package/lib/commonjs/web3_deferred_promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web3_deferred_promise.js","sourceRoot":"","sources":["../../src/web3_deferred_promise.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;EAeE;;;;;;;;;;;;;AAEF,6CAAoD;AAIpD;;;;GAIG;AACH,MAAa,mBAAmB;IAa/B;;;;;OAKG;IACH,YACC,EACC,OAAO,EACP,UAAU,EACV,cAAc,MACuD;QACrE,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,2BAA2B;KAC3C;QA3BF,0DAA0D;QAC1D,8DAA8D;QACvD,QAAoB,GAAc,SAAS,CAAC;QAK3C,WAAM,GAAyC,SAAS,CAAC;QAsBhE,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAClD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QACtC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;QAEhC,IAAI,UAAU,EAAE;YACf,IAAI,CAAC,UAAU,EAAE,CAAC;SAClB;IACF,CAAC;IACD;;;OAGG;IACH,IAAW,KAAK;QACf,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IACD;;;;;OAKG;IACU,IAAI,CAChB,WAA4D,EAC5D,UAAkE;;YAElE,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACpD,CAAC;KAAA;IACD;;;;OAIG;IACU,KAAK;IACjB,8DAA8D;IAC9D,UAA4D;;YAE5D,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;KAAA;IAED;;;;OAIG;IACU,OAAO,CAAC,SAAoC;;YACxD,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;KAAA;IAED;;;OAGG;IACI,OAAO,CAAC,KAAyB;QACvC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;QAC1B,IAAI,CAAC,aAAa,EAAE,CAAC;IACtB,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,MAAgB;QAC7B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;QACzB,IAAI,CAAC,aAAa,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACI,UAAU;QAChB,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,gBAAgB,GAAG,CAAC,EAAE;YACvD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;SACnF;IACF,CAAC;IAEO,aAAa;QACpB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE;YACjD,IAAI,CAAC,MAAM,CAAC,IAAI,mCAAqB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;SAC7D;IACF,CAAC;IAEO,aAAa;QACpB,IAAI,IAAI,CAAC,UAAU,EAAE;YACpB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;SAC9B;IACF,CAAC;CACD;AA1HD,kDA0HC;KAvHQ,MAAM,CAAC,WAAW"}

package/lib/commonjs/web3_eip1193_provider.d.ts

@@ -0,0 +1,15 @@
+import { EthExecutionAPI, Web3APISpec, Web3BaseProvider } from 'web3-types';
+import { EventEmitter } from 'eventemitter3';
+/**
+ * This is an abstract class, which extends {@link Web3BaseProvider} class. This class is used to implement a provider that adheres to the EIP-1193 standard for Ethereum providers.
+ */
+export declare abstract class Eip1193Provider<API extends Web3APISpec = EthExecutionAPI> extends Web3BaseProvider<API> {
+    protected readonly _eventEmitter: EventEmitter;
+    private _chainId;
+    private _accounts;
+    private _getChainId;
+    private _getAccounts;
+    protected _onConnect(): void;
+    protected _onDisconnect(code: number, data?: unknown): void;
+    private _onAccountsChanged;
+}

package/lib/commonjs/web3_eip1193_provider.js

@@ -0,0 +1,109 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Eip1193Provider = void 0;
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js.  If not, see <http://www.gnu.org/licenses/>.
+*/
+const web3_types_1 = require("web3-types");
+const eventemitter3_1 = require("eventemitter3");
+const web3_errors_1 = require("web3-errors");
+const json_rpc_js_1 = require("./json_rpc.js");
+/**
+ * This is an abstract class, which extends {@link Web3BaseProvider} class. This class is used to implement a provider that adheres to the EIP-1193 standard for Ethereum providers.
+ */
+class Eip1193Provider extends web3_types_1.Web3BaseProvider {
+    constructor() {
+        super(...arguments);
+        this._eventEmitter = new eventemitter3_1.EventEmitter();
+        this._chainId = '';
+        this._accounts = [];
+    }
+    _getChainId() {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const data = yield this.request((0, json_rpc_js_1.toPayload)({
+                method: 'eth_chainId',
+                params: [],
+            }));
+            return (_a = data === null || data === void 0 ? void 0 : data.result) !== null && _a !== void 0 ? _a : '';
+        });
+    }
+    _getAccounts() {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const data = yield this.request((0, json_rpc_js_1.toPayload)({
+                method: 'eth_accounts',
+                params: [],
+            }));
+            return (_a = data === null || data === void 0 ? void 0 : data.result) !== null && _a !== void 0 ? _a : [];
+        });
+    }
+    _onConnect() {
+        Promise.all([
+            this._getChainId()
+                .then(chainId => {
+                if (chainId !== this._chainId) {
+                    this._chainId = chainId;
+                    this._eventEmitter.emit('chainChanged', this._chainId);
+                }
+            })
+                .catch(err => {
+                // todo: add error handler
+                console.error(err);
+            }),
+            this._getAccounts()
+                .then(accounts => {
+                if (!(this._accounts.length === accounts.length &&
+                    accounts.every(v => accounts.includes(v)))) {
+                    this._accounts = accounts;
+                    this._onAccountsChanged();
+                }
+            })
+                .catch(err => {
+                // todo: add error handler
+                // eslint-disable-next-line no-console
+                console.error(err);
+            }),
+        ])
+            .then(() => this._eventEmitter.emit('connect', {
+            chainId: this._chainId,
+        }))
+            .catch(err => {
+            // todo: add error handler
+            // eslint-disable-next-line no-console
+            console.error(err);
+        });
+    }
+    // todo this must be ProvideRpcError with a message too
+    _onDisconnect(code, data) {
+        this._eventEmitter.emit('disconnect', new web3_errors_1.EIP1193ProviderRpcError(code, data));
+    }
+    _onAccountsChanged() {
+        // get chainId and safe to local
+        this._eventEmitter.emit('accountsChanged', this._accounts);
+    }
+}
+exports.Eip1193Provider = Eip1193Provider;
+//# sourceMappingURL=web3_eip1193_provider.js.map