web3util 4.3.2

package/lib/esm/string_manipulation.js

@@ -0,0 +1,140 @@
+/*
+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/>.
+*/
+import { NibbleWidthError } from 'web3-errors';
+import { isHexStrict, validator, utils as validatorUtils, bigintPower } from 'web3-validator';
+import { numberToHex, toHex, toNumber } from './converters.js';
+/**
+ * Adds a padding on the left of a string, if value is a integer or bigInt will be converted to a hex string.
+ * @param value - The value to be padded.
+ * @param characterAmount - The amount of characters the string should have.
+ * @param sign - The sign to be added (default is 0).
+ * @returns The padded string.
+ *
+ * @example
+ * ```ts
+ *
+ * console.log(web3.utils.padLeft('0x123', 10));
+ * >0x0000000123
+ * ```
+ */
+export const padLeft = (value, characterAmount, sign = '0') => {
+    // To avoid duplicate code and circular dependency we will
+    // use `padLeft` implementation from `web3-validator`
+    if (typeof value === 'string') {
+        if (!isHexStrict(value)) {
+            return value.padStart(characterAmount, sign);
+        }
+        return validatorUtils.padLeft(value, characterAmount, sign);
+    }
+    validator.validate(['int'], [value]);
+    return validatorUtils.padLeft(value, characterAmount, sign);
+};
+/**
+ * Adds a padding on the right of a string, if value is a integer or bigInt will be converted to a hex string.
+ * @param value - The value to be padded.
+ * @param characterAmount - The amount of characters the string should have.
+ * @param sign - The sign to be added (default is 0).
+ * @returns The padded string.
+ *
+ * @example
+ * ```ts
+ * console.log(web3.utils.padRight('0x123', 10));
+ * > 0x1230000000
+ *
+ * console.log(web3.utils.padRight('0x123', 10, '1'));
+ * > 0x1231111111
+ * ```
+ */
+export const padRight = (value, characterAmount, sign = '0') => {
+    if (typeof value === 'string' && !isHexStrict(value)) {
+        return value.padEnd(characterAmount, sign);
+    }
+    const hexString = typeof value === 'string' && isHexStrict(value) ? value : numberToHex(value);
+    const prefixLength = hexString.startsWith('-') ? 3 : 2;
+    validator.validate([hexString.startsWith('-') ? 'int' : 'uint'], [value]);
+    return hexString.padEnd(characterAmount + prefixLength, sign);
+};
+/**
+ * Adds a padding on the right of a string, if value is a integer or bigInt will be converted to a hex string. @alias `padRight`
+ */
+export const rightPad = padRight;
+/**
+ * Adds a padding on the left of a string, if value is a integer or bigInt will be converted to a hex string. @alias `padLeft`
+ */
+export const leftPad = padLeft;
+/**
+ * Converts a negative number into the two’s complement and return a hexstring of 64 nibbles.
+ * @param value - The value to be converted.
+ * @param nibbleWidth - The nibble width of the hex string (default is 64).
+ *
+ * @returns The hex string of the two’s complement.
+ *
+ * @example
+ * ```ts
+ * console.log(web3.utils.toTwosComplement(13, 32));
+ * > 0x0000000000000000000000000000000d
+ *
+ * console.log(web3.utils.toTwosComplement('-0x1', 32));
+ * > 0xffffffffffffffffffffffffffffffff
+ *
+ * console.log(web3.utils.toTwosComplement(BigInt('9007199254740992'), 32));
+ * > 0x00000000000000000020000000000000
+ * ```
+ */
+export const toTwosComplement = (value, nibbleWidth = 64) => {
+    validator.validate(['int'], [value]);
+    const val = toNumber(value);
+    if (val >= 0)
+        return padLeft(toHex(val), nibbleWidth);
+    const largestBit = bigintPower(BigInt(2), BigInt(nibbleWidth * 4));
+    if (-val >= largestBit) {
+        throw new NibbleWidthError(`value: ${value}, nibbleWidth: ${nibbleWidth}`);
+    }
+    const updatedVal = BigInt(val);
+    const complement = updatedVal + largestBit;
+    return padLeft(numberToHex(complement), nibbleWidth);
+};
+/**
+ * Converts the twos complement into a decimal number or big int.
+ * @param value - The value to be converted.
+ * @param nibbleWidth - The nibble width of the hex string (default is 64).
+ * @returns The decimal number or big int.
+ *
+ * @example
+ * ```ts
+ * console.log(web3.utils.fromTwosComplement('0x0000000000000000000000000000000d', 32'));
+ * > 13
+ *
+ * console.log(web3.utils.fromTwosComplement('0x00000000000000000020000000000000', 32));
+ * > 9007199254740992n
+ * ```
+ */
+export const fromTwosComplement = (value, nibbleWidth = 64) => {
+    validator.validate(['int'], [value]);
+    const val = toNumber(value);
+    if (val < 0)
+        return val;
+    const largestBit = Math.ceil(Math.log(Number(val)) / Math.log(2));
+    if (largestBit > nibbleWidth * 4)
+        throw new NibbleWidthError(`value: "${value}", nibbleWidth: "${nibbleWidth}"`);
+    // check the largest bit to see if negative
+    if (nibbleWidth * 4 !== largestBit)
+        return val;
+    const complement = bigintPower(BigInt(2), BigInt(nibbleWidth) * BigInt(4));
+    return toNumber(BigInt(val) - complement);
+};
+//# sourceMappingURL=string_manipulation.js.map

package/lib/esm/string_manipulation.js.map

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

package/lib/esm/uint8array.js

@@ -0,0 +1,53 @@
+/*
+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/>.
+*/
+export function isUint8Array(data) {
+    var _a, _b;
+    return (data instanceof Uint8Array ||
+        ((_a = data === null || data === void 0 ? void 0 : data.constructor) === null || _a === void 0 ? void 0 : _a.name) === 'Uint8Array' ||
+        ((_b = data === null || data === void 0 ? void 0 : data.constructor) === null || _b === void 0 ? void 0 : _b.name) === 'Buffer');
+}
+export function uint8ArrayConcat(...parts) {
+    const length = parts.reduce((prev, part) => {
+        const agg = prev + part.length;
+        return agg;
+    }, 0);
+    const result = new Uint8Array(length);
+    let offset = 0;
+    for (const part of parts) {
+        result.set(part, offset);
+        offset += part.length;
+    }
+    return result;
+}
+/**
+ * Returns true if the two passed Uint8Arrays have the same content
+ */
+export function uint8ArrayEquals(a, b) {
+    if (a === b) {
+        return true;
+    }
+    if (a.byteLength !== b.byteLength) {
+        return false;
+    }
+    for (let i = 0; i < a.byteLength; i += 1) {
+        if (a[i] !== b[i]) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=uint8array.js.map

package/lib/esm/uint8array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uint8array.js","sourceRoot":"","sources":["../../src/uint8array.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;EAeE;AAEF,MAAM,UAAU,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;AAED,MAAM,UAAU,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;AAED;;GAEG;AACH,MAAM,UAAU,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"}

package/lib/esm/uuid.js

@@ -0,0 +1,53 @@
+/*
+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/>.
+*/
+/**
+ * @module Utils
+ */
+import { bytesToHex } from './converters.js';
+import { randomBytes } from './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"
+ * ```
+ */
+export const uuidV4 = () => {
+    const bytes = 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 = bytesToHex(bytes);
+    return [
+        hexString.substring(2, 10),
+        hexString.substring(10, 14),
+        hexString.substring(14, 18),
+        hexString.substring(18, 22),
+        hexString.substring(22, 34),
+    ].join('-');
+};
+//# sourceMappingURL=uuid.js.map

package/lib/esm/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../src/uuid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;EAeE;AAEF;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,GAAW,EAAE;IAClC,MAAM,KAAK,GAAG,WAAW,CAAC,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,UAAU,CAAC,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"}

package/lib/esm/validation.js

@@ -0,0 +1,158 @@
+/*
+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/>.
+*/
+/**
+ * @module Utils
+ */
+import { InvalidBlockError } from 'web3-errors';
+import { checkAddressCheckSum as checkAddressCheckSumValidator, isAddress as isAddressValidator, isBlockTag, isBloom as isBloomValidator, isContractAddressInBloom as isContractAddressInBloomValidator, isHex as isHexValidator, isHexStrict as isHexStrictValidator, isInBloom as isInBloomValidator, isNullish as isNullishValidator, isTopic as isTopicValidator, isTopicInBloom as isTopicInBloomValidator, isUserEthereumAddressInBloom as isUserEthereumAddressInBloomValidator, } from 'web3-validator';
+import { BlockTags } from 'web3-types';
+/**
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+export const isHexStrict = isHexStrictValidator;
+/**
+ * returns true if input is a hexstring, number or bigint
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+export const isHex = isHexValidator;
+/**
+ * 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 const checkAddressCheckSum = checkAddressCheckSumValidator;
+/**
+ * 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 const isAddress = isAddressValidator;
+/**
+ * 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 const isBloom = isBloomValidator;
+/**
+ * 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 const isInBloom = isInBloomValidator;
+/**
+ * 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 const isUserEthereumAddressInBloom = isUserEthereumAddressInBloomValidator;
+/**
+ * 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 const isContractAddressInBloom = isContractAddressInBloomValidator;
+/**
+ * Checks if its a valid topic
+ *
+ * @deprecated Will be removed in next release. Please use `web3-validator` package instead.
+ */
+export const isTopic = isTopicValidator;
+/**
+ * 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 const isTopicInBloom = isTopicInBloomValidator;
+/**
+ * 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 const compareBlockNumbers = (blockA, blockB) => {
+    const isABlockTag = typeof blockA === 'string' && isBlockTag(blockA);
+    const isBBlockTag = typeof blockB === 'string' && 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 = {
+            [BlockTags.EARLIEST]: 1,
+            [BlockTags.FINALIZED]: 2,
+            [BlockTags.SAFE]: 3,
+            [BlockTags.LATEST]: 4,
+            [BlockTags.PENDING]: 5,
+        };
+        if (tagsOrder[blockA] < tagsOrder[blockB]) {
+            return -1;
+        }
+        return 1;
+    }
+    if ((isABlockTag && !isBBlockTag) || (!isABlockTag && isBBlockTag)) {
+        throw new 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;
+};
+export const isContractInitOptions = (options) => typeof options === 'object' &&
+    !isNullishValidator(options) &&
+    Object.keys(options).length !== 0 &&
+    [
+        'input',
+        'data',
+        'from',
+        'gas',
+        'gasPrice',
+        'gasLimit',
+        'address',
+        'jsonInterface',
+        'syncWithContext',
+        'dataInputFill',
+    ].some(key => key in options);
+export const isNullish = isNullishValidator;
+//# sourceMappingURL=validation.js.map

package/lib/esm/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;EAeE;AAEF;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACN,oBAAoB,IAAI,6BAA6B,EACrD,SAAS,IAAI,kBAAkB,EAC/B,UAAU,EACV,OAAO,IAAI,gBAAgB,EAC3B,wBAAwB,IAAI,iCAAiC,EAC7D,KAAK,IAAI,cAAc,EACvB,WAAW,IAAI,oBAAoB,EACnC,SAAS,IAAI,kBAAkB,EAC/B,SAAS,IAAI,kBAAkB,EAC/B,OAAO,IAAI,gBAAgB,EAC3B,cAAc,IAAI,uBAAuB,EACzC,4BAA4B,IAAI,qCAAqC,GACrE,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAoB,SAAS,EAAuB,MAAM,YAAY,CAAC;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,cAAc,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAElE;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAExC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,qCAAqC,CAAC;AAElF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,iCAAiC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAExC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAEtD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAwB,EAAE,MAAwB,EAAE,EAAE;IACzF,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAErE,IACC,MAAM,KAAK,MAAM;QACjB,CAAC,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,8CAA8C;MAClI;QACD,OAAO,CAAC,CAAC;KACT;IACD,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,GAAG,CAAC,EAAE;QACxC,OAAO,CAAC,CAAC,CAAC;KACV;IACD,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,GAAG,CAAC,EAAE;QACxC,OAAO,CAAC,CAAC;KACT;IAED,IAAI,WAAW,IAAI,WAAW,EAAE;QAC/B,iEAAiE;QACjE,MAAM,SAAS,GAAG;YACjB,CAAC,SAAS,CAAC,QAAkB,CAAC,EAAE,CAAC;YACjC,CAAC,SAAS,CAAC,SAAmB,CAAC,EAAE,CAAC;YAClC,CAAC,SAAS,CAAC,IAAc,CAAC,EAAE,CAAC;YAC7B,CAAC,SAAS,CAAC,MAAgB,CAAC,EAAE,CAAC;YAC/B,CAAC,SAAS,CAAC,OAAiB,CAAC,EAAE,CAAC;SAChC,CAAC;QAEF,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE;YAC1C,OAAO,CAAC,CAAC,CAAC;SACV;QAED,OAAO,CAAC,CAAC;KACT;IACD,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,WAAW,IAAI,WAAW,CAAC,EAAE;QACnE,MAAM,IAAI,iBAAiB,CAAC,2DAA2D,CAAC,CAAC;KACzF;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAE/B,IAAI,OAAO,GAAG,OAAO,EAAE;QACtB,OAAO,CAAC,CAAC,CAAC;KACV;IACD,IAAI,OAAO,KAAK,OAAO,EAAE;QACxB,OAAO,CAAC,CAAC;KACT;IACD,OAAO,CAAC,CAAC;AACV,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAgB,EAAkC,EAAE,CACzF,OAAO,OAAO,KAAK,QAAQ;IAC3B,CAAC,kBAAkB,CAAC,OAAO,CAAC;IAC5B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;IACjC;QACC,OAAO;QACP,MAAM;QACN,MAAM;QACN,KAAK;QACL,UAAU;QACV,UAAU;QACV,SAAS;QACT,eAAe;QACf,iBAAiB;QACjB,eAAe;KACf,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,OAAO,CAAC,CAAC;AAE/B,MAAM,CAAC,MAAM,SAAS,GAAG,kBAAkB,CAAC"}

package/lib/esm/web3_deferred_promise.js

@@ -0,0 +1,137 @@
+/*
+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;
+import { OperationTimeoutError } from '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.
+ *
+ */
+export 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 OperationTimeoutError(this._timeoutMessage));
+        }
+    }
+    _clearTimeout() {
+        if (this._timeoutId) {
+            clearTimeout(this._timeoutId);
+        }
+    }
+}
+_a = Symbol.toStringTag;
+//# sourceMappingURL=web3_deferred_promise.js.map

package/lib/esm/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,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIpD;;;;GAIG;AACH,MAAM,OAAO,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,qBAAqB,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;KAvHQ,MAAM,CAAC,WAAW"}

package/lib/esm/web3_eip1193_provider.js

@@ -0,0 +1,105 @@
+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());
+    });
+};
+/*
+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/>.
+*/
+import { Web3BaseProvider, } from 'web3-types';
+import { EventEmitter } from 'eventemitter3';
+import { EIP1193ProviderRpcError } from 'web3-errors';
+import { toPayload } from './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.
+ */
+export class Eip1193Provider extends Web3BaseProvider {
+    constructor() {
+        super(...arguments);
+        this._eventEmitter = new EventEmitter();
+        this._chainId = '';
+        this._accounts = [];
+    }
+    _getChainId() {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const data = yield this.request(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(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 EIP1193ProviderRpcError(code, data));
+    }
+    _onAccountsChanged() {
+        // get chainId and safe to local
+        this._eventEmitter.emit('accountsChanged', this._accounts);
+    }
+}
+//# sourceMappingURL=web3_eip1193_provider.js.map