hardhat 3.7.0 → 3.8.0

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/package.json

@@ -5,22 +5,22 @@
   "description": "A TypeScript Hardhat project using Node Test Runner and Viem",
   "type": "module",
   "devDependencies": {
-    "hardhat": "workspace:^3.7.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/package.json

@@ -5,10 +5,10 @@
   "description": "A TypeScript Hardhat project using Mocha and Ethers.js",
   "type": "module",
   "devDependencies": {
-    "hardhat": "workspace:^3.7.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/package.json

@@ -5,7 +5,7 @@
   "description": "A minimal Hardhat project",
   "type": "module",
   "devDependencies": {
-    "hardhat": "workspace:^3.7.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
   }
 }