hardhat 3.9.0 → 3.9.1

package/dist/src/internal/cli/parser.js

@@ -0,0 +1,282 @@
+import { HardhatError, assertHardhatInvariant, } from "@nomicfoundation/hardhat-errors";
+import { isCi } from "@nomicfoundation/hardhat-utils/ci";
+import { kebabToCamelCase } from "@nomicfoundation/hardhat-utils/string";
+import { ArgumentType, } from "../../types/arguments.js";
+import { parseArgumentValue } from "../core/arguments.js";
+import { isArgumentRequired } from "../core/tasks/utils.js";
+export async function parseBuiltinGlobalOptions(cliArguments, usedCliArguments) {
+    let configPath;
+    let showStackTraces = isCi();
+    let help = false;
+    let version = false;
+    let init = false;
+    // TODO: Use parseGlobalOptions(BUILTIN_GLOBAL_OPTIONS_DEFINITIONS, ...) instead
+    for (let i = 0; i < cliArguments.length; i++) {
+        const arg = cliArguments[i];
+        if (arg === "--init") {
+            usedCliArguments[i] = true;
+            init = true;
+            continue;
+        }
+        if (arg === "--config") {
+            usedCliArguments[i] = true;
+            if (configPath !== undefined) {
+                throw new HardhatError(HardhatError.ERRORS.CORE.ARGUMENTS.DUPLICATED_NAME, {
+                    name: "--config",
+                });
+            }
+            if (usedCliArguments[i + 1] === undefined ||
+                usedCliArguments[i + 1] === true) {
+                throw new HardhatError(HardhatError.ERRORS.CORE.ARGUMENTS.MISSING_CONFIG_FILE);
+            }
+            configPath = cliArguments[i + 1];
+            i++;
+            usedCliArguments[i] = true;
+            continue;
+        }
+        if (arg === "--show-stack-traces") {
+            usedCliArguments[i] = true;
+            showStackTraces = true;
+            continue;
+        }
+        if (arg === "--help" || arg === "-h") {
+            usedCliArguments[i] = true;
+            help = true;
+            continue;
+        }
+        if (arg === "--version") {
+            usedCliArguments[i] = true;
+            version = true;
+            continue;
+        }
+    }
+    if (init && configPath !== undefined) {
+        throw new HardhatError(HardhatError.ERRORS.CORE.ARGUMENTS.CANNOT_COMBINE_INIT_AND_CONFIG_PATH);
+    }
+    return { init, configPath, showStackTraces, help, version };
+}
+export async function parseGlobalOptions(globalOptionDefinitions, cliArguments, usedCliArguments) {
+    const globalOptions = {};
+    const optionDefinitions = new Map([...globalOptionDefinitions].map(([key, value]) => [key, value.option]));
+    parseOptions(cliArguments, usedCliArguments, optionDefinitions, globalOptions, true);
+    return globalOptions;
+}
+/**
+ * Parses the task from the cli args.
+ *
+ * @returns The task, or an array with the unrecognized task id.
+ * If no task id is provided, an empty array is returned.
+ */
+export function parseTask(cliArguments, usedCliArguments, tasksMap) {
+    const taskOrId = getTaskFromCliArguments(cliArguments, usedCliArguments, tasksMap);
+    return taskOrId;
+}
+function getTaskFromCliArguments(cliArguments, usedCliArguments, tasksMap) {
+    const taskId = [];
+    let task;
+    for (let i = 0; i < cliArguments.length; i++) {
+        if (usedCliArguments[i]) {
+            continue;
+        }
+        const arg = cliArguments[i];
+        if (arg.startsWith("-")) {
+            /* A standalone '--' is ok because it is used to separate CLI tool arguments
+             * from task arguments, ensuring the tool passes subsequent options directly
+             * to the task. Everything after "--" should be considered as a positional
+             * argument. */
+            if (arg === "--" || task !== undefined) {
+                break;
+            }
+            /* At this point in the code, the global options have already been parsed, so
+             * the remaining options starting with '--' are task options. Hence, if no task
+             * is defined, it means that the option is not assigned to any task, and it's
+             * an error. */
+            throw new HardhatError(HardhatError.ERRORS.CORE.ARGUMENTS.UNRECOGNIZED_OPTION, {
+                option: arg,
+            });
+        }
+        if (task === undefined) {
+            task = tasksMap.get(arg);
+            if (task === undefined) {
+                return [arg]; // No task found
+            }
+        }
+        else {
+            const subtask = task.subtasks.get(arg);
+            if (subtask === undefined) {
+                break;
+            }
+            task = subtask;
+        }
+        usedCliArguments[i] = true;
+        taskId.push(arg);
+    }
+    if (task === undefined) {
+        return taskId;
+    }
+    return task;
+}
+export function parseTaskArguments(cliArguments, usedCliArguments, task) {
+    const taskArguments = {};
+    // Parse options
+    parseOptions(cliArguments, usedCliArguments, task.options, taskArguments);
+    parsePositionalAndVariadicArguments(cliArguments, usedCliArguments, task, taskArguments);
+    const unusedIndex = usedCliArguments.indexOf(false);
+    if (unusedIndex !== -1) {
+        throw new HardhatError(HardhatError.ERRORS.CORE.ARGUMENTS.UNUSED_ARGUMENT, {
+            value: cliArguments[unusedIndex],
+        });
+    }
+    return taskArguments;
+}
+/**
+ * Parses the raw arguments from the command line, returning an array of
+ * arguments. If an argument starts with "--" and contains "=" (i.e. "--option=123")
+ * it is split into two separate arguments: the option name and the option value.
+ */
+export function parseRawArguments(rawArguments) {
+    return rawArguments.flatMap((arg) => {
+        if (arg.startsWith("--") && arg.includes("=")) {
+            const index = arg.indexOf("=");
+            const optionName = arg.substring(0, index);
+            const optionValue = arg.substring(index + 1);
+            return [optionName, optionValue];
+        }
+        return arg;
+    });
+}
+function parseOptions(cliArguments, usedCliArguments, optionDefinitions, providedArguments, ignoreUnknownOption = false) {
+    const optionDefinitionsByShortName = new Map();
+    for (const optionDefinition of optionDefinitions.values()) {
+        if (optionDefinition.shortName !== undefined) {
+            optionDefinitionsByShortName.set(optionDefinition.shortName, optionDefinition);
+        }
+    }
+    for (let i = 0; i < cliArguments.length; i++) {
+        if (usedCliArguments[i]) {
+            continue;
+        }
+        if (cliArguments[i] === "--") {
+            /* A standalone '--' is ok because it is used to separate CLI tool arguments
+             * from task arguments, ensuring the tool passes subsequent options directly
+             * to the task. Everything after "--" should be considered as a positional
+             * argument. */
+            break;
+        }
+        const arg = cliArguments[i];
+        let optionDefinition;
+        const providedByName = arg.startsWith("--");
+        const providedByShortName = !providedByName && arg.startsWith("-");
+        if (providedByName) {
+            const name = kebabToCamelCase(arg.substring(2));
+            optionDefinition = optionDefinitions.get(name);
+        }
+        else if (providedByShortName) {
+            const shortName = arg[1];
+            // Check if the short name is valid
+            if (Array.from(arg.substring(1)).some((c) => c !== shortName)) {
+                throw new HardhatError(HardhatError.ERRORS.CORE.ARGUMENTS.CANNOT_GROUP_OPTIONS, {
+                    option: arg,
+                });
+            }
+            optionDefinition = optionDefinitionsByShortName.get(shortName);
+        }
+        else {
+            continue;
+        }
+        if (optionDefinition === undefined) {
+            if (ignoreUnknownOption === true) {
+                continue;
+            }
+            // Only throw an error when the argument is not a global option, because
+            // it might be a option related to a task
+            throw new HardhatError(HardhatError.ERRORS.CORE.ARGUMENTS.UNRECOGNIZED_OPTION, {
+                option: arg,
+            });
+        }
+        if (optionDefinition.hidden === true) {
+            throw new HardhatError(HardhatError.ERRORS.CORE.ARGUMENTS.NO_HIDDEN_OPTION_CLI, {
+                option: arg,
+            });
+        }
+        const optionName = optionDefinition.name;
+        // Check if the short name is valid again now that we know its type
+        // E.g. --flag --flag
+        const optionAlreadyProvided = providedArguments[optionName] !== undefined;
+        // E.g. -ff
+        const shortOptionGroupedAndRepeated = providedByShortName && arg.length > 2;
+        const isLevelOption = optionDefinition.type === ArgumentType.LEVEL;
+        if (optionAlreadyProvided ||
+            (shortOptionGroupedAndRepeated && !isLevelOption)) {
+            throw new HardhatError(HardhatError.ERRORS.CORE.ARGUMENTS.CANNOT_REPEAT_OPTIONS, {
+                option: arg,
+                type: optionDefinition.type,
+            });
+        }
+        usedCliArguments[i] = true;
+        if (optionDefinition.type === ArgumentType.FLAG) {
+            providedArguments[optionName] = true;
+            continue;
+        }
+        else if (optionDefinition.type === ArgumentType.LEVEL &&
+            providedByShortName) {
+            providedArguments[optionName] = arg.length - 1;
+            continue;
+        }
+        else if (usedCliArguments[i + 1] !== undefined &&
+            usedCliArguments[i + 1] === false) {
+            i++;
+            providedArguments[optionName] = parseArgumentValue(cliArguments[i], optionDefinition.type, optionName);
+            usedCliArguments[i] = true;
+            continue;
+        }
+        throw new HardhatError(HardhatError.ERRORS.CORE.ARGUMENTS.MISSING_VALUE_FOR_ARGUMENT, {
+            argument: arg,
+        });
+    }
+}
+function parsePositionalAndVariadicArguments(cliArguments, usedCliArguments, task, providedArguments) {
+    let argIndex = 0;
+    for (let i = 0; i < cliArguments.length; i++) {
+        if (usedCliArguments[i] === true) {
+            continue;
+        }
+        if (cliArguments[i] === "--") {
+            /* A standalone '--' is ok because it is used to separate CLI tool arguments
+             * from task arguments, ensuring the tool passes subsequent options directly
+             * to the task. Everything after "--" should be considered as a positional
+             * argument. */
+            usedCliArguments[i] = true;
+            continue;
+        }
+        const argumentDefinition = task.positionalArguments[argIndex];
+        if (argumentDefinition === undefined) {
+            break;
+        }
+        usedCliArguments[i] = true;
+        const formattedValue = parseArgumentValue(cliArguments[i], argumentDefinition.type, argumentDefinition.name);
+        if (argumentDefinition.isVariadic === false) {
+            providedArguments[argumentDefinition.name] = formattedValue;
+            argIndex++;
+            continue;
+        }
+        // Handle variadic arguments. No longer increment "argIndex" because there can
+        // only be one variadic argument, and it will consume all remaining arguments.
+        providedArguments[argumentDefinition.name] =
+            providedArguments[argumentDefinition.name] ?? [];
+        const variadicTaskArg = providedArguments[argumentDefinition.name];
+        assertHardhatInvariant(Array.isArray(variadicTaskArg), "Variadic argument values should be an array");
+        variadicTaskArg.push(formattedValue);
+    }
+    // Check if all the required arguments have been used
+    validateRequiredArguments(task.positionalArguments, providedArguments);
+}
+function validateRequiredArguments(argumentDefinitions, taskArguments) {
+    const missingRequiredArgument = argumentDefinitions.find(({ defaultValue, name, type }) => isArgumentRequired(type, defaultValue) &&
+        taskArguments[name] === undefined);
+    if (missingRequiredArgument === undefined) {
+        return;
+    }
+    throw new HardhatError(HardhatError.ERRORS.CORE.ARGUMENTS.MISSING_VALUE_FOR_ARGUMENT, { argument: missingRequiredArgument.name });
+}
+//# sourceMappingURL=parser.js.map

package/dist/src/internal/cli/parser.js.map

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

package/dist/src/internal/cli/telemetry/analytics/analytics.d.ts

@@ -1,4 +1,4 @@
 export declare function sendTelemetryConfigAnalytics(enabled: boolean): Promise<boolean>;
-export declare function sendTaskAnalytics(taskId: string[]): Promise<boolean>;
+export declare function sendTaskAnalytics(taskId: string[], command: "hardhat" | "hhu"): Promise<boolean>;
 export declare function sendProjectTypeAnalytics(hardhatVersion: "hardhat-2" | "hardhat-3", template: string): Promise<boolean>;
 //# sourceMappingURL=analytics.d.ts.map

package/dist/src/internal/cli/telemetry/analytics/analytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/cli/telemetry/analytics/analytics.ts"],"names":[],"mappings":"AAyBA,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAS1E;AAED,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,WAAW,GAAG,WAAW,EACzC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAUlB"}
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/cli/telemetry/analytics/analytics.ts"],"names":[],"mappings":"AAyBA,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,SAAS,GAAG,KAAK,GACzB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,WAAW,GAAG,WAAW,EACzC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/src/internal/cli/telemetry/analytics/analytics.js

@@ -30,11 +30,12 @@ export async function sendTelemetryConfigAnalytics(enabled) {
     await createSubprocessToSendAnalytics(payload);
     return true;
 }
-export async function sendTaskAnalytics(taskId) {
+export async function sendTaskAnalytics(taskId, command) {
     const taskAnalyticsEvent = {
         name: "task",
         params: {
             task: taskId.join(", "),
+            command,
         },
     };
     return await sendAnalytics(taskAnalyticsEvent);

package/dist/src/internal/cli/telemetry/analytics/analytics.js.map

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

package/dist/src/internal/cli/telemetry/analytics/types.d.ts

@@ -28,6 +28,7 @@ export type AnalyticsEvent = {
     name: "task";
     params: {
         task: string;
+        command: "hardhat" | "hhu";
     };
 } | {
     name: "init";

package/dist/src/internal/cli/telemetry/analytics/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/cli/telemetry/analytics/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAGD,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE;YAKN,oBAAoB,CAAC,EAAE,MAAM,CAAC;YAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,iBAAiB,CAAC;QACxB,MAAM,EAAE;YACN,OAAO,EAAE,OAAO,CAAC;YACjB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC,CAAC;CACJ;AAED,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,cAAc,EAAE,WAAW,GAAG,WAAW,CAAC;QAC1C,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAEN,MAAM,WAAW,OAAQ,SAAQ,WAAW;IAC1C,eAAe,EAAE;QACf,SAAS,EAAE;YACT,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,cAAc,EAAE;YACd,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,eAAe,EAAE;YACf,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,WAAW,EAAE;YACX,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;IACF,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,EAAE;YACN,oBAAoB,EAAE,MAAM,CAAC;YAC7B,UAAU,EAAE,MAAM,CAAC;SACpB,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;KAC9B,CAAC,CAAC;CACJ"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/cli/telemetry/analytics/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAGD,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE;YAKN,oBAAoB,CAAC,EAAE,MAAM,CAAC;YAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,iBAAiB,CAAC;QACxB,MAAM,EAAE;YACN,OAAO,EAAE,OAAO,CAAC;YACjB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC,CAAC;CACJ;AAED,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QAGb,OAAO,EAAE,SAAS,GAAG,KAAK,CAAC;KAC5B,CAAC;CACH,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,cAAc,EAAE,WAAW,GAAG,WAAW,CAAC;QAC1C,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAEN,MAAM,WAAW,OAAQ,SAAQ,WAAW;IAC1C,eAAe,EAAE;QACf,SAAS,EAAE;YACT,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,cAAc,EAAE;YACd,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,eAAe,EAAE;YACf,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,WAAW,EAAE;YACX,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;IACF,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,EAAE;YACN,oBAAoB,EAAE,MAAM,CAAC;YAC7B,UAAU,EAAE,MAAM,CAAC;SACpB,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;KAC9B,CAAC,CAAC;CACJ"}

package/dist/src/internal/using-hardhat2-plugin-errors.d.ts

@@ -1,7 +1,7 @@
 import { CustomError } from "@nomicfoundation/hardhat-utils/error";
 export declare class UsingHardhat2PluginError extends CustomError {
     readonly callerRelativePath: string | undefined;
-    constructor();
+    constructor(apiName: string, migrationHint?: string);
 }
 /**
  * Returns the relative path of the file that called a deprecated Hardhat
@@ -31,5 +31,5 @@ export declare class UsingHardhat2PluginError extends CustomError {
  * Calling getCallerRelativePath() returns 'plugins/example-plugin/index.js'
  */
 export declare function getCallerRelativePath(depth?: number): string | undefined;
-export declare function throwUsingHardhat2PluginError(): never;
+export declare function throwUsingHardhat2PluginError(apiName: string, migrationHint?: string): never;
 //# sourceMappingURL=using-hardhat2-plugin-errors.d.ts.map

package/dist/src/internal/using-hardhat2-plugin-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"using-hardhat2-plugin-errors.d.ts","sourceRoot":"","sources":["../../../src/internal/using-hardhat2-plugin-errors.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAGnE,qBAAa,wBAAyB,SAAQ,WAAW;IACvD,SAAgB,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;;CAqBxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,GAAE,MAAU,GAAG,MAAM,GAAG,SAAS,CAyC3E;AAED,wBAAgB,6BAA6B,IAAI,KAAK,CAIrD"}
+{"version":3,"file":"using-hardhat2-plugin-errors.d.ts","sourceRoot":"","sources":["../../../src/internal/using-hardhat2-plugin-errors.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAGnE,qBAAa,wBAAyB,SAAQ,WAAW;IACvD,SAAgB,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;gBAC3C,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;CA0BpD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,GAAE,MAAU,GAAG,MAAM,GAAG,SAAS,CAyC3E;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,KAAK,CAIP"}

package/dist/src/internal/using-hardhat2-plugin-errors.js

@@ -4,7 +4,7 @@ import { CustomError } from "@nomicfoundation/hardhat-utils/error";
 import { shortenPath } from "@nomicfoundation/hardhat-utils/path";
 export class UsingHardhat2PluginError extends CustomError {
     callerRelativePath;
-    constructor() {
+    constructor(apiName, migrationHint) {
         const callerPath = getCallerRelativePath();
         let message;
         if (callerPath !== undefined) {
@@ -15,6 +15,10 @@ This file is part of a Hardhat 2 plugin calling an API that was removed in Hardh
         else {
             message = `You are trying to use a Hardhat 2 plugin in a Hardhat 3 project.`;
         }
+        message += `\n\nThe removed API is: ${styleText("bold", apiName)}.`;
+        if (migrationHint !== undefined) {
+            message += `\n\n${migrationHint}`;
+        }
         super(message);
         // Use a non-enumerable property so that `console.error(error)` does not
         // print `{ callerRelativePath: '…' }` after the stack trace.
@@ -87,9 +91,9 @@ export function getCallerRelativePath(depth = 5) {
         return undefined;
     }
 }
-export function throwUsingHardhat2PluginError() {
+export function throwUsingHardhat2PluginError(apiName, migrationHint) {
     /* eslint-disable-next-line no-restricted-syntax -- Intentionally throwing a
       custom error here so that we always print the stack trace */
-    throw new UsingHardhat2PluginError();
+    throw new UsingHardhat2PluginError(apiName, migrationHint);
 }
 //# sourceMappingURL=using-hardhat2-plugin-errors.js.map

package/dist/src/internal/using-hardhat2-plugin-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"using-hardhat2-plugin-errors.js","sourceRoot":"","sources":["../../../src/internal/using-hardhat2-plugin-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAElE,MAAM,OAAO,wBAAyB,SAAQ,WAAW;IACvC,kBAAkB,CAAqB;IACvD;QACE,MAAM,UAAU,GAAG,qBAAqB,EAAE,CAAC;QAE3C,IAAI,OAAe,CAAC;QACpB,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,GAAG;;wFAEwE,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;QACpH,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,kEAAkE,CAAC;QAC/E,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,wEAAwE;QACxE,6DAA6D;QAC7D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,EAAE;YAChD,KAAK,EAAE,UAAU;YACjB,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED;;;;;;;;WAQG;QACH,MAAM,sBAAsB,GAC1B,iDAAiD,CAAC;QAEpD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC9D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC7C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAExB,4CAA4C;QAC5C,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C;kEAC8D;IAC9D,MAAM,IAAI,wBAAwB,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"using-hardhat2-plugin-errors.js","sourceRoot":"","sources":["../../../src/internal/using-hardhat2-plugin-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAElE,MAAM,OAAO,wBAAyB,SAAQ,WAAW;IACvC,kBAAkB,CAAqB;IACvD,YAAY,OAAe,EAAE,aAAsB;QACjD,MAAM,UAAU,GAAG,qBAAqB,EAAE,CAAC;QAE3C,IAAI,OAAe,CAAC;QACpB,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,GAAG;;wFAEwE,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;QACpH,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,kEAAkE,CAAC;QAC/E,CAAC;QAED,OAAO,IAAI,2BAA2B,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC;QAEpE,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,IAAI,OAAO,aAAa,EAAE,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,wEAAwE;QACxE,6DAA6D;QAC7D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,EAAE;YAChD,KAAK,EAAE,UAAU;YACjB,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED;;;;;;;;WAQG;QACH,MAAM,sBAAsB,GAC1B,iDAAiD,CAAC;QAEpD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC9D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC7C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAExB,4CAA4C;QAC5C,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,OAAe,EACf,aAAsB;IAEtB;kEAC8D;IAC9D,MAAM,IAAI,wBAAwB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAC7D,CAAC"}

package/dist/src/plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKxD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAGjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,KAAK,EAAE,GAAG,GAAG,GAAG,CAE/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,KAAK,EAAE,GAAG,GAAG,GAAG,CAE7C"}
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAGjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,KAAK,EAAE,GAAG,GAAG,GAAG,CAE/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,KAAK,EAAE,GAAG,GAAG,GAAG,CAE7C"}

package/dist/src/plugins.js

@@ -1,6 +1,7 @@
 export { HardhatPluginError } from "@nomicfoundation/hardhat-errors";
 import { registerLoadedPlugin } from "./internal/core/plugins/loaded-plugins-registry.js";
 import { throwUsingHardhat2PluginError } from "./internal/using-hardhat2-plugin-errors.js";
+const LAZY_LOADING_MIGRATION_HINT = "To migrate a plugin to Hardhat 3, export a plugin object with definePlugin from hardhat/plugins and register lazy-loaded logic through dependencies, hook handlers, and task actions.";
 /**
  * Defines a Hardhat plugin.
  *
@@ -20,12 +21,12 @@ export function definePlugin(plugin) {
  * @deprecated This function is part of the Hardhat 2 plugin API.
  */
 export function lazyFunction(..._args) {
-    throwUsingHardhat2PluginError();
+    throwUsingHardhat2PluginError("lazyFunction", LAZY_LOADING_MIGRATION_HINT);
 }
 /**
  * @deprecated This function is part of the Hardhat 2 plugin API.
  */
 export function lazyObject(..._args) {
-    throwUsingHardhat2PluginError();
+    throwUsingHardhat2PluginError("lazyObject", LAZY_LOADING_MIGRATION_HINT);
 }
 //# sourceMappingURL=plugins.js.map

package/dist/src/plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAIrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC;AAC1F,OAAO,EAAE,6BAA6B,EAAE,MAAM,4CAA4C,CAAC;AAE3F;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAG,KAAU;IACxC,6BAA6B,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAG,KAAU;IACtC,6BAA6B,EAAE,CAAC;AAClC,CAAC"}
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAIrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC;AAC1F,OAAO,EAAE,6BAA6B,EAAE,MAAM,4CAA4C,CAAC;AAE3F,MAAM,2BAA2B,GAC/B,uLAAuL,CAAC;AAE1L;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAG,KAAU;IACxC,6BAA6B,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAG,KAAU;IACtC,6BAA6B,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAAC;AAC3E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hardhat",
-  "version": "3.9.0",
+  "version": "3.9.1",
   "description": "Hardhat is an extensible developer tool that helps smart contract developers increase productivity by reliably bringing together the tools they want.",
   "homepage": "https://hardhat.org",
   "repository": {
@@ -77,9 +77,9 @@
     "@nomicfoundation/hardhat-test-utils": "^2.0.3"
   },
   "dependencies": {
-    "@nomicfoundation/edr": "0.12.0",
-    "@nomicfoundation/hardhat-errors": "^3.0.15",
-    "@nomicfoundation/hardhat-utils": "^4.1.3",
+    "@nomicfoundation/edr": "0.12.1",
+    "@nomicfoundation/hardhat-errors": "^3.0.16",
+    "@nomicfoundation/hardhat-utils": "^4.1.4",
     "@nomicfoundation/hardhat-vendored": "^3.0.4",
     "@nomicfoundation/hardhat-zod-utils": "^3.0.5",
     "@nomicfoundation/solidity-analyzer": "^0.1.1",

package/src/config.ts

@@ -7,6 +7,9 @@ import type { HardhatUserConfig } from "./types/config.js";
 
 import { throwUsingHardhat2PluginError } from "./internal/using-hardhat2-plugin-errors.js";
 
+const DEFINE_PLUGIN_MIGRATION_HINT =
+  "To migrate a plugin to Hardhat 3, export a plugin object with definePlugin from hardhat/plugins and register hook handlers in its hookHandlers field.";
+
 /**
  * Defines a Hardhat user config.
  *
@@ -42,33 +45,42 @@ export function defineConfig(config: HardhatUserConfig): HardhatUserConfig {
  * @deprecated This function is part of the Hardhat 2 plugin API.
  */
 export function extendConfig(..._args: any): any {
-  throwUsingHardhat2PluginError();
+  throwUsingHardhat2PluginError("extendConfig", DEFINE_PLUGIN_MIGRATION_HINT);
 }
 
 /**
  * @deprecated This function is part of the Hardhat 2 plugin API.
  */
 export function extendEnvironment(..._args: any): any {
-  throwUsingHardhat2PluginError();
+  throwUsingHardhat2PluginError(
+    "extendEnvironment",
+    DEFINE_PLUGIN_MIGRATION_HINT,
+  );
 }
 
 /**
  * @deprecated This function is part of the Hardhat 2 plugin API.
  */
 export function extendProvider(..._args: any): any {
-  throwUsingHardhat2PluginError();
+  throwUsingHardhat2PluginError("extendProvider", DEFINE_PLUGIN_MIGRATION_HINT);
 }
 
 /**
  * @deprecated This function is part of the Hardhat 2 plugin API.
  */
 export function scope(..._args: any): any {
-  throwUsingHardhat2PluginError();
+  throwUsingHardhat2PluginError(
+    "scope",
+    "To migrate tasks to Hardhat 3, define them with task or emptyTask from hardhat/config and include them in a plugin exported with definePlugin from hardhat/plugins.",
+  );
 }
 
 /**
  * @deprecated This function is part of the Hardhat 2 plugin API.
  */
 export function subtask(..._args: any): any {
-  throwUsingHardhat2PluginError();
+  throwUsingHardhat2PluginError(
+    "subtask",
+    "To migrate subtasks to Hardhat 3, define them as nested tasks with task or emptyTask from hardhat/config and include them in a plugin exported with definePlugin from hardhat/plugins.",
+  );
 }

package/src/hhu.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+
+import { exitIfNodeVersionNotSupported } from "./internal/cli/node-version.js";
+
+// We enable the sourcemaps before loading main, so that everything except this
+// small file is loaded with sourcemaps enabled.
+process.setSourceMapsEnabled(true);
+
+// We check the Node.js version before loading main, so that if there is some
+// unsupported js syntax or Node API elsewhere, we get to exit with a clear
+// error before crashing.
+exitIfNodeVersionNotSupported();
+
+// eslint-disable-next-line no-restricted-syntax -- Allow top-level await here
+const { main } = await import("./internal/cli/hhu.js");
+
+// eslint-disable-next-line no-restricted-syntax -- We do want TLA here
+await main(process.argv.slice(2));

package/src/internal/builtin-plugins/artifacts/hook-handlers/hre.ts

@@ -4,6 +4,11 @@ import type {
   StringWithArtifactContractNamesAutocompletion,
 } from "../../../../types/artifacts.js";
 import type { HardhatRuntimeEnvironmentHooks } from "../../../../types/hooks.js";
+import type { ArtifactManagerImplementation as ArtifactManagerImplementationT } from "../artifact-manager.js";
+
+let ArtifactManagerImplementation:
+  | typeof ArtifactManagerImplementationT
+  | undefined;
 
 class LazyArtifactManager implements ArtifactManager {
   readonly #artifactsPath: string;
@@ -85,10 +90,13 @@ class LazyArtifactManager implements ArtifactManager {
   }
 
   async #getArtifactManager(): Promise<ArtifactManager> {
-    if (this.#artifactManager === undefined) {
-      const { ArtifactManagerImplementation } = await import(
+    if (ArtifactManagerImplementation === undefined) {
+      ({ ArtifactManagerImplementation } = await import(
         "../artifact-manager.js"
-      );
+      ));
+    }
+
+    if (this.#artifactManager === undefined) {
       this.#artifactManager = new ArtifactManagerImplementation(
         this.#artifactsPath,
       );