hardhat 3.6.0 → 3.8.0

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/init/prompt.ts

@@ -22,7 +22,7 @@ export async function promptForHardhatVersion(): Promise<
       choices: [
         {
           name: "hardhat-3",
-          message: "Hardhat 3 Beta (recommended for new projects)",
+          message: "Hardhat 3 (recommended for new projects)",
           value: "hardhat-3",
         },
         {

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

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

@@ -0,0 +1,47 @@
+import type { HardhatPlugin } from "../../../types/plugins.js";
+
+import { styleText } from "node:util";
+
+import { getLoadedPlugins } from "./loaded-plugins-registry.js";
+
+export function warnAboutUnusedLoadedPlugins(
+  resolvedPlugins: HardhatPlugin[],
+  printError: (message: string) => void = (message) => console.error(message),
+  loadedPlugins: Iterable<HardhatPlugin> = getLoadedPlugins().values(),
+): void {
+  const resolvedIds = new Set(resolvedPlugins.map((p) => p.id));
+
+  const unused: HardhatPlugin[] = [];
+  for (const plugin of loadedPlugins) {
+    if (!resolvedIds.has(plugin.id)) {
+      unused.push(plugin);
+    }
+  }
+
+  if (unused.length === 0) {
+    return;
+  }
+
+  const lines: string[] = [
+    "",
+    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"));
+}

package/src/plugins.ts

@@ -1,7 +1,26 @@
 export { HardhatPluginError } from "@nomicfoundation/hardhat-errors";
 
+import type { HardhatPlugin } from "./types/plugins.js";
+
+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: HardhatPlugin): HardhatPlugin {
+  registerLoadedPlugin(plugin);
+  return plugin;
+}
+
 /**
  * @deprecated This function is part of the Hardhat 2 plugin API.
  */

package/templates/hardhat-3/01-node-test-runner-viem/README.md

@@ -1,8 +1,8 @@
-# Sample Hardhat 3 Beta Project (`node:test` and `viem`)
+# Sample Hardhat 3 Project (`node:test` and `viem`)
 
-This project showcases a Hardhat 3 Beta project using the native Node.js test runner (`node:test`) and the `viem` library for Ethereum interactions.
+This project showcases a Hardhat 3 project using the native Node.js test runner (`node:test`) and the `viem` library for Ethereum interactions.
 
-To learn more about the Hardhat 3 Beta, please visit the [Getting Started guide](https://hardhat.org/docs/getting-started#getting-started-with-hardhat-3). To share your feedback, join our [Hardhat 3 Beta](https://hardhat.org/hardhat3-beta-telegram-group) Telegram group or [open an issue](https://github.com/NomicFoundation/hardhat/issues/new) in our GitHub issue tracker.
+To learn more about Hardhat 3, please visit the [Getting Started guide](https://hardhat.org/docs/getting-started#getting-started-with-hardhat-3). To share your feedback, join our [Hardhat 3](https://hardhat.org/hardhat3-telegram-group) Telegram group or [open an issue](https://github.com/NomicFoundation/hardhat/issues/new) in our GitHub issue tracker.
 
 ## Project Overview
 

package/templates/hardhat-3/01-node-test-runner-viem/package.json

@@ -5,22 +5,22 @@
   "description": "A TypeScript Hardhat project using Node Test Runner and Viem",
   "type": "module",
   "devDependencies": {
-    "hardhat": "workspace:^3.6.0",
-    "@nomicfoundation/hardhat-toolbox-viem": "workspace:^5.0.6",
-    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.6",
+    "hardhat": "workspace:^3.8.0",
+    "@nomicfoundation/hardhat-toolbox-viem": "workspace:^5.0.7",
+    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.7",
     "@types/node": "^22.8.5",
     "forge-std": "foundry-rs/forge-std#v1.9.4",
     "typescript": "~6.0.3",
     "viem": "^2.47.6"
   },
   "peerDependencies": {
-    "@nomicfoundation/hardhat-ignition-viem": "workspace:^3.1.5",
-    "@nomicfoundation/hardhat-keystore": "workspace:^3.0.11",
-    "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.9",
-    "@nomicfoundation/hardhat-node-test-runner": "workspace:^3.0.16",
-    "@nomicfoundation/hardhat-viem": "workspace:^3.0.8",
-    "@nomicfoundation/hardhat-viem-assertions": "workspace:^3.1.0",
-    "@nomicfoundation/hardhat-verify": "workspace:^3.0.18",
-    "@nomicfoundation/ignition-core": "workspace:^3.1.6"
+    "@nomicfoundation/hardhat-ignition-viem": "workspace:^3.1.6",
+    "@nomicfoundation/hardhat-keystore": "workspace:^3.0.12",
+    "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.10",
+    "@nomicfoundation/hardhat-node-test-runner": "workspace:^3.0.17",
+    "@nomicfoundation/hardhat-viem": "workspace:^3.0.9",
+    "@nomicfoundation/hardhat-viem-assertions": "workspace:^3.1.1",
+    "@nomicfoundation/hardhat-verify": "workspace:^3.0.19",
+    "@nomicfoundation/ignition-core": "workspace:^3.1.7"
   }
 }

package/templates/hardhat-3/01-node-test-runner-viem/tsconfig.json

@@ -5,6 +5,7 @@
     "target": "es2023",
     "skipLibCheck": true,
     "outDir": "dist",
-    "types": ["node"]
+    "types": ["node"],
+    "verbatimModuleSyntax": true
   }
 }

package/templates/hardhat-3/02-mocha-ethers/README.md

@@ -1,8 +1,8 @@
-# Sample Hardhat 3 Beta Project (`mocha` and `ethers`)
+# Sample Hardhat 3 Project (`mocha` and `ethers`)
 
-This project showcases a Hardhat 3 Beta project using `mocha` for tests and the `ethers` library for Ethereum interactions.
+This project showcases a Hardhat 3 project using `mocha` for tests and the `ethers` library for Ethereum interactions.
 
-To learn more about the Hardhat 3 Beta, please visit the [Getting Started guide](https://hardhat.org/docs/getting-started#getting-started-with-hardhat-3). To share your feedback, join our [Hardhat 3 Beta](https://hardhat.org/hardhat3-beta-telegram-group) Telegram group or [open an issue](https://github.com/NomicFoundation/hardhat/issues/new) in our GitHub issue tracker.
+To learn more about Hardhat 3, please visit the [Getting Started guide](https://hardhat.org/docs/getting-started#getting-started-with-hardhat-3). To share your feedback, join our [Hardhat 3](https://hardhat.org/hardhat3-telegram-group) Telegram group or [open an issue](https://github.com/NomicFoundation/hardhat/issues/new) in our GitHub issue tracker.
 
 ## Project Overview
 

package/templates/hardhat-3/02-mocha-ethers/package.json

@@ -5,10 +5,10 @@
   "description": "A TypeScript Hardhat project using Mocha and Ethers.js",
   "type": "module",
   "devDependencies": {
-    "hardhat": "workspace:^3.6.0",
-    "@nomicfoundation/hardhat-toolbox-mocha-ethers": "workspace:^3.0.6",
-    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.12",
-    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.6",
+    "hardhat": "workspace:^3.8.0",
+    "@nomicfoundation/hardhat-toolbox-mocha-ethers": "workspace:^3.0.7",
+    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.13",
+    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.7",
     "@types/chai": "^5.2.3",
     "@types/chai-as-promised": "^8.0.1",
     "@types/mocha": ">=10.0.10",
@@ -20,15 +20,15 @@
     "typescript": "~6.0.3"
   },
   "peerDependencies": {
-    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.12",
-    "@nomicfoundation/hardhat-ethers-chai-matchers": "workspace:^3.0.9",
-    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.6",
-    "@nomicfoundation/hardhat-ignition-ethers": "workspace:^3.1.5",
-    "@nomicfoundation/hardhat-keystore": "workspace:^3.0.11",
-    "@nomicfoundation/hardhat-mocha": "workspace:^3.0.20",
-    "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.9",
-    "@nomicfoundation/hardhat-typechain": "workspace:^3.1.0",
-    "@nomicfoundation/hardhat-verify": "workspace:^3.0.18",
-    "@nomicfoundation/ignition-core": "workspace:^3.1.6"
+    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.13",
+    "@nomicfoundation/hardhat-ethers-chai-matchers": "workspace:^3.0.10",
+    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.7",
+    "@nomicfoundation/hardhat-ignition-ethers": "workspace:^3.1.6",
+    "@nomicfoundation/hardhat-keystore": "workspace:^3.0.12",
+    "@nomicfoundation/hardhat-mocha": "workspace:^3.0.21",
+    "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.10",
+    "@nomicfoundation/hardhat-typechain": "workspace:^3.1.1",
+    "@nomicfoundation/hardhat-verify": "workspace:^3.0.19",
+    "@nomicfoundation/ignition-core": "workspace:^3.1.7"
   }
 }

package/templates/hardhat-3/02-mocha-ethers/tsconfig.json

@@ -5,6 +5,7 @@
     "target": "es2023",
     "skipLibCheck": true,
     "outDir": "dist",
-    "types": ["node", "mocha"]
+    "types": ["node", "mocha"],
+    "verbatimModuleSyntax": true
   }
 }

package/templates/hardhat-3/03-minimal/README.md

@@ -1,6 +1,6 @@
-# Sample Hardhat 3 Beta Project (minimal)
+# Sample Hardhat 3 Project (minimal)
 
-This project has a minimal setup of Hardhat 3 Beta, without any plugins.
+This project has a minimal setup of Hardhat 3, without any plugins.
 
 ## What's included?
 

package/templates/hardhat-3/03-minimal/package.json

@@ -5,7 +5,7 @@
   "description": "A minimal Hardhat project",
   "type": "module",
   "devDependencies": {
-    "hardhat": "workspace:^3.6.0",
+    "hardhat": "workspace:^3.8.0",
     "@types/node": "^22.8.5",
     "typescript": "~6.0.3"
   }

package/templates/hardhat-3/03-minimal/tsconfig.json

@@ -5,6 +5,7 @@
     "target": "es2023",
     "skipLibCheck": true,
     "outDir": "dist",
-    "types": ["node"]
+    "types": ["node"],
+    "verbatimModuleSyntax": true
   }
 }