hardhat 3.7.0 → 3.8.0

package/dist/src/internal/core/plugins/loaded-plugins-registry.js

@@ -0,0 +1,8 @@
+const loadedPlugins = new Map();
+export function registerLoadedPlugin(plugin) {
+    loadedPlugins.set(plugin.id, plugin);
+}
+export function getLoadedPlugins() {
+    return loadedPlugins;
+}
+//# sourceMappingURL=loaded-plugins-registry.js.map

package/dist/src/internal/core/plugins/loaded-plugins-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaded-plugins-registry.js","sourceRoot":"","sources":["../../../../../src/internal/core/plugins/loaded-plugins-registry.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,IAAI,GAAG,EAAyB,CAAC;AAEvD,MAAM,UAAU,oBAAoB,CAAC,MAAqB;IACxD,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/src/internal/core/plugins/unused-plugins-warning.d.ts

@@ -0,0 +1,3 @@
+import type { HardhatPlugin } from "../../../types/plugins.js";
+export declare function warnAboutUnusedLoadedPlugins(resolvedPlugins: HardhatPlugin[], printError?: (message: string) => void, loadedPlugins?: Iterable<HardhatPlugin>): void;
+//# sourceMappingURL=unused-plugins-warning.d.ts.map

package/dist/src/internal/core/plugins/unused-plugins-warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-plugins-warning.d.ts","sourceRoot":"","sources":["../../../../../src/internal/core/plugins/unused-plugins-warning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM/D,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,aAAa,EAAE,EAChC,UAAU,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAA0C,EAC3E,aAAa,GAAE,QAAQ,CAAC,aAAa,CAA+B,GACnE,IAAI,CAoCN"}

package/dist/src/internal/core/plugins/unused-plugins-warning.js

@@ -0,0 +1,29 @@
+import { styleText } from "node:util";
+import { getLoadedPlugins } from "./loaded-plugins-registry.js";
+export function warnAboutUnusedLoadedPlugins(resolvedPlugins, printError = (message) => console.error(message), loadedPlugins = getLoadedPlugins().values()) {
+    const resolvedIds = new Set(resolvedPlugins.map((p) => p.id));
+    const unused = [];
+    for (const plugin of loadedPlugins) {
+        if (!resolvedIds.has(plugin.id)) {
+            unused.push(plugin);
+        }
+    }
+    if (unused.length === 0) {
+        return;
+    }
+    const lines = [
+        "",
+        styleText(["bold", "yellow"], "Warning:") +
+            " the following plugins were imported but are not present in the `plugins` array of your config:",
+        "",
+    ];
+    for (const plugin of unused) {
+        const name = plugin.npmPackage !== undefined && plugin.npmPackage !== null
+            ? `${plugin.npmPackage}  (id: ${plugin.id})`
+            : plugin.id;
+        lines.push(`  - ${name}`);
+    }
+    lines.push("", "  Add them to the `plugins` array, or remove the unused plugin import(s) to silence this warning.", "");
+    printError(lines.join("\n"));
+}
+//# sourceMappingURL=unused-plugins-warning.js.map

package/dist/src/internal/core/plugins/unused-plugins-warning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-plugins-warning.js","sourceRoot":"","sources":["../../../../../src/internal/core/plugins/unused-plugins-warning.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,MAAM,UAAU,4BAA4B,CAC1C,eAAgC,EAChC,aAAwC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAC3E,gBAAyC,gBAAgB,EAAE,CAAC,MAAM,EAAE;IAEpE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,EAAE;QACF,SAAS,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC;YACvC,iGAAiG;QACnG,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,IAAI,GACR,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;YAC3D,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,UAAU,MAAM,CAAC,EAAE,GAAG;YAC5C,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,mGAAmG,EACnG,EAAE,CACH,CAAC;IAEF,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/src/plugins.d.ts

@@ -1,4 +1,17 @@
 export { HardhatPluginError } from "@nomicfoundation/hardhat-errors";
+import type { HardhatPlugin } from "./types/plugins.js";
+/**
+ * Defines a Hardhat plugin.
+ *
+ * Plugin authors should use this helper as the default export of their
+ * plugin's `index` module. It registers the plugin's `id` in a process-wide
+ * registry of loaded plugins, which the Hardhat CLI uses to detect plugins
+ * that are imported but not included in the user's `plugins` array.
+ *
+ * @param plugin The plugin definition.
+ * @returns The same plugin definition, unchanged.
+ */
+export declare function definePlugin(plugin: HardhatPlugin): HardhatPlugin;
 /**
  * @deprecated This function is part of the Hardhat 2 plugin API.
  */

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;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"}
+{"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"}

package/dist/src/plugins.js

@@ -1,5 +1,21 @@
 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";
+/**
+ * Defines a Hardhat plugin.
+ *
+ * Plugin authors should use this helper as the default export of their
+ * plugin's `index` module. It registers the plugin's `id` in a process-wide
+ * registry of loaded plugins, which the Hardhat CLI uses to detect plugins
+ * that are imported but not included in the user's `plugins` array.
+ *
+ * @param plugin The plugin definition.
+ * @returns The same plugin definition, unchanged.
+ */
+export function definePlugin(plugin) {
+    registerLoadedPlugin(plugin);
+    return plugin;
+}
 /**
  * @deprecated This function is part of the Hardhat 2 plugin API.
  */

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;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"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hardhat",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "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": {
@@ -63,7 +63,7 @@
     "README.md"
   ],
   "devDependencies": {
-    "@nomicfoundation/hardhat-node-test-reporter": "^3.0.7",
+    "@nomicfoundation/hardhat-node-test-reporter": "^3.1.0",
     "@types/adm-zip": "^0.5.5",
     "@types/node": "^22.0.0",
     "@types/semver": "^7.5.8",
@@ -77,8 +77,8 @@
     "@nomicfoundation/hardhat-test-utils": "^2.0.3"
   },
   "dependencies": {
-    "@nomicfoundation/edr": "0.12.0-next.33",
-    "@nomicfoundation/hardhat-errors": "^3.0.14",
+    "@nomicfoundation/edr": "0.12.0",
+    "@nomicfoundation/hardhat-errors": "^3.0.15",
     "@nomicfoundation/hardhat-utils": "^4.1.3",
     "@nomicfoundation/hardhat-vendored": "^3.0.4",
     "@nomicfoundation/hardhat-zod-utils": "^3.0.5",

package/src/cli.ts

@@ -24,4 +24,7 @@ function isTsxRequired(): boolean {
 }
 
 // eslint-disable-next-line no-restricted-syntax -- We do want TLA here
-await main(process.argv.slice(2), { registerTsx: isTsxRequired() });
+await main(process.argv.slice(2), {
+  registerTsx: isTsxRequired(),
+  warnAboutUnusedPlugins: true,
+});

package/src/internal/builtin-plugins/artifacts/index.ts

@@ -1,12 +1,15 @@
 import type { HardhatPlugin } from "../../../types/plugins.js";
+
+import { definePlugin } from "../../../plugins.js";
+
 export type * from "./type-extensions.js";
 
-const hardhatPlugin: HardhatPlugin = {
+const hardhatPlugin: HardhatPlugin = definePlugin({
   id: "builtin:artifacts",
   hookHandlers: {
     hre: () => import("./hook-handlers/hre.js"),
   },
   npmPackage: "hardhat",
-};
+});
 
 export default hardhatPlugin;

package/src/internal/builtin-plugins/clean/index.ts

@@ -1,10 +1,11 @@
 import type { HardhatPlugin } from "../../../types/plugins.js";
 
+import { definePlugin } from "../../../plugins.js";
 import { task } from "../../core/config.js";
 
 export type * from "./type-extensions.js";
 
-const hardhatPlugin: HardhatPlugin = {
+const hardhatPlugin: HardhatPlugin = definePlugin({
   id: "builtin:clean",
   tasks: [
     task("clean", "Clear the cache and delete all artifacts")
@@ -16,6 +17,6 @@ const hardhatPlugin: HardhatPlugin = {
       .build(),
   ],
   npmPackage: "hardhat",
-};
+});
 
 export default hardhatPlugin;

package/src/internal/builtin-plugins/console/index.ts

@@ -1,8 +1,9 @@
 import type { HardhatPlugin } from "../../../types/plugins.js";
 
+import { definePlugin } from "../../../plugins.js";
 import { task } from "../../core/config.js";
 
-const hardhatPlugin: HardhatPlugin = {
+const hardhatPlugin: HardhatPlugin = definePlugin({
   id: "builtin:console",
   tasks: [
     task("console", "Open a hardhat console")
@@ -25,6 +26,6 @@ const hardhatPlugin: HardhatPlugin = {
   ],
   dependencies: () => [import("../solidity/index.js")],
   npmPackage: "hardhat",
-};
+});
 
 export default hardhatPlugin;

package/src/internal/builtin-plugins/coverage/index.ts

@@ -1,10 +1,11 @@
 import type { HardhatPlugin } from "../../../types/plugins.js";
 
+import { definePlugin } from "../../../plugins.js";
 import { globalFlag } from "../../core/config.js";
 
 export type * from "./type-extensions.js";
 
-const hardhatPlugin: HardhatPlugin = {
+const hardhatPlugin: HardhatPlugin = definePlugin({
   id: "builtin:coverage",
   tasks: [],
   globalOptions: [
@@ -20,6 +21,6 @@ const hardhatPlugin: HardhatPlugin = {
     test: () => import("./hook-handlers/test.js"),
   },
   npmPackage: "hardhat",
-};
+});
 
 export default hardhatPlugin;

package/src/internal/builtin-plugins/flatten/index.ts

@@ -1,9 +1,10 @@
 import type { HardhatPlugin } from "../../../types/plugins.js";
 
+import { definePlugin } from "../../../plugins.js";
 import { ArgumentType } from "../../../types/arguments.js";
 import { task } from "../../core/config.js";
 
-const hardhatPlugin: HardhatPlugin = {
+const hardhatPlugin: HardhatPlugin = definePlugin({
   id: "builtin:flatten",
   tasks: [
     task("flatten")
@@ -17,6 +18,6 @@ const hardhatPlugin: HardhatPlugin = {
       .setAction(async () => await import("./task-action.js"))
       .build(),
   ],
-};
+});
 
 export default hardhatPlugin;

package/src/internal/builtin-plugins/gas-analytics/index.ts

@@ -1,11 +1,12 @@
 import type { HardhatPlugin } from "../../../types/plugins.js";
 
+import { definePlugin } from "../../../plugins.js";
 import { ArgumentType } from "../../../types/arguments.js";
 import { globalFlag, globalOption, overrideTask } from "../../core/config.js";
 
 export type * from "./type-extensions.js";
 
-const hardhatPlugin: HardhatPlugin = {
+const hardhatPlugin: HardhatPlugin = definePlugin({
   id: "builtin:gas-analytics",
   tasks: [
     overrideTask("test")
@@ -63,6 +64,6 @@ const hardhatPlugin: HardhatPlugin = {
     import("../solidity-test/index.js"),
   ],
   npmPackage: "hardhat",
-};
+});
 
 export default hardhatPlugin;

package/src/internal/builtin-plugins/network-manager/edr/stack-traces/stack-trace-solidity-errors.ts

@@ -319,6 +319,7 @@ function getMessageFromLastStackTraceEntry(
  **/
 export class SolidityError extends Error {
   public readonly code: number = REVERT_ERROR_CODE;
+  public readonly solidityStack: string;
 
   constructor(
     message: string,
@@ -328,6 +329,10 @@ export class SolidityError extends Error {
   ) {
     super(message);
     this.name = "SolidityError";
+    this.solidityStack =
+      stackTrace.length !== 0
+        ? stackTrace.map(encodeStackTraceEntry).reverse().join("\n")
+        : "Internal error when encoding SolidityError";
 
     Object.defineProperty(this, Symbol.for("nodejs.util.inspect.custom"), {
       value: () =>

package/src/internal/builtin-plugins/network-manager/index.ts

@@ -1,5 +1,6 @@
 import type { HardhatPlugin } from "../../../types/plugins.js";
 
+import { definePlugin } from "../../../plugins.js";
 import { ArgumentType } from "../../../types/arguments.js";
 import { globalOption } from "../../core/config.js";
 
@@ -8,7 +9,7 @@ export type * from "./type-extensions/global-options.js";
 export type * from "./type-extensions/hooks.js";
 export type * from "./type-extensions/hre.js";
 
-const hardhatPlugin: HardhatPlugin = {
+const hardhatPlugin: HardhatPlugin = definePlugin({
   id: "builtin:network-manager",
   hookHandlers: {
     config: () => import("./hook-handlers/config.js"),
@@ -25,6 +26,6 @@ const hardhatPlugin: HardhatPlugin = {
   ],
   npmPackage: "hardhat",
   dependencies: () => [import("../artifacts/index.js")],
-};
+});
 
 export default hardhatPlugin;

package/src/internal/builtin-plugins/network-manager/provider-errors.ts

@@ -15,13 +15,7 @@ const IS_PROVIDER_ERROR_PROPERTY_NAME = "_isProviderError";
 // -32603	Internal error	      Internal JSON-RPC error	            standard
 // -32700	Parse error	          Invalid JSON	                      standard
 //
-// -32003	Transaction rejected	Transaction creation failed	        non-standard
-// -32004	Method not supported	Method is not implemented	          non-standard
 // -32005	Limit exceeded	      Request exceeds defined limit	      non-standard
-//
-// -32999 Invalid response      The server returned a JSON-RPC      hardhat-specific
-//                              response, but the result is not
-//                              in the expected format
 export class ProviderError extends CustomError implements ProviderRpcError {
   public code: number;
   public data?: unknown;
@@ -76,7 +70,6 @@ export class InvalidRequestError extends ProviderError {
   }
 }
 
-// TODO: not used, should we remove it?
 export class MethodNotFoundError extends ProviderError {
   public static readonly CODE = -32601;
 
@@ -101,33 +94,6 @@ export class InternalError extends ProviderError {
   }
 }
 
-// TODO: not used, should we remove it?
-export class TransactionExecutionError extends ProviderError {
-  public static readonly CODE = -32003;
-
-  constructor(message: string = "Transaction rejected", parent?: Error) {
-    super(message, TransactionExecutionError.CODE, parent);
-  }
-}
-
-// TODO: not used, should we remove it?
-export class MethodNotSupportedError extends ProviderError {
-  public static readonly CODE = -32004;
-
-  constructor(message: string = "Method not supported", parent?: Error) {
-    super(message, MethodNotSupportedError.CODE, parent);
-  }
-}
-
-// TODO: not used, should we remove it?
-export class InvalidResponseError extends ProviderError {
-  public static readonly CODE = -32999;
-
-  constructor(message: string = "Invalid response", parent?: Error) {
-    super(message, InvalidResponseError.CODE, parent);
-  }
-}
-
 export class UnknownError extends ProviderError {
   public static readonly CODE = -1;
 

package/src/internal/builtin-plugins/node/index.ts

@@ -1,9 +1,10 @@
 import type { HardhatPlugin } from "../../../types/plugins.js";
 
+import { definePlugin } from "../../../plugins.js";
 import { ArgumentType } from "../../../types/arguments.js";
 import { task } from "../../core/config.js";
 
-const hardhatPlugin: HardhatPlugin = {
+const hardhatPlugin: HardhatPlugin = definePlugin({
   id: "builtin:node",
   tasks: [
     task("node", "Start a JSON-RPC server on top of Hardhat Network")
@@ -50,6 +51,6 @@ const hardhatPlugin: HardhatPlugin = {
       .build(),
   ],
   dependencies: () => [import("../network-manager/index.js")],
-};
+});
 
 export default hardhatPlugin;

package/src/internal/builtin-plugins/run/index.ts

@@ -1,8 +1,9 @@
 import type { HardhatPlugin } from "../../../types/plugins.js";
 
+import { definePlugin } from "../../../plugins.js";
 import { task } from "../../core/config.js";
 
-const hardhatPlugin: HardhatPlugin = {
+const hardhatPlugin: HardhatPlugin = definePlugin({
   id: "builtin:run",
   tasks: [
     task("run", "Run a user-defined script after compiling the project")
@@ -19,6 +20,6 @@ const hardhatPlugin: HardhatPlugin = {
   ],
   dependencies: () => [import("../solidity/index.js")],
   npmPackage: "hardhat",
-};
+});
 
 export default hardhatPlugin;

package/src/internal/builtin-plugins/solidity/build-system/build-system.ts

@@ -96,6 +96,17 @@ export function isSolcSolidityCompilerConfig(
   return config.type === undefined || config.type === "solc";
 }
 
+/**
+ * Returns true if the given compiler config defines a custom path to a solc
+ * compiler (native binary or WASM bundle). Such a compiler is user-provided and
+ * does not need to be downloaded.
+ */
+export function isSolcSolidityCompilerLocalBinary(
+  config: SolidityCompilerConfig,
+): boolean {
+  return isSolcSolidityCompilerConfig(config) && config.path !== undefined;
+}
+
 interface CompilationResult {
   compilationJob: CompilationJob;
   compilerOutput: CompilerOutput;

package/src/internal/builtin-plugins/solidity/build-system/warning-suppression.ts

@@ -31,6 +31,7 @@ const SPECIFIC_FILE_RULES: ReadonlyArray<{
 const TEST_FILE_WARNING_MESSAGES: readonly string[] = [
   SPDX_WARNING,
   PRAGMA_WARNING,
+  CONTRACT_SIZE_WARNING,
 ];
 
 // Warnings suppressed only when running with `--coverage`. An entry with no

package/src/internal/builtin-plugins/solidity/config.ts

@@ -613,6 +613,7 @@ function copyFromDefault(
     return {
       version: defaultSolidityConfig.version,
       type: defaultSolidityConfig.type,
+      path: defaultSolidityConfig.path,
     };
   }
 
@@ -620,12 +621,17 @@ function copyFromDefault(
     compilers: defaultSolidityConfig.compilers.map((c) => ({
       version: c.version,
       type: c.type,
+      path: c.path,
     })),
     overrides: Object.fromEntries(
       Object.entries(defaultSolidityConfig.overrides ?? {}).map(
         ([userSourceName, override]) => [
           userSourceName,
-          { version: override.version, type: override.type },
+          {
+            version: override.version,
+            type: override.type,
+            path: override.path,
+          },
         ],
       ),
     ),

package/src/internal/builtin-plugins/solidity/index.ts

@@ -1,5 +1,6 @@
 import type { HardhatPlugin } from "../../../types/plugins.js";
 
+import { definePlugin } from "../../../plugins.js";
 import { ArgumentType } from "../../../types/arguments.js";
 import { globalOption, task } from "../../core/config.js";
 
@@ -35,7 +36,7 @@ const buildTask = task("build", "Build project")
   .setAction(async () => await import("./tasks/build.js"))
   .build();
 
-const hardhatPlugin: HardhatPlugin = {
+const hardhatPlugin: HardhatPlugin = definePlugin({
   id: "builtin:solidity",
   dependencies: () => [import("../artifacts/index.js")],
   hookHandlers: {
@@ -65,6 +66,6 @@ const hardhatPlugin: HardhatPlugin = {
     }),
   ],
   npmPackage: "hardhat",
-};
+});
 
 export default hardhatPlugin;

package/src/internal/builtin-plugins/solidity/solidity-hooks.ts

@@ -1,7 +1,10 @@
 import type { SolidityCompilerConfig } from "../../../types/config.js";
 import type { Compiler } from "../../../types/solidity.js";
 
-import { isSolcSolidityCompilerConfig } from "./build-system/build-system.js";
+import {
+  isSolcSolidityCompilerConfig,
+  isSolcSolidityCompilerLocalBinary,
+} from "./build-system/build-system.js";
 import {
   downloadSolcCompilers,
   getCompiler,
@@ -16,7 +19,10 @@ export async function downloadSolcCompilersHandler(
   quiet: boolean,
 ): Promise<void> {
   const solcVersions = new Set(
-    compilerConfigs.filter(isSolcSolidityCompilerConfig).map((c) => c.version),
+    compilerConfigs
+      .filter(isSolcSolidityCompilerConfig)
+      .filter((c) => !isSolcSolidityCompilerLocalBinary(c))
+      .map((c) => c.version),
   );
 
   if (solcVersions.size > 0) {

package/src/internal/builtin-plugins/solidity-test/index.ts

@@ -2,11 +2,12 @@ import type { HardhatPlugin } from "../../../types/plugins.js";
 
 import { ArgumentType } from "hardhat/types/arguments";
 
+import { definePlugin } from "../../../plugins.js";
 import { task } from "../../core/config.js";
 
 export type * from "./type-extensions.js";
 
-const hardhatPlugin: HardhatPlugin = {
+const hardhatPlugin: HardhatPlugin = definePlugin({
   id: "builtin:solidity-tests",
   hookHandlers: {
     config: () => import("./hook-handlers/config.js"),
@@ -51,6 +52,6 @@ const hardhatPlugin: HardhatPlugin = {
     import("../coverage/index.js"),
   ],
   npmPackage: "hardhat",
-};
+});
 
 export default hardhatPlugin;

package/src/internal/builtin-plugins/telemetry/index.ts

@@ -1,8 +1,9 @@
 import type { HardhatPlugin } from "../../../types/plugins.js";
 
+import { definePlugin } from "../../../plugins.js";
 import { task } from "../../core/config.js";
 
-const hardhatPlugin: HardhatPlugin = {
+const hardhatPlugin: HardhatPlugin = definePlugin({
   id: "builtin:telemetry",
   tasks: [
     task("telemetry", "Display and modify telemetry settings")
@@ -18,6 +19,6 @@ const hardhatPlugin: HardhatPlugin = {
       .build(),
   ],
   npmPackage: "hardhat",
-};
+});
 
 export default hardhatPlugin;

package/src/internal/builtin-plugins/test/index.ts

@@ -1,11 +1,12 @@
 import type { HardhatPlugin } from "../../../types/plugins.js";
 
+import { definePlugin } from "../../../plugins.js";
 import { ArgumentType } from "../../../types/arguments.js";
 import { task } from "../../core/config.js";
 
 export type * from "./type-extensions.js";
 
-const hardhatPlugin: HardhatPlugin = {
+const hardhatPlugin: HardhatPlugin = definePlugin({
   id: "builtin:test",
   hookHandlers: {
     config: () => import("./hook-handlers/config.js"),
@@ -37,6 +38,6 @@ const hardhatPlugin: HardhatPlugin = {
   ],
   dependencies: () => [import("../solidity/index.js")],
   npmPackage: "hardhat",
-};
+});
 
 export default hardhatPlugin;

package/src/internal/cli/main.ts

@@ -40,6 +40,7 @@ import { parseArgumentValue } from "../core/arguments.js";
 import { buildGlobalOptionDefinitions } from "../core/global-options.js";
 import { resolveProjectRoot } from "../core/hre.js";
 import { resolvePluginList } from "../core/plugins/resolve-plugin-list.js";
+import { warnAboutUnusedLoadedPlugins } from "../core/plugins/unused-plugins-warning.js";
 import { isArgumentRequired } from "../core/tasks/utils.js";
 import { setGlobalHardhatRuntimeEnvironment } from "../global-hre-instance.js";
 import { createHardhatRuntimeEnvironment } from "../hre-initialization.js";
@@ -60,6 +61,7 @@ export interface MainOptions {
   registerTsx?: boolean;
   rethrowErrors?: true;
   allowNonlocalHardhatInstallation?: true;
+  warnAboutUnusedPlugins?: true;
 }
 
 export async function main(
@@ -234,6 +236,10 @@ export async function main(
       { resolvedPlugins, globalOptionDefinitions },
     );
 
+    if (options.warnAboutUnusedPlugins) {
+      warnAboutUnusedLoadedPlugins(hre.config.plugins);
+    }
+
     // This must be the first time we set it, otherwise we let it crash
     setGlobalHardhatRuntimeEnvironment(hre);
 

package/src/internal/core/plugins/loaded-plugins-registry.ts

@@ -0,0 +1,11 @@
+import type { HardhatPlugin } from "../../../types/plugins.js";
+
+const loadedPlugins = new Map<string, HardhatPlugin>();
+
+export function registerLoadedPlugin(plugin: HardhatPlugin): void {
+  loadedPlugins.set(plugin.id, plugin);
+}
+
+export function getLoadedPlugins(): ReadonlyMap<string, HardhatPlugin> {
+  return loadedPlugins;
+}