hardhat 3.11.1 → 3.12.0

package/src/internal/builtin-plugins/gas-analytics/tasks/solidity-test/task-action.ts

@@ -33,6 +33,7 @@ interface GasAnalyticsTestActionArguments {
   snapshotCheck: boolean;
   // Forwarded from the base `test solidity` task; used to detect scoped runs.
   grep?: string;
+  grepExclude?: string;
   testFiles?: string[];
 }
 
@@ -77,11 +78,11 @@ const runSolidityTests: TaskOverrideActionFunction<
       rootPath,
       suiteResults,
     );
-    // On a scoped run, added/missing snapshots are expected, so don't report
-    // them (they'd be noise from the filter, not real differences).
-    const isFiltered =
-      args.grep !== undefined || (args.testFiles?.length ?? 0) > 0;
-    logSnapshotCheckResult(snapshotCheckResult, console.log, isFiltered);
+    logSnapshotCheckResult(
+      snapshotCheckResult,
+      console.log,
+      isFilteredRun(args),
+    );
     snapshotCheckPassed =
       snapshotCheckResult.functionGasSnapshotsCheck.passed &&
       snapshotCheckResult.snapshotCheatcodesCheck.passed;
@@ -94,6 +95,32 @@ const runSolidityTests: TaskOverrideActionFunction<
   return superResult;
 };
 
+/**
+ * Whether a `test solidity` run is scoped to a subset of tests (via `--grep`,
+ * `--grep-exclude`, or explicit files). On a scoped run, added/missing
+ * snapshots are artifacts of the filter rather than real differences, so they
+ * aren't reported.
+ *
+ * An explicit empty pattern (e.g. `--grep ""`) is normalized to "no filter" by
+ * the base task before it runs EDR (see `solidity-test/helpers.ts`), so it runs
+ * the full suite; treat it as unfiltered here so real differences still
+ * surface. (An omitted option already arrives as `undefined`.)
+ */
+export function isFilteredRun(args: {
+  grep?: string;
+  grepExclude?: string;
+  testFiles?: string[];
+}): boolean {
+  const hasPattern = (pattern?: string): boolean =>
+    pattern !== undefined && pattern !== "";
+
+  return (
+    hasPattern(args.grep) ||
+    hasPattern(args.grepExclude) ||
+    (args.testFiles?.length ?? 0) > 0
+  );
+}
+
 export async function handleSnapshot(
   basePath: string,
   suiteResults: SuiteResult[],

package/src/internal/builtin-plugins/hhu/types.ts

@@ -23,8 +23,7 @@ export interface UtilsHardhatRuntimeEnvironment {
  * ({@link UtilsHardhatRuntimeEnvironment}) plus the `config` that
  * `TaskManagerImplementation` needs to build the task map.
  */
-export interface FakeHhuHardhatRuntimeEnvironment
-  extends UtilsHardhatRuntimeEnvironment {
+export interface FakeHhuHardhatRuntimeEnvironment extends UtilsHardhatRuntimeEnvironment {
   config: Pick<HardhatRuntimeEnvironment["config"], "tasks" | "plugins">;
 }
 

package/src/internal/builtin-plugins/network-manager/accounts/derive-private-keys.ts

@@ -61,17 +61,15 @@ async function deriveKeyFromMnemonicAndPath(
   const trimmedMnemonic = mnemonic.trim();
 
   if (mnemonicToSeedSync === undefined) {
-    const { mnemonicToSeedSync: importedMnemonicToSeedSync } = await import(
-      "ethereum-cryptography/bip39"
-    );
+    const { mnemonicToSeedSync: importedMnemonicToSeedSync } =
+      await import("ethereum-cryptography/bip39");
 
     mnemonicToSeedSync = importedMnemonicToSeedSync;
   }
 
   if (HDKey === undefined) {
-    const { HDKey: ImportedHDKey } = await import(
-      "ethereum-cryptography/hdkey"
-    );
+    const { HDKey: ImportedHDKey } =
+      await import("ethereum-cryptography/hdkey");
 
     HDKey = ImportedHDKey;
   }

package/src/internal/builtin-plugins/network-manager/edr/edr-constants.ts

@@ -10,8 +10,7 @@ export const EDR_NETWORK_DEFAULT_COINBASE =
 
 export const DEFAULT_EDR_NETWORK_BLOCK_GAS_LIMIT = 60_000_000n;
 
-interface EdrNetworkDefaultHDAccountsConfigParams
-  extends DefaultHDAccountsConfigParams {
+interface EdrNetworkDefaultHDAccountsConfigParams extends DefaultHDAccountsConfigParams {
   mnemonic: string;
   accountsBalance: bigint;
 }

package/src/internal/builtin-plugins/network-manager/edr/edr-provider.ts

@@ -167,9 +167,8 @@ export class EdrProvider extends BaseProvider {
 
       let traceOutput: TraceOutputManager | undefined;
       if (tracesEnabled) {
-        const { TraceOutputManager: TraceOutputManagerImpl } = await import(
-          "./utils/trace-output.js"
-        );
+        const { TraceOutputManager: TraceOutputManagerImpl } =
+          await import("./utils/trace-output.js");
         traceOutput = new TraceOutputManagerImpl(
           printLineFn,
           connectionId,

package/src/internal/builtin-plugins/network-manager/hook-handlers/hre.ts

@@ -63,9 +63,8 @@ async function createNetworkManager(
   hre: HardhatRuntimeEnvironment,
   context: HookContext,
 ): Promise<NetworkManager> {
-  const { NetworkManagerImplementation } = await import(
-    "../network-manager.js"
-  );
+  const { NetworkManagerImplementation } =
+    await import("../network-manager.js");
 
   return new NetworkManagerImplementation(
     hre.globalOptions.network !== undefined

package/src/internal/builtin-plugins/network-manager/network-connection.ts

@@ -8,8 +8,7 @@ export type CloseConnectionFunction<ChainTypeT extends ChainType | string> = (
 
 export class NetworkConnectionImplementation<
   ChainTypeT extends ChainType | string,
-> implements NetworkConnection<ChainTypeT>
-{
+> implements NetworkConnection<ChainTypeT> {
   public readonly id: number;
   public readonly networkName: string;
   public readonly networkConfig: Readonly<NetworkConfig>;

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

@@ -32,6 +32,7 @@ import { exists, readBinaryFile } from "@nomicfoundation/hardhat-utils/fs";
 import { deepMerge } from "@nomicfoundation/hardhat-utils/lang";
 import { AsyncMutex } from "@nomicfoundation/hardhat-utils/synchronization";
 
+import { sendNetworkAnalytics } from "../../cli/telemetry/analytics/analytics.js";
 import { resolveUserConfigToHardhatConfig } from "../../core/hre.js";
 import { isSupportedChainType } from "../../edr/chain-type.js";
 import { JsonRpcServerImplementation } from "../node/json-rpc/server.js";
@@ -73,6 +74,8 @@ export class NetworkManagerImplementation implements NetworkManager {
     Map<string, NetworkConnection<ChainType | string>>
   >();
 
+  readonly #chainTypesWithSentAnalytics = new Set<string>();
+
   constructor(
     defaultNetwork: string,
     defaultChainType: DefaultChainType,
@@ -124,6 +127,13 @@ export class NetworkManagerImplementation implements NetworkManager {
         ),
     );
 
+    if (!this.#chainTypesWithSentAnalytics.has(networkConnection.chainType)) {
+      this.#chainTypesWithSentAnalytics.add(networkConnection.chainType);
+      // Fire-and-forget: analytics must never delay or break connection
+      // creation
+      void sendNetworkAnalytics(networkConnection.chainType).catch(() => {});
+    }
+
     /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions
     -- Cast to NetworkConnection<ChainTypeT> because we know it's valid */
     return networkConnection as NetworkConnection<ChainTypeT>;
@@ -624,7 +634,7 @@ export class NetworkManagerImplementation implements NetworkManager {
     const networkName =
       typeof networkOrParams === "string"
         ? networkOrParams
-        : networkOrParams?.network ?? this.#defaultNetwork;
+        : (networkOrParams?.network ?? this.#defaultNetwork);
 
     const networkConfig = this.#networkConfigs[networkName];
 

package/src/internal/builtin-plugins/network-manager/request-handlers/handlers/accounts/local-accounts.ts

@@ -130,9 +130,8 @@ export class LocalAccountsHandler extends ChainId implements RequestHandler {
           }
 
           if (microEthSignerTypedData === undefined) {
-            microEthSignerTypedData = await import(
-              "micro-eth-signer/typed-data"
-            );
+            microEthSignerTypedData =
+              await import("micro-eth-signer/typed-data");
           }
 
           const privateKey = await this.#getPrivateKeyForAddress(address);
@@ -155,14 +154,14 @@ export class LocalAccountsHandler extends ChainId implements RequestHandler {
         if (data !== undefined) {
           if (address === undefined) {
             throw new HardhatError(
-              HardhatError.ERRORS.CORE.NETWORK.PERSONALSIGN_MISSING_ADDRESS_PARAM,
+              HardhatError.ERRORS.CORE.NETWORK
+                .PERSONALSIGN_MISSING_ADDRESS_PARAM,
             );
           }
 
           if (microEthSignerTypedData === undefined) {
-            microEthSignerTypedData = await import(
-              "micro-eth-signer/typed-data"
-            );
+            microEthSignerTypedData =
+              await import("micro-eth-signer/typed-data");
           }
 
           const privateKey = await this.#getPrivateKeyForAddress(address);
@@ -193,7 +192,8 @@ export class LocalAccountsHandler extends ChainId implements RequestHandler {
           typedMessage = JSON.parse(data);
         } catch {
           throw new HardhatError(
-            HardhatError.ERRORS.CORE.NETWORK.ETHSIGN_TYPED_DATA_V4_INVALID_DATA_PARAM,
+            HardhatError.ERRORS.CORE.NETWORK
+              .ETHSIGN_TYPED_DATA_V4_INVALID_DATA_PARAM,
           );
         }
       }
@@ -403,7 +403,8 @@ export class LocalAccountsHandler extends ChainId implements RequestHandler {
       txData.data === undefined
     ) {
       throw new HardhatError(
-        HardhatError.ERRORS.CORE.NETWORK.DATA_FIELD_CANNOT_BE_NULL_WITH_NULL_ADDRESS,
+        HardhatError.ERRORS.CORE.NETWORK
+          .DATA_FIELD_CANNOT_BE_NULL_WITH_NULL_ADDRESS,
       );
     }
 

package/src/internal/builtin-plugins/network-manager/type-extensions/config.ts

@@ -20,8 +20,7 @@ declare module "../../../../types/config.js" {
 
   export interface HardforkHistoryUserConfig {
     [hardforkName: string]:
-      | ActivationBlockNumberUserConfig
-      | ActivationTimestampUserConfig;
+      ActivationBlockNumberUserConfig | ActivationTimestampUserConfig;
   }
 
   export interface ActivationBlockNumberUserConfig {
@@ -64,8 +63,7 @@ declare module "../../../../types/config.js" {
   // Ideally we use Partial<Omit<NetworkUserConfig, "type">> but omit breaks
   // discriminated unions. See https://github.com/microsoft/TypeScript/issues/31501
   export type NetworkConfigOverride =
-    | HttpNetworkConfigOverride
-    | EdrNetworkConfigOverride;
+    HttpNetworkConfigOverride | EdrNetworkConfigOverride;
 
   export interface HttpNetworkUserConfig {
     type: "http";
@@ -84,9 +82,7 @@ declare module "../../../../types/config.js" {
   }
 
   export type HttpNetworkAccountsUserConfig =
-    | "remote"
-    | SensitiveString[]
-    | HttpNetworkHDAccountsUserConfig;
+    "remote" | SensitiveString[] | HttpNetworkHDAccountsUserConfig;
 
   export interface HttpNetworkHDAccountsUserConfig {
     mnemonic: SensitiveString;
@@ -127,8 +123,7 @@ declare module "../../../../types/config.js" {
   }
 
   export type EdrNetworkAccountsUserConfig =
-    | EdrNetworkAccountUserConfig[]
-    | EdrNetworkHDAccountsUserConfig;
+    EdrNetworkAccountUserConfig[] | EdrNetworkHDAccountsUserConfig;
 
   export interface EdrNetworkAccountUserConfig {
     balance: string | bigint;
@@ -230,9 +225,7 @@ declare module "../../../../types/config.js" {
   }
 
   export type HttpNetworkAccountsConfig =
-    | "remote"
-    | ResolvedConfigurationVariable[]
-    | HttpNetworkHDAccountsConfig;
+    "remote" | ResolvedConfigurationVariable[] | HttpNetworkHDAccountsConfig;
 
   export interface HttpNetworkHDAccountsConfig {
     mnemonic: ResolvedConfigurationVariable;
@@ -273,8 +266,7 @@ declare module "../../../../types/config.js" {
   }
 
   export type EdrNetworkAccountsConfig =
-    | EdrNetworkAccountConfig[]
-    | EdrNetworkHDAccountsConfig;
+    EdrNetworkAccountConfig[] | EdrNetworkHDAccountsConfig;
 
   export interface EdrNetworkAccountConfig {
     balance: bigint;

package/src/internal/builtin-plugins/solidity/build-results.ts

@@ -10,8 +10,7 @@ import { HardhatError } from "@nomicfoundation/hardhat-errors";
 import { FileBuildResultType } from "../../../types/solidity.js";
 
 type SolidityBuildResults =
-  | Map<string, FileBuildResult>
-  | CompilationJobCreationError;
+  Map<string, FileBuildResult> | CompilationJobCreationError;
 type SuccessfulSolidityBuildResults = Map<
   string,
   Exclude<FileBuildResult, FailedFileBuildResult>

package/src/internal/builtin-plugins/solidity/build-system/build-system.ts

@@ -1364,7 +1364,8 @@ export class SolidityBuildSystemImplementation implements SolidityBuildSystem {
       [partialCompilerConfig],
       async () => {
         throw new HardhatError(
-          HardhatError.ERRORS.CORE.SOLIDITY.BUILD_INFO_COMPILER_TYPE_NOT_HANDLED,
+          HardhatError.ERRORS.CORE.SOLIDITY
+            .BUILD_INFO_COMPILER_TYPE_NOT_HANDLED,
           {
             compilerType,
             version: buildInfo.solcVersion,

package/src/internal/builtin-plugins/solidity/build-system/compilation-job.ts

@@ -110,7 +110,8 @@ export class CompilationJobImplementation implements CompilationJob {
             ]) {
               if (expectedParamValue !== actualParamValue) {
                 throw new HardhatError(
-                  HardhatError.ERRORS.CORE.HOOKS.UNEXPECTED_HOOK_PARAM_MODIFICATION,
+                  HardhatError.ERRORS.CORE.HOOKS
+                    .UNEXPECTED_HOOK_PARAM_MODIFICATION,
                   {
                     hookCategoryName: "solidity",
                     hookName: "preprocessProjectFileBeforeBuilding",

package/src/internal/builtin-plugins/solidity/build-system/resolver/remapped-npm-packages-graph.ts

@@ -83,9 +83,7 @@ export function isResolvedUserRemapping(
   );
 }
 
-export class RemappedNpmPackagesGraphImplementation
-  implements RemappedNpmPackagesGraph
-{
+export class RemappedNpmPackagesGraphImplementation implements RemappedNpmPackagesGraph {
   /**
    * The Hardhat project itself.
    */

package/src/internal/builtin-plugins/solidity/build-system/resolver/types.ts

@@ -77,8 +77,7 @@ export interface ResolvedNpmUserRemapping extends BaseUserRemapping, Remapping {
  * A resolved user remapping.
  */
 export type ResolvedUserRemapping =
-  | LocalUserRemapping
-  | ResolvedNpmUserRemapping;
+  LocalUserRemapping | ResolvedNpmUserRemapping;
 
 /**
  * Npm packages can be installed with different names than the one declared in

package/src/internal/builtin-plugins/solidity/config.ts

@@ -501,8 +501,7 @@ function resolveSolidityConfig(
 
 function resolveBuildProfileConfig(
   solidityConfig:
-    | SingleVersionSolidityUserConfig
-    | MultiVersionSolidityUserConfig,
+    SingleVersionSolidityUserConfig | MultiVersionSolidityUserConfig,
   production: boolean = false,
   toolVersionsInBuildInfo?: boolean,
 ): SolidityBuildProfileConfig {
@@ -606,8 +605,7 @@ export function isSolcSolidityCompilerUserConfig(
 
 function copyFromDefault(
   defaultSolidityConfig:
-    | SingleVersionSolidityUserConfig
-    | MultiVersionSolidityUserConfig,
+    SingleVersionSolidityUserConfig | MultiVersionSolidityUserConfig,
 ): SingleVersionSolidityUserConfig | MultiVersionSolidityUserConfig {
   if ("version" in defaultSolidityConfig) {
     return {

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

@@ -27,8 +27,7 @@ import type {
 } from "../build-system/build-system.js";
 
 let SolidityBuildSystemImplementation:
-  | typeof SolidityBuildSystemImplementationT
-  | undefined;
+  typeof SolidityBuildSystemImplementationT | undefined;
 
 class LazySolidityBuildSystem implements SolidityBuildSystem {
   readonly #hooks: HookManager;

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

@@ -71,8 +71,7 @@ declare module "../../../types/config.js" {
    * NOTE: All the variants of SingleVersionSolidityUserConfig must extend this
    * interface.
    */
-  export interface CommonSingleVersionSolidityUserConfig
-    extends CommonSolidityUserConfig {
+  export interface CommonSingleVersionSolidityUserConfig extends CommonSolidityUserConfig {
     toolVersionsInBuildInfo?: boolean;
   }
 
@@ -122,7 +121,9 @@ declare module "../../../types/config.js" {
    */
   export type SolidityCompilerUserConfig =
     | {
-        [type in keyof SolidityCompilerUserConfigPerType]: SolidityCompilerUserConfigPerType[type];
+        [
+          type in keyof SolidityCompilerUserConfigPerType
+        ]: SolidityCompilerUserConfigPerType[type];
       }[keyof SolidityCompilerUserConfigPerType]
     // SolcSolidityCompilerUserConfig when the type isn't present
     | (Omit<SolcSolidityCompilerUserConfig, "type"> &
@@ -133,7 +134,8 @@ declare module "../../../types/config.js" {
    * @deprecated
    */
   export interface SingleVersionSolcUserConfig
-    extends SolcSolidityCompilerUserConfig,
+    extends
+      SolcSolidityCompilerUserConfig,
       CommonSingleVersionSolidityUserConfig {}
 
   /**
@@ -141,8 +143,7 @@ declare module "../../../types/config.js" {
    */
   /* eslint-disable-next-line @typescript-eslint/no-empty-interface -- Defined
     in SingleVersionSolcUserConfig for backwards compatibility */
-  export interface SolcSingleVersionSolidityUserConfig
-    extends SingleVersionSolcUserConfig {}
+  export interface SolcSingleVersionSolidityUserConfig extends SingleVersionSolcUserConfig {}
 
   /**
    * A map from compiler type to its SingleVersionSolidityUserConfig type.
@@ -158,7 +159,9 @@ declare module "../../../types/config.js" {
    */
   export type SingleVersionSolidityUserConfig =
     | {
-        [type in keyof SingleVersionSolidityUserConfigPerType]: SingleVersionSolidityUserConfigPerType[type];
+        [
+          type in keyof SingleVersionSolidityUserConfigPerType
+        ]: SingleVersionSolidityUserConfigPerType[type];
       }[keyof SingleVersionSolidityUserConfigPerType]
     // SolcSingleVersionSolidityUserConfig when the type isn't present
     | (Omit<SolcSingleVersionSolidityUserConfig, "type"> &
@@ -188,8 +191,7 @@ declare module "../../../types/config.js" {
    * compatibility.
    */
   export interface MultiVersionSolidityUserConfig
-    extends MultiVersionSolcUserConfig,
-      CommonSolidityUserConfig {
+    extends MultiVersionSolcUserConfig, CommonSolidityUserConfig {
     toolVersionsInBuildInfo?: boolean;
   }
 
@@ -206,16 +208,14 @@ declare module "../../../types/config.js" {
    * The type of a multi-version build profile user config.
    * Mostly defined in `MultiVersionSolcUserConfig` for backwards compatibility
    */
-  export interface MultiVersionBuildProfileUserConfig
-    extends MultiVersionSolcUserConfig {
+  export interface MultiVersionBuildProfileUserConfig extends MultiVersionSolcUserConfig {
     toolVersionsInBuildInfo?: boolean;
   }
 
   /**
    * The type of the build profile version of the SolidityUserConfig.
    */
-  export interface BuildProfilesSolidityUserConfig
-    extends CommonSolidityUserConfig {
+  export interface BuildProfilesSolidityUserConfig extends CommonSolidityUserConfig {
     profiles: Record<
       string,
       SingleVersionBuildProfileUserConfig | MultiVersionBuildProfileUserConfig
@@ -274,7 +274,9 @@ declare module "../../../types/config.js" {
    */
   export type SolidityCompilerConfig =
     | {
-        [type in keyof SolidityCompilerConfigPerType]: SolidityCompilerConfigPerType[type] & {
+        [
+          type in keyof SolidityCompilerConfigPerType
+        ]: SolidityCompilerConfigPerType[type] & {
           type: type;
         };
       }[keyof SolidityCompilerConfigPerType]

package/src/internal/builtin-plugins/solidity-test/helpers.ts

@@ -38,6 +38,7 @@ interface SolidityTestConfigParams {
   verbosity: number;
   observability?: ObservabilityConfig;
   testPattern?: string;
+  excludeTestPattern?: string;
   generateGasReport: boolean;
   testFunctionOverrides?: TestFunctionOverride[];
   eip712CanonicalTypes?: string[];
@@ -51,6 +52,7 @@ export async function solidityTestConfigToSolidityTestRunnerConfigArgs({
   verbosity,
   observability,
   testPattern,
+  excludeTestPattern,
   generateGasReport,
   testFunctionOverrides,
   eip712CanonicalTypes,
@@ -149,7 +151,9 @@ export async function solidityTestConfigToSolidityTestRunnerConfigArgs({
     txOrigin,
     blockCoinbase,
     observability,
-    testPattern,
+    testPattern: testPattern === "" ? undefined : testPattern,
+    excludeTestPattern:
+      excludeTestPattern === "" ? undefined : excludeTestPattern,
     includeTraces,
     blockGasLimit,
     disableBlockGasLimit,

package/src/internal/builtin-plugins/solidity-test/index.ts

@@ -31,6 +31,12 @@ const hardhatPlugin: HardhatPlugin = definePlugin({
         type: ArgumentType.STRING_WITHOUT_DEFAULT,
         defaultValue: undefined,
       })
+      .addOption({
+        name: "grepExclude",
+        description: "Skip tests matching the given string or regexp",
+        type: ArgumentType.STRING_WITHOUT_DEFAULT,
+        defaultValue: undefined,
+      })
       .addFlag({
         name: "noCompile",
         description: "Don't compile the project before running the tests",

package/src/internal/builtin-plugins/solidity-test/inline-config/index.ts

@@ -143,7 +143,8 @@ async function collectRawOverrides(
       );
 
       throw new HardhatError(
-        HardhatError.ERRORS.CORE.SOLIDITY_TESTS.BUILD_INFO_NOT_FOUND_FOR_CONTRACT,
+        HardhatError.ERRORS.CORE.SOLIDITY_TESTS
+          .BUILD_INFO_NOT_FOUND_FOR_CONTRACT,
         {
           fqn,
         },
@@ -265,7 +266,8 @@ function buildTestFunctionOverrides(
 
     if (selector === undefined) {
       throw new HardhatError(
-        HardhatError.ERRORS.CORE.SOLIDITY_TESTS.INLINE_CONFIG_UNRESOLVED_SELECTOR,
+        HardhatError.ERRORS.CORE.SOLIDITY_TESTS
+          .INLINE_CONFIG_UNRESOLVED_SELECTOR,
         { functionFqn },
       );
     }

package/src/internal/builtin-plugins/solidity-test/inline-config/parsing.ts

@@ -161,7 +161,8 @@ export function parseInlineConfigLine(
       const profile = firstSegment;
       if (profile !== "default") {
         throw new HardhatError(
-          HardhatError.ERRORS.CORE.SOLIDITY_TESTS.INLINE_CONFIG_UNSUPPORTED_PROFILE,
+          HardhatError.ERRORS.CORE.SOLIDITY_TESTS
+            .INLINE_CONFIG_UNSUPPORTED_PROFILE,
           {
             profile,
             functionFqn,

package/src/internal/builtin-plugins/solidity-test/inline-config/validation.ts

@@ -66,7 +66,8 @@ export function validateInlineOverrides(overrides: RawInlineOverride[]): void {
           .join(", ");
 
         throw new HardhatError(
-          HardhatError.ERRORS.CORE.SOLIDITY_TESTS.INLINE_CONFIG_INVALID_KEY_FOR_TEST_TYPE,
+          HardhatError.ERRORS.CORE.SOLIDITY_TESTS
+            .INLINE_CONFIG_INVALID_KEY_FOR_TEST_TYPE,
           {
             key: rawKey,
             functionFqn,

package/src/internal/builtin-plugins/solidity-test/reporter.ts

@@ -272,7 +272,7 @@ export async function* testReporter(
         reason =
           failure.reason?.startsWith("FFI is disabled") === true
             ? "FFI is disabled; set `test.solidity.ffi` to `true` in your Hardhat config to allow tests to call external commands"
-            : failure.reason ?? "Unknown error";
+            : (failure.reason ?? "Unknown error");
       }
       yield* output(indenter.t`${colorize("red", `Error: ${reason}`)}\n`);
       // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check -- Ignore Cases not matched: undefined

package/src/internal/builtin-plugins/solidity-test/runner.ts

@@ -102,7 +102,8 @@ export function run(
 
       stream.destroy(
         new HardhatError(
-          HardhatError.ERRORS.CORE.SOLIDITY_TESTS.UNHANDLED_EDR_ERROR_SOLIDITY_TESTS,
+          HardhatError.ERRORS.CORE.SOLIDITY_TESTS
+            .UNHANDLED_EDR_ERROR_SOLIDITY_TESTS,
           {
             error: error.message,
           },

package/src/internal/builtin-plugins/solidity-test/task-action.ts

@@ -50,6 +50,7 @@ interface TestActionArguments {
   testFiles: string[];
   chainType: string;
   grep?: string;
+  grepExclude?: string;
   noCompile: boolean;
   testSummaryIndex: number;
 }
@@ -59,7 +60,7 @@ export interface SolidityTestRunResult extends TestRunResult {
 }
 
 const runSolidityTests: NewTaskActionFunction<TestActionArguments> = async (
-  { testFiles, chainType, grep, noCompile, testSummaryIndex },
+  { testFiles, chainType, grep, grepExclude, noCompile, testSummaryIndex },
   hre,
 ): Promise<Result<SolidityTestRunResult, SolidityTestRunResult>> => {
   // Set an environment variable that plugins can use to detect when a process is running tests
@@ -163,7 +164,8 @@ const runSolidityTests: NewTaskActionFunction<TestActionArguments> = async (
 
       if (notCompiledFiles.length > 0) {
         throw new HardhatError(
-          HardhatError.ERRORS.CORE.SOLIDITY_TESTS.SELECTED_TEST_FILES_NOT_COMPILED,
+          HardhatError.ERRORS.CORE.SOLIDITY_TESTS
+            .SELECTED_TEST_FILES_NOT_COMPILED,
           {
             files: notCompiledFiles.map((f) => `- ${f}`).join("\n"),
           },
@@ -251,6 +253,7 @@ const runSolidityTests: NewTaskActionFunction<TestActionArguments> = async (
       verbosity,
       observability: observabilityConfig,
       testPattern: grep,
+      excludeTestPattern: grepExclude,
       generateGasReport:
         hre.globalOptions.gasStats ||
         hre.globalOptions.gasStatsJson !== undefined,
@@ -416,7 +419,8 @@ async function validateThatProvidedFilesAreTests(
 
   if (nonTests.length > 0) {
     throw new HardhatError(
-      HardhatError.ERRORS.CORE.SOLIDITY_TESTS.SELECTED_FILES_ARE_NOT_SOLIDITY_TESTS,
+      HardhatError.ERRORS.CORE.SOLIDITY_TESTS
+        .SELECTED_FILES_ARE_NOT_SOLIDITY_TESTS,
       {
         files: nonTests.map((f) => `- ${f}`).join("\n"),
       },

package/src/internal/builtin-plugins/solidity-test/type-extensions.ts

@@ -85,8 +85,7 @@ declare module "../../../types/test.js" {
   }
 
   export type SolidityTestUserConfig =
-    | SolidityTestProfileUserConfig
-    | SolidityTestProfilesUserConfig;
+    SolidityTestProfileUserConfig | SolidityTestProfilesUserConfig;
 
   export interface HardhatTestUserConfig {
     solidity?: SolidityTestUserConfig;

package/src/internal/builtin-plugins/test/index.ts

@@ -29,6 +29,12 @@ const hardhatPlugin: HardhatPlugin = definePlugin({
         type: ArgumentType.STRING_WITHOUT_DEFAULT,
         defaultValue: undefined,
       })
+      .addOption({
+        name: "grepExclude",
+        description: "Skip tests matching the given string or regexp",
+        type: ArgumentType.STRING_WITHOUT_DEFAULT,
+        defaultValue: undefined,
+      })
       .addFlag({
         name: "noCompile",
         description: "Do not compile the project before running the tests",