hardhat 3.4.0 → 3.4.1

package/src/internal/cli/telemetry/sentry/reporter.ts

@@ -19,15 +19,16 @@ const log = debug("hardhat:cli:telemetry:sentry:reporter");
 export const SENTRY_DSN =
   "https://572b03708e298427cc72fc26dac1e8b2@o385026.ingest.us.sentry.io/4508780138856448"; // PROD
 
-// TODO: This could be done in a more elegant way, but for now, we just
-// initialize the entire reporter so that it sets the global error handlers.
-export async function setupErrorTelemetryIfEnabled(): Promise<void> {
-  await Reporter.getInstance(true);
-}
-
-export async function sendErrorTelemetry(error: Error): Promise<boolean> {
+/**
+ * @deprecated Use packages/hardhat/src/internal/cli/telemetry/error-reporter/reporter.ts
+ *   instead.
+ */
+export async function sendErrorTelemetry(
+  error: Error,
+  hint?: { unhandled?: boolean; mechanismType?: string },
+): Promise<boolean> {
   const instance = await Reporter.getInstance();
-  return instance.reportErrorViaSubprocess(error);
+  return await instance.reportErrorViaSubprocess(error, hint);
 }
 
 export function setCliHardhatConfigPath(configPath: string): void {
@@ -57,9 +58,7 @@ class Reporter {
     this.#hardhatConfigPath = configPath;
   }
 
-  public static async getInstance(
-    shouldSetupErrorHandlers = false,
-  ): Promise<Reporter> {
+  public static async getInstance(): Promise<Reporter> {
     if (this.#instance !== undefined) {
       return this.#instance;
     }
@@ -94,7 +93,6 @@ class Reporter {
       ),
       release,
       environment,
-      installGlobalHandlers: shouldSetupErrorHandlers,
     });
 
     setExtra("nodeVersion", process.version);
@@ -108,17 +106,31 @@ class Reporter {
     this.#instance = undefined;
   }
 
-  public async reportErrorViaSubprocess(error: Error): Promise<boolean> {
+  public async reportErrorViaSubprocess(
+    error: Error,
+    hint?: { unhandled?: boolean; mechanismType?: string },
+  ): Promise<boolean> {
     if (!(await this.#shouldBeReported(error))) {
       log("Error not send: this type of error should not be reported");
       return false;
     }
 
-    const { captureException } = await import("@sentry/core");
+    const { captureException, flush } = await import("@sentry/core");
 
     log("Capturing exception");
 
-    captureException(error);
+    captureException(
+      error,
+      hint !== undefined
+        ? {
+            mechanism: {
+              type: hint.mechanismType ?? "generic",
+              handled: hint.unhandled !== true,
+            },
+          }
+        : undefined,
+    );
+    await flush();
 
     return true;
   }

package/src/internal/cli/telemetry/sentry/transport.ts

@@ -139,7 +139,7 @@ export async function sendEnvelopeToSentryBackend(
   dsn: string,
   envelope: Envelope,
 ): Promise<TransportMakeRequestResponse> {
-  return sendSerializedEnvelopeToSentryBackend(
+  return await sendSerializedEnvelopeToSentryBackend(
     dsn,
     serializeEnvelope(envelope),
   );

package/src/internal/cli/telemetry/telemetry-permissions.ts

@@ -35,7 +35,7 @@ export async function isTelemetryAllowed(
     return process.env.HARDHAT_TEST_TELEMETRY_ENABLED === "true" ? true : false;
   }
 
-  return isTelemetryEnabled(telemetryConfigFilePath);
+  return await isTelemetryEnabled(telemetryConfigFilePath);
 }
 
 /**

package/src/internal/config-loading.ts

@@ -34,15 +34,15 @@ export async function resolveHardhatConfigPath(
   userProvidedPath?: string,
 ): Promise<string> {
   if (userProvidedPath !== undefined) {
-    return normalizeConfigPath(userProvidedPath);
+    return await normalizeConfigPath(userProvidedPath);
   }
 
   if (process.env.HARDHAT_CONFIG !== undefined) {
     log("Using config file path from the HARDHAT_CONFIG env var");
-    return normalizeConfigPath(process.env.HARDHAT_CONFIG);
+    return await normalizeConfigPath(process.env.HARDHAT_CONFIG);
   }
 
-  return findClosestHardhatConfig();
+  return await findClosestHardhatConfig();
 }
 
 /**

package/src/internal/core/configuration-variables.ts

@@ -118,24 +118,25 @@ export class LazyResolvedConfigurationVariable extends BaseResolvedConfiguration
     const mutex = LazyResolvedConfigurationVariable.#mutexes.get(this.#hooks);
     assertHardhatInvariant(mutex !== undefined, "Mutex must be defined");
 
-    return mutex.exclusiveRun(async () =>
-      this.#hooks.runHandlerChain(
-        "configurationVariables",
-        "fetchValue",
-        [this.#variable],
-        async (_context, v) => {
-          const value = process.env[v.name];
-
-          if (typeof value !== "string") {
-            throw new HardhatError(
-              HardhatError.ERRORS.CORE.GENERAL.ENV_VAR_NOT_FOUND,
-              { name: v.name },
-            );
-          }
-
-          return value;
-        },
-      ),
+    return await mutex.exclusiveRun(
+      async () =>
+        await this.#hooks.runHandlerChain(
+          "configurationVariables",
+          "fetchValue",
+          [this.#variable],
+          async (_context, v) => {
+            const value = process.env[v.name];
+
+            if (typeof value !== "string") {
+              throw new HardhatError(
+                HardhatError.ERRORS.CORE.GENERAL.ENV_VAR_NOT_FOUND,
+                { name: v.name },
+              );
+            }
+
+            return value;
+          },
+        ),
     );
   }
 }

package/src/internal/core/hook-manager.ts

@@ -124,7 +124,7 @@ export class HookManagerImplementation implements HookManager {
       return result;
     };
 
-    return next(...handlerParams);
+    return await next(...handlerParams);
   }
 
   public async runSequentialHandlers<
@@ -192,7 +192,7 @@ export class HookManagerImplementation implements HookManager {
       handlerParams = params;
     }
 
-    return Promise.all(
+    return await Promise.all(
       handlers.map((handler) => (handler as any)(...handlerParams)),
     );
   }
@@ -277,7 +277,7 @@ export class HookManagerImplementation implements HookManager {
     const categories: Array<
       Partial<HardhatHooks[HookCategoryNameT]> | undefined
     > = await this.#mutex.exclusiveRun(async () => {
-      return Promise.all(
+      return await Promise.all(
         this.#pluginsInReverseOrder.map(async (plugin) => {
           const existingCategory = this.#staticHookHandlerCategories
             .get(plugin.id)

package/src/internal/core/hre.ts

@@ -193,7 +193,9 @@ export class HardhatRuntimeEnvironmentImplementation
 export async function resolveProjectRoot(
   absolutePathWithinProject: string | undefined,
 ): Promise<string> {
-  return findClosestPackageRoot(absolutePathWithinProject ?? process.cwd());
+  return await findClosestPackageRoot(
+    absolutePathWithinProject ?? process.cwd(),
+  );
 }
 
 /**
@@ -292,7 +294,7 @@ async function runUserConfigExtensions(
   hooks: HookManager,
   config: HardhatUserConfig,
 ): Promise<HardhatUserConfig> {
-  return hooks.runHandlerChain(
+  return await hooks.runHandlerChain(
     "config",
     "extendUserConfig",
     [config],
@@ -320,7 +322,7 @@ async function resolveUserConfig(
     paths: resolvePaths(projectRoot, configPath, config.paths),
   } as HardhatConfig;
 
-  return hooks.runHandlerChain(
+  return await hooks.runHandlerChain(
     "config",
     "resolveUserConfig",
     [config, (variable) => resolveConfigurationVariable(hooks, variable)],

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

@@ -12,7 +12,7 @@ export async function resolvePluginList(
   projectRoot: string,
   userConfigPluginList: HardhatPlugin[] = [],
 ): Promise<HardhatPlugin[]> {
-  return reverseTopologicalSort(projectRoot, userConfigPluginList);
+  return await reverseTopologicalSort(projectRoot, userConfigPluginList);
 }
 
 /**

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

@@ -175,22 +175,22 @@ export class ResolvedTask implements Task {
       if (currentIndex === 0) {
         /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions --
         We know that the first action in the array is a NewTaskActionFunction */
-        return (actionFn as NewTaskActionFunction)(
+        return await (actionFn as NewTaskActionFunction)(
           nextTaskArguments,
           this.#hre,
         );
       }
 
-      return actionFn(
+      return await actionFn(
         nextTaskArguments,
         this.#hre,
         async (newTaskArguments: TaskArguments) => {
-          return next(newTaskArguments, currentIndex - 1);
+          return await next(newTaskArguments, currentIndex - 1);
         },
       );
     };
 
-    return next(validatedTaskArguments);
+    return await next(validatedTaskArguments);
   }
 
   /**

package/src/internal/core/user-interruptions.ts

@@ -21,8 +21,8 @@ export class UserInterruptionManagerImplementation
     interruptor: string,
     message: string,
   ): Promise<void> {
-    return this.#mutex.exclusiveRun(async () => {
-      return this.#hooks.runHandlerChain(
+    return await this.#mutex.exclusiveRun(async () => {
+      return await this.#hooks.runHandlerChain(
         "userInterruptions",
         "displayMessage",
         [interruptor, message],
@@ -35,8 +35,8 @@ export class UserInterruptionManagerImplementation
     interruptor: string,
     inputDescription: string,
   ): Promise<string> {
-    return this.#mutex.exclusiveRun(async () => {
-      return this.#hooks.runHandlerChain(
+    return await this.#mutex.exclusiveRun(async () => {
+      return await this.#hooks.runHandlerChain(
         "userInterruptions",
         "requestInput",
         [interruptor, inputDescription],
@@ -49,8 +49,8 @@ export class UserInterruptionManagerImplementation
     interruptor: string,
     inputDescription: string,
   ): Promise<string> {
-    return this.#mutex.exclusiveRun(async () => {
-      return this.#hooks.runHandlerChain(
+    return await this.#mutex.exclusiveRun(async () => {
+      return await this.#hooks.runHandlerChain(
         "userInterruptions",
         "requestSecretInput",
         [interruptor, inputDescription],
@@ -62,7 +62,7 @@ export class UserInterruptionManagerImplementation
   public async uninterrupted<ReturnT>(
     f: () => ReturnT,
   ): Promise<Awaited<ReturnT>> {
-    return this.#mutex.exclusiveRun(f);
+    return await this.#mutex.exclusiveRun(f);
   }
 }
 
@@ -84,7 +84,7 @@ async function defaultRequestInput(
     output: process.stdout,
   });
 
-  return new Promise<string>((resolve) => {
+  return await new Promise<string>((resolve) => {
     rl.question(
       chalk.blue(`[${interruptor}]`) + ` ${inputDescription}: `,
       (answer) => {
@@ -138,7 +138,7 @@ async function defaultRequestSecretInput(
     }
   };
 
-  return new Promise<string>((resolve) => {
+  return await new Promise<string>((resolve) => {
     rl.question(
       chalk.blue(`[${interruptor}]`) + ` ${inputDescription}: `,
       (answer) => {

package/src/internal/hre-initialization.ts

@@ -65,7 +65,7 @@ export async function createHardhatRuntimeEnvironment(
     unsafeOptions.globalOptionDefinitions = globalOptionDefinitions;
   }
 
-  return HardhatRuntimeEnvironmentImplementation.create(
+  return await HardhatRuntimeEnvironmentImplementation.create(
     config,
     userProvidedGlobalOptions,
     resolvedProjectRoot,

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.4.0",
+    "hardhat": "workspace:^3.4.1",
     "@nomicfoundation/hardhat-toolbox-viem": "workspace:^5.0.4",
-    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.2",
+    "@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.47.6"
   },
   "peerDependencies": {
-    "@nomicfoundation/hardhat-ignition-viem": "workspace:^3.1.2",
-    "@nomicfoundation/hardhat-keystore": "workspace:^3.0.6",
-    "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.5",
-    "@nomicfoundation/hardhat-node-test-runner": "workspace:^3.0.13",
-    "@nomicfoundation/hardhat-viem": "workspace:^3.0.5",
-    "@nomicfoundation/hardhat-viem-assertions": "workspace:^3.0.8",
-    "@nomicfoundation/hardhat-verify": "workspace:^3.0.14",
-    "@nomicfoundation/ignition-core": "workspace:^3.1.2"
+    "@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/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.4.0",
+    "hardhat": "workspace:^3.4.1",
     "@nomicfoundation/hardhat-toolbox-mocha-ethers": "workspace:^3.0.4",
-    "@nomicfoundation/hardhat-ethers": "workspace:^4.0.8",
-    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.2",
+    "@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.8",
-    "@nomicfoundation/hardhat-ethers-chai-matchers": "workspace:^3.0.5",
-    "@nomicfoundation/hardhat-ignition": "workspace:^3.1.2",
-    "@nomicfoundation/hardhat-ignition-ethers": "workspace:^3.1.2",
-    "@nomicfoundation/hardhat-keystore": "workspace:^3.0.6",
-    "@nomicfoundation/hardhat-mocha": "workspace:^3.0.16",
-    "@nomicfoundation/hardhat-network-helpers": "workspace:^3.0.5",
-    "@nomicfoundation/hardhat-typechain": "workspace:^3.0.6",
-    "@nomicfoundation/hardhat-verify": "workspace:^3.0.14",
-    "@nomicfoundation/ignition-core": "workspace:^3.1.2"
+    "@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/03-minimal/package.json

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