hardhat 3.3.0 → 3.4.1

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

@@ -43,7 +43,13 @@ export interface BuildOptions {
   quiet?: boolean;
 
   /**
-   * Whether to compile contracts or tests. Defaults to contracts
+   * Whether to compile contracts or tests. Defaults to contracts.
+   *
+   * When `solidity.splitTestsCompilation` is `false` (the default), only
+   * `"contracts"` is accepted.
+   *
+   * When `solidity.splitTestsCompilation` is `true`, both scopes are valid
+   * and produce separate compilation passes.
    */
   scope?: BuildScope;
 }
@@ -272,6 +278,16 @@ export interface SolidityBuildSystem {
    * The root files are either absolute paths or
    * `npm:<package-name>/<file-path>` URIs.
    *
+   * When `solidity.splitTestsCompilation` is `false`, contracts and tests are
+   * compiled together and `scope: "contracts"` returns every build root:
+   * contract roots, test roots, and `npmFilesToBuild` roots.
+   *
+   * Calling this method with `scope: "tests"` in this mode is a logic error and
+   * throws a `HardhatError`.
+   *
+   * When `solidity.splitTestsCompilation` is `true`, `scope: "contracts"`
+   * returns only contract roots and `scope: "tests"` returns only test roots.
+   *
    * @returns An array of root file paths.
    */
   getRootFilePaths(options?: { scope?: BuildScope }): Promise<string[]>;
@@ -284,6 +300,15 @@ export interface SolidityBuildSystem {
   /**
    * Builds the provided files, generating their compilation artifacts.
    *
+   * When `solidity.splitTestsCompilation` is `false`, this method rejects
+   * `scope: "tests"` as a logic error and throws a `HardhatError`
+   *
+   * In this mode, callers must use `scope: "contracts"` and contracts and tests
+   * are built together, emitting their artifacts into the same directory.
+   *
+   * When `solidity.splitTestsCompilation` is `true`, both scopes are valid
+   * and are built into separate artifact directories.
+   *
    * @param rootFilePaths The files to build, which can be either absolute paths
    * or `npm:<package-name>/<file-path>` URIs.
    * @param options The options to use when building the files.
@@ -313,6 +338,9 @@ export interface SolidityBuildSystem {
    * can be returned for multiple files, so you should deduplicate the results
    * before using them.
    *
+   * When `solidity.splitTestsCompilation` is `false`, this method rejects
+   * `scope: "tests"` as a logic error and throws a `HardhatError`.
+   *
    * @param rootFilePaths The files to analyze, which can be either absolute
    * paths or `npm:<package-name>/<file-path>` URIs.
    * @param options The options to use when analyzing the files.
@@ -358,6 +386,13 @@ export interface SolidityBuildSystem {
   /**
    * Emits the artifacts of the given compilation job.
    *
+   * When `solidity.splitTestsCompilation` is `false`, this method rejects
+   * `scope: "tests"` as a logic error and throws a `HardhatError`
+   *
+   * Artifacts for both contracts and tests are emitted under the main artifacts
+   * directory when built with `scope: "contracts"` and `splitTestsCompilation`
+   * `false`.
+   *
    * @param compilationJob The compilation job to emit the artifacts of.
    * @param compilerOutput The result of running the compilation job.
    * @returns A map from user source name to the absolute paths of the
@@ -379,7 +414,25 @@ export interface SolidityBuildSystem {
    * This method should only be used after a complete build has succeeded, as
    * it relies on the build system to have generated all the necessary artifact
    * files.
-
+   *
+   * When `solidity.splitTestsCompilation` is `false`, this method rejects
+   * `scope: "tests"` as a logic error and throws a `HardhatError`. Cleanup in
+   * this mode operates on the main artifacts directory using `scope:
+   * "contracts"`.
+   *
+   * What is considered a complete build changes according to
+   * `splitTestsCompilation`:
+   *  - When it's `true`
+   *    - A full "contracts" build is run when `--no-contracts` isn't used, and
+   *      no explicit contract `files` are provided (i.e. you can still provide
+   *      explicit test `files`).
+   *    - A full "tests" build is run when `--no-tests` isn't used, and no
+   *      explicit test files `files` are provided (i.e. you can still provide
+   *      explicit contract `files`)
+   *  - When it's `false`
+   *    - A full build is when `files`, `--no-contracts`, nor `--no-tests` are
+   *      used.
+   *
    * @param rootFilePaths All the root files of the project.
    */
   cleanupArtifacts(
@@ -405,7 +458,17 @@ export interface SolidityBuildSystem {
   ): Promise<CompilerOutput>;
 
   /**
-   * Gets the artifacts directory for a given target (contracts/tests)
+   * Gets the artifacts directory for a given target (contracts/tests).
+   *
+   * When `solidity.splitTestsCompilation` is `false`, both scopes return the
+   * main artifacts directory, because contracts and tests share it.
+   *
+   * Unlike the other scope-aware methods, this one does not throw on that mode,
+   * as it's a read-only method that can be helpful for plugins.
+   *
+   * When `solidity.splitTestsCompilation` is `true`, `scope: "contracts"`
+   * returns the main artifacts directory and `scope: "tests"` returns a
+   * separate test-artifacts directory under the cache path.
    */
   getArtifactsDirectory(scope: BuildScope): Promise<string>;
 }

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

@@ -1,5 +1,6 @@
 import type { CompilerInput } from "./compiler-io.js";
 import type { DependencyGraph } from "./dependency-graph.js";
+import type { ToolVersions } from "./solidity-artifacts.js";
 import type { SolidityCompilerConfig } from "../config.js";
 
 /**
@@ -22,6 +23,12 @@ export interface CompilationJob {
    */
   solcLongVersion: string;
 
+  /**
+   * The versions to include in the build info, if any.
+   * When present, these versions influence the build id.
+   */
+  toolVersions?: ToolVersions;
+
   /**
    * Returns the solc input to be used.
    */

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

@@ -1,5 +1,13 @@
 import type { CompilerInput, CompilerOutput } from "./compiler-io.js";
 
+/**
+ * A record with the versions of the different tools used to create a
+ * build info.
+ */
+export interface ToolVersions {
+  readonly hardhat: string;
+}
+
 /**
  * A SolidityBuildInfo is a file that contains all the information of a solc
  * run. It includes all the necessary information to recreate that exact same
@@ -43,6 +51,14 @@ export interface SolidityBuildInfo {
    */
   readonly compilerType?: string;
 
+  /**
+   * Versions of the different tools used to create this build info.
+   *
+   * Not present if the build profile used to create this build info
+   * had `toolVersionsInBuildInfo` as `false`.
+   */
+  readonly toolVersions?: ToolVersions;
+
   /**
    * 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-2/04-mocha-viem-ts/package.json

@@ -20,6 +20,6 @@
     "solidity-coverage": "^0.8.0",
     "ts-node": ">=8.0.0",
     "typescript": "~5.0.4",
-    "viem": "^2.43.0"
+    "viem": "^2.47.6"
   }
 }

package/templates/hardhat-3/01-node-test-runner-viem/gitignore

@@ -16,5 +16,16 @@
 # Typechain output
 /types
 
+# Environment files
+.env
+.env.*
+!.env.example
+
 # Hardhat coverage reports
 /coverage
+
+# Gas snapshot files
+/.gas-snapshot
+
+# Snapshot cheatcodes output
+/snapshots

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.3.0",
-    "@nomicfoundation/hardhat-toolbox-viem": "workspace:^5.0.3",
-    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.1",
+    "hardhat": "workspace:^3.4.1",
+    "@nomicfoundation/hardhat-toolbox-viem": "workspace:^5.0.4",
+    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.3",
     "@types/node": "^22.8.5",
     "forge-std": "foundry-rs/forge-std#v1.9.4",
     "typescript": "~5.8.0",
-    "viem": "^2.43.0"
+    "viem": "^2.47.6"
   },
   "peerDependencies": {
-    "@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.13",
-    "@nomicfoundation/ignition-core": "workspace:^3.1.1"
+    "@nomicfoundation/hardhat-ignition-viem": "workspace:^3.1.3",
+    "@nomicfoundation/hardhat-keystore": "workspace:^3.0.7",
+    "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.6",
+    "@nomicfoundation/hardhat-node-test-runner": "workspace:^3.0.14",
+    "@nomicfoundation/hardhat-viem": "workspace:^3.0.6",
+    "@nomicfoundation/hardhat-viem-assertions": "workspace:^3.0.9",
+    "@nomicfoundation/hardhat-verify": "workspace:^3.0.15",
+    "@nomicfoundation/ignition-core": "workspace:^3.1.3"
   }
 }

package/templates/hardhat-3/01-node-test-runner-viem/scripts/send-op-tx.ts

@@ -1,6 +1,6 @@
 import { network } from "hardhat";
 
-const { viem } = await network.connect({
+const { viem } = await network.create({
   network: "hardhatOp",
   chainType: "op",
 });

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

@@ -4,7 +4,7 @@ import { describe, it } from "node:test";
 import { network } from "hardhat";
 
 describe("Counter", async function () {
-  const { viem } = await network.connect();
+  const { viem } = await network.create();
   const publicClient = await viem.getPublicClient();
 
   it("Should emit the Increment event when calling the inc() function", async function () {

package/templates/hardhat-3/02-mocha-ethers/gitignore

@@ -16,5 +16,16 @@
 # Typechain output
 /types
 
+# Environment files
+.env
+.env.*
+!.env.example
+
 # Hardhat coverage reports
 /coverage
+
+# Gas snapshot files
+/.gas-snapshot
+
+# Snapshot cheatcodes output
+/snapshots

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.3.0",
-    "@nomicfoundation/hardhat-toolbox-mocha-ethers": "workspace:^3.0.3",
-    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.7",
-    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.1",
+    "hardhat": "workspace:^3.4.1",
+    "@nomicfoundation/hardhat-toolbox-mocha-ethers": "workspace:^3.0.4",
+    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.9",
+    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.3",
     "@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.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.15",
-    "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.4",
-    "@nomicfoundation/hardhat-typechain": "workspace:^3.0.5",
-    "@nomicfoundation/hardhat-verify": "workspace:^3.0.13",
-    "@nomicfoundation/ignition-core": "workspace:^3.1.1"
+    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.9",
+    "@nomicfoundation/hardhat-ethers-chai-matchers": "workspace:^3.0.6",
+    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.3",
+    "@nomicfoundation/hardhat-ignition-ethers": "workspace:^3.1.3",
+    "@nomicfoundation/hardhat-keystore": "workspace:^3.0.7",
+    "@nomicfoundation/hardhat-mocha": "workspace:^3.0.17",
+    "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.6",
+    "@nomicfoundation/hardhat-typechain": "workspace:^3.0.7",
+    "@nomicfoundation/hardhat-verify": "workspace:^3.0.15",
+    "@nomicfoundation/ignition-core": "workspace:^3.1.3"
   }
 }

package/templates/hardhat-3/02-mocha-ethers/scripts/send-op-tx.ts

@@ -1,6 +1,6 @@
 import { network } from "hardhat";
 
-const { ethers } = await network.connect({
+const { ethers } = await network.create({
   network: "hardhatOp",
   chainType: "op",
 });

package/templates/hardhat-3/02-mocha-ethers/test/Counter.ts

@@ -1,7 +1,7 @@
 import { expect } from "chai";
 import { network } from "hardhat";
 
-const { ethers } = await network.connect();
+const { ethers } = await network.create();
 
 describe("Counter", function () {
   it("Should emit the Increment event when calling the inc() function", async function () {

package/templates/hardhat-3/03-minimal/gitignore

@@ -16,5 +16,16 @@
 # Typechain output
 /types
 
+# Environment files
+.env
+.env.*
+!.env.example
+
 # Hardhat coverage reports
 /coverage
+
+# Gas snapshot files
+/.gas-snapshot
+
+# Snapshot cheatcodes output
+/snapshots

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

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

package/dist/src/internal/builtin-plugins/gas-analytics/helpers.d.ts

@@ -1,14 +0,0 @@
-import type { GasAnalyticsManager } from "./types.js";
-import type { HookContext } from "../../../types/hooks.js";
-import type { HardhatRuntimeEnvironment } from "../../../types/hre.js";
-export declare function getGasAnalyticsManager(hookContextOrHre: HookContext | HardhatRuntimeEnvironment): GasAnalyticsManager;
-export declare function setGasAnalyticsManager(hre: HardhatRuntimeEnvironment, gasAnalyticsManager: GasAnalyticsManager): void;
-export declare function markTestRunStart(id: string): Promise<void>;
-export declare function markTestWorkerDone(id: string): Promise<void>;
-export declare function markTestRunDone(id: string): Promise<void>;
-export declare function formatSectionHeader(sectionName: string, { changedLength, addedLength, removedLength, }: {
-    changedLength: number;
-    addedLength: number;
-    removedLength: number;
-}): string;
-//# sourceMappingURL=helpers.d.ts.map

package/dist/src/internal/builtin-plugins/gas-analytics/helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../src/internal/builtin-plugins/gas-analytics/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAcvE,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,WAAW,GAAG,yBAAyB,GACxD,mBAAmB,CAQrB;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,yBAAyB,EAC9B,mBAAmB,EAAE,mBAAmB,GACvC,IAAI,CAMN;AAkBD,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhE;AAED,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/D;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,EACE,aAAa,EACb,WAAW,EACX,aAAa,GACd,EAAE;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,GACA,MAAM,CAcR"}

package/dist/src/internal/builtin-plugins/gas-analytics/helpers.js

@@ -1,55 +0,0 @@
-import { assertHardhatInvariant } from "@nomicfoundation/hardhat-errors";
-import chalk from "chalk";
-import { HardhatRuntimeEnvironmentImplementation } from "../../core/hre.js";
-import { GasAnalyticsManagerImplementation } from "./gas-analytics-manager.js";
-import { testRunDone, testRunStart, testWorkerDone, } from "./hook-handlers/test.js";
-export function getGasAnalyticsManager(hookContextOrHre) {
-    assertHardhatInvariant("_gasAnalytics" in hookContextOrHre &&
-        hookContextOrHre._gasAnalytics instanceof
-            GasAnalyticsManagerImplementation, "Expected _gasAnalytics to be an instance of GasAnalyticsManagerImplementation");
-    return hookContextOrHre._gasAnalytics;
-}
-export function setGasAnalyticsManager(hre, gasAnalyticsManager) {
-    assertHardhatInvariant(hre instanceof HardhatRuntimeEnvironmentImplementation, "Expected HRE to be an instance of HardhatRuntimeEnvironmentImplementation");
-    hre._gasAnalytics = gasAnalyticsManager;
-}
-/**
- * The following helpers are kept for backward compatibility with older versions
- * of test runner plugins (hardhat-mocha, hardhat-node-test-runner) that import
- * from "hardhat/internal/gas-analytics".
- */
-// Dynamically import the HRE when calling the helpers
-let cachedHre;
-async function getHre() {
-    if (cachedHre === undefined) {
-        const { default: hre } = await import("../../../index.js");
-        cachedHre = hre;
-    }
-    return cachedHre;
-}
-export async function markTestRunStart(id) {
-    const hre = await getHre();
-    await testRunStart(hre, id);
-}
-export async function markTestWorkerDone(id) {
-    const hre = await getHre();
-    await testWorkerDone(hre, id);
-}
-export async function markTestRunDone(id) {
-    const hre = await getHre();
-    await testRunDone(hre, id);
-}
-export function formatSectionHeader(sectionName, { changedLength, addedLength, removedLength, }) {
-    const parts = [];
-    if (changedLength > 0) {
-        parts.push(`${changedLength} changed`);
-    }
-    if (addedLength > 0) {
-        parts.push(`${addedLength} added`);
-    }
-    if (removedLength > 0) {
-        parts.push(`${removedLength} removed`);
-    }
-    return `${sectionName}: ${chalk.gray(parts.join(", "))}`;
-}
-//# sourceMappingURL=helpers.js.map

package/dist/src/internal/builtin-plugins/gas-analytics/helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../../src/internal/builtin-plugins/gas-analytics/helpers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,uCAAuC,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,sBAAsB,CACpC,gBAAyD;IAEzD,sBAAsB,CACpB,eAAe,IAAI,gBAAgB;QACjC,gBAAgB,CAAC,aAAa;YAC5B,iCAAiC,EACrC,+EAA+E,CAChF,CAAC;IACF,OAAO,gBAAgB,CAAC,aAAa,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,GAA8B,EAC9B,mBAAwC;IAExC,sBAAsB,CACpB,GAAG,YAAY,uCAAuC,EACtD,2EAA2E,CAC5E,CAAC;IACF,GAAG,CAAC,aAAa,GAAG,mBAAmB,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AAEH,sDAAsD;AACtD,IAAI,SAAgD,CAAC;AACrD,KAAK,UAAU,MAAM;IACnB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC3D,SAAS,GAAG,GAAG,CAAC;IAClB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAU;IAC/C,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAC;IAC3B,MAAM,YAAY,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EAAU;IACjD,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAC;IAC3B,MAAM,cAAc,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAU;IAC9C,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAC;IAC3B,MAAM,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,EACE,aAAa,EACb,WAAW,EACX,aAAa,GAKd;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,UAAU,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,QAAQ,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,GAAG,WAAW,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;AAC3D,CAAC"}

package/src/internal/builtin-plugins/gas-analytics/helpers.ts

@@ -1,96 +0,0 @@
-import type { GasAnalyticsManager } from "./types.js";
-import type { HookContext } from "../../../types/hooks.js";
-import type { HardhatRuntimeEnvironment } from "../../../types/hre.js";
-
-import { assertHardhatInvariant } from "@nomicfoundation/hardhat-errors";
-import chalk from "chalk";
-
-import { HardhatRuntimeEnvironmentImplementation } from "../../core/hre.js";
-
-import { GasAnalyticsManagerImplementation } from "./gas-analytics-manager.js";
-import {
-  testRunDone,
-  testRunStart,
-  testWorkerDone,
-} from "./hook-handlers/test.js";
-
-export function getGasAnalyticsManager(
-  hookContextOrHre: HookContext | HardhatRuntimeEnvironment,
-): GasAnalyticsManager {
-  assertHardhatInvariant(
-    "_gasAnalytics" in hookContextOrHre &&
-      hookContextOrHre._gasAnalytics instanceof
-        GasAnalyticsManagerImplementation,
-    "Expected _gasAnalytics to be an instance of GasAnalyticsManagerImplementation",
-  );
-  return hookContextOrHre._gasAnalytics;
-}
-
-export function setGasAnalyticsManager(
-  hre: HardhatRuntimeEnvironment,
-  gasAnalyticsManager: GasAnalyticsManager,
-): void {
-  assertHardhatInvariant(
-    hre instanceof HardhatRuntimeEnvironmentImplementation,
-    "Expected HRE to be an instance of HardhatRuntimeEnvironmentImplementation",
-  );
-  hre._gasAnalytics = gasAnalyticsManager;
-}
-
-/**
- * The following helpers are kept for backward compatibility with older versions
- * of test runner plugins (hardhat-mocha, hardhat-node-test-runner) that import
- * from "hardhat/internal/gas-analytics".
- */
-
-// Dynamically import the HRE when calling the helpers
-let cachedHre: HardhatRuntimeEnvironment | undefined;
-async function getHre(): Promise<HardhatRuntimeEnvironment> {
-  if (cachedHre === undefined) {
-    const { default: hre } = await import("../../../index.js");
-    cachedHre = hre;
-  }
-  return cachedHre;
-}
-
-export async function markTestRunStart(id: string): Promise<void> {
-  const hre = await getHre();
-  await testRunStart(hre, id);
-}
-
-export async function markTestWorkerDone(id: string): Promise<void> {
-  const hre = await getHre();
-  await testWorkerDone(hre, id);
-}
-
-export async function markTestRunDone(id: string): Promise<void> {
-  const hre = await getHre();
-  await testRunDone(hre, id);
-}
-
-export function formatSectionHeader(
-  sectionName: string,
-  {
-    changedLength,
-    addedLength,
-    removedLength,
-  }: {
-    changedLength: number;
-    addedLength: number;
-    removedLength: number;
-  },
-): string {
-  const parts: string[] = [];
-
-  if (changedLength > 0) {
-    parts.push(`${changedLength} changed`);
-  }
-  if (addedLength > 0) {
-    parts.push(`${addedLength} added`);
-  }
-  if (removedLength > 0) {
-    parts.push(`${removedLength} removed`);
-  }
-
-  return `${sectionName}: ${chalk.gray(parts.join(", "))}`;
-}