web3util 4.3.2

package/lib/commonjs/event_emitter.js

@@ -0,0 +1,44 @@
+"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/>.
+*/
+/* eslint-disable max-classes-per-file */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventEmitter = void 0;
+const eventemitter3_1 = __importDefault(require("eventemitter3"));
+/**
+ * This class copy the behavior of Node.js EventEmitter class.
+ * It is used to provide the same interface for the browser environment.
+ */
+class EventEmitter extends eventemitter3_1.default {
+    constructor() {
+        super(...arguments);
+        // must be defined for backwards compatibility
+        this.maxListeners = Number.MAX_SAFE_INTEGER;
+    }
+    setMaxListeners(maxListeners) {
+        this.maxListeners = maxListeners;
+        return this;
+    }
+    getMaxListeners() {
+        return this.maxListeners;
+    }
+}
+exports.EventEmitter = EventEmitter;
+//# sourceMappingURL=event_emitter.js.map

package/lib/commonjs/event_emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event_emitter.js","sourceRoot":"","sources":["../../src/event_emitter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;EAeE;AACF,yCAAyC;;;;;;AAEzC,kEAA0C;AAE1C;;;GAGG;AACH,MAAa,YAAa,SAAQ,uBAAa;IAA/C;;QACC,8CAA8C;QACtC,iBAAY,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAUhD,CAAC;IARO,eAAe,CAAC,YAAoB;QAC1C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,OAAO,IAAI,CAAC;IACb,CAAC;IAEM,eAAe;QACrB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC1B,CAAC;CACD;AAZD,oCAYC"}

package/lib/commonjs/formatter.d.ts

@@ -0,0 +1,43 @@
+import { DataFormat, FormatType } from 'web3-types';
+import { JsonSchema, ValidationSchemaInput } from 'web3-validator';
+export declare const isDataFormat: (dataFormat: unknown) => dataFormat is DataFormat;
+/**
+ * Converts a value depending on the format
+ * @param value - value to convert
+ * @param ethType - The type of the value to be parsed
+ * @param format - The format to be converted to
+ * @returns - The value converted to the specified format
+ */
+export declare const convertScalarValue: (value: unknown, ethType: string, format: DataFormat) => unknown;
+/**
+ * Converts the data to the specified format
+ * @param data - data to convert
+ * @param schema - The JSON schema that describes the structure of the data
+ * @param dataPath - A string array that specifies the path to the data within the JSON schema
+ * @param format  - The format to be converted to
+ * @param oneOfPath - An optional array of two-element tuples that specifies the "oneOf" option to choose, if the schema has oneOf and the data path can match multiple subschemas
+ * @returns - The data converted to the specified format
+ */
+export declare const convert: (data: Record<string, unknown> | unknown[] | unknown, schema: JsonSchema, dataPath: string[], format: DataFormat, oneOfPath?: [string, number][]) => unknown;
+/**
+ * Given data that can be interpreted according to the provided schema, returns equivalent data that has been formatted
+ * according to the provided return format.
+ *
+ * @param schema - how to interpret the data
+ * @param data - data to be formatted
+ * @param returnFormat - how to format the data
+ * @returns - formatted data
+ *
+ * @example
+ *
+ * ```js
+ * import { FMT_NUMBER, utils } from "web3";
+ *
+ * console.log(
+ *   utils.format({ format: "uint" }, "221", { number: FMT_NUMBER.HEX }),
+ * );
+ * // 0xdd
+ * ```
+ *
+ */
+export declare const format: <DataType extends unknown, ReturnType_1 extends DataFormat>(schema: ValidationSchemaInput | JsonSchema, data: DataType, returnFormat?: ReturnType_1) => FormatType<DataType, ReturnType_1>;

package/lib/commonjs/formatter.js

@@ -0,0 +1,320 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.format = exports.convert = exports.convertScalarValue = exports.isDataFormat = 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_errors_1 = require("web3-errors");
+const web3_types_1 = require("web3-types");
+const web3_validator_1 = require("web3-validator");
+const converters_js_1 = require("./converters.js");
+const objects_js_1 = require("./objects.js");
+const string_manipulation_js_1 = require("./string_manipulation.js");
+const uint8array_js_1 = require("./uint8array.js");
+const { parseBaseType } = web3_validator_1.utils;
+const isDataFormat = (dataFormat) => typeof dataFormat === 'object' &&
+    !(0, web3_validator_1.isNullish)(dataFormat) &&
+    'number' in dataFormat &&
+    'bytes' in dataFormat;
+exports.isDataFormat = isDataFormat;
+/**
+ * Finds the schema that corresponds to a specific data path within a larger JSON schema.
+ * It works by iterating over the dataPath array and traversing the JSON schema one step at a time until it reaches the end of the path.
+ *
+ * @param schema - represents a JSON schema, which is an object that describes the structure of JSON data
+ * @param dataPath - represents an array of strings that specifies the path to the data within the JSON schema
+ * @param oneOfPath - represents an optional array of two-element tuples that specifies the "oneOf" option to choose, if the schema has oneOf and the data path can match multiple subschemas
+ * @returns the JSON schema that matches the data path
+ *
+ */
+const findSchemaByDataPath = (schema, dataPath, oneOfPath = []) => {
+    let result = Object.assign({}, schema);
+    let previousDataPath;
+    for (const dataPart of dataPath) {
+        if (result.oneOf && previousDataPath) {
+            const currentDataPath = previousDataPath;
+            const path = oneOfPath.find(([key]) => key === currentDataPath);
+            if (path && path[0] === previousDataPath) {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+                result = result.oneOf[path[1]];
+            }
+        }
+        if (!result.properties && !result.items) {
+            return undefined;
+        }
+        if (result.properties) {
+            result = result.properties[dataPart];
+        }
+        else if (result.items && result.items.properties) {
+            const node = result.items.properties;
+            result = node[dataPart];
+        }
+        else if (result.items && (0, web3_validator_1.isObject)(result.items)) {
+            result = result.items;
+        }
+        else if (result.items && Array.isArray(result.items)) {
+            result = result.items[parseInt(dataPart, 10)];
+        }
+        if (result && dataPart)
+            previousDataPath = dataPart;
+    }
+    return result;
+};
+/**
+ * Converts a value depending on the format
+ * @param value - value to convert
+ * @param ethType - The type of the value to be parsed
+ * @param format - The format to be converted to
+ * @returns - The value converted to the specified format
+ */
+const convertScalarValue = (value, ethType, format) => {
+    try {
+        const { baseType, baseTypeSize } = parseBaseType(ethType);
+        if (baseType === 'int' || baseType === 'uint') {
+            switch (format.number) {
+                case web3_types_1.FMT_NUMBER.NUMBER:
+                    return Number((0, converters_js_1.toBigInt)(value));
+                case web3_types_1.FMT_NUMBER.HEX:
+                    return (0, converters_js_1.numberToHex)((0, converters_js_1.toBigInt)(value));
+                case web3_types_1.FMT_NUMBER.STR:
+                    return (0, converters_js_1.toBigInt)(value).toString();
+                case web3_types_1.FMT_NUMBER.BIGINT:
+                    return (0, converters_js_1.toBigInt)(value);
+                default:
+                    throw new web3_errors_1.FormatterError(`Invalid format: ${String(format.number)}`);
+            }
+        }
+        if (baseType === 'bytes') {
+            let paddedValue;
+            if (baseTypeSize) {
+                if (typeof value === 'string')
+                    paddedValue = (0, string_manipulation_js_1.padLeft)(value, baseTypeSize * 2);
+                else if ((0, uint8array_js_1.isUint8Array)(value)) {
+                    paddedValue = (0, uint8array_js_1.uint8ArrayConcat)(new Uint8Array(baseTypeSize - value.length), value);
+                }
+            }
+            else {
+                paddedValue = value;
+            }
+            switch (format.bytes) {
+                case web3_types_1.FMT_BYTES.HEX:
+                    return (0, converters_js_1.bytesToHex)((0, converters_js_1.bytesToUint8Array)(paddedValue));
+                case web3_types_1.FMT_BYTES.UINT8ARRAY:
+                    return (0, converters_js_1.bytesToUint8Array)(paddedValue);
+                default:
+                    throw new web3_errors_1.FormatterError(`Invalid format: ${String(format.bytes)}`);
+            }
+        }
+        if (baseType === 'string') {
+            return String(value);
+        }
+    }
+    catch (error) {
+        // If someone didn't use `eth` keyword we can return original value
+        // as the scope of this code is formatting not validation
+        return value;
+    }
+    return value;
+};
+exports.convertScalarValue = convertScalarValue;
+const convertArray = ({ value, schemaProp, schema, object, key, dataPath, format, oneOfPath = [], }) => {
+    var _a, _b;
+    // If value is an array
+    if (Array.isArray(value)) {
+        let _schemaProp = schemaProp;
+        // TODO This is a naive approach to solving the issue of
+        // a schema using oneOf. This chunk of code was intended to handle
+        // BlockSchema.transactions
+        // TODO BlockSchema.transactions are not being formatted
+        if ((schemaProp === null || schemaProp === void 0 ? void 0 : schemaProp.oneOf) !== undefined) {
+            // The following code is basically saying:
+            // if the schema specifies oneOf, then we are to loop
+            // over each possible schema and check if they type of the schema
+            // matches the type of value[0], and if so we use the oneOfSchemaProp
+            // as the schema for formatting
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call
+            schemaProp.oneOf.forEach((oneOfSchemaProp, index) => {
+                var _a, _b;
+                if (!Array.isArray(schemaProp === null || schemaProp === void 0 ? void 0 : schemaProp.items) &&
+                    ((typeof value[0] === 'object' &&
+                        ((_a = oneOfSchemaProp === null || oneOfSchemaProp === void 0 ? void 0 : oneOfSchemaProp.items) === null || _a === void 0 ? void 0 : _a.type) === 'object') ||
+                        (typeof value[0] === 'string' &&
+                            ((_b = oneOfSchemaProp === null || oneOfSchemaProp === void 0 ? void 0 : oneOfSchemaProp.items) === null || _b === void 0 ? void 0 : _b.type) !== 'object'))) {
+                    _schemaProp = oneOfSchemaProp;
+                    oneOfPath.push([key, index]);
+                }
+            });
+        }
+        if ((0, web3_validator_1.isNullish)(_schemaProp === null || _schemaProp === void 0 ? void 0 : _schemaProp.items)) {
+            // Can not find schema for array item, delete that item
+            // eslint-disable-next-line no-param-reassign
+            delete object[key];
+            dataPath.pop();
+            return true;
+        }
+        // If schema for array items is a single type
+        if ((0, web3_validator_1.isObject)(_schemaProp.items) && !(0, web3_validator_1.isNullish)(_schemaProp.items.format)) {
+            for (let i = 0; i < value.length; i += 1) {
+                // eslint-disable-next-line no-param-reassign
+                object[key][i] = (0, exports.convertScalarValue)(value[i], 
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+                (_a = _schemaProp === null || _schemaProp === void 0 ? void 0 : _schemaProp.items) === null || _a === void 0 ? void 0 : _a.format, format);
+            }
+            dataPath.pop();
+            return true;
+        }
+        // If schema for array items is an object
+        if (!Array.isArray(_schemaProp === null || _schemaProp === void 0 ? void 0 : _schemaProp.items) && ((_b = _schemaProp === null || _schemaProp === void 0 ? void 0 : _schemaProp.items) === null || _b === void 0 ? void 0 : _b.type) === 'object') {
+            for (const arrObject of value) {
+                // eslint-disable-next-line no-use-before-define
+                (0, exports.convert)(arrObject, schema, dataPath, format, oneOfPath);
+            }
+            dataPath.pop();
+            return true;
+        }
+        // If schema for array is a tuple
+        if (Array.isArray(_schemaProp === null || _schemaProp === void 0 ? void 0 : _schemaProp.items)) {
+            for (let i = 0; i < value.length; i += 1) {
+                // eslint-disable-next-line no-param-reassign
+                object[key][i] = (0, exports.convertScalarValue)(value[i], _schemaProp.items[i].format, format);
+            }
+            dataPath.pop();
+            return true;
+        }
+    }
+    return false;
+};
+/**
+ * Converts the data to the specified format
+ * @param data - data to convert
+ * @param schema - The JSON schema that describes the structure of the data
+ * @param dataPath - A string array that specifies the path to the data within the JSON schema
+ * @param format  - The format to be converted to
+ * @param oneOfPath - An optional array of two-element tuples that specifies the "oneOf" option to choose, if the schema has oneOf and the data path can match multiple subschemas
+ * @returns - The data converted to the specified format
+ */
+const convert = (data, schema, dataPath, format, oneOfPath = []) => {
+    var _a;
+    // If it's a scalar value
+    if (!(0, web3_validator_1.isObject)(data) && !Array.isArray(data)) {
+        return (0, exports.convertScalarValue)(data, schema === null || schema === void 0 ? void 0 : schema.format, format);
+    }
+    const object = data;
+    // case when schema is array and `items` is object
+    if (Array.isArray(object) &&
+        (schema === null || schema === void 0 ? void 0 : schema.type) === 'array' &&
+        ((_a = schema === null || schema === void 0 ? void 0 : schema.items) === null || _a === void 0 ? void 0 : _a.type) === 'object') {
+        convertArray({
+            value: object,
+            schemaProp: schema,
+            schema,
+            object,
+            key: '',
+            dataPath,
+            format,
+            oneOfPath,
+        });
+    }
+    else {
+        for (const [key, value] of Object.entries(object)) {
+            dataPath.push(key);
+            let schemaProp = findSchemaByDataPath(schema, dataPath, oneOfPath);
+            // If value is a scaler value
+            if ((0, web3_validator_1.isNullish)(schemaProp)) {
+                delete object[key];
+                dataPath.pop();
+                continue;
+            }
+            // If value is an object, recurse into it
+            if ((0, web3_validator_1.isObject)(value)) {
+                (0, exports.convert)(value, schema, dataPath, format, oneOfPath);
+                dataPath.pop();
+                continue;
+            }
+            // If value is an array
+            if (convertArray({
+                value,
+                schemaProp,
+                schema,
+                object,
+                key,
+                dataPath,
+                format,
+                oneOfPath,
+            })) {
+                continue;
+            }
+            // The following code is basically saying:
+            // if the schema specifies oneOf, then we are to loop
+            // over each possible schema and check if they type of the schema specifies format
+            // and if so we use the oneOfSchemaProp as the schema for formatting
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call
+            if ((schemaProp === null || schemaProp === void 0 ? void 0 : schemaProp.format) === undefined && (schemaProp === null || schemaProp === void 0 ? void 0 : schemaProp.oneOf) !== undefined) {
+                for (const [_index, oneOfSchemaProp] of schemaProp.oneOf.entries()) {
+                    if ((oneOfSchemaProp === null || oneOfSchemaProp === void 0 ? void 0 : oneOfSchemaProp.format) !== undefined) {
+                        schemaProp = oneOfSchemaProp;
+                        break;
+                    }
+                }
+            }
+            object[key] = (0, exports.convertScalarValue)(value, schemaProp.format, format);
+            dataPath.pop();
+        }
+    }
+    return object;
+};
+exports.convert = convert;
+/**
+ * Given data that can be interpreted according to the provided schema, returns equivalent data that has been formatted
+ * according to the provided return format.
+ *
+ * @param schema - how to interpret the data
+ * @param data - data to be formatted
+ * @param returnFormat - how to format the data
+ * @returns - formatted data
+ *
+ * @example
+ *
+ * ```js
+ * import { FMT_NUMBER, utils } from "web3";
+ *
+ * console.log(
+ *   utils.format({ format: "uint" }, "221", { number: FMT_NUMBER.HEX }),
+ * );
+ * // 0xdd
+ * ```
+ *
+ */
+const format = (schema, data, returnFormat = web3_types_1.DEFAULT_RETURN_FORMAT) => {
+    let dataToParse;
+    if ((0, web3_validator_1.isObject)(data)) {
+        dataToParse = (0, objects_js_1.mergeDeep)({}, data);
+    }
+    else if (Array.isArray(data)) {
+        dataToParse = [...data];
+    }
+    else {
+        dataToParse = data;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    const jsonSchema = (0, web3_validator_1.isObject)(schema) ? schema : web3_validator_1.utils.ethAbiToJsonSchema(schema);
+    if (!jsonSchema.properties && !jsonSchema.items && !jsonSchema.format) {
+        throw new web3_errors_1.FormatterError('Invalid json schema for formatting');
+    }
+    return (0, exports.convert)(dataToParse, jsonSchema, [], returnFormat);
+};
+exports.format = format;
+//# sourceMappingURL=formatter.js.map

package/lib/commonjs/formatter.js.map

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

package/lib/commonjs/hash.d.ts

@@ -0,0 +1,93 @@
+import { Bytes, Numbers, Sha3Input, TypedObject, TypedObjectAbbreviated } from 'web3-types';
+/**
+ * A wrapper for ethereum-cryptography/keccak256 to allow hashing a `string` and a `bigint` in addition to `UInt8Array`
+ * @param data - the input to hash
+ * @returns - the Keccak-256 hash of the input
+ *
+ * @example
+ * ```ts
+ * console.log(web3.utils.keccak256Wrapper('web3.js'));
+ * > 0x63667efb1961039c9bb0d6ea7a5abdd223a3aca7daa5044ad894226e1f83919a
+ *
+ * console.log(web3.utils.keccak256Wrapper(1));
+ * > 0xc89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc6
+ *
+ * console.log(web3.utils.keccak256Wrapper(0xaf12fd));
+ * > 0x358640fd4719fa923525d74ab5ae80a594301aba5543e3492b052bf4598b794c
+ * ```
+ */
+export declare const keccak256Wrapper: (data: Bytes | Numbers | string | ReadonlyArray<number>) => string;
+export { keccak256Wrapper as keccak256 };
+/**
+ * computes the Keccak-256 hash of the input and returns a hexstring
+ * @param data - the input to hash
+ * @returns - the Keccak-256 hash of the input
+ *
+ * @example
+ * ```ts
+ * console.log(web3.utils.sha3('web3.js'));
+ * > 0x63667efb1961039c9bb0d6ea7a5abdd223a3aca7daa5044ad894226e1f83919a
+ *
+ * console.log(web3.utils.sha3(''));
+ * > undefined
+ * ```
+ */
+export declare const sha3: (data: Bytes) => string | undefined;
+/**
+ * Will calculate the sha3 of the input but does return the hash value instead of null if for example a empty string is passed.
+ * @param data - the input to hash
+ * @returns - the Keccak-256 hash of the input
+ *
+ * @example
+ * ```ts
+ * conosle.log(web3.utils.sha3Raw('web3.js'));
+ * > 0x63667efb1961039c9bb0d6ea7a5abdd223a3aca7daa5044ad894226e1f83919a
+ *
+ * console.log(web3.utils.sha3Raw(''));
+ * > 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470
+ * ```
+ */
+export declare const sha3Raw: (data: Bytes) => string;
+/**
+ * returns a string of the tightly packed value given based on the type
+ * @param arg - the input to return the tightly packed value
+ * @returns - the tightly packed value
+ */
+export declare const processSolidityEncodePackedArgs: (arg: Sha3Input) => string;
+/**
+ * Encode packed arguments to a hexstring
+ */
+export declare const encodePacked: (...values: Sha3Input[]) => string;
+/**
+ * Will tightly pack values given in the same way solidity would then hash.
+ * returns a hash string, or null if input is empty
+ * @param values - the input to return the tightly packed values
+ * @returns - the keccack246 of the tightly packed values
+ *
+ * @example
+ * ```ts
+ * console.log(web3.utils.soliditySha3({ type: "string", value: "31323334" }));
+ * > 0xf15f8da2ad27e486d632dc37d24912f634398918d6f9913a0a0ff84e388be62b
+ * ```
+ */
+export declare const soliditySha3: (...values: Sha3Input[]) => string | undefined;
+/**
+ * Will tightly pack values given in the same way solidity would then hash.
+ * returns a hash string, if input is empty will return `0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470`
+ * @param values - the input to return the tightly packed values
+ * @returns - the keccack246 of the tightly packed values
+ *
+ * @example
+ * ```ts
+ * console.log(web3.utils.soliditySha3Raw({ type: "string", value: "helloworld" }))
+ * > 0xfa26db7ca85ead399216e7c6316bc50ed24393c3122b582735e7f3b0f91b93f0
+ * ```
+ */
+export declare const soliditySha3Raw: (...values: TypedObject[] | TypedObjectAbbreviated[]) => string;
+/**
+ * Get slot number for storage long string in contract. Basically for getStorage method
+ * returns slotNumber where will data placed
+ * @param mainSlotNumber - the slot number where will be stored hash of long string
+ * @returns - the slot number where will be stored long string
+ */
+export declare const getStorageSlotNumForLongString: (mainSlotNumber: number | string) => string | undefined;