web3util 4.3.2

package/lib/commonjs/socket_provider.js

@@ -0,0 +1,356 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+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.SocketProvider = void 0;
+const web3_errors_1 = require("web3-errors");
+const web3_eip1193_provider_js_1 = require("./web3_eip1193_provider.js");
+const chunk_response_parser_js_1 = require("./chunk_response_parser.js");
+const validation_js_1 = require("./validation.js");
+const web3_deferred_promise_js_1 = require("./web3_deferred_promise.js");
+const jsonRpc = __importStar(require("./json_rpc.js"));
+const DEFAULT_RECONNECTION_OPTIONS = {
+    autoReconnect: true,
+    delay: 5000,
+    maxAttempts: 5,
+};
+const NORMAL_CLOSE_CODE = 1000; // https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close
+class SocketProvider extends web3_eip1193_provider_js_1.Eip1193Provider {
+    /**
+     * This is an abstract class for implementing a socket provider (e.g. WebSocket, IPC). It extends the EIP-1193 provider {@link EIP1193Provider}.
+     * @param socketPath - The path to the socket (e.g. /ipc/path or ws://localhost:8546)
+     * @param socketOptions - The options for the socket connection. Its type is supposed to be specified in the inherited classes.
+     * @param reconnectOptions - The options for the socket reconnection {@link ReconnectOptions}
+     */
+    constructor(socketPath, socketOptions, reconnectOptions) {
+        super();
+        this._connectionStatus = 'connecting';
+        // Message handlers. Due to bounding of `this` and removing the listeners we have to keep it's reference.
+        this._onMessageHandler = this._onMessage.bind(this);
+        this._onOpenHandler = this._onConnect.bind(this);
+        this._onCloseHandler = this._onCloseEvent.bind(this);
+        this._onErrorHandler = this._onError.bind(this);
+        if (!this._validateProviderPath(socketPath))
+            throw new web3_errors_1.InvalidClientError(socketPath);
+        this._socketPath = socketPath;
+        this._socketOptions = socketOptions;
+        this._reconnectOptions = Object.assign(Object.assign({}, DEFAULT_RECONNECTION_OPTIONS), (reconnectOptions !== null && reconnectOptions !== void 0 ? reconnectOptions : {}));
+        this._pendingRequestsQueue = new Map();
+        this._sentRequestsQueue = new Map();
+        this._init();
+        this.connect();
+        this.chunkResponseParser = new chunk_response_parser_js_1.ChunkResponseParser(this._eventEmitter, this._reconnectOptions.autoReconnect);
+        this.chunkResponseParser.onError(() => {
+            this._clearQueues();
+        });
+        this.isReconnecting = false;
+    }
+    get SocketConnection() {
+        return this._socketConnection;
+    }
+    _init() {
+        this._reconnectAttempts = 0;
+    }
+    /**
+     * Try to establish a connection to the socket
+     */
+    connect() {
+        try {
+            this._openSocketConnection();
+            this._connectionStatus = 'connecting';
+            this._addSocketListeners();
+        }
+        catch (e) {
+            if (!this.isReconnecting) {
+                this._connectionStatus = 'disconnected';
+                if (e && e.message) {
+                    throw new web3_errors_1.ConnectionError(`Error while connecting to ${this._socketPath}. Reason: ${e.message}`);
+                }
+                else {
+                    throw new web3_errors_1.InvalidClientError(this._socketPath);
+                }
+            }
+            else {
+                setImmediate(() => {
+                    this._reconnect();
+                });
+            }
+        }
+    }
+    // eslint-disable-next-line class-methods-use-this
+    _validateProviderPath(path) {
+        return !!path;
+    }
+    /**
+     *
+     * @returns the pendingRequestQueue size
+     */
+    // eslint-disable-next-line class-methods-use-this
+    getPendingRequestQueueSize() {
+        return this._pendingRequestsQueue.size;
+    }
+    /**
+     *
+     * @returns the sendPendingRequests size
+     */
+    // eslint-disable-next-line class-methods-use-this
+    getSentRequestsQueueSize() {
+        return this._sentRequestsQueue.size;
+    }
+    /**
+     *
+     * @returns `true` if the socket supports subscriptions
+     */
+    // eslint-disable-next-line class-methods-use-this
+    supportsSubscriptions() {
+        return true;
+    }
+    on(type, listener) {
+        this._eventEmitter.on(type, listener);
+    }
+    once(type, listener) {
+        this._eventEmitter.once(type, listener);
+    }
+    removeListener(type, listener) {
+        this._eventEmitter.removeListener(type, listener);
+    }
+    _onDisconnect(code, data) {
+        this._connectionStatus = 'disconnected';
+        super._onDisconnect(code, data);
+    }
+    /**
+     * Disconnects the socket
+     * @param code - The code to be sent to the server
+     * @param data - The data to be sent to the server
+     */
+    disconnect(code, data) {
+        const disconnectCode = code !== null && code !== void 0 ? code : NORMAL_CLOSE_CODE;
+        this._removeSocketListeners();
+        if (this.getStatus() !== 'disconnected') {
+            this._closeSocketConnection(disconnectCode, data);
+        }
+        this._onDisconnect(disconnectCode, data);
+    }
+    /**
+     * Safely disconnects the socket, async and waits for request size to be 0 before disconnecting
+     * @param forceDisconnect - If true, will clear queue after 5 attempts of waiting for both pending and sent queue to be 0
+     * @param ms - Determines the ms of setInterval
+     * @param code - The code to be sent to the server
+     * @param data - The data to be sent to the server
+     */
+    safeDisconnect(code, data, forceDisconnect = false, ms = 1000) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let retryAttempt = 0;
+            const checkQueue = () => __awaiter(this, void 0, void 0, function* () {
+                return new Promise(resolve => {
+                    const interval = setInterval(() => {
+                        if (forceDisconnect && retryAttempt >= 5) {
+                            this.clearQueues();
+                        }
+                        if (this.getPendingRequestQueueSize() === 0 &&
+                            this.getSentRequestsQueueSize() === 0) {
+                            clearInterval(interval);
+                            resolve(true);
+                        }
+                        retryAttempt += 1;
+                    }, ms);
+                });
+            });
+            yield checkQueue();
+            this.disconnect(code, data);
+        });
+    }
+    /**
+     * Removes all listeners for the specified event type.
+     * @param type - The event type to remove the listeners for
+     */
+    removeAllListeners(type) {
+        this._eventEmitter.removeAllListeners(type);
+    }
+    _onError(event) {
+        // do not emit error while trying to reconnect
+        if (this.isReconnecting) {
+            this._reconnect();
+        }
+        else {
+            this._eventEmitter.emit('error', event);
+        }
+    }
+    /**
+     * Resets the socket, removing all listeners and pending requests
+     */
+    reset() {
+        this._sentRequestsQueue.clear();
+        this._pendingRequestsQueue.clear();
+        this._init();
+        this._removeSocketListeners();
+        this._addSocketListeners();
+    }
+    _reconnect() {
+        if (this.isReconnecting) {
+            return;
+        }
+        this.isReconnecting = true;
+        if (this._sentRequestsQueue.size > 0) {
+            this._sentRequestsQueue.forEach((request, key) => {
+                request.deferredPromise.reject(new web3_errors_1.PendingRequestsOnReconnectingError());
+                this._sentRequestsQueue.delete(key);
+            });
+        }
+        if (this._reconnectAttempts < this._reconnectOptions.maxAttempts) {
+            this._reconnectAttempts += 1;
+            setTimeout(() => {
+                this._removeSocketListeners();
+                this.connect(); // this can error out
+                this.isReconnecting = false;
+            }, this._reconnectOptions.delay);
+        }
+        else {
+            this.isReconnecting = false;
+            this._clearQueues();
+            this._removeSocketListeners();
+            this._eventEmitter.emit('error', new web3_errors_1.MaxAttemptsReachedOnReconnectingError(this._reconnectOptions.maxAttempts));
+        }
+    }
+    /**
+     *  Creates a request object to be sent to the server
+     */
+    request(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if ((0, validation_js_1.isNullish)(this._socketConnection)) {
+                throw new Error('Connection is undefined');
+            }
+            // if socket disconnected - open connection
+            if (this.getStatus() === 'disconnected') {
+                this.connect();
+            }
+            const requestId = jsonRpc.isBatchRequest(request)
+                ? request[0].id
+                : request.id;
+            if (!requestId) {
+                throw new web3_errors_1.Web3WSProviderError('Request Id not defined');
+            }
+            if (this._sentRequestsQueue.has(requestId)) {
+                throw new web3_errors_1.RequestAlreadySentError(requestId);
+            }
+            const deferredPromise = new web3_deferred_promise_js_1.Web3DeferredPromise();
+            deferredPromise.catch(error => {
+                this._eventEmitter.emit('error', error);
+            });
+            const reqItem = {
+                payload: request,
+                deferredPromise,
+            };
+            if (this.getStatus() === 'connecting') {
+                this._pendingRequestsQueue.set(requestId, reqItem);
+                return reqItem.deferredPromise;
+            }
+            this._sentRequestsQueue.set(requestId, reqItem);
+            try {
+                this._sendToSocket(reqItem.payload);
+            }
+            catch (error) {
+                this._sentRequestsQueue.delete(requestId);
+                this._eventEmitter.emit('error', error);
+            }
+            return deferredPromise;
+        });
+    }
+    _onConnect() {
+        this._connectionStatus = 'connected';
+        this._reconnectAttempts = 0;
+        super._onConnect();
+        this._sendPendingRequests();
+    }
+    _sendPendingRequests() {
+        for (const [id, value] of this._pendingRequestsQueue.entries()) {
+            try {
+                this._sendToSocket(value.payload);
+                this._pendingRequestsQueue.delete(id);
+                this._sentRequestsQueue.set(id, value);
+            }
+            catch (error) {
+                // catches if sendTosocket fails
+                this._pendingRequestsQueue.delete(id);
+                this._eventEmitter.emit('error', error);
+            }
+        }
+    }
+    _onMessage(event) {
+        const responses = this._parseResponses(event);
+        if ((0, validation_js_1.isNullish)(responses) || responses.length === 0) {
+            return;
+        }
+        for (const response of responses) {
+            if (jsonRpc.isResponseWithNotification(response) &&
+                response.method.endsWith('_subscription')) {
+                this._eventEmitter.emit('message', response);
+                return;
+            }
+            const requestId = jsonRpc.isBatchResponse(response)
+                ? response[0].id
+                : response.id;
+            const requestItem = this._sentRequestsQueue.get(requestId);
+            if (!requestItem) {
+                return;
+            }
+            if (jsonRpc.isBatchResponse(response) ||
+                jsonRpc.isResponseWithResult(response) ||
+                jsonRpc.isResponseWithError(response)) {
+                this._eventEmitter.emit('message', response);
+                requestItem.deferredPromise.resolve(response);
+            }
+            this._sentRequestsQueue.delete(requestId);
+        }
+    }
+    clearQueues(event) {
+        this._clearQueues(event);
+    }
+    _clearQueues(event) {
+        if (this._pendingRequestsQueue.size > 0) {
+            this._pendingRequestsQueue.forEach((request, key) => {
+                request.deferredPromise.reject(new web3_errors_1.ConnectionNotOpenError(event));
+                this._pendingRequestsQueue.delete(key);
+            });
+        }
+        if (this._sentRequestsQueue.size > 0) {
+            this._sentRequestsQueue.forEach((request, key) => {
+                request.deferredPromise.reject(new web3_errors_1.ConnectionNotOpenError(event));
+                this._sentRequestsQueue.delete(key);
+            });
+        }
+        this._removeSocketListeners();
+    }
+}
+exports.SocketProvider = SocketProvider;
+//# sourceMappingURL=socket_provider.js.map

package/lib/commonjs/socket_provider.js.map

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

package/lib/commonjs/string_manipulation.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @module Utils
+ */
+import { Numbers } from 'web3-types';
+/**
+ * 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 declare const padLeft: (value: Numbers, characterAmount: number, sign?: string) => string;
+/**
+ * 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 declare const padRight: (value: Numbers, characterAmount: number, sign?: string) => string;
+/**
+ * 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 declare const rightPad: (value: Numbers, characterAmount: number, sign?: string) => string;
+/**
+ * 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 declare const leftPad: (value: Numbers, characterAmount: number, sign?: string) => string;
+/**
+ * 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 declare const toTwosComplement: (value: Numbers, nibbleWidth?: number) => string;
+/**
+ * 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 declare const fromTwosComplement: (value: Numbers, nibbleWidth?: number) => number | bigint;

package/lib/commonjs/string_manipulation.js

@@ -0,0 +1,147 @@
+"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.fromTwosComplement = exports.toTwosComplement = exports.leftPad = exports.rightPad = exports.padRight = exports.padLeft = void 0;
+const web3_errors_1 = require("web3-errors");
+const web3_validator_1 = require("web3-validator");
+const converters_js_1 = require("./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
+ * ```
+ */
+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 (!(0, web3_validator_1.isHexStrict)(value)) {
+            return value.padStart(characterAmount, sign);
+        }
+        return web3_validator_1.utils.padLeft(value, characterAmount, sign);
+    }
+    web3_validator_1.validator.validate(['int'], [value]);
+    return web3_validator_1.utils.padLeft(value, characterAmount, sign);
+};
+exports.padLeft = padLeft;
+/**
+ * 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
+ * ```
+ */
+const padRight = (value, characterAmount, sign = '0') => {
+    if (typeof value === 'string' && !(0, web3_validator_1.isHexStrict)(value)) {
+        return value.padEnd(characterAmount, sign);
+    }
+    const hexString = typeof value === 'string' && (0, web3_validator_1.isHexStrict)(value) ? value : (0, converters_js_1.numberToHex)(value);
+    const prefixLength = hexString.startsWith('-') ? 3 : 2;
+    web3_validator_1.validator.validate([hexString.startsWith('-') ? 'int' : 'uint'], [value]);
+    return hexString.padEnd(characterAmount + prefixLength, sign);
+};
+exports.padRight = padRight;
+/**
+ * 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`
+ */
+exports.rightPad = exports.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`
+ */
+exports.leftPad = exports.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
+ * ```
+ */
+const toTwosComplement = (value, nibbleWidth = 64) => {
+    web3_validator_1.validator.validate(['int'], [value]);
+    const val = (0, converters_js_1.toNumber)(value);
+    if (val >= 0)
+        return (0, exports.padLeft)((0, converters_js_1.toHex)(val), nibbleWidth);
+    const largestBit = (0, web3_validator_1.bigintPower)(BigInt(2), BigInt(nibbleWidth * 4));
+    if (-val >= largestBit) {
+        throw new web3_errors_1.NibbleWidthError(`value: ${value}, nibbleWidth: ${nibbleWidth}`);
+    }
+    const updatedVal = BigInt(val);
+    const complement = updatedVal + largestBit;
+    return (0, exports.padLeft)((0, converters_js_1.numberToHex)(complement), nibbleWidth);
+};
+exports.toTwosComplement = toTwosComplement;
+/**
+ * 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
+ * ```
+ */
+const fromTwosComplement = (value, nibbleWidth = 64) => {
+    web3_validator_1.validator.validate(['int'], [value]);
+    const val = (0, converters_js_1.toNumber)(value);
+    if (val < 0)
+        return val;
+    const largestBit = Math.ceil(Math.log(Number(val)) / Math.log(2));
+    if (largestBit > nibbleWidth * 4)
+        throw new web3_errors_1.NibbleWidthError(`value: "${value}", nibbleWidth: "${nibbleWidth}"`);
+    // check the largest bit to see if negative
+    if (nibbleWidth * 4 !== largestBit)
+        return val;
+    const complement = (0, web3_validator_1.bigintPower)(BigInt(2), BigInt(nibbleWidth) * BigInt(4));
+    return (0, converters_js_1.toNumber)(BigInt(val) - complement);
+};
+exports.fromTwosComplement = fromTwosComplement;
+//# sourceMappingURL=string_manipulation.js.map

package/lib/commonjs/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/commonjs/uint8array.d.ts

@@ -0,0 +1,6 @@
+export declare function isUint8Array(data: unknown | Uint8Array): data is Uint8Array;
+export declare function uint8ArrayConcat(...parts: Uint8Array[]): Uint8Array;
+/**
+ * Returns true if the two passed Uint8Arrays have the same content
+ */
+export declare function uint8ArrayEquals(a: Uint8Array, b: Uint8Array): boolean;

package/lib/commonjs/uint8array.js

@@ -0,0 +1,59 @@
+"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.uint8ArrayEquals = exports.uint8ArrayConcat = exports.isUint8Array = void 0;
+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');
+}
+exports.isUint8Array = isUint8Array;
+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;
+}
+exports.uint8ArrayConcat = uint8ArrayConcat;
+/**
+ * Returns true if the two passed Uint8Arrays have the same content
+ */
+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;
+}
+exports.uint8ArrayEquals = uint8ArrayEquals;
+//# sourceMappingURL=uint8array.js.map