hardhat 3.1.9 → 3.1.10

package/dist/src/internal/core/tasks/validations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validations.d.ts","sourceRoot":"","sources":["../../../../../src/internal/core/tasks/validations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AAYrC,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAMtD;AAED,wBAAgB,cAAc,CAC5B,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,gBAAgB,EACzD,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GACxB,IAAI,CA6BN;AAED,wBAAgB,0BAA0B,CACxC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,4BAA4B,EACtE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EACzB,OAAO,CAAC,EAAE,4BAA4B,GACrC,IAAI,CA0CN;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,aAAa,GAAG,aAAa,EAAE,EACtC,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GACxB,IAAI,CAuBN"}
+{"version":3,"file":"validations.d.ts","sourceRoot":"","sources":["../../../../../src/internal/core/tasks/validations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,0BAA0B,EAC3B,MAAM,yBAAyB,CAAC;AAYjC,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAMtD;AAED,wBAAgB,cAAc,CAC5B,MAAM,EACF,gBAAgB,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,GACtD,gBAAgB,CAAC,0BAA0B,CAAC,aAAa,CAAC,CAAC,GAC3D,SAAS,EACb,YAAY,EACR,qBAAqB,CAAC,aAAa,CAAC,GACpC,0BAA0B,CAAC,aAAa,CAAC,GACzC,SAAS,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,OAAO,GAChB,IAAI,CAqBN;AAED,wBAAgB,cAAc,CAC5B,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,gBAAgB,EACzD,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GACxB,IAAI,CA6BN;AAED,wBAAgB,0BAA0B,CACxC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,4BAA4B,EACtE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EACzB,OAAO,CAAC,EAAE,4BAA4B,GACrC,IAAI,CA0CN;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,aAAa,GAAG,aAAa,EAAE,EACtC,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GACxB,IAAI,CAuBN"}

package/dist/src/internal/core/tasks/validations.js

@@ -6,6 +6,17 @@ export function validateId(id) {
         throw new HardhatError(HardhatError.ERRORS.CORE.TASK_DEFINITIONS.EMPTY_TASK_ID);
     }
 }
+export function validateAction(action, inlineAction, taskId, isPlugin) {
+    if (isPlugin && inlineAction !== undefined) {
+        throw new HardhatError(HardhatError.ERRORS.CORE.TASK_DEFINITIONS.INLINE_ACTION_CANNOT_BE_USED_IN_PLUGINS, { task: formatTaskId(taskId) });
+    }
+    if (action !== undefined && inlineAction !== undefined) {
+        throw new HardhatError(HardhatError.ERRORS.CORE.TASK_DEFINITIONS.ACTION_AND_INLINE_ACTION_SET, { task: formatTaskId(taskId) });
+    }
+    if (action === undefined && inlineAction === undefined) {
+        throw new HardhatError(HardhatError.ERRORS.CORE.TASK_DEFINITIONS.NO_ACTION, { task: formatTaskId(taskId) });
+    }
+}
 export function validateOption({ name, shortName, type, defaultValue }, usedNames, taskId) {
     validateArgumentName(name);
     if (usedNames.has(name)) {

package/dist/src/internal/core/tasks/validations.js.map

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

package/dist/src/internal/deprecated-module-imported-from-hardhat2-plugin.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deprecated-module-imported-from-hardhat2-plugin.d.ts.map

package/dist/src/internal/deprecated-module-imported-from-hardhat2-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated-module-imported-from-hardhat2-plugin.d.ts","sourceRoot":"","sources":["../../../src/internal/deprecated-module-imported-from-hardhat2-plugin.ts"],"names":[],"mappings":""}

package/dist/src/internal/deprecated-module-imported-from-hardhat2-plugin.js

@@ -0,0 +1,12 @@
+// This is an empty module that is used to exported it with a subpath that's
+// commonly used by Hardhat 2 plugins. This is to avoid the plugins breaking
+// when the `require` it, so that they have an opportunity to run a function
+// that throws a better error message.
+export {};
+// The reason this module can be empty is that Hardhat 2 plugins are CJS modules
+// so they can destructure the require and get `undefined` values, instead of
+// a load-time error.
+// We could also throw from this file, but if it gets imported by an ESM module
+// you don't get an import-stack-trace, so you loose the possibility of figuring
+// out which plugin is triggering the error.
+//# sourceMappingURL=deprecated-module-imported-from-hardhat2-plugin.js.map

package/dist/src/internal/deprecated-module-imported-from-hardhat2-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated-module-imported-from-hardhat2-plugin.js","sourceRoot":"","sources":["../../../src/internal/deprecated-module-imported-from-hardhat2-plugin.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4EAA4E;AAC5E,4EAA4E;AAC5E,sCAAsC;;AAEtC,gFAAgF;AAChF,6EAA6E;AAC7E,qBAAqB;AAErB,+EAA+E;AAC/E,gFAAgF;AAChF,4CAA4C"}

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

@@ -0,0 +1,35 @@
+import { CustomError } from "@nomicfoundation/hardhat-utils/error";
+export declare class UsingHardhat2PluginError extends CustomError {
+    readonly callerRelativePath: string | undefined;
+    constructor();
+}
+/**
+ * Returns the relative path of the file that called a deprecated Hardhat
+ * plugin API, based on the stack trace. This helps identify which plugin
+ * file is triggering usage of Hardhat 2 APIs in a Hardhat 3 project.
+ *
+ * @param {number} [depth=5] The stack trace depth to locate the caller's
+ * source file. By default, depth 5 is used because:
+ *   0 = message
+ *   1 = getCallerRelativePath
+ *   2 = UsingHardhat2PluginError constructor
+ *   3 = throwUsingHardhat2PluginError
+ *   4 = deprecated function
+ *   5 = actual caller (the plugin file)
+ *
+ * @returns {string|undefined} The shortened relative path of the caller file,
+ * or undefined if not found.
+ *
+ * @example
+ * If the stack trace is:
+ * // Error
+ * //     at getCallerRelativePath (src/internal/using-hardhat2-plugin-errors.ts:34:15)
+ * //     at UsingHardhat2PluginError.constructor (src/internal/using-hardhat2-plugin-errors.ts:7:3)
+ * //     at throwUsingHardhat2PluginError (src/internal/using-hardhat2-plugin-errors.ts:90:3)
+ * //     at deprecatedFunction (plugins/example-plugin/deprecated.js:50:10)
+ * //     at main (plugins/example-plugin/index.js:100:5)
+ * Calling getCallerRelativePath() returns 'plugins/example-plugin/index.js'
+ */
+export declare function getCallerRelativePath(depth?: number): string | undefined;
+export declare function throwUsingHardhat2PluginError(): never;
+//# sourceMappingURL=using-hardhat2-plugin-errors.d.ts.map

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

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

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

@@ -0,0 +1,98 @@
+import { fileURLToPath } from "node:url";
+import { CustomError } from "@nomicfoundation/hardhat-utils/error";
+import { shortenPath } from "@nomicfoundation/hardhat-utils/path";
+import chalk from "chalk";
+export class UsingHardhat2PluginError extends CustomError {
+    callerRelativePath;
+    constructor() {
+        const callerPath = getCallerRelativePath();
+        let message;
+        if (callerPath !== undefined) {
+            message = `You are trying to use a Hardhat 2 plugin in a Hardhat 3 project.
+
+This file is part of a Hardhat 2 plugin calling an API that was removed in Hardhat 3: ${chalk.bold(callerPath)}
+
+Please read https://hardhat.org/migrate-from-hardhat2 to learn how to migrate your project to Hardhat 3.
+`;
+        }
+        else {
+            message = `You are trying to use a Hardhat 2 plugin in a Hardhat 3 project.
+      
+Check the stack trace below to identify which plugin is causing this.
+
+Please read https://hardhat.org/migrate-from-hardhat2 to learn how to migrate your project to Hardhat 3.
+`;
+        }
+        super(message);
+        this.callerRelativePath = callerPath;
+    }
+}
+/**
+ * Returns the relative path of the file that called a deprecated Hardhat
+ * plugin API, based on the stack trace. This helps identify which plugin
+ * file is triggering usage of Hardhat 2 APIs in a Hardhat 3 project.
+ *
+ * @param {number} [depth=5] The stack trace depth to locate the caller's
+ * source file. By default, depth 5 is used because:
+ *   0 = message
+ *   1 = getCallerRelativePath
+ *   2 = UsingHardhat2PluginError constructor
+ *   3 = throwUsingHardhat2PluginError
+ *   4 = deprecated function
+ *   5 = actual caller (the plugin file)
+ *
+ * @returns {string|undefined} The shortened relative path of the caller file,
+ * or undefined if not found.
+ *
+ * @example
+ * If the stack trace is:
+ * // Error
+ * //     at getCallerRelativePath (src/internal/using-hardhat2-plugin-errors.ts:34:15)
+ * //     at UsingHardhat2PluginError.constructor (src/internal/using-hardhat2-plugin-errors.ts:7:3)
+ * //     at throwUsingHardhat2PluginError (src/internal/using-hardhat2-plugin-errors.ts:90:3)
+ * //     at deprecatedFunction (plugins/example-plugin/deprecated.js:50:10)
+ * //     at main (plugins/example-plugin/index.js:100:5)
+ * Calling getCallerRelativePath() returns 'plugins/example-plugin/index.js'
+ */
+export function getCallerRelativePath(depth = 5) {
+    try {
+        const stack = new Error().stack;
+        if (stack === undefined) {
+            return undefined;
+        }
+        const lines = stack.split("\n");
+        const callerLine = lines[depth];
+        if (callerLine === undefined) {
+            return undefined;
+        }
+        /**
+         * Matches a single stack trace line:
+         *
+         * at FunctionName (path/to/file.ts:10:5)
+         * at path/to/file.ts:10:5
+         *
+         * Captures:
+         *  - group 1: file location (without line/column)
+         */
+        const STACK_TRACE_LINE_REGEX = /^at (?:.+? \()?([^\(].*?)(?::\d+)?(?::\d+)?\)?$/;
+        const match = callerLine.trim().match(STACK_TRACE_LINE_REGEX);
+        if (match === null || match[1] === undefined) {
+            return undefined;
+        }
+        let filePath = match[1];
+        // Handle file:// URLs from ESM stack traces
+        if (filePath.startsWith("file://")) {
+            filePath = fileURLToPath(filePath);
+        }
+        return shortenPath(filePath);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function throwUsingHardhat2PluginError() {
+    /* eslint-disable-next-line no-restricted-syntax -- Intentionally throwing a
+      custom error here so that we always print the stack trace */
+    throw new UsingHardhat2PluginError();
+}
+//# sourceMappingURL=using-hardhat2-plugin-errors.js.map

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

@@ -0,0 +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;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAClE,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,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,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;;;CAG7G,CAAC;QACE,CAAC;aAAM,CAAC;YACN,OAAO,GAAG;;;;;CAKf,CAAC;QACE,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,kBAAkB,GAAG,UAAU,CAAC;IACvC,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"}

package/dist/src/plugins.d.ts

@@ -1,2 +1,10 @@
 export { HardhatPluginError } from "@nomicfoundation/hardhat-errors";
+/**
+ * @deprecated This function is part of the Hardhat 2 plugin API.
+ */
+export declare function lazyFunction(..._args: any): any;
+/**
+ * @deprecated This function is part of the Hardhat 2 plugin API.
+ */
+export declare function lazyObject(..._args: any): any;
 //# sourceMappingURL=plugins.d.ts.map

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"}
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAIrE;;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,2 +1,15 @@
 export { HardhatPluginError } from "@nomicfoundation/hardhat-errors";
+import { throwUsingHardhat2PluginError } from "./internal/using-hardhat2-plugin-errors.js";
+/**
+ * @deprecated This function is part of the Hardhat 2 plugin API.
+ */
+export function lazyFunction(..._args) {
+    throwUsingHardhat2PluginError();
+}
+/**
+ * @deprecated This function is part of the Hardhat 2 plugin API.
+ */
+export function lazyObject(..._args) {
+    throwUsingHardhat2PluginError();
+}
 //# 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"}
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,EAAE,6BAA6B,EAAE,MAAM,4CAA4C,CAAC;AAE3F;;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"}

package/dist/src/types/index.d.ts

@@ -0,0 +1,15 @@
+export * from "./arguments.js";
+export * from "./artifacts.js";
+export * from "./config.js";
+export * from "./global-options.js";
+export * from "./hooks.js";
+export * from "./hre.js";
+export * from "./network.js";
+export * from "./plugins.js";
+export * from "./providers.js";
+export * from "./solidity.js";
+export * from "./tasks.js";
+export * from "./test.js";
+export * from "./user-interruptions.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}

package/dist/src/types/index.js

@@ -0,0 +1,15 @@
+export * from "./arguments.js";
+export * from "./artifacts.js";
+export * from "./config.js";
+export * from "./global-options.js";
+export * from "./hooks.js";
+export * from "./hre.js";
+export * from "./network.js";
+export * from "./plugins.js";
+export * from "./providers.js";
+export * from "./solidity.js";
+export * from "./tasks.js";
+export * from "./test.js";
+export * from "./user-interruptions.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/src/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}

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

@@ -57,8 +57,8 @@ export interface HardhatPlugin {
      * returning an object with a handler for the `extendUserConfig` hook.
      *
      * You can define each factory in two ways:
-     *  - As an inline function.
-     *  - As a string with the path to a file that exports the factory as `default`.
+     * - As an inline function.
+     * - As a string with the path to a file that exports the factory as `default`.
      *
      * The first option should only be used for development. You MUST use the second
      * option for production.

package/dist/src/types/solidity/errors.d.ts

@@ -75,6 +75,11 @@ export interface NpmRootFileOfUninstalledPackageError {
     type: RootResolutionErrorType.NPM_ROOT_FILE_OF_UNINSTALLED_PACKAGE;
     npmModule: string;
     installationName: string;
+    /**
+     * A boolean indicating if the Hardhat project has a foundry.toml file in its
+     * root.
+     */
+    projectHasFoundryToml?: boolean;
 }
 export interface NpmRootResolutionWithRemappingErrors {
     type: RootResolutionErrorType.NPM_ROOT_FILE_RESOLUTION_WITH_REMAPPING_ERRORS;
@@ -88,6 +93,10 @@ export interface NpmRootFileDoesNotExistWithinPackageError extends ResolvedFileR
 export interface NpmRootFileWithIncorrectCasingError extends ResolvedFileReference {
     type: RootResolutionErrorType.NPM_ROOT_FILE_WITH_INCORRECT_CASING;
     npmModule: string;
+    /**
+     * The correct casing of the file, expressed as the relative fs path from the
+     * package's root, using forward slashes, and without a leading "./".
+     */
     correctCasing: string;
 }
 export interface NpmRootFileNonExportedFileError extends ResolvedFileReference {
@@ -171,6 +180,10 @@ export interface ImportInvalidCasingError extends ResolvedFileReference {
     type: ImportResolutionErrorType.IMPORT_INVALID_CASING;
     fromFsPath: string;
     importPath: string;
+    /**
+     * The correct casing of the file, expressed as the relative fs path from the
+     * package's root, using forward slashes, and without a leading "./".
+     */
     correctCasing: string;
 }
 export interface ImportWithInvalidNpmSyntaxError {
@@ -183,6 +196,11 @@ export interface ImportOfUninstalledPackageError {
     fromFsPath: string;
     importPath: string;
     installationName: string;
+    /**
+     * A boolean indicating weather the import is from a source file whose package
+     * has a foundry.toml file in its root.
+     */
+    importerPackageHasFoundryToml?: boolean;
 }
 export interface ImportWithRemappingErrorsError {
     type: ImportResolutionErrorType.IMPORT_WITH_REMAPPING_ERRORS;

package/dist/src/types/solidity/errors.d.ts.map

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

package/dist/src/types/solidity/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/types/solidity/errors.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,uBA0DX;AA1DD,WAAY,uBAAuB;IACjC;;OAEG;IACH,gGAAqE,CAAA;IAErE;;OAEG;IACH,gGAAqE,CAAA;IAErE;;;OAGG;IACH,kGAAuE,CAAA;IAEvE;;;OAGG;IACH,4GAAiF,CAAA;IAEjF;;;;;OAKG;IACH,4GAAiF,CAAA;IAEjF;;OAEG;IACH,wGAA6E,CAAA;IAE7E;;OAEG;IACH,4HAAiG,CAAA;IAEjG;;;OAGG;IACH,8HAAmG,CAAA;IAEnG;;;OAGG;IACH,sGAA2E,CAAA;IAE3E;;;OAGG;IACH,8FAAmE,CAAA;AACrE,CAAC,EA1DW,uBAAuB,KAAvB,uBAAuB,QA0DlC;AA6ED;;GAEG;AACH,MAAM,CAAN,IAAY,yBAgDX;AAhDD,WAAY,yBAAyB;IACnC;;OAEG;IACH,wGAA2E,CAAA;IAC3E;;OAEG;IACH,gFAAmD,CAAA;IACnD;;;OAGG;IACH,oGAAuE,CAAA;IACvE;;OAEG;IACH,4EAA+C,CAAA;IAC/C;;OAEG;IACH,4EAA+C,CAAA;IAC/C;;OAEG;IACH,8FAAiE,CAAA;IACjE;;OAEG;IACH,4FAA+D,CAAA;IAC/D;;OAEG;IACH,mFAAsD,CAAA;IACtD;;OAEG;IACH,gGAAmE,CAAA;IAEnE;;OAEG;IACH,wHAA2F,CAAA;IAE3F;;OAEG;IACH,wFAA2D,CAAA;AAC7D,CAAC,EAhDW,yBAAyB,KAAzB,yBAAyB,QAgDpC;AAuFD;;;GAGG;AACH,MAAM,CAAN,IAAY,sBAUX;AAVD,WAAY,sBAAsB;IAChC;;OAEG;IACH,yFAA+D,CAAA;IAE/D;;OAEG;IACH,+FAAqE,CAAA;AACvE,CAAC,EAVW,sBAAsB,KAAtB,sBAAsB,QAUjC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/types/solidity/errors.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,uBA0DX;AA1DD,WAAY,uBAAuB;IACjC;;OAEG;IACH,gGAAqE,CAAA;IAErE;;OAEG;IACH,gGAAqE,CAAA;IAErE;;;OAGG;IACH,kGAAuE,CAAA;IAEvE;;;OAGG;IACH,4GAAiF,CAAA;IAEjF;;;;;OAKG;IACH,4GAAiF,CAAA;IAEjF;;OAEG;IACH,wGAA6E,CAAA;IAE7E;;OAEG;IACH,4HAAiG,CAAA;IAEjG;;;OAGG;IACH,8HAAmG,CAAA;IAEnG;;;OAGG;IACH,sGAA2E,CAAA;IAE3E;;;OAGG;IACH,8FAAmE,CAAA;AACrE,CAAC,EA1DW,uBAAuB,KAAvB,uBAAuB,QA0DlC;AAsFD;;GAEG;AACH,MAAM,CAAN,IAAY,yBAgDX;AAhDD,WAAY,yBAAyB;IACnC;;OAEG;IACH,wGAA2E,CAAA;IAC3E;;OAEG;IACH,gFAAmD,CAAA;IACnD;;;OAGG;IACH,oGAAuE,CAAA;IACvE;;OAEG;IACH,4EAA+C,CAAA;IAC/C;;OAEG;IACH,4EAA+C,CAAA;IAC/C;;OAEG;IACH,8FAAiE,CAAA;IACjE;;OAEG;IACH,4FAA+D,CAAA;IAC/D;;OAEG;IACH,mFAAsD,CAAA;IACtD;;OAEG;IACH,gGAAmE,CAAA;IAEnE;;OAEG;IACH,wHAA2F,CAAA;IAE3F;;OAEG;IACH,wFAA2D,CAAA;AAC7D,CAAC,EAhDW,yBAAyB,KAAzB,yBAAyB,QAgDpC;AAgGD;;;GAGG;AACH,MAAM,CAAN,IAAY,sBAUX;AAVD,WAAY,sBAAsB;IAChC;;OAEG;IACH,yFAA+D,CAAA;IAE/D;;OAEG;IACH,+FAAqE,CAAA;AACvE,CAAC,EAVW,sBAAsB,KAAtB,sBAAsB,QAUjC"}

package/dist/src/types/tasks.d.ts

@@ -48,6 +48,20 @@ export declare enum TaskDefinitionType {
     NEW_TASK = "NEW_TASK",
     TASK_OVERRIDE = "TASK_OVERRIDE"
 }
+export type TaskAction = {
+    action: LazyActionObject<NewTaskActionFunction>;
+    inlineAction?: never;
+} | {
+    inlineAction: NewTaskActionFunction;
+    action?: never;
+};
+export type TaskOverrideAction = {
+    action: LazyActionObject<TaskOverrideActionFunction>;
+    inlineAction?: never;
+} | {
+    inlineAction: TaskOverrideActionFunction;
+    action?: never;
+};
 /**
  * Empty task definition. It is meant to be used as a placeholder task that only
  * prints information about its subtasks.
@@ -62,26 +76,32 @@ export interface EmptyTaskDefinition {
     description: string;
 }
 /**
- * The definition of a new task.
+ * The base definition of a new task.
  */
-export interface NewTaskDefinition {
+export interface BaseTaskDefinition {
     type: TaskDefinitionType.NEW_TASK;
     id: string[];
     description: string;
-    action: LazyActionObject<NewTaskActionFunction>;
     options: Record<string, OptionDefinition>;
     positionalArguments: PositionalArgumentDefinition[];
 }
 /**
- * An override of an existing task.
+ * The definition of a new task.
  */
-export interface TaskOverrideDefinition {
+export type NewTaskDefinition = BaseTaskDefinition & TaskAction;
+/**
+ * The base definition of an override of an existing task.
+ */
+export interface BaseTaskOverrideDefinition {
     type: TaskDefinitionType.TASK_OVERRIDE;
     id: string[];
     description?: string;
-    action: LazyActionObject<TaskOverrideActionFunction>;
     options: Record<string, OptionDefinition>;
 }
+/**
+ * An override of an existing task.
+ */
+export type TaskOverrideDefinition = BaseTaskOverrideDefinition & TaskOverrideAction;
 /**
  * The definition of a task, as used in the plugins and user config. They are
  * declarative descriptions of the task, which are later processed to create the
@@ -103,8 +123,11 @@ export interface EmptyTaskDefinitionBuilder {
 }
 /**
  * A builder for creating NewTaskDefinitions.
+ *
+ * @template TaskArgumentsT The arguments of the task.
+ * @template ActionTypeT Tracks if the action is "LAZY_ACTION" (Plugin Safe) or "INLINE_ACTION".
  */
-export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments = TaskArguments> {
+export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments = TaskArguments, ActionTypeT extends "LAZY_ACTION" | "INLINE_ACTION" | "MISSING_ACTION" = "MISSING_ACTION"> {
     /**
      * Sets the description of the task.
      */
@@ -112,13 +135,33 @@ export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments =
     /**
      * Sets the action of the task.
      *
-     * It can be provided as a function, or as a `file://` URL pointing to a file
-     * that exports a default NewTaskActionFunction.
+     * It must be provided as a lazy import function that returns a module with
+     * a default export, like `() => import("./my-action.js")`.
      *
-     * Note that plugins can only use the inline function form for development
-     * purposes.
+     * Note that plugins cannot use inline actions (see {@link setInlineAction}).
+     * They must use this method with a lazy import.
+     *
+     * @remarks
+     * This method can only be called once per task definition. Calling it multiple
+     * times will result in a runtime error.
+     *
+     * This method cannot be used together with {@link setInlineAction} on the same
+     * task. Use one or the other.
+     */
+    setAction(action: LazyActionObject<NewTaskActionFunction<TaskArgumentsT>>): NewTaskDefinitionBuilder<TaskArgumentsT, "LAZY_ACTION">;
+    /**
+     * Sets the inline action of the task.
+     *
+     * It must be provided as a function.
+     *
+     * @remarks
+     * This method can only be called once per task definition. Calling it multiple
+     * times will result in a runtime error.
+     *
+     * This method cannot be used together with {@link setAction} on the same
+     * task. Use one or the other.
      */
-    setAction(action: LazyActionObject<NewTaskActionFunction<TaskArgumentsT>>): this;
+    setInlineAction(inlineAction: NewTaskActionFunction<TaskArgumentsT>): NewTaskDefinitionBuilder<TaskArgumentsT, "INLINE_ACTION">;
     /**
      * Adds an option to the task.
      *
@@ -135,7 +178,7 @@ export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments =
         type?: TypeT;
         defaultValue: ArgumentTypeToValueType<TypeT>;
         hidden?: boolean;
-    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, TypeT, TaskArgumentsT>>;
+    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, TypeT, TaskArgumentsT>, ActionTypeT>;
     /**
      * Adds an option of flag type and default value false.
      */
@@ -144,7 +187,7 @@ export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments =
         shortName?: string;
         description?: string;
         hidden?: boolean;
-    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.FLAG, TaskArgumentsT>>;
+    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.FLAG, TaskArgumentsT>, ActionTypeT>;
     /**
      * Adds an option of level type and default value 0.
      */
@@ -153,7 +196,7 @@ export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments =
         shortName?: string;
         description?: string;
         defaultValue?: number;
-    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.LEVEL, TaskArgumentsT>>;
+    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.LEVEL, TaskArgumentsT>, ActionTypeT>;
     /**
      * Adds a positional argument to the task.
      *
@@ -175,7 +218,7 @@ export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments =
         description?: string;
         type?: TypeT;
         defaultValue?: ArgumentTypeToValueType<TypeT>;
-    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, TypeT, TaskArgumentsT>>;
+    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, TypeT, TaskArgumentsT>, ActionTypeT>;
     /**
      * Adds a variadic positional argument to the task.
      *
@@ -195,16 +238,23 @@ export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments =
         description?: string;
         type?: TypeT;
         defaultValue?: Array<ArgumentTypeToValueType<TypeT>>;
-    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, TypeT[], TaskArgumentsT>>;
+    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, TypeT[], TaskArgumentsT>, ActionTypeT>;
     /**
      * Builds the NewTaskDefinition.
      */
-    build(): NewTaskDefinition;
+    build(): ActionTypeT extends "LAZY_ACTION" ? Extract<NewTaskDefinition, {
+        action: LazyActionObject<NewTaskActionFunction>;
+    }> : ActionTypeT extends "INLINE_ACTION" ? Extract<NewTaskDefinition, {
+        inlineAction: NewTaskActionFunction;
+    }> : never;
 }
 /**
- * A builder for overriding existing tasks.
+ * A builder for overriding existing tasks
+ *
+ * @template TaskArgumentsT The arguments of the task.
+ * @template ActionTypeT Tracks if the action is "LAZY_ACTION" (Plugin Safe) or "INLINE_ACTION".
  */
-export interface TaskOverrideDefinitionBuilder<TaskArgumentsT extends TaskArguments = TaskArguments> {
+export interface TaskOverrideDefinitionBuilder<TaskArgumentsT extends TaskArguments = TaskArguments, ActionTypeT extends "LAZY_ACTION" | "INLINE_ACTION" | "MISSING_ACTION" = "MISSING_ACTION"> {
     /**
      * Sets a new description for the task.
      */
@@ -214,7 +264,13 @@ export interface TaskOverrideDefinitionBuilder<TaskArgumentsT extends TaskArgume
      *
      * @see NewTaskDefinitionBuilder.setAction
      */
-    setAction(action: LazyActionObject<TaskOverrideActionFunction<TaskArgumentsT>>): this;
+    setAction(action: LazyActionObject<TaskOverrideActionFunction<TaskArgumentsT>>): TaskOverrideDefinitionBuilder<TaskArgumentsT, "LAZY_ACTION">;
+    /**
+     * Sets a new inline action for the task.
+     *
+     * @see NewTaskDefinitionBuilder.setInlineAction
+     */
+    setInlineAction(inlineAction: TaskOverrideActionFunction<TaskArgumentsT>): TaskOverrideDefinitionBuilder<TaskArgumentsT, "INLINE_ACTION">;
     /**
      * Adds a new option to the task.
      *
@@ -227,7 +283,7 @@ export interface TaskOverrideDefinitionBuilder<TaskArgumentsT extends TaskArgume
         type?: TypeT;
         defaultValue: ArgumentTypeToValueType<TypeT>;
         hidden?: boolean;
-    }): TaskOverrideDefinitionBuilder<ExtendTaskArguments<NameT, TypeT, TaskArgumentsT>>;
+    }): TaskOverrideDefinitionBuilder<ExtendTaskArguments<NameT, TypeT, TaskArgumentsT>, ActionTypeT>;
     /**
      * Adds an option of flag type and default value false.
      */
@@ -236,7 +292,7 @@ export interface TaskOverrideDefinitionBuilder<TaskArgumentsT extends TaskArgume
         shortName?: string;
         description?: string;
         hidden?: boolean;
-    }): TaskOverrideDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.FLAG, TaskArgumentsT>>;
+    }): TaskOverrideDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.FLAG, TaskArgumentsT>, ActionTypeT>;
     /**
      * Adds an option of level type and default value 0.
      */
@@ -245,33 +301,38 @@ export interface TaskOverrideDefinitionBuilder<TaskArgumentsT extends TaskArgume
         shortName?: string;
         description?: string;
         defaultValue?: number;
-    }): TaskOverrideDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.LEVEL, TaskArgumentsT>>;
+    }): TaskOverrideDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.LEVEL, TaskArgumentsT>, ActionTypeT>;
     /**
      * Builds the TaskOverrideDefinition.
      */
-    build(): TaskOverrideDefinition;
+    build(): ActionTypeT extends "LAZY_ACTION" ? Extract<TaskOverrideDefinition, {
+        action: LazyActionObject<TaskOverrideActionFunction>;
+    }> : ActionTypeT extends "INLINE_ACTION" ? Extract<TaskOverrideDefinition, {
+        inlineAction: TaskOverrideActionFunction;
+    }> : never;
 }
 /**
  * The actions associated to the task, in order.
  *
  * Each of them has the pluginId of the plugin that defined it, if any, and the
- * action itself.
+ * action itself. The action is stored either in `action` or `inlineAction`.
+ * Note that `inlineAction` is reserved for user tasks and is not allowed for plugins.
  *
- * Note that the first action is a `NewTaskActionFunction`, `string`, or
- * `undefined`. `undefined` is only used for empty tasks.
+ * Note that the first action is a `NewTaskActionFunction` or undefined.
+ * `undefined` is only used for empty tasks.
  *
- * The rest of the actions always have a `TaskOverrideActionFunction` or a
- * `string`.
+ * The rest of the actions always have a `TaskOverrideActionFunction`.
  */
 export type TaskActions = [
     {
         pluginId?: string;
-        action?: LazyActionObject<NewTaskActionFunction>;
-    },
+    } & (TaskAction | {
+        action?: undefined;
+        inlineAction?: undefined;
+    }),
     ...Array<{
         pluginId?: string;
-        action: LazyActionObject<TaskOverrideActionFunction>;
-    }>
+    } & TaskOverrideAction>
 ];
 /**
  * A task.