hardhat 3.0.6 → 3.0.8

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

@@ -15,6 +15,7 @@ import {
  *
  * @param basePathForNpmResolution the dir path for node module resolution
  * @param plugin the plugin to be validated
+ * @param originalError the original error why we are running this function
  * @throws {HardhatError} with descriptor:
  * - {@link HardhatError.ERRORS.CORE.PLUGINS.PLUGIN_NOT_INSTALLED} if the plugin is
  * not installed as an npm package
@@ -26,6 +27,7 @@ import {
 export async function detectPluginNpmDependencyProblems(
   basePathForNpmResolution: string,
   plugin: HardhatPlugin,
+  originalError: Error,
 ): Promise<void> {
   if (plugin.npmPackage === null) {
     return;
@@ -43,6 +45,7 @@ export async function detectPluginNpmDependencyProblems(
       {
         pluginId: plugin.id,
       },
+      originalError,
     );
   }
 
@@ -71,6 +74,7 @@ export async function detectPluginNpmDependencyProblems(
           pluginId: plugin.id,
           peerDependencyName: dependencyName,
         },
+        originalError,
       );
     }
 
@@ -91,6 +95,7 @@ export async function detectPluginNpmDependencyProblems(
           installedVersion,
           expectedVersion: versionSpec,
         },
+        originalError,
       );
     }
   }

package/src/internal/core/plugins/resolve-plugin-list.ts

@@ -28,7 +28,7 @@ async function reverseTopologicalSort(
   plugins: HardhatPlugin[],
 ): Promise<HardhatPlugin[]> {
   const visitedPlugins: Map<string, HardhatPlugin> = new Map();
-  const result: HardhatPlugin[] = [];
+  const resolvedPlugins: HardhatPlugin[] = [];
 
   async function dfs(plugin: HardhatPlugin) {
     const visited = visitedPlugins.get(plugin.id);
@@ -53,7 +53,7 @@ async function reverseTopologicalSort(
         dependencyModules = await Promise.all(plugin.dependencies());
       } catch (error) {
         ensureError(error);
-        await detectPluginNpmDependencyProblems(projectRoot, plugin);
+        await detectPluginNpmDependencyProblems(projectRoot, plugin, error);
 
         throw new HardhatError(
           HardhatError.ERRORS.CORE.PLUGINS.PLUGIN_DEPENDENCY_FAILED_LOAD,
@@ -69,12 +69,66 @@ async function reverseTopologicalSort(
       }
     }
 
-    result.push(plugin);
+    resolvedPlugins.push(plugin);
   }
 
   for (const plugin of plugins) {
     await dfs(plugin);
   }
 
-  return result;
+  // Resolve conditional dependencies iteratively
+  let lastResolvedCount = -1;
+
+  while (resolvedPlugins.length !== lastResolvedCount) {
+    lastResolvedCount = resolvedPlugins.length;
+
+    for (const plugin of resolvedPlugins) {
+      if (plugin.conditionalDependencies === undefined) {
+        continue;
+      }
+
+      for (const conditionalDependency of plugin.conditionalDependencies) {
+        // Check all condition plugins are installed
+        let conditionModules;
+        try {
+          conditionModules = await Promise.all(
+            conditionalDependency.condition(),
+          );
+        } catch (_error) {
+          continue;
+        }
+
+        // Check all condition plugins are loaded
+        if (
+          conditionModules.some(
+            (conditionPlugin) =>
+              !resolvedPlugins.includes(conditionPlugin.default),
+          )
+        ) {
+          continue;
+        }
+
+        // Load the conditional dependency
+        let pluginModule;
+        try {
+          pluginModule = await conditionalDependency.plugin();
+        } catch (error) {
+          ensureError(error);
+          await detectPluginNpmDependencyProblems(projectRoot, plugin, error);
+
+          throw new HardhatError(
+            HardhatError.ERRORS.CORE.PLUGINS.PLUGIN_DEPENDENCY_FAILED_LOAD,
+            {
+              pluginId: plugin.id,
+            },
+            error,
+          );
+        }
+
+        await dfs(pluginModule.default);
+      }
+    }
+  }
+
+  return resolvedPlugins;
 }

package/src/internal/core/tasks/resolved-task.ts

@@ -244,6 +244,7 @@ export class ResolvedTask implements Task {
         await detectPluginNpmDependencyProblems(
           this.#hre.config.paths.root,
           plugin,
+          error,
         );
       }
 

package/src/internal/utils/package.ts

@@ -1,9 +1,16 @@
 import type { PackageJson } from "@nomicfoundation/hardhat-utils/package";
 
-import { readClosestPackageJson } from "@nomicfoundation/hardhat-utils/package";
+import { readFile } from "node:fs/promises";
+
+import {
+  findClosestPackageRoot,
+  findDependencyPackageJson,
+  readClosestPackageJson,
+} from "@nomicfoundation/hardhat-utils/package";
 
 let cachedHardhatVersion: string | undefined;
 let cachedLatestHardhatVersion: string | undefined;
+let cachedEdrVersion: string | undefined;
 
 export async function getHardhatVersion(): Promise<string> {
   if (cachedHardhatVersion !== undefined) {
@@ -19,6 +26,29 @@ export async function getHardhatVersion(): Promise<string> {
   return packageJson.version;
 }
 
+export async function getEdrVersion(): Promise<string> {
+  if (cachedEdrVersion !== undefined) {
+    return cachedEdrVersion;
+  }
+
+  const hardhatRoot = await findClosestPackageRoot(import.meta.url);
+
+  const edrPackageJsonPath = await findDependencyPackageJson(
+    hardhatRoot,
+    "@nomicfoundation/edr",
+  );
+
+  if (edrPackageJsonPath === undefined) {
+    return "";
+  }
+
+  const rawPackageJson = await readFile(edrPackageJsonPath, "utf-8");
+  const edrPackageJson: PackageJson = JSON.parse(rawPackageJson);
+  cachedEdrVersion = edrPackageJson.version;
+
+  return cachedEdrVersion;
+}
+
 export async function getLatestHardhatVersion(): Promise<string> {
   const { getRequest } = await import("@nomicfoundation/hardhat-utils/request");
 

package/src/types/hre.ts

@@ -11,6 +11,10 @@ export interface HardhatRuntimeEnvironment {
   readonly userConfig: HardhatUserConfig;
   readonly globalOptions: GlobalOptions;
   readonly interruptions: UserInterruptionManager;
+  readonly versions: {
+    readonly hardhat: string;
+    readonly edr: string;
+  };
   // These fields are defined using module agumentation despite being part of
   // Hardhat's core:
   // readonly hooks: HookManager;

package/src/types/network.ts

@@ -52,6 +52,21 @@ export interface NetworkManager {
   connect<ChainTypeT extends ChainType | string = DefaultChainType>(
     networkOrParams?: NetworkConnectionParams<ChainTypeT> | string,
   ): Promise<NetworkConnection<ChainTypeT>>;
+
+  /**
+   * Spawns an Ethereum JSON-RPC server listening on HTTP and Websocket.
+   *
+   * @param networkOrParams The network name or connection parameters.
+   * @param hostname Hostname to bind the server to. Defaults to localhost or 0.0.0.0 on docker.
+   * @param port Port to listen on. Defaults to a random available port.
+   *
+   * @return A `JsonRpcServer` instance that can be started with {@link JsonRpcServer.listen}.
+   */
+  createServer(
+    networkOrParams?: NetworkConnectionParams | string,
+    hostname?: string,
+    port?: number,
+  ): Promise<JsonRpcServer>;
 }
 
 export interface NetworkConnection<
@@ -65,3 +80,33 @@ export interface NetworkConnection<
 
   close(): Promise<void>;
 }
+
+/**
+ * An Ethereum JSON-RPC server that accepts connections via HTTP and websocket.
+ */
+export interface JsonRpcServer {
+  /**
+   * Starts the Ethereum JSON-RPC server.
+   *
+   * @returns returns the address and port the server is listening on.
+   */
+  listen(): Promise<{ address: string; port: number }>;
+
+  /**
+   * Closes the Ethereum JSON-RPC server.
+   *
+   * @returns A promise that resolves once shutdown is finished.
+   */
+  close(): Promise<void>;
+
+  /**
+   * Resolves once the Ethereum JSON-RPC server has been
+   * closed, including its underlying HTTP and Websocket sockets.
+   *
+   * Useful for awaiting a shutdown that was initiated elsewhere.
+   *
+   * @returns A promise that resolves once the server and
+   *   its sockets have been closed.
+   */
+  afterClosed(): Promise<void>;
+}

package/src/types/plugins.ts

@@ -39,6 +39,11 @@ export interface HardhatPlugin {
    */
   dependencies?: () => Array<Promise<{ default: HardhatPlugin }>>;
 
+  conditionalDependencies?: Array<{
+    condition: () => Array<Promise<{ default: HardhatPlugin }>>;
+    plugin: () => Promise<{ default: HardhatPlugin }>;
+  }>;
+
   /**
    * An object with the different hook handlers that this plugin defines.
    *

package/src/types/solidity/build-system.ts

@@ -38,18 +38,18 @@ export interface BuildOptions {
   concurrency?: number;
 
   /**
-   * An array of remappings provided by the user.
+   * If `true`, the build process doesn't print any output.
    */
-  userProvidedRemappings?: string[];
+  quiet?: boolean;
 
   /**
-   * If `true`, the build process doesn't print any output.
+   * Whether to compile contracts or tests. Defaults to contracts
    */
-  quiet?: boolean;
+  scope?: BuildScope;
 }
 
 /**
- * The options of the `getBuildInfos` method.
+ * The options of the `getCompilationJobs` method.
  *
  * Note that this option object includes a `quiet` property, as this process
  * may require downloading compilers, and potentially printing some output.
@@ -196,7 +196,12 @@ export interface SolidityBuildSystem {
    *
    * @returns An array of root file paths.
    */
-  getRootFilePaths(): Promise<string[]>;
+  getRootFilePaths(options?: { scope?: BuildScope }): Promise<string[]>;
+
+  /**
+   * Given the filesystem path for a source file, returns the build scope
+   */
+  getScope(fsPath: string): Promise<BuildScope>;
 
   /**
    * Builds the provided files, generating their compilation artifacts.
@@ -272,6 +277,7 @@ export interface SolidityBuildSystem {
   emitArtifacts(
     compilationJob: CompilationJob,
     compilerOutput: CompilerOutput,
+    options?: { scope?: BuildScope },
   ): Promise<EmitArtifactsResult>;
 
   /**
@@ -287,7 +293,10 @@ export interface SolidityBuildSystem {
 
    * @param rootFilePaths All the root files of the project.
    */
-  cleanupArtifacts(rootFilePaths: string[]): Promise<void>;
+  cleanupArtifacts(
+    rootFilePaths: string[],
+    options?: { scope?: BuildScope },
+  ): Promise<void>;
 
   /**
    * Compiles a build info, returning the output of the compilation, verbatim,
@@ -301,4 +310,11 @@ export interface SolidityBuildSystem {
     buildInfo: SolidityBuildInfo,
     options?: CompileBuildInfoOptions,
   ): Promise<CompilerOutput>;
+
+  /**
+   * Gets the artifacts directory for a given target (contracts/tests)
+   */
+  getArtifactsDirectory(scope: BuildScope): Promise<string>;
 }
+
+export type BuildScope = "contracts" | "tests";

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

@@ -5,7 +5,7 @@
   "description": "A TypeScript Hardhat project using Node Test Runner and Viem",
   "type": "module",
   "devDependencies": {
-    "hardhat": "workspace:^3.0.6",
+    "hardhat": "workspace:^3.0.8",
     "@nomicfoundation/hardhat-toolbox-viem": "workspace:^5.0.0",
     "@nomicfoundation/hardhat-ignition": "workspace:^3.0.0",
     "@types/node": "^22.8.5",
@@ -16,11 +16,11 @@
   "peerDependencies": {
     "@nomicfoundation/hardhat-ignition-viem": "workspace:^3.0.0",
     "@nomicfoundation/hardhat-keystore": "workspace:^3.0.0",
-    "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.0",
+    "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.1",
     "@nomicfoundation/hardhat-node-test-runner": "workspace:^3.0.0",
     "@nomicfoundation/hardhat-viem": "workspace:^3.0.0",
     "@nomicfoundation/hardhat-viem-assertions": "workspace:^3.0.0",
-    "@nomicfoundation/hardhat-verify": "workspace:^3.0.0",
+    "@nomicfoundation/hardhat-verify": "workspace:^3.0.4",
     "@nomicfoundation/ignition-core": "workspace:^3.0.0"
   }
 }

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

@@ -5,7 +5,7 @@
   "description": "A TypeScript Hardhat project using Mocha and Ethers.js",
   "type": "module",
   "devDependencies": {
-    "hardhat": "workspace:^3.0.6",
+    "hardhat": "workspace:^3.0.8",
     "@nomicfoundation/hardhat-toolbox-mocha-ethers": "workspace:^3.0.0",
     "@nomicfoundation/hardhat-ignition": "workspace:^3.0.0",
     "@types/chai": "^4.2.0",
@@ -19,15 +19,15 @@
     "typescript": "~5.8.0"
   },
   "peerDependencies": {
-    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.0",
+    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.2",
     "@nomicfoundation/hardhat-ethers-chai-matchers": "workspace:^3.0.0",
     "@nomicfoundation/hardhat-ignition": "workspace:^3.0.0",
     "@nomicfoundation/hardhat-ignition-ethers": "workspace:^3.0.0",
     "@nomicfoundation/hardhat-keystore": "workspace:^3.0.0",
-    "@nomicfoundation/hardhat-mocha": "workspace:^3.0.0",
-    "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.0",
+    "@nomicfoundation/hardhat-mocha": "workspace:^3.0.3",
+    "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.1",
     "@nomicfoundation/hardhat-typechain": "workspace:^3.0.0",
-    "@nomicfoundation/hardhat-verify": "workspace:^3.0.0",
+    "@nomicfoundation/hardhat-verify": "workspace:^3.0.4",
     "@nomicfoundation/ignition-core": "workspace:^3.0.0"
   }
 }