hardhat 2.12.2 → 2.13.0-dev.1

package/internal/hardhat-network/provider/vm/vm-adapter.d.ts

@@ -0,0 +1,36 @@
+/// <reference types="node" />
+import type { EVMResult, InterpreterStep, Message } from "@nomicfoundation/ethereumjs-evm";
+import type { RunTxResult } from "@nomicfoundation/ethereumjs-vm";
+import type { Block } from "@nomicfoundation/ethereumjs-block";
+import type { Common } from "@nomicfoundation/ethereumjs-common";
+import type { TypedTransaction } from "@nomicfoundation/ethereumjs-tx";
+import type { Account, Address } from "@nomicfoundation/ethereumjs-util";
+import type { RpcDebugTracingConfig } from "../../../core/jsonrpc/types/input/debugTraceTransaction";
+import type { RpcDebugTraceOutput } from "../output";
+export interface VMAdapter {
+    dryRun(tx: TypedTransaction, blockContext: Block, forceBaseFeeZero?: boolean): Promise<RunTxResult>;
+    getCommon(): Common;
+    isEip1559Active(blockNumberOrPending?: bigint | "pending"): boolean;
+    getAccount(address: Address): Promise<Account>;
+    getContractStorage(address: Address, key: Buffer): Promise<Buffer>;
+    getContractCode(address: Address): Promise<Buffer>;
+    putAccount(address: Address, account: Account): Promise<void>;
+    putContractCode(address: Address, value: Buffer): Promise<void>;
+    putContractStorage(address: Address, key: Buffer, value: Buffer): Promise<void>;
+    getStateRoot(): Promise<Buffer>;
+    setBlockContext(block: Block, irregularStateOrUndefined: Buffer | undefined): Promise<void>;
+    restoreContext(stateRoot: Buffer): Promise<void>;
+    startBlock(): Promise<void>;
+    runTxInBlock(tx: TypedTransaction, block: Block): Promise<RunTxResult>;
+    addBlockRewards(rewards: Array<[Address, bigint]>): Promise<void>;
+    sealBlock(): Promise<void>;
+    revertBlock(): Promise<void>;
+    traceTransaction(hash: Buffer, block: Block, config: RpcDebugTracingConfig): Promise<RpcDebugTraceOutput>;
+    enableTracing(callbacks: {
+        beforeMessage: (message: Message, next: any) => Promise<void>;
+        step: (step: InterpreterStep, next: any) => Promise<void>;
+        afterMessage: (result: EVMResult, next: any) => Promise<void>;
+    }): void;
+    disableTracing(): void;
+}
+//# sourceMappingURL=vm-adapter.d.ts.map

package/internal/hardhat-network/provider/vm/vm-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-adapter.d.ts","sourceRoot":"","sources":["../../../../src/internal/hardhat-network/provider/vm/vm-adapter.ts"],"names":[],"mappings":"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"}

package/internal/hardhat-network/provider/vm/vm-adapter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vm-adapter.js.map

package/internal/hardhat-network/provider/vm/vm-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-adapter.js","sourceRoot":"","sources":["../../../../src/internal/hardhat-network/provider/vm/vm-adapter.ts"],"names":[],"mappings":""}

package/internal/lib/hardhat-lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hardhat-lib.d.ts","sourceRoot":"","sources":["../../src/internal/lib/hardhat-lib.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAUxD,QAAA,IAAI,GAAG,EAAE,yBAAyB,CAAC;AAsCnC,SAAS,GAAG,CAAC"}
+{"version":3,"file":"hardhat-lib.d.ts","sourceRoot":"","sources":["../../src/internal/lib/hardhat-lib.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAUxD,QAAA,IAAI,GAAG,EAAE,yBAAyB,CAAC;AA2CnC,SAAS,GAAG,CAAC"}

package/internal/lib/hardhat-lib.js

@@ -28,7 +28,10 @@ else {
         debug_1.default.enable("hardhat*");
     }
     const { resolvedConfig, userConfig } = (0, config_loading_1.loadConfigAndTasks)(hardhatArguments);
-    env = new runtime_environment_1.Environment(resolvedConfig, hardhatArguments, ctx.tasksDSL.getTaskDefinitions(), ctx.extendersManager.getExtenders(), ctx.experimentalHardhatNetworkMessageTraceHooks, userConfig);
+    const artifactsExtensions = ctx.extendersManager
+        .getArtifactsExtenders()
+        .map((artifactsExtender) => artifactsExtender(resolvedConfig));
+    env = new runtime_environment_1.Environment(resolvedConfig, hardhatArguments, ctx.tasksDSL.getTaskDefinitions(), ctx.extendersManager.getEnvironmentExtenders(), artifactsExtensions, ctx.experimentalHardhatNetworkMessageTraceHooks, userConfig);
     ctx.setHardhatRuntimeEnvironment(env);
 }
 module.exports = env;

package/internal/lib/hardhat-lib.js.map

@@ -1 +1 @@
-{"version":3,"file":"hardhat-lib.js","sourceRoot":"","sources":["../../src/internal/lib/hardhat-lib.ts"],"names":[],"mappings":";;;;AAAA,kDAA0B;AAG1B,wCAA4C;AAC5C,kEAAmE;AACnE,2CAA8C;AAC9C,qDAA6C;AAC7C,gEAAsE;AACtE,kEAA0E;AAC1E,qEAA0D;AAE1D,IAAI,GAAmB,CAAC;AACxB,IAAI,GAA8B,CAAC;AAEnC,IAAI,wBAAc,CAAC,SAAS,EAAE,EAAE;IAC9B,GAAG,GAAG,wBAAc,CAAC,iBAAiB,EAAE,CAAC;IAEzC,6EAA6E;IAC7E,uBAAuB;IACvB,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,EAAE;QACjC,MAAM,IAAI,qBAAY,CAAC,oBAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;KACrE;IAED,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC;CACvB;KAAM;IACL,GAAG,GAAG,wBAAc,CAAC,oBAAoB,EAAE,CAAC;IAE5C,MAAM,gBAAgB,GAAG,IAAA,sCAAsB,EAC7C,0CAAyB,EACzB,OAAO,CAAC,GAAG,CACZ,CAAC;IAEF,IAAI,gBAAgB,CAAC,OAAO,EAAE;QAC5B,eAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;KAC1B;IAED,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,IAAA,mCAAkB,EAAC,gBAAgB,CAAC,CAAC;IAE5E,GAAG,GAAG,IAAI,iCAAW,CACnB,cAAc,EACd,gBAAgB,EAChB,GAAG,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EACjC,GAAG,CAAC,gBAAgB,CAAC,YAAY,EAAE,EACnC,GAAG,CAAC,2CAA2C,EAC/C,UAAU,CACX,CAAC;IAEF,GAAG,CAAC,4BAA4B,CAAC,GAAG,CAAC,CAAC;CACvC;AAED,iBAAS,GAAG,CAAC"}
+{"version":3,"file":"hardhat-lib.js","sourceRoot":"","sources":["../../src/internal/lib/hardhat-lib.ts"],"names":[],"mappings":";;;;AAAA,kDAA0B;AAG1B,wCAA4C;AAC5C,kEAAmE;AACnE,2CAA8C;AAC9C,qDAA6C;AAC7C,gEAAsE;AACtE,kEAA0E;AAC1E,qEAA0D;AAE1D,IAAI,GAAmB,CAAC;AACxB,IAAI,GAA8B,CAAC;AAEnC,IAAI,wBAAc,CAAC,SAAS,EAAE,EAAE;IAC9B,GAAG,GAAG,wBAAc,CAAC,iBAAiB,EAAE,CAAC;IAEzC,6EAA6E;IAC7E,uBAAuB;IACvB,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,EAAE;QACjC,MAAM,IAAI,qBAAY,CAAC,oBAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;KACrE;IAED,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC;CACvB;KAAM;IACL,GAAG,GAAG,wBAAc,CAAC,oBAAoB,EAAE,CAAC;IAE5C,MAAM,gBAAgB,GAAG,IAAA,sCAAsB,EAC7C,0CAAyB,EACzB,OAAO,CAAC,GAAG,CACZ,CAAC;IAEF,IAAI,gBAAgB,CAAC,OAAO,EAAE;QAC5B,eAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;KAC1B;IAED,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,IAAA,mCAAkB,EAAC,gBAAgB,CAAC,CAAC;IAE5E,MAAM,mBAAmB,GAAG,GAAG,CAAC,gBAAgB;SAC7C,qBAAqB,EAAE;SACvB,GAAG,CAAC,CAAC,iBAAiB,EAAE,EAAE,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC;IAEjE,GAAG,GAAG,IAAI,iCAAW,CACnB,cAAc,EACd,gBAAgB,EAChB,GAAG,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EACjC,GAAG,CAAC,gBAAgB,CAAC,uBAAuB,EAAE,EAC9C,mBAAmB,EACnB,GAAG,CAAC,2CAA2C,EAC/C,UAAU,CACX,CAAC;IAEF,GAAG,CAAC,4BAA4B,CAAC,GAAG,CAAC,CAAC;CACvC;AAED,iBAAS,GAAG,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hardhat",
-  "version": "2.12.2",
+  "version": "2.13.0-dev.1",
   "author": "Nomic Labs LLC",
   "license": "MIT",
   "homepage": "https://hardhat.org",

package/register.js

@@ -25,7 +25,10 @@ if (!context_1.HardhatContext.isCreated()) {
         (0, typescript_support_1.loadTsNode)(hardhatArguments.tsconfig, hardhatArguments.typecheck);
     }
     const { resolvedConfig, userConfig } = (0, config_loading_1.loadConfigAndTasks)(hardhatArguments);
-    const env = new runtime_environment_1.Environment(resolvedConfig, hardhatArguments, ctx.tasksDSL.getTaskDefinitions(), ctx.extendersManager.getExtenders(), ctx.experimentalHardhatNetworkMessageTraceHooks, userConfig);
+    const artifactsExtensions = ctx.extendersManager
+        .getArtifactsExtenders()
+        .map((artifactsExtender) => artifactsExtender(resolvedConfig));
+    const env = new runtime_environment_1.Environment(resolvedConfig, hardhatArguments, ctx.tasksDSL.getTaskDefinitions(), ctx.extendersManager.getEnvironmentExtenders(), artifactsExtensions, ctx.experimentalHardhatNetworkMessageTraceHooks, userConfig);
     ctx.setHardhatRuntimeEnvironment(env);
     env.injectToGlobal();
 }

package/register.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.js","sourceRoot":"","sources":["src/register.ts"],"names":[],"mappings":";;;;;AAAA,kDAA0B;AAE1B,gDAAoD;AACpD,0EAA2E;AAC3E,wEAA8E;AAC9E,0EAAkF;AAClF,6EAAkE;AAClE,2EAG4C;AAC5C,qDAGiC;AAEjC,IAAI,CAAC,wBAAc,CAAC,SAAS,EAAE,EAAE;IAC/B,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAEvC,MAAM,GAAG,GAAG,wBAAc,CAAC,oBAAoB,EAAE,CAAC;IAElD,IAAI,IAAA,oCAA0B,GAAE,EAAE;QAChC,IAAA,oCAA0B,GAAE,CAAC;KAC9B;IAED,MAAM,gBAAgB,GAAG,IAAA,sCAAsB,EAC7C,0CAAyB,EACzB,OAAO,CAAC,GAAG,CACZ,CAAC;IAEF,IAAI,gBAAgB,CAAC,OAAO,EAAE;QAC5B,eAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;KAC1B;IAED,IAAI,IAAA,0CAAqB,EAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE;QAClD,IAAA,+BAAU,EAAC,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;KACnE;IAED,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,IAAA,mCAAkB,EAAC,gBAAgB,CAAC,CAAC;IAE5E,MAAM,GAAG,GAAG,IAAI,iCAAW,CACzB,cAAc,EACd,gBAAgB,EAChB,GAAG,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EACjC,GAAG,CAAC,gBAAgB,CAAC,YAAY,EAAE,EACnC,GAAG,CAAC,2CAA2C,EAC/C,UAAU,CACX,CAAC;IAEF,GAAG,CAAC,4BAA4B,CAAC,GAAG,CAAC,CAAC;IAEtC,GAAG,CAAC,cAAc,EAAE,CAAC;CACtB"}
+{"version":3,"file":"register.js","sourceRoot":"","sources":["src/register.ts"],"names":[],"mappings":";;;;;AAAA,kDAA0B;AAE1B,gDAAoD;AACpD,0EAA2E;AAC3E,wEAA8E;AAC9E,0EAAkF;AAClF,6EAAkE;AAClE,2EAG4C;AAC5C,qDAGiC;AAEjC,IAAI,CAAC,wBAAc,CAAC,SAAS,EAAE,EAAE;IAC/B,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAEvC,MAAM,GAAG,GAAG,wBAAc,CAAC,oBAAoB,EAAE,CAAC;IAElD,IAAI,IAAA,oCAA0B,GAAE,EAAE;QAChC,IAAA,oCAA0B,GAAE,CAAC;KAC9B;IAED,MAAM,gBAAgB,GAAG,IAAA,sCAAsB,EAC7C,0CAAyB,EACzB,OAAO,CAAC,GAAG,CACZ,CAAC;IAEF,IAAI,gBAAgB,CAAC,OAAO,EAAE;QAC5B,eAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;KAC1B;IAED,IAAI,IAAA,0CAAqB,EAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE;QAClD,IAAA,+BAAU,EAAC,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;KACnE;IAED,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,IAAA,mCAAkB,EAAC,gBAAgB,CAAC,CAAC;IAE5E,MAAM,mBAAmB,GAAG,GAAG,CAAC,gBAAgB;SAC7C,qBAAqB,EAAE;SACvB,GAAG,CAAC,CAAC,iBAAiB,EAAE,EAAE,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC;IAEjE,MAAM,GAAG,GAAG,IAAI,iCAAW,CACzB,cAAc,EACd,gBAAgB,EAChB,GAAG,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EACjC,GAAG,CAAC,gBAAgB,CAAC,uBAAuB,EAAE,EAC9C,mBAAmB,EACnB,GAAG,CAAC,2CAA2C,EAC/C,UAAU,CACX,CAAC;IAEF,GAAG,CAAC,4BAA4B,CAAC,GAAG,CAAC,CAAC;IAEtC,GAAG,CAAC,cAAc,EAAE,CAAC;CACtB"}

package/src/internal/artifacts/caching.ts

@@ -0,0 +1,239 @@
+import {
+  Artifact,
+  ArtifactsSource,
+  BuildInfo,
+  CompilerInput,
+  CompilerOutput,
+} from "../../types";
+
+import { MutableSource } from "./mutable";
+
+interface Cache {
+  artifactPaths?: string[];
+  debugFilePaths?: string[];
+  buildInfoPaths?: string[];
+  artifactNameToArtifactPathCache: Map<string, string>;
+  artifactFQNToBuildInfoPathCache: Map<string, string>;
+  artifactNameToArtifact: Map<string, Artifact>;
+}
+
+export class CachingSource extends MutableSource implements ArtifactsSource {
+  // Undefined means that the cache is disabled.
+  private _cache?: Cache = {
+    artifactNameToArtifactPathCache: new Map(),
+    artifactFQNToBuildInfoPathCache: new Map(),
+    artifactNameToArtifact: new Map(),
+  };
+
+  constructor(artifactsPath: string) {
+    super(artifactsPath);
+  }
+
+  public async readArtifact(name: string): Promise<Artifact | undefined> {
+    const cached = this._cache?.artifactNameToArtifact.get(name);
+    if (cached !== undefined) {
+      return cached;
+    }
+
+    const artifact = await super.readArtifact(name);
+    if (artifact === undefined) {
+      return undefined;
+    }
+
+    this._cache?.artifactNameToArtifact.set(name, artifact);
+
+    return artifact;
+  }
+
+  public readArtifactSync(name: string): Artifact | undefined {
+    const cached = this._cache?.artifactNameToArtifact.get(name);
+    if (cached !== undefined) {
+      return cached;
+    }
+
+    const artifact = super.readArtifactSync(name);
+    if (artifact === undefined) {
+      return undefined;
+    }
+
+    this._cache?.artifactNameToArtifact.set(name, artifact);
+
+    return artifact;
+  }
+
+  public async getBuildInfo(
+    fullyQualifiedName: string
+  ): Promise<BuildInfo | undefined> {
+    let buildInfoPath =
+      this._cache?.artifactFQNToBuildInfoPathCache.get(fullyQualifiedName);
+
+    if (buildInfoPath === undefined) {
+      buildInfoPath = await super._getBuildInfoPath(fullyQualifiedName);
+
+      if (buildInfoPath === undefined) {
+        return undefined;
+      }
+
+      this._cache?.artifactFQNToBuildInfoPathCache.set(
+        fullyQualifiedName,
+        buildInfoPath
+      );
+    }
+
+    return super._getBuildInfoByPath(buildInfoPath);
+  }
+
+  public async getArtifactPaths(): Promise<string[]> {
+    const cached = this._cache?.artifactPaths;
+    if (cached !== undefined) {
+      return cached;
+    }
+
+    const artifactPaths = await super.getArtifactPaths();
+
+    if (this._cache !== undefined) {
+      this._cache.artifactPaths = artifactPaths;
+    }
+
+    return artifactPaths;
+  }
+
+  public async getBuildInfoPaths(): Promise<string[]> {
+    const cached = this._cache?.buildInfoPaths;
+    if (cached !== undefined) {
+      return cached;
+    }
+
+    const buildInfoPaths = await super.getBuildInfoPaths();
+
+    if (this._cache !== undefined) {
+      this._cache.buildInfoPaths = buildInfoPaths;
+    }
+
+    return buildInfoPaths;
+  }
+
+  public async getDebugFilePaths(): Promise<string[]> {
+    const cached = this._cache?.debugFilePaths;
+    if (cached !== undefined) {
+      return cached;
+    }
+
+    const debugFilePaths = await super.getDebugFilePaths();
+
+    if (this._cache !== undefined) {
+      this._cache.debugFilePaths = debugFilePaths;
+    }
+
+    return debugFilePaths;
+  }
+
+  public async saveArtifactAndDebugFile(
+    artifact: Artifact,
+    pathToBuildInfo?: string
+  ) {
+    try {
+      await super.saveArtifactAndDebugFile(artifact, pathToBuildInfo);
+    } finally {
+      this.clearCache();
+    }
+  }
+
+  public async saveBuildInfo(
+    solcVersion: string,
+    solcLongVersion: string,
+    input: CompilerInput,
+    output: CompilerOutput
+  ): Promise<string> {
+    try {
+      return await super.saveBuildInfo(
+        solcVersion,
+        solcLongVersion,
+        input,
+        output
+      );
+    } finally {
+      this.clearCache();
+    }
+  }
+
+  /**
+   * Remove all artifacts that don't correspond to the current solidity files
+   */
+  public async removeObsoleteArtifacts() {
+    // We clear the cache here, as we want to be sure this runs correctly
+    this.clearCache();
+
+    try {
+      await super.removeObsoleteArtifacts();
+    } finally {
+      // We clear the cache here, as this may have non-existent paths now
+      this.clearCache();
+    }
+  }
+
+  public clearCache() {
+    // Avoid accidentally re-enabling the cache
+    if (this._cache === undefined) {
+      return;
+    }
+
+    this._cache = {
+      artifactFQNToBuildInfoPathCache: new Map(),
+      artifactNameToArtifactPathCache: new Map(),
+      artifactNameToArtifact: new Map(),
+    };
+  }
+
+  public disableCache() {
+    this._cache = undefined;
+  }
+
+  protected async _getArtifactPath(name: string): Promise<string | undefined> {
+    const cached = this._cache?.artifactNameToArtifactPathCache.get(name);
+    if (cached !== undefined) {
+      return cached;
+    }
+
+    const result = await super._getArtifactPath(name);
+    if (result === undefined) {
+      return undefined;
+    }
+
+    this._cache?.artifactNameToArtifactPathCache.set(name, result);
+    return result;
+  }
+
+  protected _getArtifactPathsSync(): string[] {
+    const cached = this._cache?.artifactPaths;
+    if (cached !== undefined) {
+      return cached;
+    }
+
+    const result = super._getArtifactPathsSync();
+
+    if (this._cache !== undefined) {
+      this._cache.artifactPaths = result;
+    }
+
+    return result;
+  }
+
+  /**
+   * Sync version of _getArtifactPath
+   */
+  protected _getArtifactPathSync(name: string): string | undefined {
+    const cached = this._cache?.artifactNameToArtifactPathCache.get(name);
+    if (cached !== undefined) {
+      return cached;
+    }
+
+    const result = super._getArtifactPathSync(name);
+    if (result === undefined) {
+      return undefined;
+    }
+
+    this._cache?.artifactNameToArtifactPathCache.set(name, result);
+    return result;
+  }
+}

package/src/internal/artifacts/index.ts

@@ -0,0 +1,296 @@
+import * as os from "os";
+import path from "path";
+
+import {
+  Artifact,
+  Artifacts as IArtifacts,
+  ArtifactsSource,
+  BuildInfo,
+  CompilerInput,
+  CompilerOutput,
+} from "../../types";
+import { parseFullyQualifiedName } from "../../utils/contract-names";
+
+import { ARTIFACT_FORMAT_VERSION } from "../constants";
+import { HardhatError } from "../core/errors";
+import { ERRORS } from "../core/errors-list";
+
+import { CachingSource } from "./caching";
+
+export class Artifacts implements IArtifacts {
+  private readonly _hardhatSource: CachingSource;
+
+  constructor(
+    private readonly _artifactsPath: string,
+    private readonly _extensionSources: ArtifactsSource[] = []
+  ) {
+    this._hardhatSource = new CachingSource(this._artifactsPath);
+  }
+
+  public async readArtifact(
+    contractNameOrFullyQualifiedName: string
+  ): Promise<Artifact> {
+    let artifact: Artifact | undefined = await this._hardhatSource.readArtifact(
+      contractNameOrFullyQualifiedName
+    );
+
+    if (artifact === undefined) {
+      const artifacts: Array<Artifact | undefined> = await Promise.all(
+        this._extensionSources.map((source) =>
+          source.readArtifact(contractNameOrFullyQualifiedName)
+        )
+      );
+
+      artifact = artifacts.find((_artifact) => _artifact !== undefined);
+    }
+
+    if (artifact === undefined) {
+      this._throwNotFound(contractNameOrFullyQualifiedName);
+    }
+
+    return artifact;
+  }
+
+  public readArtifactSync(contractNameOrFullyQualifiedName: string): Artifact {
+    let artifact: Artifact | undefined = this._hardhatSource.readArtifactSync(
+      contractNameOrFullyQualifiedName
+    );
+
+    if (artifact === undefined) {
+      for (const source of this._extensionSources) {
+        artifact = source.readArtifactSync(contractNameOrFullyQualifiedName);
+        if (artifact !== undefined) {
+          break;
+        }
+      }
+    }
+
+    if (artifact === undefined) {
+      this._throwNotFound(contractNameOrFullyQualifiedName);
+    }
+
+    return artifact;
+  }
+
+  public async artifactExists(
+    contractNameOrFullyQualifiedName: string
+  ): Promise<boolean> {
+    const existencesPerSource = await Promise.all(
+      [this._hardhatSource, ...this._extensionSources].map((source) =>
+        source.artifactExists(contractNameOrFullyQualifiedName)
+      )
+    );
+    return existencesPerSource.includes(true);
+  }
+
+  public async getAllFullyQualifiedNames(): Promise<string[]> {
+    return (
+      await Promise.all(
+        [this._hardhatSource, ...this._extensionSources].map((s) =>
+          s.getAllFullyQualifiedNames()
+        )
+      )
+    ).flat();
+  }
+
+  public async getBuildInfo(
+    fullyQualifiedName: string
+  ): Promise<BuildInfo | undefined> {
+    let buildInfo = await this._hardhatSource.getBuildInfo(fullyQualifiedName);
+
+    if (buildInfo === undefined) {
+      const buildInfos: Array<BuildInfo | undefined> = await Promise.all(
+        this._extensionSources.map((source) =>
+          source.getBuildInfo(fullyQualifiedName)
+        )
+      );
+      buildInfo = buildInfos.find((info) => info !== undefined);
+    }
+
+    return buildInfo;
+  }
+
+  public async getArtifactPaths(): Promise<string[]> {
+    return (
+      await Promise.all(
+        [this._hardhatSource, ...this._extensionSources].map((s) =>
+          s.getArtifactPaths()
+        )
+      )
+    ).flat();
+  }
+
+  public async getDebugFilePaths(): Promise<string[]> {
+    return (
+      await Promise.all(
+        [this._hardhatSource, ...this._extensionSources].map((s) =>
+          s.getDebugFilePaths()
+        )
+      )
+    ).flat();
+  }
+
+  public async getBuildInfoPaths(): Promise<string[]> {
+    return (
+      await Promise.all(
+        [this._hardhatSource, ...this._extensionSources].map((s) =>
+          s.getBuildInfoPaths()
+        )
+      )
+    ).flat();
+  }
+
+  public clearCache(): void {
+    for (const source of [this._hardhatSource, ...this._extensionSources]) {
+      source.clearCache();
+    }
+  }
+
+  public disableCache(): void {
+    for (const source of [this._hardhatSource, ...this._extensionSources]) {
+      source.disableCache();
+    }
+  }
+
+  public saveArtifactAndDebugFile(
+    artifact: Artifact,
+    pathToBuildInfo?: string
+  ): Promise<void> {
+    return this._hardhatSource.saveArtifactAndDebugFile(
+      artifact,
+      pathToBuildInfo
+    );
+  }
+
+  public saveBuildInfo(
+    solcVersion: string,
+    solcLongVersion: string,
+    input: CompilerInput,
+    output: CompilerOutput
+  ): Promise<string> {
+    return this._hardhatSource.saveBuildInfo(
+      solcVersion,
+      solcLongVersion,
+      input,
+      output
+    );
+  }
+
+  public formArtifactPathFromFullyQualifiedName(
+    fullyQualifiedName: string
+  ): string {
+    return this._hardhatSource.formArtifactPathFromFullyQualifiedName(
+      fullyQualifiedName
+    );
+  }
+
+  public addValidArtifacts(
+    validArtifacts: Array<{ sourceName: string; artifacts: string[] }>
+  ) {
+    this._hardhatSource.addValidArtifacts(validArtifacts);
+  }
+
+  public async removeObsoleteArtifacts() {
+    return this._hardhatSource.removeObsoleteArtifacts();
+  }
+
+  private _throwNotFound(contractNameOrFullyQualifiedName: string): never {
+    const suggestions = this._hardhatSource.getSuggestions(
+      contractNameOrFullyQualifiedName
+    );
+
+    const uniqueSuggestions = [...new Set(suggestions)].sort();
+
+    const suggestion = this._formatSuggestions(
+      uniqueSuggestions,
+      contractNameOrFullyQualifiedName
+    );
+
+    throw new HardhatError(ERRORS.ARTIFACTS.NOT_FOUND, {
+      contractName: contractNameOrFullyQualifiedName,
+      suggestion,
+    });
+  }
+
+  private _formatSuggestions(names: string[], contractName: string): string {
+    switch (names.length) {
+      case 0:
+        return "";
+      case 1:
+        return `Did you mean "${names[0]}"?`;
+      default:
+        return `We found some that were similar:
+
+${names.map((n) => `  * ${n}`).join(os.EOL)}
+
+Please replace "${contractName}" for the correct contract name wherever you are trying to read its artifact.
+`;
+    }
+  }
+
+  /**
+   * DO NOT DELETE OR CHANGE
+   *
+   * use this.formArtifactPathFromFullyQualifiedName instead
+   * @deprecated until typechain migrates to public version
+   * @see https://github.com/dethcrypto/TypeChain/issues/544
+   */
+  private _getArtifactPathFromFullyQualifiedName(
+    fullyQualifiedName: string
+  ): string {
+    const { sourceName, contractName } =
+      parseFullyQualifiedName(fullyQualifiedName);
+
+    return path.join(this._artifactsPath, sourceName, `${contractName}.json`);
+  }
+}
+
+/**
+ * Retrieves an artifact for the given `contractName` from the compilation output.
+ *
+ * @param sourceName The contract's source name.
+ * @param contractName the contract's name.
+ * @param contractOutput the contract's compilation output as emitted by `solc`.
+ */
+export function getArtifactFromContractOutput(
+  sourceName: string,
+  contractName: string,
+  contractOutput: any
+): Artifact {
+  const evmBytecode = contractOutput.evm && contractOutput.evm.bytecode;
+  let bytecode: string =
+    evmBytecode && evmBytecode.object ? evmBytecode.object : "";
+
+  if (bytecode.slice(0, 2).toLowerCase() !== "0x") {
+    bytecode = `0x${bytecode}`;
+  }
+
+  const evmDeployedBytecode =
+    contractOutput.evm && contractOutput.evm.deployedBytecode;
+  let deployedBytecode: string =
+    evmDeployedBytecode && evmDeployedBytecode.object
+      ? evmDeployedBytecode.object
+      : "";
+
+  if (deployedBytecode.slice(0, 2).toLowerCase() !== "0x") {
+    deployedBytecode = `0x${deployedBytecode}`;
+  }
+
+  const linkReferences =
+    evmBytecode && evmBytecode.linkReferences ? evmBytecode.linkReferences : {};
+  const deployedLinkReferences =
+    evmDeployedBytecode && evmDeployedBytecode.linkReferences
+      ? evmDeployedBytecode.linkReferences
+      : {};
+
+  return {
+    _format: ARTIFACT_FORMAT_VERSION,
+    contractName,
+    sourceName,
+    abi: contractOutput.abi,
+    bytecode,
+    deployedBytecode,
+    linkReferences,
+    deployedLinkReferences,
+  };
+}