hardhat 3.2.0 → 3.3.0

package/src/internal/core/hre.ts

@@ -13,6 +13,7 @@ import type {
   GlobalOptionDefinitions,
 } from "../../types/global-options.js";
 import type {
+  HardhatConfigValidationError,
   HardhatUserConfigValidationError,
   HookContext,
   HookManager,
@@ -96,6 +97,20 @@ export class HardhatRuntimeEnvironmentImplementation
     );
 
     if (!configResolutionResult.success) {
+      if (configResolutionResult.configValidationErrors !== undefined) {
+        throw new HardhatError(
+          HardhatError.ERRORS.CORE.GENERAL.INVALID_RESOLVED_CONFIG,
+          {
+            errors: `\t${configResolutionResult.configValidationErrors
+              .map(
+                (error) =>
+                  `* Resolved config error in config.${error.path.join(".")}: ${error.message}`,
+              )
+              .join("\n\t")}`,
+          },
+        );
+      }
+
       throw new HardhatError(HardhatError.ERRORS.CORE.GENERAL.INVALID_CONFIG, {
         errors: `\t${configResolutionResult.userConfigValidationErrors
           .map(
@@ -211,6 +226,7 @@ export async function resolveUserConfigToHardhatConfig(
   | {
       success: false;
       userConfigValidationErrors: HardhatUserConfigValidationError[];
+      configValidationErrors?: HardhatConfigValidationError[];
     }
 > {
   // extend user config:
@@ -225,6 +241,7 @@ export async function resolveUserConfigToHardhatConfig(
     extendedUserConfig,
   );
 
+  // If user config is structurally invalid, we can't resolve — return early.
   if (userConfigValidationErrors.length > 0) {
     return {
       success: false,
@@ -252,6 +269,22 @@ export async function resolveUserConfigToHardhatConfig(
     plugins: resolvedPlugins,
   };
 
+  // Validate the resolved config (post-resolution checks).
+  const resolvedConfigValidationResults = await hooks.runSequentialHandlers(
+    "config",
+    "validateResolvedConfig",
+    [config],
+  );
+  const resolvedConfigValidationErrors = resolvedConfigValidationResults.flat();
+
+  if (resolvedConfigValidationErrors.length > 0) {
+    return {
+      success: false,
+      userConfigValidationErrors: [],
+      configValidationErrors: resolvedConfigValidationErrors,
+    };
+  }
+
   return { success: true, config, extendedUserConfig };
 }
 

package/src/internal/core/plugins/detect-plugin-npm-dependency-problems.ts

@@ -1,4 +1,5 @@
 import type { HardhatPlugin } from "../../../types/plugins.js";
+import type { satisfies as SatisfiesT } from "semver";
 
 import path from "node:path";
 
@@ -9,6 +10,10 @@ import {
   type PackageJson,
 } from "@nomicfoundation/hardhat-utils/package";
 
+// semver is slow to load, and this file is loaded by HookManager, so we lazy
+// load it.
+let satisfies: typeof SatisfiesT | undefined;
+
 /**
  * Validate that a plugin is installed and that its peer dependencies are
  * installed and satisfy the version constraints.
@@ -84,7 +89,9 @@ export async function detectPluginNpmDependencyProblems(
 
     const installedVersion = dependencyPackageJson.version;
 
-    const { satisfies } = await import("semver");
+    if (satisfies === undefined) {
+      ({ satisfies } = await import("semver"));
+    }
 
     if (!satisfies(installedVersion, versionSpec.replace("workspace:", ""))) {
       throw new HardhatError(

package/src/internal/core/user-interruptions.ts

@@ -1,8 +1,11 @@
 import type { HookContext, HookManager } from "../../types/hooks.js";
 import type { UserInterruptionManager } from "../../types/user-interruptions.js";
 
+import { createInterface } from "node:readline";
+
 import { assertHardhatInvariant } from "@nomicfoundation/hardhat-errors";
 import { AsyncMutex } from "@nomicfoundation/hardhat-utils/synchronization";
+import chalk from "chalk";
 
 export class UserInterruptionManagerImplementation
   implements UserInterruptionManager
@@ -68,7 +71,6 @@ async function defaultDisplayMessage(
   interruptor: string,
   message: string,
 ) {
-  const chalk = (await import("chalk")).default;
   console.log(chalk.blue(`[${interruptor}]`) + ` ${message}`);
 }
 
@@ -77,8 +79,6 @@ async function defaultRequestInput(
   interruptor: string,
   inputDescription: string,
 ): Promise<string> {
-  const { createInterface } = await import("node:readline");
-  const chalk = (await import("chalk")).default;
   const rl = createInterface({
     input: process.stdin,
     output: process.stdout,
@@ -100,8 +100,6 @@ async function defaultRequestSecretInput(
   interruptor: string,
   inputDescription: string,
 ): Promise<string> {
-  const { createInterface } = await import("node:readline");
-  const chalk = (await import("chalk")).default;
   const rl = createInterface({
     input: process.stdin,
     output: process.stdout,

package/src/internal/utils/colorizer.ts

@@ -0,0 +1,9 @@
+export interface Colorizer {
+  blue: (text: string) => string;
+  green: (text: string) => string;
+  red: (text: string) => string;
+  cyan: (text: string) => string;
+  yellow: (text: string) => string;
+  grey: (text: string) => string;
+  dim: (text: string) => string;
+}

package/src/internal/utils/package.ts

@@ -7,6 +7,7 @@ import {
   findDependencyPackageJson,
   readClosestPackageJson,
 } from "@nomicfoundation/hardhat-utils/package";
+import { getRequest } from "@nomicfoundation/hardhat-utils/request";
 
 let cachedHardhatVersion: string | undefined;
 let cachedLatestHardhatVersion: string | undefined;
@@ -50,8 +51,6 @@ export async function getEdrVersion(): Promise<string> {
 }
 
 export async function getLatestHardhatVersion(): Promise<string> {
-  const { getRequest } = await import("@nomicfoundation/hardhat-utils/request");
-
   if (cachedLatestHardhatVersion !== undefined) {
     return cachedLatestHardhatVersion;
   }

package/src/types/global-options.ts

@@ -21,6 +21,7 @@ export interface GlobalOptions {
   help: boolean;
   init: boolean;
   showStackTraces: boolean;
+  verbosity: number;
   version: boolean;
 }
 

package/src/types/hooks.ts

@@ -93,6 +93,20 @@ export interface ConfigHooks {
       nextResolveConfigurationVariable: ConfigurationVariableResolver,
     ) => Promise<HardhatConfig>,
   ) => Promise<HardhatConfig>;
+
+  /**
+   * Provide a handler for this hook to validate the resolved config.
+   *
+   * This hook runs after all plugins have resolved their config. Use it to
+   * validate cross-cutting concerns that require the fully resolved config
+   * (e.g., checking that all compiler types are registered).
+   *
+   * @param resolvedConfig The fully resolved config.
+   * @returns An array of validation errors.
+   */
+  validateResolvedConfig: (
+    resolvedConfig: HardhatConfig,
+  ) => Promise<HardhatConfigValidationError[]>;
 }
 
 /**
@@ -114,6 +128,29 @@ export interface HardhatUserConfigValidationError {
   message: string;
 }
 
+/**
+ * A `HardhatConfig` validation error.
+ *
+ * This is the equivalent of `HardhatUserConfigValidationError` but for the
+ * resolved config.
+ */
+export interface HardhatConfigValidationError {
+  /**
+   * The path from the resolved config object to the value that originated this
+   * validation error.
+   *
+   * For example, if `config.solidity.profiles.foo.compilers[0].type` is
+   * invalid, this array would be
+   * `["solidity", "profiles", "foo", "compilers", 0, "type"]`.
+   */
+  path: Array<string | number>;
+
+  /**
+   * The error message.
+   */
+  message: string;
+}
+
 /**
  * ConfigurationVariable-related hooks.
  */

package/src/types/solidity/compilation-job.ts

@@ -1,9 +1,9 @@
 import type { CompilerInput } from "./compiler-io.js";
 import type { DependencyGraph } from "./dependency-graph.js";
-import type { SolcConfig } from "../config.js";
+import type { SolidityCompilerConfig } from "../config.js";
 
 /**
- * A compilation job to be run using solc.
+ * A compilation job to be run.
  */
 export interface CompilationJob {
   /**
@@ -13,12 +13,12 @@ export interface CompilationJob {
   dependencyGraph: DependencyGraph;
 
   /**
-   * The solc config to use.
+   * The compiler config to use.
    */
-  solcConfig: SolcConfig;
+  solcConfig: SolidityCompilerConfig;
 
   /**
-   * The long version of the solc compiler to be used.
+   * The long version of the compiler to be used.
    */
   solcLongVersion: string;
 

package/src/types/solidity/solidity-artifacts.ts

@@ -14,6 +14,12 @@ export interface SolidityBuildInfo {
   /**
    * The id of the build, which is derived from the rest of the data,
    * guaranteeing that it's unique and deterministic.
+   *
+   * When `compilerType` is present and is not "solc", the format is:
+   *   `solc-<major>_<minor>_<patch>-<compiler-type>-<job-hash>`
+   *
+   * Otherwise (i.e. solc or undefined), the format is:
+   *   `solc-<major>_<minor>_<patch>-<job-hash>`
    */
   readonly id: string;
 
@@ -27,6 +33,16 @@ export interface SolidityBuildInfo {
    */
   readonly solcLongVersion: string;
 
+  /**
+   * The compiler type used for this build. If absent or undefined, it means
+   * "solc" was used.
+   *
+   * Note: This is typed as `string` rather than `SolidityCompilerType` because
+   * the build info may come from a different Hardhat setup where the compiler
+   * type may not be registered in the current type definitions.
+   */
+  readonly compilerType?: string;
+
   /**
    * A mapping from user source names to input source names, for the root
    * files of the build (i.e. the files whose artifacts where being compiled).

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.2.0",
+    "hardhat": "workspace:^3.3.0",
     "@nomicfoundation/hardhat-toolbox-viem": "workspace:^5.0.3",
-    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.0",
+    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.1",
     "@types/node": "^22.8.5",
     "forge-std": "foundry-rs/forge-std#v1.9.4",
     "typescript": "~5.8.0",
     "viem": "^2.43.0"
   },
   "peerDependencies": {
-    "@nomicfoundation/hardhat-ignition-viem": "workspace:^3.1.0",
+    "@nomicfoundation/hardhat-ignition-viem": "workspace:^3.1.1",
     "@nomicfoundation/hardhat-keystore": "workspace:^3.0.5",
     "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.4",
     "@nomicfoundation/hardhat-node-test-runner": "workspace:^3.0.12",
     "@nomicfoundation/hardhat-viem": "workspace:^3.0.4",
     "@nomicfoundation/hardhat-viem-assertions": "workspace:^3.0.7",
-    "@nomicfoundation/hardhat-verify": "workspace:^3.0.12",
-    "@nomicfoundation/ignition-core": "workspace:^3.1.0"
+    "@nomicfoundation/hardhat-verify": "workspace:^3.0.13",
+    "@nomicfoundation/ignition-core": "workspace:^3.1.1"
   }
 }

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.2.0",
+    "hardhat": "workspace:^3.3.0",
     "@nomicfoundation/hardhat-toolbox-mocha-ethers": "workspace:^3.0.3",
-    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.6",
-    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.0",
+    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.7",
+    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.1",
     "@types/chai": "^5.2.3",
     "@types/chai-as-promised": "^8.0.1",
     "@types/mocha": ">=10.0.10",
@@ -20,15 +20,15 @@
     "typescript": "~5.8.0"
   },
   "peerDependencies": {
-    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.6",
-    "@nomicfoundation/hardhat-ethers-chai-matchers": "workspace:^3.0.3",
-    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.0",
-    "@nomicfoundation/hardhat-ignition-ethers": "workspace:^3.1.0",
+    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.7",
+    "@nomicfoundation/hardhat-ethers-chai-matchers": "workspace:^3.0.4",
+    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.1",
+    "@nomicfoundation/hardhat-ignition-ethers": "workspace:^3.1.1",
     "@nomicfoundation/hardhat-keystore": "workspace:^3.0.5",
-    "@nomicfoundation/hardhat-mocha": "workspace:^3.0.14",
+    "@nomicfoundation/hardhat-mocha": "workspace:^3.0.15",
     "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.4",
-    "@nomicfoundation/hardhat-typechain": "workspace:^3.0.4",
-    "@nomicfoundation/hardhat-verify": "workspace:^3.0.12",
-    "@nomicfoundation/ignition-core": "workspace:^3.1.0"
+    "@nomicfoundation/hardhat-typechain": "workspace:^3.0.5",
+    "@nomicfoundation/hardhat-verify": "workspace:^3.0.13",
+    "@nomicfoundation/ignition-core": "workspace:^3.1.1"
   }
 }

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

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