hardhat 3.7.0 → 3.9.0

package/dist/src/internal/{builtin-plugins/solidity-test/eip712 → utils}/glob.js

@@ -9,10 +9,10 @@ export function isPathSelected(path, include, exclude) {
     if (include.length === 0) {
         return false;
     }
-    if (!matchesAny(path, include)) {
+    if (!matchesAnyGlob(path, include)) {
         return false;
     }
-    if (exclude.length > 0 && matchesAny(path, exclude)) {
+    if (exclude.length > 0 && matchesAnyGlob(path, exclude)) {
         return false;
     }
     return true;
@@ -20,7 +20,7 @@ export function isPathSelected(path, include, exclude) {
 /**
  * Returns true if `value` matches at least one of the given glob patterns.
  */
-function matchesAny(value, patterns) {
+export function matchesAnyGlob(value, patterns) {
     for (const pattern of patterns) {
         if (getCompiledGlob(pattern).test(value)) {
             return true;

package/dist/src/internal/utils/glob.js.map

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

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.9.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/config.ts

@@ -0,0 +1,28 @@
+import type { HardhatUserConfig } from "../../../config.js";
+import type { CoverageConfig } from "../../../types/config.js";
+import type { HardhatUserConfigValidationError } from "../../../types/hooks.js";
+
+import { validateUserConfigZodType } from "@nomicfoundation/hardhat-zod-utils";
+import { z } from "zod";
+
+const userConfigType = z.object({
+  coverage: z
+    .object({
+      skipFiles: z.array(z.string()).optional(),
+    })
+    .optional(),
+});
+
+export function validateCoverageUserConfig(
+  userConfig: unknown,
+): HardhatUserConfigValidationError[] {
+  return validateUserConfigZodType(userConfig, userConfigType);
+}
+
+export function resolveCoverageConfig(
+  userConfig: HardhatUserConfig,
+): CoverageConfig {
+  return {
+    skipFiles: userConfig.coverage?.skipFiles ?? [],
+  };
+}

package/src/internal/builtin-plugins/coverage/hook-handlers/config.ts

@@ -0,0 +1,30 @@
+import type { ConfigHooks } from "../../../../types/hooks.js";
+
+import {
+  resolveCoverageConfig,
+  validateCoverageUserConfig,
+} from "../config.js";
+
+export default async (): Promise<Partial<ConfigHooks>> => {
+  const handlers: Partial<ConfigHooks> = {
+    validateUserConfig: async (userConfig) =>
+      validateCoverageUserConfig(userConfig),
+    resolveUserConfig: async (
+      userConfig,
+      resolveConfigurationVariable,
+      next,
+    ) => {
+      const resolvedConfig = await next(
+        userConfig,
+        resolveConfigurationVariable,
+      );
+
+      return {
+        ...resolvedConfig,
+        coverage: resolveCoverageConfig(userConfig),
+      };
+    },
+  };
+
+  return handlers;
+};

package/src/internal/builtin-plugins/coverage/hook-handlers/solidity.ts

@@ -8,6 +8,8 @@ import { HardhatError } from "@nomicfoundation/hardhat-errors";
 import { createDebug } from "@nomicfoundation/hardhat-utils/debug";
 import { ensureError } from "@nomicfoundation/hardhat-utils/error";
 
+import { matchesAnyGlob } from "../../../utils/glob.js";
+import { toUserSourceName } from "../../solidity/source-names.js";
 import { getCoverageManager } from "../helpers/accessors.js";
 import { instrumentSolidityFileForCompilationJob } from "../instrumentation.js";
 
@@ -22,12 +24,23 @@ export default async (): Promise<Partial<SolidityHooks>> => ({
     solcVersion,
     next,
   ) => {
+    // This hook runs on every project file of every build. Coverage is the
+    // only reason to preprocess them, so when it is off we pass the file
+    // through untouched and keep the common path free of the work below.
+    if (!context.globalOptions.coverage) {
+      return await next(context, sourceName, fsPath, fileContent, solcVersion);
+    }
+
     // NOTE: We do not want to instrument the test project files as we don't
     // want to report coverage for them.
-
     const isTestSource = (await context.solidity.getScope(fsPath)) === "tests";
 
-    if (context.globalOptions.coverage && !isTestSource) {
+    const isSkipped = matchesAnyGlob(
+      toUserSourceName(sourceName),
+      context.config.coverage.skipFiles,
+    );
+
+    if (!isTestSource && !isSkipped) {
       try {
         const { source, metadata } = instrumentSolidityFileForCompilationJob({
           compilationJobSolcVersion: solcVersion,

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: [
@@ -15,11 +16,12 @@ const hardhatPlugin: HardhatPlugin = {
   ],
   hookHandlers: {
     clean: () => import("./hook-handlers/clean.js"),
+    config: () => import("./hook-handlers/config.js"),
     hre: () => import("./hook-handlers/hre.js"),
     solidity: () => import("./hook-handlers/solidity.js"),
     test: () => import("./hook-handlers/test.js"),
   },
   npmPackage: "hardhat",
-};
+});
 
 export default hardhatPlugin;

package/src/internal/builtin-plugins/coverage/type-extensions.ts

@@ -3,3 +3,27 @@ declare module "../../../types/global-options.js" {
     coverage: boolean;
   }
 }
+
+declare module "../../../types/config.js" {
+  export interface CoverageUserConfig {
+    /**
+     * Globs of Solidity source files to exclude from coverage instrumentation.
+     * A project file whose project-relative source name matches any of these
+     * globs is not instrumented during a `--coverage` run, and so does not
+     * appear in coverage reports.
+     */
+    skipFiles?: string[];
+  }
+
+  export interface HardhatUserConfig {
+    coverage?: CoverageUserConfig;
+  }
+
+  export interface CoverageConfig {
+    skipFiles: string[];
+  }
+
+  export interface HardhatConfig {
+    coverage: CoverageConfig;
+  }
+}

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/genesis-state.ts

@@ -12,6 +12,7 @@ import {
   opHardforkFromString,
   type AccountOverride,
 } from "@nomicfoundation/edr";
+import { bytesToHexString } from "@nomicfoundation/hardhat-utils/hex";
 import { AsyncMutex } from "@nomicfoundation/hardhat-utils/synchronization";
 import { hexToBytes } from "ethereum-cryptography/utils";
 
@@ -50,7 +51,7 @@ const genesisStateAndAccountsCache: WeakMap<
       Map<
         string,
         {
-          genesisState: Map<Uint8Array, AccountOverride>;
+          genesisState: Map<string, AccountOverride>;
           ownedAccounts: Array<{ secretKey: string; balance: bigint }>;
         }
       >
@@ -66,7 +67,7 @@ export async function getGenesisStateAndOwnedAccounts(
   chainType: ChainType,
   specId: string,
 ): Promise<{
-  genesisState: Map<Uint8Array, AccountOverride>;
+  genesisState: Map<string, AccountOverride>;
   ownedAccounts: Array<{ secretKey: string; balance: bigint }>;
 }> {
   const cached = genesisStateAndAccountsCache
@@ -131,7 +132,7 @@ async function createGenesisStateAndOwnedAccounts(
   chainType: ChainType,
   specId: string,
 ): Promise<{
-  genesisState: Map<Uint8Array, AccountOverride>;
+  genesisState: Map<string, AccountOverride>;
   ownedAccounts: Array<{ secretKey: string; balance: bigint }>;
 }> {
   if (microEthSignerAddress === undefined) {
@@ -142,7 +143,7 @@ async function createGenesisStateAndOwnedAccounts(
 
   const ownedAccounts = await hardhatAccountsToEdrOwnedAccounts(accountsConfig);
 
-  const genesisState: Map<Uint8Array, AccountOverride> = new Map(
+  const genesisState: Map<string, AccountOverride> = new Map(
     ownedAccounts.map(({ secretKey, balance }) => {
       const address = hexToBytes(addr.fromPrivateKey(secretKey));
       const accountOverride: AccountOverride = {
@@ -151,7 +152,7 @@ async function createGenesisStateAndOwnedAccounts(
         code: new Uint8Array(), // Empty account code, removing potential delegation code when forking
       };
 
-      return [address, accountOverride];
+      return [bytesToHexString(address), accountOverride];
     }),
   );
 
@@ -162,18 +163,25 @@ async function createGenesisStateAndOwnedAccounts(
         ? opGenesisState(opHardforkFromString(specId))
         : l1GenesisState(l1HardforkFromString(specId));
 
+  mergeGenesisState(genesisState, chainGenesisState);
+
+  return { genesisState, ownedAccounts };
+}
+
+export function mergeGenesisState(
+  genesisState: Map<string, AccountOverride>,
+  chainGenesisState: readonly AccountOverride[],
+): void {
   for (const account of chainGenesisState) {
-    const existingOverride = genesisState.get(account.address);
+    const addressKey = bytesToHexString(account.address);
+    const existingOverride = genesisState.get(addressKey);
     if (existingOverride !== undefined) {
       // Favor the genesis state specified by the user
-      account.balance = account.balance ?? existingOverride.balance;
-      account.nonce = account.nonce ?? existingOverride.nonce;
-      account.code = account.code ?? existingOverride.code;
-      account.storage = account.storage ?? existingOverride.storage;
-    } else {
-      genesisState.set(account.address, account);
+      account.balance = existingOverride.balance ?? account.balance;
+      account.nonce = existingOverride.nonce ?? account.nonce;
+      account.code = existingOverride.code ?? account.code;
+      account.storage = existingOverride.storage ?? account.storage;
     }
+    genesisState.set(addressKey, account);
   }
-
-  return { genesisState, ownedAccounts };
 }

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/network-manager/type-validation.ts

@@ -322,7 +322,20 @@ const edrNetworkUserConfigSchema = z.object({
   hardfork: z.optional(z.string()),
   initialBaseFeePerGas: z.optional(gasUnitUserConfigSchema),
   initialDate: z.optional(
-    unionType([z.string(), z.instanceof(Date)], "Expected a string or a Date"),
+    unionType(
+      [z.string(), z.instanceof(Date)],
+      "Expected a string or a Date",
+    ).refine(
+      (val) => {
+        if (typeof val === "string") return !Number.isNaN(Date.parse(val));
+        if (val instanceof Date) return !Number.isNaN(val.getTime());
+        // already union of string/Date, all types are exhausted
+        return true;
+      },
+      {
+        message: "initialDate must be a parseable date string or a valid Date",
+      },
+    ),
   ),
   loggingEnabled: z.optional(z.boolean()),
   minGasPrice: z.optional(gasUnitUserConfigSchema),

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;