hardhat 3.1.8 → 3.1.10

package/dist/src/types/tasks.d.ts

@@ -48,6 +48,20 @@ export declare enum TaskDefinitionType {
     NEW_TASK = "NEW_TASK",
     TASK_OVERRIDE = "TASK_OVERRIDE"
 }
+export type TaskAction = {
+    action: LazyActionObject<NewTaskActionFunction>;
+    inlineAction?: never;
+} | {
+    inlineAction: NewTaskActionFunction;
+    action?: never;
+};
+export type TaskOverrideAction = {
+    action: LazyActionObject<TaskOverrideActionFunction>;
+    inlineAction?: never;
+} | {
+    inlineAction: TaskOverrideActionFunction;
+    action?: never;
+};
 /**
  * Empty task definition. It is meant to be used as a placeholder task that only
  * prints information about its subtasks.
@@ -62,26 +76,32 @@ export interface EmptyTaskDefinition {
     description: string;
 }
 /**
- * The definition of a new task.
+ * The base definition of a new task.
  */
-export interface NewTaskDefinition {
+export interface BaseTaskDefinition {
     type: TaskDefinitionType.NEW_TASK;
     id: string[];
     description: string;
-    action: LazyActionObject<NewTaskActionFunction>;
     options: Record<string, OptionDefinition>;
     positionalArguments: PositionalArgumentDefinition[];
 }
 /**
- * An override of an existing task.
+ * The definition of a new task.
  */
-export interface TaskOverrideDefinition {
+export type NewTaskDefinition = BaseTaskDefinition & TaskAction;
+/**
+ * The base definition of an override of an existing task.
+ */
+export interface BaseTaskOverrideDefinition {
     type: TaskDefinitionType.TASK_OVERRIDE;
     id: string[];
     description?: string;
-    action: LazyActionObject<TaskOverrideActionFunction>;
     options: Record<string, OptionDefinition>;
 }
+/**
+ * An override of an existing task.
+ */
+export type TaskOverrideDefinition = BaseTaskOverrideDefinition & TaskOverrideAction;
 /**
  * The definition of a task, as used in the plugins and user config. They are
  * declarative descriptions of the task, which are later processed to create the
@@ -103,8 +123,11 @@ export interface EmptyTaskDefinitionBuilder {
 }
 /**
  * A builder for creating NewTaskDefinitions.
+ *
+ * @template TaskArgumentsT The arguments of the task.
+ * @template ActionTypeT Tracks if the action is "LAZY_ACTION" (Plugin Safe) or "INLINE_ACTION".
  */
-export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments = TaskArguments> {
+export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments = TaskArguments, ActionTypeT extends "LAZY_ACTION" | "INLINE_ACTION" | "MISSING_ACTION" = "MISSING_ACTION"> {
     /**
      * Sets the description of the task.
      */
@@ -112,13 +135,33 @@ export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments =
     /**
      * Sets the action of the task.
      *
-     * It can be provided as a function, or as a `file://` URL pointing to a file
-     * that exports a default NewTaskActionFunction.
+     * It must be provided as a lazy import function that returns a module with
+     * a default export, like `() => import("./my-action.js")`.
      *
-     * Note that plugins can only use the inline function form for development
-     * purposes.
+     * Note that plugins cannot use inline actions (see {@link setInlineAction}).
+     * They must use this method with a lazy import.
+     *
+     * @remarks
+     * This method can only be called once per task definition. Calling it multiple
+     * times will result in a runtime error.
+     *
+     * This method cannot be used together with {@link setInlineAction} on the same
+     * task. Use one or the other.
+     */
+    setAction(action: LazyActionObject<NewTaskActionFunction<TaskArgumentsT>>): NewTaskDefinitionBuilder<TaskArgumentsT, "LAZY_ACTION">;
+    /**
+     * Sets the inline action of the task.
+     *
+     * It must be provided as a function.
+     *
+     * @remarks
+     * This method can only be called once per task definition. Calling it multiple
+     * times will result in a runtime error.
+     *
+     * This method cannot be used together with {@link setAction} on the same
+     * task. Use one or the other.
      */
-    setAction(action: LazyActionObject<NewTaskActionFunction<TaskArgumentsT>>): this;
+    setInlineAction(inlineAction: NewTaskActionFunction<TaskArgumentsT>): NewTaskDefinitionBuilder<TaskArgumentsT, "INLINE_ACTION">;
     /**
      * Adds an option to the task.
      *
@@ -135,7 +178,7 @@ export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments =
         type?: TypeT;
         defaultValue: ArgumentTypeToValueType<TypeT>;
         hidden?: boolean;
-    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, TypeT, TaskArgumentsT>>;
+    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, TypeT, TaskArgumentsT>, ActionTypeT>;
     /**
      * Adds an option of flag type and default value false.
      */
@@ -144,7 +187,7 @@ export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments =
         shortName?: string;
         description?: string;
         hidden?: boolean;
-    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.FLAG, TaskArgumentsT>>;
+    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.FLAG, TaskArgumentsT>, ActionTypeT>;
     /**
      * Adds an option of level type and default value 0.
      */
@@ -153,7 +196,7 @@ export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments =
         shortName?: string;
         description?: string;
         defaultValue?: number;
-    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.LEVEL, TaskArgumentsT>>;
+    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.LEVEL, TaskArgumentsT>, ActionTypeT>;
     /**
      * Adds a positional argument to the task.
      *
@@ -175,7 +218,7 @@ export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments =
         description?: string;
         type?: TypeT;
         defaultValue?: ArgumentTypeToValueType<TypeT>;
-    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, TypeT, TaskArgumentsT>>;
+    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, TypeT, TaskArgumentsT>, ActionTypeT>;
     /**
      * Adds a variadic positional argument to the task.
      *
@@ -195,16 +238,23 @@ export interface NewTaskDefinitionBuilder<TaskArgumentsT extends TaskArguments =
         description?: string;
         type?: TypeT;
         defaultValue?: Array<ArgumentTypeToValueType<TypeT>>;
-    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, TypeT[], TaskArgumentsT>>;
+    }): NewTaskDefinitionBuilder<ExtendTaskArguments<NameT, TypeT[], TaskArgumentsT>, ActionTypeT>;
     /**
      * Builds the NewTaskDefinition.
      */
-    build(): NewTaskDefinition;
+    build(): ActionTypeT extends "LAZY_ACTION" ? Extract<NewTaskDefinition, {
+        action: LazyActionObject<NewTaskActionFunction>;
+    }> : ActionTypeT extends "INLINE_ACTION" ? Extract<NewTaskDefinition, {
+        inlineAction: NewTaskActionFunction;
+    }> : never;
 }
 /**
- * A builder for overriding existing tasks.
+ * A builder for overriding existing tasks
+ *
+ * @template TaskArgumentsT The arguments of the task.
+ * @template ActionTypeT Tracks if the action is "LAZY_ACTION" (Plugin Safe) or "INLINE_ACTION".
  */
-export interface TaskOverrideDefinitionBuilder<TaskArgumentsT extends TaskArguments = TaskArguments> {
+export interface TaskOverrideDefinitionBuilder<TaskArgumentsT extends TaskArguments = TaskArguments, ActionTypeT extends "LAZY_ACTION" | "INLINE_ACTION" | "MISSING_ACTION" = "MISSING_ACTION"> {
     /**
      * Sets a new description for the task.
      */
@@ -214,7 +264,13 @@ export interface TaskOverrideDefinitionBuilder<TaskArgumentsT extends TaskArgume
      *
      * @see NewTaskDefinitionBuilder.setAction
      */
-    setAction(action: LazyActionObject<TaskOverrideActionFunction<TaskArgumentsT>>): this;
+    setAction(action: LazyActionObject<TaskOverrideActionFunction<TaskArgumentsT>>): TaskOverrideDefinitionBuilder<TaskArgumentsT, "LAZY_ACTION">;
+    /**
+     * Sets a new inline action for the task.
+     *
+     * @see NewTaskDefinitionBuilder.setInlineAction
+     */
+    setInlineAction(inlineAction: TaskOverrideActionFunction<TaskArgumentsT>): TaskOverrideDefinitionBuilder<TaskArgumentsT, "INLINE_ACTION">;
     /**
      * Adds a new option to the task.
      *
@@ -227,7 +283,7 @@ export interface TaskOverrideDefinitionBuilder<TaskArgumentsT extends TaskArgume
         type?: TypeT;
         defaultValue: ArgumentTypeToValueType<TypeT>;
         hidden?: boolean;
-    }): TaskOverrideDefinitionBuilder<ExtendTaskArguments<NameT, TypeT, TaskArgumentsT>>;
+    }): TaskOverrideDefinitionBuilder<ExtendTaskArguments<NameT, TypeT, TaskArgumentsT>, ActionTypeT>;
     /**
      * Adds an option of flag type and default value false.
      */
@@ -236,7 +292,7 @@ export interface TaskOverrideDefinitionBuilder<TaskArgumentsT extends TaskArgume
         shortName?: string;
         description?: string;
         hidden?: boolean;
-    }): TaskOverrideDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.FLAG, TaskArgumentsT>>;
+    }): TaskOverrideDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.FLAG, TaskArgumentsT>, ActionTypeT>;
     /**
      * Adds an option of level type and default value 0.
      */
@@ -245,33 +301,38 @@ export interface TaskOverrideDefinitionBuilder<TaskArgumentsT extends TaskArgume
         shortName?: string;
         description?: string;
         defaultValue?: number;
-    }): TaskOverrideDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.LEVEL, TaskArgumentsT>>;
+    }): TaskOverrideDefinitionBuilder<ExtendTaskArguments<NameT, ArgumentType.LEVEL, TaskArgumentsT>, ActionTypeT>;
     /**
      * Builds the TaskOverrideDefinition.
      */
-    build(): TaskOverrideDefinition;
+    build(): ActionTypeT extends "LAZY_ACTION" ? Extract<TaskOverrideDefinition, {
+        action: LazyActionObject<TaskOverrideActionFunction>;
+    }> : ActionTypeT extends "INLINE_ACTION" ? Extract<TaskOverrideDefinition, {
+        inlineAction: TaskOverrideActionFunction;
+    }> : never;
 }
 /**
  * The actions associated to the task, in order.
  *
  * Each of them has the pluginId of the plugin that defined it, if any, and the
- * action itself.
+ * action itself. The action is stored either in `action` or `inlineAction`.
+ * Note that `inlineAction` is reserved for user tasks and is not allowed for plugins.
  *
- * Note that the first action is a `NewTaskActionFunction`, `string`, or
- * `undefined`. `undefined` is only used for empty tasks.
+ * Note that the first action is a `NewTaskActionFunction` or undefined.
+ * `undefined` is only used for empty tasks.
  *
- * The rest of the actions always have a `TaskOverrideActionFunction` or a
- * `string`.
+ * The rest of the actions always have a `TaskOverrideActionFunction`.
  */
 export type TaskActions = [
     {
         pluginId?: string;
-        action?: LazyActionObject<NewTaskActionFunction>;
-    },
+    } & (TaskAction | {
+        action?: undefined;
+        inlineAction?: undefined;
+    }),
     ...Array<{
         pluginId?: string;
-        action: LazyActionObject<TaskOverrideActionFunction>;
-    }>
+    } & TaskOverrideAction>
 ];
 /**
  * A task.

package/dist/src/types/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/types/tasks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/types/tasks.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hardhat",
-  "version": "3.1.8",
+  "version": "3.1.10",
   "description": "Hardhat is an extensible developer tool that helps smart contract developers increase productivity by reliably bringing together the tools they want.",
   "homepage": "https://github.com/nomicfoundation/hardhat/tree/v-next/v-next/hardhat",
   "repository": {
@@ -21,6 +21,7 @@
     "./hre": "./dist/src/hre.js",
     "./plugins": "./dist/src/plugins.js",
     "./internal/lsp-helpers": "./dist/src/lsp-helpers.js",
+    "./types": "./dist/src/types/index.js",
     "./types/arguments": "./dist/src/types/arguments.js",
     "./types/artifacts": "./dist/src/types/artifacts.js",
     "./types/config": "./dist/src/types/config.js",
@@ -38,7 +39,10 @@
     "./console.sol": "./console.sol",
     "./internal/coverage": "./dist/src/internal/builtin-plugins/coverage/exports.js",
     "./internal/gas-analytics": "./dist/src/internal/builtin-plugins/gas-analytics/exports.js",
-    "./utils/contract-names": "./dist/src/utils/contract-names.js"
+    "./utils/contract-names": "./dist/src/utils/contract-names.js",
+    "./types/runtime": "./dist/src/internal/deprecated-module-imported-from-hardhat2-plugin.js",
+    "./builtin-tasks/task-names": "./dist/src/internal/deprecated-module-imported-from-hardhat2-plugin.js",
+    "./internal/artifacts": "./dist/src/internal/deprecated-module-imported-from-hardhat2-plugin.js"
   },
   "keywords": [
     "ethereum",
@@ -68,14 +72,14 @@
     "prettier": "3.2.5",
     "rimraf": "^5.0.5",
     "typescript": "~5.8.0",
-    "@nomicfoundation/hardhat-test-utils": "^2.0.1"
+    "@nomicfoundation/hardhat-test-utils": "^2.0.2"
   },
   "dependencies": {
     "@nomicfoundation/edr": "0.12.0-next.24",
-    "@nomicfoundation/hardhat-errors": "^3.0.6",
-    "@nomicfoundation/hardhat-utils": "^3.0.6",
+    "@nomicfoundation/hardhat-errors": "^3.0.7",
+    "@nomicfoundation/hardhat-utils": "^4.0.0",
     "@nomicfoundation/hardhat-vendored": "^3.0.1",
-    "@nomicfoundation/hardhat-zod-utils": "^3.0.1",
+    "@nomicfoundation/hardhat-zod-utils": "^3.0.2",
     "@nomicfoundation/solidity-analyzer": "^0.1.1",
     "@sentry/core": "^9.4.0",
     "adm-zip": "^0.4.16",

package/src/config.ts

@@ -8,6 +8,8 @@ export type { HardhatUserConfig } from "./types/config.js";
 import "./internal/builtin-plugins/index.js";
 import type { HardhatUserConfig } from "./types/config.js";
 
+import { throwUsingHardhat2PluginError } from "./internal/using-hardhat2-plugin-errors.js";
+
 /**
  * Defines a Hardhat user config.
  *
@@ -38,3 +40,38 @@ export function defineConfig(config: HardhatUserConfig): HardhatUserConfig {
   //    use it and have a better user experience.
   return config;
 }
+
+/**
+ * @deprecated This function is part of the Hardhat 2 plugin API.
+ */
+export function extendConfig(..._args: any): any {
+  throwUsingHardhat2PluginError();
+}
+
+/**
+ * @deprecated This function is part of the Hardhat 2 plugin API.
+ */
+export function extendEnvironment(..._args: any): any {
+  throwUsingHardhat2PluginError();
+}
+
+/**
+ * @deprecated This function is part of the Hardhat 2 plugin API.
+ */
+export function extendProvider(..._args: any): any {
+  throwUsingHardhat2PluginError();
+}
+
+/**
+ * @deprecated This function is part of the Hardhat 2 plugin API.
+ */
+export function scope(..._args: any): any {
+  throwUsingHardhat2PluginError();
+}
+
+/**
+ * @deprecated This function is part of the Hardhat 2 plugin API.
+ */
+export function subtask(..._args: any): any {
+  throwUsingHardhat2PluginError();
+}

package/src/internal/builtin-plugins/coverage/coverage-manager.ts

@@ -8,7 +8,7 @@ import type { TableItem } from "@nomicfoundation/hardhat-utils/format";
 
 import path from "node:path";
 
-import { divider, formatTable } from "@nomicfoundation/hardhat-utils/format";
+import { formatTable } from "@nomicfoundation/hardhat-utils/format";
 import {
   ensureDir,
   getAllFilesMatching,
@@ -433,55 +433,60 @@ export class CoverageManagerImplementation implements CoverageManager {
 
     const rows: TableItem[] = [];
 
-    rows.push([chalk.bold("Coverage Report")]);
-    rows.push(divider);
+    rows.push({
+      type: "title",
+      text: chalk.bold("Coverage Report"),
+    });
 
-    rows.push(
-      ["File Path", "Line %", "Statement %", "Uncovered Lines"].map((s) =>
-        chalk.yellow(s),
+    rows.push({
+      type: "section-header",
+      text: chalk.bold("File Coverage"),
+    });
+
+    rows.push({
+      type: "header",
+      cells: ["File Path", "Line %", "Statement %", "Uncovered Lines"].map(
+        (s) => chalk.yellow(s),
       ),
-    );
+    });
 
-    const bodyRows = Object.entries(report).map(
-      ([
-        relativePath,
-        {
-          executedStatementsCount,
-          unexecutedStatementsCount,
-          lineExecutionCounts,
-          executedLinesCount,
-          unexecutedLines,
-        },
-      ]) => {
-        const lineCoverage =
-          lineExecutionCounts.size === 0
-            ? 0
-            : (executedLinesCount * 100.0) / lineExecutionCounts.size;
-        const statementCoverage =
-          executedStatementsCount === 0
-            ? 0
-            : (executedStatementsCount * 100.0) /
-              (executedStatementsCount + unexecutedStatementsCount);
-
-        totalExecutedLines += executedLinesCount;
-        totalExecutableLines += lineExecutionCounts.size;
-
-        totalExecutedStatements += executedStatementsCount;
-        totalExecutableStatements +=
-          executedStatementsCount + unexecutedStatementsCount;
-
-        const row: string[] = [
+    for (const [
+      relativePath,
+      {
+        executedStatementsCount,
+        unexecutedStatementsCount,
+        lineExecutionCounts,
+        executedLinesCount,
+        unexecutedLines,
+      },
+    ] of Object.entries(report)) {
+      const lineCoverage =
+        lineExecutionCounts.size === 0
+          ? 0
+          : (executedLinesCount * 100.0) / lineExecutionCounts.size;
+      const statementCoverage =
+        executedStatementsCount === 0
+          ? 0
+          : (executedStatementsCount * 100.0) /
+            (executedStatementsCount + unexecutedStatementsCount);
+
+      totalExecutedLines += executedLinesCount;
+      totalExecutableLines += lineExecutionCounts.size;
+
+      totalExecutedStatements += executedStatementsCount;
+      totalExecutableStatements +=
+        executedStatementsCount + unexecutedStatementsCount;
+
+      rows.push({
+        type: "row",
+        cells: [
           this.formatRelativePath(relativePath),
           this.formatCoverage(lineCoverage),
           this.formatCoverage(statementCoverage),
           this.formatLines(unexecutedLines),
-        ];
-
-        return row;
-      },
-    );
-
-    rows.push(...bodyRows);
+        ],
+      });
+    }
 
     const totalLineCoverage =
       totalExecutableLines === 0
@@ -492,13 +497,15 @@ export class CoverageManagerImplementation implements CoverageManager {
         ? 0
         : (totalExecutedStatements * 100.0) / totalExecutableStatements;
 
-    rows.push(divider);
-    rows.push([
-      chalk.yellow("Total"),
-      this.formatCoverage(totalLineCoverage),
-      this.formatCoverage(totalStatementCoverage),
-      "",
-    ]);
+    rows.push({
+      type: "header",
+      cells: [
+        chalk.yellow("Total"),
+        this.formatCoverage(totalLineCoverage),
+        this.formatCoverage(totalStatementCoverage),
+        "",
+      ],
+    });
 
     return formatTable(rows);
   }

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

@@ -3,10 +3,6 @@ import type { CoverageMetadata } from "../types.js";
 
 import path from "node:path";
 
-import {
-  addStatementCoverageInstrumentation,
-  latestSupportedSolidityVersion,
-} from "@nomicfoundation/edr";
 import {
   assertHardhatInvariant,
   HardhatError,
@@ -15,9 +11,9 @@ import { ensureError } from "@nomicfoundation/hardhat-utils/error";
 import { readUtf8File } from "@nomicfoundation/hardhat-utils/fs";
 import { findClosestPackageRoot } from "@nomicfoundation/hardhat-utils/package";
 import debug from "debug";
-import { satisfies } from "semver";
 
 import { CoverageManagerImplementation } from "../coverage-manager.js";
+import { instrumentSolidityFileForCompilationJob } from "../instrumentation.js";
 
 const log = debug("hardhat:core:coverage:hook-handlers:solidity");
 
@@ -40,19 +36,12 @@ export default async (): Promise<Partial<SolidityHooks>> => ({
 
     if (context.globalOptions.coverage && !isTestSource) {
       try {
-        const latestSupportedVersion = latestSupportedSolidityVersion();
-        if (!satisfies(solcVersion, `<=${latestSupportedVersion}`)) {
-          console.log(
-            `Solidity version ${solcVersion} is not yet supported for coverage instrumentation. Hardhat will try the latest supported version ${latestSupportedVersion} instead.`,
-          );
-          solcVersion = latestSupportedVersion;
-        }
-        const { source, metadata } = addStatementCoverageInstrumentation(
-          fileContent,
+        const { source, metadata } = instrumentSolidityFileForCompilationJob({
+          compilationJobSolcVersion: solcVersion,
           sourceName,
-          solcVersion,
-          COVERAGE_LIBRARY_PATH,
-        );
+          fileContent,
+          coverageLibraryPath: COVERAGE_LIBRARY_PATH,
+        });
 
         // TODO: Remove this once EDR starts returning line information as part
         // of the metadata.

package/src/internal/builtin-plugins/coverage/instrumentation.ts

@@ -0,0 +1,52 @@
+import type { InstrumentationMetadata } from "@nomicfoundation/edr";
+
+import {
+  addStatementCoverageInstrumentation,
+  latestSupportedSolidityVersion,
+} from "@nomicfoundation/edr";
+import { satisfies } from "semver";
+
+/**
+ * Instruments a solidity source file as part of a compilation job. i.e. the
+ * file is about to be compile as either a root file or a transitive dependency
+ * of one of the root files.
+ *
+ * @param compilationJobSolcVersion The solc version that the compilation job
+ *  will use.
+ * @param sourceName The source name of the file, as present in the compilation
+ *  job.
+ * @param fileContent The contents of the file.
+ * @param coverageLibraryPath The path to the coverage library. i.e. where to
+ *  import it from.
+ * @returns An object with the instrumented source and its metadata, and the
+ *  solidity version used to instrument the sources.
+ */
+export function instrumentSolidityFileForCompilationJob({
+  compilationJobSolcVersion,
+  sourceName,
+  fileContent,
+  coverageLibraryPath,
+}: {
+  compilationJobSolcVersion: string;
+  sourceName: string;
+  fileContent: string;
+  coverageLibraryPath: string;
+}): {
+  source: string;
+  metadata: InstrumentationMetadata[];
+  instrumentationVersion: string;
+} {
+  const latestSupportedVersion = latestSupportedSolidityVersion();
+  let instrumentationVersion = compilationJobSolcVersion;
+  if (!satisfies(instrumentationVersion, `<=${latestSupportedVersion}`)) {
+    instrumentationVersion = latestSupportedVersion;
+  }
+  const { source, metadata } = addStatementCoverageInstrumentation(
+    fileContent,
+    sourceName,
+    instrumentationVersion,
+    coverageLibraryPath,
+  );
+
+  return { source, metadata, instrumentationVersion };
+}

package/src/internal/builtin-plugins/flatten/task-action.ts

@@ -64,6 +64,7 @@ const flattenAction: NewTaskActionFunction<FlattenActionArguments> = async (
     rootPaths.toSorted(), // We sort them to have a deterministic order
     config.paths.root,
     readSourceFileFactory(hooks),
+    hooks,
   );
 
   let flattened = "";