hardhatjs 2.22.15

package/internal/util/io-ts.d.ts

@@ -0,0 +1,5 @@
+import * as t from "io-ts";
+export declare function optionalOrNullable<TypeT, OutputT, InputT>(codec: t.Type<TypeT, OutputT, InputT>, name?: string): t.Type<TypeT | undefined, OutputT | undefined, InputT | undefined | null>;
+export declare function optional<TypeT, OutputT, InputT>(codec: t.Type<TypeT, OutputT, InputT>, name?: string): t.Type<TypeT | undefined, OutputT | undefined, InputT | undefined>;
+export declare function nullable<TypeT, OutputT, InputT>(codec: t.Type<TypeT, OutputT, InputT>, name?: string): t.Type<TypeT | null, OutputT | null, InputT | null>;
+//# sourceMappingURL=io-ts.d.ts.map

package/internal/util/io-ts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io-ts.d.ts","sourceRoot":"","sources":["../../src/internal/util/io-ts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,OAAO,CAAC;AAE3B,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EACvD,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EACrC,IAAI,GAAE,MAAoC,GACzC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,CAiB3E;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAC7C,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EACrC,IAAI,GAAE,MAAoC,GACzC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,CAOpE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAC7C,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EACrC,IAAI,GAAE,MAA+B,GACpC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAOrD"}

package/internal/util/io-ts.js

@@ -0,0 +1,50 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nullable = exports.optional = exports.optionalOrNullable = void 0;
+const t = __importStar(require("io-ts"));
+function optionalOrNullable(codec, name = `${codec.name} | undefined`) {
+    return new t.Type(name, (u) => u === undefined || codec.is(u), (i, c) => {
+        if (i === undefined || i === null) {
+            return t.success(undefined);
+        }
+        return codec.validate(i, c);
+    }, (a) => {
+        if (a === undefined) {
+            return undefined;
+        }
+        return codec.encode(a);
+    });
+}
+exports.optionalOrNullable = optionalOrNullable;
+function optional(codec, name = `${codec.name} | undefined`) {
+    return new t.Type(name, (u) => u === undefined || codec.is(u), (u, c) => (u === undefined ? t.success(undefined) : codec.validate(u, c)), (a) => (a === undefined ? undefined : codec.encode(a)));
+}
+exports.optional = optional;
+function nullable(codec, name = `${codec.name} | null`) {
+    return new t.Type(name, (u) => u === null || codec.is(u), (u, c) => (u === null ? t.success(null) : codec.validate(u, c)), (a) => (a === null ? null : codec.encode(a)));
+}
+exports.nullable = nullable;
+//# sourceMappingURL=io-ts.js.map

package/internal/util/io-ts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io-ts.js","sourceRoot":"","sources":["../../src/internal/util/io-ts.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yCAA2B;AAE3B,SAAgB,kBAAkB,CAChC,KAAqC,EACrC,OAAe,GAAG,KAAK,CAAC,IAAI,cAAc;IAE1C,OAAO,IAAI,CAAC,CAAC,IAAI,CACf,IAAI,EACJ,CAAC,CAAU,EAA0B,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EACtE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACP,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,EAAE;YACjC,OAAO,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;SAC7B;QACD,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC,EACD,CAAC,CAAC,EAAE,EAAE;QACJ,IAAI,CAAC,KAAK,SAAS,EAAE;YACnB,OAAO,SAAS,CAAC;SAClB;QACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC,CACF,CAAC;AACJ,CAAC;AApBD,gDAoBC;AAED,SAAgB,QAAQ,CACtB,KAAqC,EACrC,OAAe,GAAG,KAAK,CAAC,IAAI,cAAc;IAE1C,OAAO,IAAI,CAAC,CAAC,IAAI,CACf,IAAI,EACJ,CAAC,CAAU,EAA0B,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EACtE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EACzE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CACvD,CAAC;AACJ,CAAC;AAVD,4BAUC;AAED,SAAgB,QAAQ,CACtB,KAAqC,EACrC,OAAe,GAAG,KAAK,CAAC,IAAI,SAAS;IAErC,OAAO,IAAI,CAAC,CAAC,IAAI,CACf,IAAI,EACJ,CAAC,CAAU,EAAqB,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAC5D,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAC/D,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAC7C,CAAC;AACJ,CAAC;AAVD,4BAUC"}

package/internal/util/jsonrpc.d.ts

@@ -0,0 +1,26 @@
+export interface JsonRpcRequest {
+    jsonrpc: string;
+    method: string;
+    params: any[];
+    id: number | string;
+}
+export interface SuccessfulJsonRpcResponse {
+    jsonrpc: string;
+    id: number | string;
+    result: any;
+}
+export interface FailedJsonRpcResponse {
+    jsonrpc: string;
+    id: number | string | null;
+    error: {
+        code: number;
+        message: string;
+        data?: any;
+    };
+}
+export type JsonRpcResponse = SuccessfulJsonRpcResponse | FailedJsonRpcResponse;
+export declare function parseJsonResponse(text: string): JsonRpcResponse | JsonRpcResponse[];
+export declare function isValidJsonRequest(payload: any): boolean;
+export declare function isValidJsonResponse(payload: any): boolean;
+export declare function isSuccessfulJsonResponse(payload: JsonRpcResponse): payload is SuccessfulJsonRpcResponse;
+//# sourceMappingURL=jsonrpc.d.ts.map

package/internal/util/jsonrpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.d.ts","sourceRoot":"","sources":["../../src/internal/util/jsonrpc.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,GAAG,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,GAAG,CAAC;KACZ,CAAC;CACH;AAED,MAAM,MAAM,eAAe,GAAG,yBAAyB,GAAG,qBAAqB,CAAC;AAEhF,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GACX,eAAe,GAAG,eAAe,EAAE,CAoBrC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAkBxD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,WAgC/C;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,GACvB,OAAO,IAAI,yBAAyB,CAEtC"}

package/internal/util/jsonrpc.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSuccessfulJsonResponse = exports.isValidJsonResponse = exports.isValidJsonRequest = exports.parseJsonResponse = void 0;
+const errors_1 = require("../core/errors");
+const errors_list_1 = require("../core/errors-list");
+function parseJsonResponse(text) {
+    try {
+        const json = JSON.parse(text);
+        const responses = Array.isArray(json) ? json : [json];
+        for (const response of responses) {
+            if (!isValidJsonResponse(response)) {
+                // We are sending the proper error inside the catch part of the statement.
+                // We just need to raise anything here.
+                // eslint-disable-next-line @nomicfoundation/hardhat-internal-rules/only-hardhat-error
+                throw new Error();
+            }
+        }
+        return json;
+    }
+    catch {
+        throw new errors_1.HardhatError(errors_list_1.ERRORS.NETWORK.INVALID_JSON_RESPONSE, {
+            response: text,
+        });
+    }
+}
+exports.parseJsonResponse = parseJsonResponse;
+function isValidJsonRequest(payload) {
+    if (payload.jsonrpc !== "2.0") {
+        return false;
+    }
+    if (typeof payload.id !== "number" && typeof payload.id !== "string") {
+        return false;
+    }
+    if (typeof payload.method !== "string") {
+        return false;
+    }
+    if (payload.params !== undefined && !Array.isArray(payload.params)) {
+        return false;
+    }
+    return true;
+}
+exports.isValidJsonRequest = isValidJsonRequest;
+function isValidJsonResponse(payload) {
+    if (payload.jsonrpc !== "2.0") {
+        return false;
+    }
+    if (typeof payload.id !== "number" &&
+        typeof payload.id !== "string" &&
+        payload.id !== null) {
+        return false;
+    }
+    if (payload.id === null && payload.error === undefined) {
+        return false;
+    }
+    if (payload.result === undefined && payload.error === undefined) {
+        return false;
+    }
+    if (payload.error !== undefined) {
+        if (typeof payload.error.code !== "number") {
+            return false;
+        }
+        if (typeof payload.error.message !== "string") {
+            return false;
+        }
+    }
+    return true;
+}
+exports.isValidJsonResponse = isValidJsonResponse;
+function isSuccessfulJsonResponse(payload) {
+    return "result" in payload;
+}
+exports.isSuccessfulJsonResponse = isSuccessfulJsonResponse;
+//# sourceMappingURL=jsonrpc.js.map

package/internal/util/jsonrpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.js","sourceRoot":"","sources":["../../src/internal/util/jsonrpc.ts"],"names":[],"mappings":";;;AAAA,2CAA8C;AAC9C,qDAA6C;AA2B7C,SAAgB,iBAAiB,CAC/B,IAAY;IAEZ,IAAI;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;YAChC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE;gBAClC,0EAA0E;gBAC1E,uCAAuC;gBACvC,sFAAsF;gBACtF,MAAM,IAAI,KAAK,EAAE,CAAC;aACnB;SACF;QAED,OAAO,IAAI,CAAC;KACb;IAAC,MAAM;QACN,MAAM,IAAI,qBAAY,CAAC,oBAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE;YAC3D,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;KACJ;AACH,CAAC;AAtBD,8CAsBC;AAED,SAAgB,kBAAkB,CAAC,OAAY;IAC7C,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE;QAC7B,OAAO,KAAK,CAAC;KACd;IAED,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,EAAE;QACpE,OAAO,KAAK,CAAC;KACd;IAED,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE;QACtC,OAAO,KAAK,CAAC;KACd;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;QAClE,OAAO,KAAK,CAAC;KACd;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAlBD,gDAkBC;AAED,SAAgB,mBAAmB,CAAC,OAAY;IAC9C,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE;QAC7B,OAAO,KAAK,CAAC;KACd;IAED,IACE,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ;QAC9B,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ;QAC9B,OAAO,CAAC,EAAE,KAAK,IAAI,EACnB;QACA,OAAO,KAAK,CAAC;KACd;IAED,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE;QACtD,OAAO,KAAK,CAAC;KACd;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE;QAC/D,OAAO,KAAK,CAAC;KACd;IAED,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE;QAC/B,IAAI,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE;YAC1C,OAAO,KAAK,CAAC;SACd;QAED,IAAI,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE;YAC7C,OAAO,KAAK,CAAC;SACd;KACF;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAhCD,kDAgCC;AAED,SAAgB,wBAAwB,CACtC,OAAwB;IAExB,OAAO,QAAQ,IAAI,OAAO,CAAC;AAC7B,CAAC;AAJD,4DAIC"}

package/internal/util/keccak.d.ts

@@ -0,0 +1,2 @@
+export declare function keccak256(data: Uint8Array): Uint8Array;
+//# sourceMappingURL=keccak.d.ts.map

package/internal/util/keccak.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keccak.d.ts","sourceRoot":"","sources":["../../src/internal/util/keccak.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAEtD"}

package/internal/util/keccak.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keccak256 = void 0;
+const keccak_1 = __importDefault(require("keccak"));
+function keccak256(data) {
+    return (0, keccak_1.default)("keccak256").update(Buffer.from(data)).digest();
+}
+exports.keccak256 = keccak256;
+//# sourceMappingURL=keccak.js.map

package/internal/util/keccak.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keccak.js","sourceRoot":"","sources":["../../src/internal/util/keccak.ts"],"names":[],"mappings":";;;;;;AAAA,oDAAsC;AAEtC,SAAgB,SAAS,CAAC,IAAgB;IACxC,OAAO,IAAA,gBAAgB,EAAC,WAAW,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AAC1E,CAAC;AAFD,8BAEC"}

package/internal/util/keys-derivation.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="node" />
+export declare function deriveKeyFromMnemonicAndPath(mnemonic: string, hdPath: string, passphrase: string): Buffer | undefined;
+//# sourceMappingURL=keys-derivation.d.ts.map

package/internal/util/keys-derivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys-derivation.d.ts","sourceRoot":"","sources":["../../src/internal/util/keys-derivation.ts"],"names":[],"mappings":";AAGA,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAuBpB"}

package/internal/util/keys-derivation.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveKeyFromMnemonicAndPath = void 0;
+function deriveKeyFromMnemonicAndPath(mnemonic, hdPath, passphrase) {
+    const { mnemonicToSeedSync, } = require("ethereum-cryptography/bip39");
+    // NOTE: If mnemonic has space or newline at the beginning or end, it will be trimmed.
+    // This is because mnemonic containing them may generate different private keys.
+    const trimmedMnemonic = mnemonic.trim();
+    const seed = mnemonicToSeedSync(trimmedMnemonic, passphrase);
+    const { HDKey, } = require("ethereum-cryptography/hdkey");
+    const masterKey = HDKey.fromMasterSeed(seed);
+    const derived = masterKey.derive(hdPath);
+    return derived.privateKey === null
+        ? undefined
+        : Buffer.from(derived.privateKey);
+}
+exports.deriveKeyFromMnemonicAndPath = deriveKeyFromMnemonicAndPath;
+//# sourceMappingURL=keys-derivation.js.map

package/internal/util/keys-derivation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys-derivation.js","sourceRoot":"","sources":["../../src/internal/util/keys-derivation.ts"],"names":[],"mappings":";;;AAGA,SAAgB,4BAA4B,CAC1C,QAAgB,EAChB,MAAc,EACd,UAAkB;IAElB,MAAM,EACJ,kBAAkB,GACnB,GAEG,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC3C,sFAAsF;IACtF,gFAAgF;IAChF,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,kBAAkB,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAE7D,MAAM,EACJ,KAAK,GACN,GAEG,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAE3C,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEzC,OAAO,OAAO,CAAC,UAAU,KAAK,IAAI;QAChC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC;AA3BD,oEA2BC"}

package/internal/util/lang.d.ts

@@ -0,0 +1,3 @@
+export declare function fromEntries<T = any>(entries: Array<[string, any]>): T;
+export declare function mapValues<T extends object, ResultT>(o: T, callback: (value: T[keyof T]) => ResultT[keyof ResultT]): ResultT;
+//# sourceMappingURL=lang.d.ts.map

package/internal/util/lang.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lang.d.ts","sourceRoot":"","sources":["../../src/internal/util/lang.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAOrE;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EACjD,CAAC,EAAE,CAAC,EACJ,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,OAAO,CAAC,MAAM,OAAO,CAAC,GACtD,OAAO,CAQT"}

package/internal/util/lang.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapValues = exports.fromEntries = void 0;
+function fromEntries(entries) {
+    return Object.assign({}, ...entries.map(([name, value]) => ({
+        [name]: value,
+    })));
+}
+exports.fromEntries = fromEntries;
+function mapValues(o, callback) {
+    const result = {};
+    for (const [key, value] of Object.entries(o)) {
+        result[key] = callback(value);
+    }
+    return result;
+}
+exports.mapValues = mapValues;
+//# sourceMappingURL=lang.js.map

package/internal/util/lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lang.js","sourceRoot":"","sources":["../../src/internal/util/lang.ts"],"names":[],"mappings":";;;AAAA,SAAgB,WAAW,CAAU,OAA6B;IAChE,OAAO,MAAM,CAAC,MAAM,CAClB,EAAE,EACF,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACjC,CAAC,IAAI,CAAC,EAAE,KAAK;KACd,CAAC,CAAC,CACJ,CAAC;AACJ,CAAC;AAPD,kCAOC;AAED,SAAgB,SAAS,CACvB,CAAI,EACJ,QAAuD;IAEvD,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QAC5C,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;KAC/B;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAXD,8BAWC"}

package/internal/util/lazy.d.ts

@@ -0,0 +1,29 @@
+/**
+ * This module provides function to implement proxy-based object, functions, and
+ * classes (they are functions). They receive an initializer function that it's
+ * not used until someone interacts with the lazy element.
+ *
+ * This functions can also be used like a lazy `require`, creating a proxy that
+ * doesn't require the module until needed.
+ *
+ * The disadvantage of using this technique is that the type information is
+ * lost wrt `import`, as `require` returns an `any. If done with enough care,
+ * this can be manually fixed.
+ *
+ * TypeScript doesn't emit `require` calls for modules that are imported only
+ * because of their types. So if one uses lazyObject or lazyFunction along with
+ * a normal ESM import you can pass the module's type to this function.
+ *
+ * An example of this can be:
+ *
+ *    import findUpT from "find-up";
+ *    export const findUp = lazyFunction<typeof findUpT>(() => require("find-up"));
+ *
+ * You can also use it with named exports:
+ *
+ *    import { EthT } from "web3x/eth";
+ *    const Eth = lazyFunction<typeof EthT>(() => require("web3x/eth").Eth);
+ */
+export declare function lazyObject<T extends object>(objectCreator: () => T): T;
+export declare function lazyFunction<T extends Function>(functionCreator: () => T): T;
+//# sourceMappingURL=lazy.d.ts.map

package/internal/util/lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../src/internal/util/lazy.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,CA+BtE;AAGD,wBAAgB,YAAY,CAAC,CAAC,SAAS,QAAQ,EAAE,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,CA8B5E"}

package/internal/util/lazy.js

@@ -0,0 +1,189 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lazyFunction = exports.lazyObject = void 0;
+const util_1 = __importDefault(require("util"));
+const errors_1 = require("../core/errors");
+const errors_list_1 = require("../core/errors-list");
+const inspect = Symbol.for("nodejs.util.inspect.custom");
+/**
+ * This module provides function to implement proxy-based object, functions, and
+ * classes (they are functions). They receive an initializer function that it's
+ * not used until someone interacts with the lazy element.
+ *
+ * This functions can also be used like a lazy `require`, creating a proxy that
+ * doesn't require the module until needed.
+ *
+ * The disadvantage of using this technique is that the type information is
+ * lost wrt `import`, as `require` returns an `any. If done with enough care,
+ * this can be manually fixed.
+ *
+ * TypeScript doesn't emit `require` calls for modules that are imported only
+ * because of their types. So if one uses lazyObject or lazyFunction along with
+ * a normal ESM import you can pass the module's type to this function.
+ *
+ * An example of this can be:
+ *
+ *    import findUpT from "find-up";
+ *    export const findUp = lazyFunction<typeof findUpT>(() => require("find-up"));
+ *
+ * You can also use it with named exports:
+ *
+ *    import { EthT } from "web3x/eth";
+ *    const Eth = lazyFunction<typeof EthT>(() => require("web3x/eth").Eth);
+ */
+function lazyObject(objectCreator) {
+    return createLazyProxy(objectCreator, (getRealTarget) => ({
+        [inspect](depth, options, inspectFn = util_1.default.inspect) {
+            const realTarget = getRealTarget();
+            const newOptions = { ...options, depth };
+            return inspectFn(realTarget, newOptions);
+        },
+    }), (object) => {
+        if (object instanceof Function) {
+            throw new errors_1.HardhatError(errors_list_1.ERRORS.GENERAL.UNSUPPORTED_OPERATION, {
+                operation: "Creating lazy functions or classes with lazyObject",
+            });
+        }
+        if (typeof object !== "object" || object === null) {
+            throw new errors_1.HardhatError(errors_list_1.ERRORS.GENERAL.UNSUPPORTED_OPERATION, {
+                operation: "Using lazyObject with anything other than objects",
+            });
+        }
+    });
+}
+exports.lazyObject = lazyObject;
+// eslint-disable-next-line @typescript-eslint/ban-types
+function lazyFunction(functionCreator) {
+    return createLazyProxy(functionCreator, (getRealTarget) => {
+        function dummyTarget() { }
+        dummyTarget[inspect] = function (depth, options, inspectFn = util_1.default.inspect) {
+            const realTarget = getRealTarget();
+            const newOptions = { ...options, depth };
+            return inspectFn(realTarget, newOptions);
+        };
+        return dummyTarget;
+    }, (object) => {
+        if (!(object instanceof Function)) {
+            throw new errors_1.HardhatError(errors_list_1.ERRORS.GENERAL.UNSUPPORTED_OPERATION, {
+                operation: "Using lazyFunction with anything other than functions or classes",
+            });
+        }
+    });
+}
+exports.lazyFunction = lazyFunction;
+function createLazyProxy(targetCreator, dummyTargetCreator, validator) {
+    let realTarget;
+    const dummyTarget = dummyTargetCreator(getRealTarget);
+    function getRealTarget() {
+        if (realTarget === undefined) {
+            const target = targetCreator();
+            validator(target);
+            // We copy all properties. We won't use them, but help us avoid Proxy
+            // invariant violations
+            const properties = Object.getOwnPropertyNames(target);
+            for (const property of properties) {
+                const descriptor = Object.getOwnPropertyDescriptor(target, property);
+                Object.defineProperty(dummyTarget, property, descriptor);
+            }
+            Object.setPrototypeOf(dummyTarget, Object.getPrototypeOf(target));
+            // Using a null prototype seems to tirgger a V8 bug, so we forbid it
+            // See: https://github.com/nodejs/node/issues/29730
+            if (Object.getPrototypeOf(target) === null) {
+                throw new errors_1.HardhatError(errors_list_1.ERRORS.GENERAL.UNSUPPORTED_OPERATION, {
+                    operation: "Using lazyFunction or lazyObject to construct objects/functions with prototype null",
+                });
+            }
+            if (!Object.isExtensible(target)) {
+                Object.preventExtensions(dummyTarget);
+            }
+            realTarget = target;
+        }
+        return realTarget;
+    }
+    const handler = {
+        defineProperty(target, property, descriptor) {
+            Reflect.defineProperty(dummyTarget, property, descriptor);
+            return Reflect.defineProperty(getRealTarget(), property, descriptor);
+        },
+        deleteProperty(target, property) {
+            Reflect.deleteProperty(dummyTarget, property);
+            return Reflect.deleteProperty(getRealTarget(), property);
+        },
+        get(target, property, receiver) {
+            // We have this short-circuit logic here to avoid a cyclic require when
+            // loading Web3.js.
+            //
+            // If a lazy object is somehow accessed while its real target is being
+            // created, it would trigger an endless loop of recreation, which node
+            // detects and resolve to an empty object.
+            //
+            // This happens with Web3.js because we a lazyObject that loads it,
+            // and expose it as `global.web3`. This Web3.js file accesses
+            // `global.web3` when it's being loaded, triggering the loop we mentioned
+            // before: https://github.com/ethereum/web3.js/blob/8574bd3bf11a2e9cf4bcf8850cab13e1db56653f/packages/web3-core-requestmanager/src/givenProvider.js#L41
+            //
+            // We just return `undefined` in that case, to not enter into the loop.
+            //
+            // **SUPER IMPORTANT NOTE:** Removing this is very tempting, I know. This
+            // is a horrible hack. The most obvious approach for doing so is to
+            // remove the `global` elements that trigger this crazy behavior right
+            // before doing our `require("web3")`, and restore them afterwards.
+            // **THIS IS NOT ENOUGH** Users, and libraries (!!!!), will have their own
+            // `require`s that we can't control and will trigger the same bug.
+            const stack = new Error().stack;
+            if (stack !== undefined &&
+                stack.includes("givenProvider.js") &&
+                realTarget === undefined) {
+                return undefined;
+            }
+            return Reflect.get(getRealTarget(), property, receiver);
+        },
+        getOwnPropertyDescriptor(target, property) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(getRealTarget(), property);
+            if (descriptor !== undefined) {
+                Object.defineProperty(dummyTarget, property, descriptor);
+            }
+            return descriptor;
+        },
+        getPrototypeOf(_target) {
+            return Reflect.getPrototypeOf(getRealTarget());
+        },
+        has(target, property) {
+            return Reflect.has(getRealTarget(), property);
+        },
+        isExtensible(_target) {
+            return Reflect.isExtensible(getRealTarget());
+        },
+        ownKeys(_target) {
+            return Reflect.ownKeys(getRealTarget());
+        },
+        preventExtensions(_target) {
+            Object.preventExtensions(dummyTarget);
+            return Reflect.preventExtensions(getRealTarget());
+        },
+        set(target, property, value, receiver) {
+            Reflect.set(dummyTarget, property, value, receiver);
+            return Reflect.set(getRealTarget(), property, value, receiver);
+        },
+        setPrototypeOf(target, prototype) {
+            Reflect.setPrototypeOf(dummyTarget, prototype);
+            return Reflect.setPrototypeOf(getRealTarget(), prototype);
+        },
+    };
+    if (dummyTarget instanceof Function) {
+        // If dummy target is a function, the actual target must be a function too.
+        handler.apply = (target, thisArg, argArray) => {
+            // eslint-disable-next-line @typescript-eslint/ban-types
+            return Reflect.apply(getRealTarget(), thisArg, argArray);
+        };
+        handler.construct = (target, argArray, _newTarget) => {
+            // eslint-disable-next-line @typescript-eslint/ban-types
+            return Reflect.construct(getRealTarget(), argArray);
+        };
+    }
+    return new Proxy(dummyTarget, handler);
+}
+//# sourceMappingURL=lazy.js.map

package/internal/util/lazy.js.map

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

package/internal/util/multi-process-mutex.d.ts

@@ -0,0 +1,12 @@
+export declare class MultiProcessMutex {
+    private _mutexFilePath;
+    private _mutexLifespanInMs;
+    constructor(mutexName: string, maxMutexLifespanInMs?: number);
+    use<T>(f: () => Promise<T>): Promise<T>;
+    private _tryToAcquireMutex;
+    private _executeFunctionAndReleaseMutex;
+    private _isMutexFileTooOld;
+    private _deleteMutexFile;
+    private _waitMs;
+}
+//# sourceMappingURL=multi-process-mutex.d.ts.map

package/internal/util/multi-process-mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-process-mutex.d.ts","sourceRoot":"","sources":["../../src/internal/util/multi-process-mutex.ts"],"names":[],"mappings":"AAoBA,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAS;gBAEvB,SAAS,EAAE,MAAM,EAAE,oBAAoB,CAAC,EAAE,MAAM;IAQ/C,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;YAuBtC,kBAAkB;YAelB,+BAA+B;IAuB7C,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,gBAAgB;YAcV,OAAO;CAKtB"}

package/internal/util/multi-process-mutex.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiProcessMutex = void 0;
+/* eslint-disable @nomicfoundation/hardhat-internal-rules/only-hardhat-error */
+const debug_1 = __importDefault(require("debug"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+// Logic explanation: the fs.writeFile function, when used with the wx+ flag, performs an atomic operation to create a file.
+// If multiple processes try to create the same file simultaneously, only one will succeed.
+// This logic can be utilized to implement a mutex.
+// ATTENTION: in the current implementation, there's still a risk of two processes running simultaneously.
+// For example, if processA has locked the mutex and is running, processB will wait.
+// During this wait, processB continuously checks the elapsed time since the mutex lock file was created.
+// If an excessive amount of time has passed, processB will assume ownership of the mutex to avoid stale locks.
+// However, there's a possibility that processB might take ownership because the mutex creation file is outdated, even though processA is still running
+// For more info check the Nomic Notion page (internal link).
+const log = (0, debug_1.default)("hardhat:util:multi-process-mutex");
+const DEFAULT_MAX_MUTEX_LIFESPAN_IN_MS = 60000;
+const MUTEX_LOOP_WAITING_TIME_IN_MS = 100;
+class MultiProcessMutex {
+    constructor(mutexName, maxMutexLifespanInMs) {
+        log(`Creating mutex with name '${mutexName}'`);
+        this._mutexFilePath = node_path_1.default.join(node_os_1.default.tmpdir(), `${mutexName}.txt`);
+        this._mutexLifespanInMs =
+            maxMutexLifespanInMs ?? DEFAULT_MAX_MUTEX_LIFESPAN_IN_MS;
+    }
+    async use(f) {
+        log(`Starting mutex process with mutex file '${this._mutexFilePath}'`);
+        while (true) {
+            if (await this._tryToAcquireMutex()) {
+                // Mutex has been acquired
+                return this._executeFunctionAndReleaseMutex(f);
+            }
+            // Mutex not acquired
+            if (this._isMutexFileTooOld()) {
+                // If the mutex file is too old, it likely indicates a stale lock, so the file should be removed
+                log(`Current mutex file is too old, removing it at path '${this._mutexFilePath}'`);
+                this._deleteMutexFile();
+            }
+            else {
+                // wait
+                await this._waitMs();
+            }
+        }
+    }
+    async _tryToAcquireMutex() {
+        try {
+            // Create a file only if it does not exist
+            node_fs_1.default.writeFileSync(this._mutexFilePath, "", { flag: "wx+" });
+            return true;
+        }
+        catch (error) {
+            if (error.code === "EEXIST") {
+                // File already exists, so the mutex is already acquired
+                return false;
+            }
+            throw error;
+        }
+    }
+    async _executeFunctionAndReleaseMutex(f) {
+        log(`Mutex acquired at path '${this._mutexFilePath}'`);
+        try {
+            const res = await f();
+            // Release the mutex
+            log(`Mutex released at path '${this._mutexFilePath}'`);
+            this._deleteMutexFile();
+            log(`Mutex released at path '${this._mutexFilePath}'`);
+            return res;
+        }
+        catch (error) {
+            // Catch any error to avoid stale locks.
+            // Remove the mutex file and re-throw the error
+            this._deleteMutexFile();
+            throw error;
+        }
+    }
+    _isMutexFileTooOld() {
+        let fileStat;
+        try {
+            fileStat = node_fs_1.default.statSync(this._mutexFilePath);
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                // The file might have been deleted by another process while this function was trying to access it.
+                return false;
+            }
+            throw error;
+        }
+        const now = new Date();
+        const fileDate = new Date(fileStat.ctime);
+        const diff = now.getTime() - fileDate.getTime();
+        return diff > this._mutexLifespanInMs;
+    }
+    _deleteMutexFile() {
+        try {
+            log(`Deleting mutex file at path '${this._mutexFilePath}'`);
+            node_fs_1.default.unlinkSync(this._mutexFilePath);
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                // The file might have been deleted by another process while this function was trying to access it.
+                return;
+            }
+            throw error;
+        }
+    }
+    async _waitMs() {
+        return new Promise((resolve) => setTimeout(resolve, MUTEX_LOOP_WAITING_TIME_IN_MS));
+    }
+}
+exports.MultiProcessMutex = MultiProcessMutex;
+//# sourceMappingURL=multi-process-mutex.js.map