hardhat 3.11.1 → 3.13.0

package/src/internal/core/tasks/validations.ts

@@ -43,7 +43,8 @@ export function validateAction(
 ): void {
   if (isPlugin && inlineAction !== undefined) {
     throw new HardhatError(
-      HardhatError.ERRORS.CORE.TASK_DEFINITIONS.INLINE_ACTION_CANNOT_BE_USED_IN_PLUGINS,
+      HardhatError.ERRORS.CORE.TASK_DEFINITIONS
+        .INLINE_ACTION_CANNOT_BE_USED_IN_PLUGINS,
       { task: formatTaskId(taskId) },
     );
   }

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

@@ -7,9 +7,7 @@ import { styleText } from "node:util";
 import { assertHardhatInvariant } from "@nomicfoundation/hardhat-errors";
 import { AsyncMutex } from "@nomicfoundation/hardhat-utils/synchronization";
 
-export class UserInterruptionManagerImplementation
-  implements UserInterruptionManager
-{
+export class UserInterruptionManagerImplementation implements UserInterruptionManager {
   readonly #hooks;
   readonly #mutex = new AsyncMutex();
 

package/src/internal/global-hre-instance.ts

@@ -12,8 +12,7 @@ let hre: HardhatRuntimeEnvironment | undefined;
  * are always using the same HRE instance.
  */
 export function getGlobalHardhatRuntimeEnvironment():
-  | HardhatRuntimeEnvironment
-  | undefined {
+  HardhatRuntimeEnvironment | undefined {
   return hre;
 }
 

package/src/types/artifacts.ts

@@ -48,8 +48,7 @@ export type ArtifactContractNames = keyof ArtifactMap extends never
  * @see {@link ArtifactContractNames}
  */
 export type StringWithArtifactContractNamesAutocompletion =
-  | ArtifactContractNames
-  | (string & {});
+  ArtifactContractNames | (string & {});
 
 /**
  * The ArtifactManager is responsible for reading and writing artifacts from

package/src/types/config.ts

@@ -8,6 +8,18 @@ export interface ConfigurationVariable {
   _type: "ConfigurationVariable";
   name: string;
   format?: string;
+
+  /**
+   * An optional fallback value, used only when the variable can't be resolved
+   * from any other source (e.g. an environment variable or the keystore).
+   *
+   * By default, the value is resolved from the environment variable first, then
+   * any plugin source (like hardhat-keystore), and finally this default. Plugins
+   * can customize this, but the built-in resolver and bundled plugins follow this
+   * order. If none of them provide a value and no default is set, resolving the
+   * variable throws.
+   */
+  default?: string;
 }
 
 /**

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

@@ -151,42 +151,35 @@ export interface BaseCompilationJobCreationError {
   formattedReason: string;
 }
 
-export interface CompilationJobCreationErrorNoCompatibleSolcVersionWithRoot
-  extends BaseCompilationJobCreationError {
+export interface CompilationJobCreationErrorNoCompatibleSolcVersionWithRoot extends BaseCompilationJobCreationError {
   reason: CompilationJobCreationErrorReason.NO_COMPATIBLE_SOLC_VERSION_WITH_ROOT;
 }
 
-export interface CompilationJobCreationErrorNoCompatibleSolcVersionWithDependency
-  extends BaseCompilationJobCreationError {
+export interface CompilationJobCreationErrorNoCompatibleSolcVersionWithDependency extends BaseCompilationJobCreationError {
   reason: CompilationJobCreationErrorReason.NO_COMPATIBLE_SOLC_VERSION_WITH_DEPENDENCY;
   incompatibleImportPath: string[];
 }
 
-export interface CompilationJobCreationErrorImportOfIncompatibleFile
-  extends BaseCompilationJobCreationError {
+export interface CompilationJobCreationErrorImportOfIncompatibleFile extends BaseCompilationJobCreationError {
   reason: CompilationJobCreationErrorReason.IMPORT_OF_INCOMPATIBLE_FILE;
   incompatibleImportPath: string[];
 }
 
-export interface CompilationJobCreationErrorNoCompatibleSolcVersionForTransitiveImportPath
-  extends BaseCompilationJobCreationError {
+export interface CompilationJobCreationErrorNoCompatibleSolcVersionForTransitiveImportPath extends BaseCompilationJobCreationError {
   reason: CompilationJobCreationErrorReason.NO_COMPATIBLE_SOLC_VERSION_FOR_TRANSITIVE_IMPORT_PATH;
   incompatibleImportPath: string[];
 }
 
-export interface CompilationJobCreationErrorIncompatibleOverriddenSolcVersion
-  extends BaseCompilationJobCreationError {
+export interface CompilationJobCreationErrorIncompatibleOverriddenSolcVersion extends BaseCompilationJobCreationError {
   reason: CompilationJobCreationErrorReason.INCOMPATIBLE_OVERRIDDEN_SOLC_VERSION;
 }
 
-export interface CompilationJobCreationErrorOverriddenSolcVersionIncompatibleWithDependency
-  extends BaseCompilationJobCreationError {
+export interface CompilationJobCreationErrorOverriddenSolcVersionIncompatibleWithDependency extends BaseCompilationJobCreationError {
   reason: CompilationJobCreationErrorReason.OVERRIDDEN_SOLC_VERSION_INCOMPATIBLE_WITH_DEPENDENCY;
   incompatibleImportPath: string[];
 }
 
-export interface CompilationJobCreationErrorNoCompatibleSolcVersionFound
-  extends BaseCompilationJobCreationError {
+export interface CompilationJobCreationErrorNoCompatibleSolcVersionFound extends BaseCompilationJobCreationError {
   reason: CompilationJobCreationErrorReason.NO_COMPATIBLE_SOLC_VERSION_FOUND;
 }
 
@@ -209,9 +202,7 @@ export enum FileBuildResultType {
 }
 
 export type FileBuildResult =
-  | CacheHitFileBuildResult
-  | SuccessfulFileBuildResult
-  | FailedFileBuildResult;
+  CacheHitFileBuildResult | SuccessfulFileBuildResult | FailedFileBuildResult;
 
 export interface CacheHitFileBuildResult {
   type: FileBuildResultType.CACHE_HIT;

package/src/types/solidity/errors.ts

@@ -104,14 +104,12 @@ export interface NpmRootResolutionWithRemappingErrors {
   remappingErrors: UserRemappingError[];
 }
 
-export interface NpmRootFileDoesNotExistWithinPackageError
-  extends ResolvedFileReference {
+export interface NpmRootFileDoesNotExistWithinPackageError extends ResolvedFileReference {
   type: RootResolutionErrorType.NPM_ROOT_FILE_DOES_NOT_EXIST_WITHIN_ITS_PACKAGE;
   npmModule: string;
 }
 
-export interface NpmRootFileWithIncorrectCasingError
-  extends ResolvedFileReference {
+export interface NpmRootFileWithIncorrectCasingError extends ResolvedFileReference {
   type: RootResolutionErrorType.NPM_ROOT_FILE_WITH_INCORRECT_CASING;
   npmModule: string;
   /**
@@ -141,8 +139,7 @@ export type NpmRootResolutionError =
   | NpmRootFileNonExportedFileError;
 
 export type RootResolutionError =
-  | ProjectRootResolutionError
-  | NpmRootResolutionError;
+  ProjectRootResolutionError | NpmRootResolutionError;
 
 /**
  * The different types of errors that can happen when resolving an import.

package/src/types/tasks.ts

@@ -149,9 +149,7 @@ export type TaskOverrideDefinition = BaseTaskOverrideDefinition &
  * actual `Task`s.
  */
 export type TaskDefinition =
-  | EmptyTaskDefinition
-  | NewTaskDefinition
-  | TaskOverrideDefinition;
+  EmptyTaskDefinition | NewTaskDefinition | TaskOverrideDefinition;
 
 /**
  * This helper type adds an argument to an existing TaskArgumentsT.
@@ -188,10 +186,8 @@ export interface EmptyTaskDefinitionBuilder {
  */
 export interface NewTaskDefinitionBuilder<
   TaskArgumentsT extends TaskArguments = TaskArguments,
-  ActionTypeT extends
-    | "LAZY_ACTION"
-    | "INLINE_ACTION"
-    | "MISSING_ACTION" = "MISSING_ACTION",
+  ActionTypeT extends "LAZY_ACTION" | "INLINE_ACTION" | "MISSING_ACTION" =
+    "MISSING_ACTION",
 > {
   /**
    * Sets the description of the task.
@@ -369,10 +365,8 @@ export interface NewTaskDefinitionBuilder<
  */
 export interface TaskOverrideDefinitionBuilder<
   TaskArgumentsT extends TaskArguments = TaskArguments,
-  ActionTypeT extends
-    | "LAZY_ACTION"
-    | "INLINE_ACTION"
-    | "MISSING_ACTION" = "MISSING_ACTION",
+  ActionTypeT extends "LAZY_ACTION" | "INLINE_ACTION" | "MISSING_ACTION" =
+    "MISSING_ACTION",
 > {
   /**
    * Sets a new description for the task.

package/templates/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.11.1",
+    "hardhat": "workspace:^3.13.0",
     "@nomicfoundation/hardhat-toolbox-viem": "workspace:^5.0.7",
     "@nomicfoundation/hardhat-ignition": "workspace:^3.1.8",
     "@types/node": "^22.8.5",

package/templates/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.11.1",
+    "hardhat": "workspace:^3.13.0",
     "@nomicfoundation/hardhat-toolbox-mocha-ethers": "workspace:^3.0.7",
     "@nomicfoundation/hardhat-ethers": "workspace:^4.0.15",
     "@nomicfoundation/hardhat-ignition": "workspace:^3.1.8",

package/templates/03-minimal/package.json

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

package/dist/src/internal/cli/error-handler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../../src/internal/cli/error-handler.ts"],"names":[],"mappings":"AAyDA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,KAAK,EACZ,qBAAqB,GAAE,OAAe,EACtC,KAAK,GAAE,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,KAAK,IAAoB,GACvD,OAAO,CAAC,IAAI,CAAC,CA8Df"}

package/dist/src/internal/cli/error-handler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../../../src/internal/cli/error-handler.ts"],"names":[],"mappings":"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"}