Add artifact functions in ethers getContractFactoryFromArtifact and getContractAtFromArtifact

[kanej]

In hardhat-ethers, allow passing of artifacts (resolved via custom code) into an equivalent of the getContractFactory call, this is instead of resolving by contract name.

The intention here is to support custom contract artifact resolution but still allow the leveraging of hardhat-ethers.

Two new functions have been added to support this without altering the existing signature:

• getContractFactoryFromArtifact
• getContractAtFromArtifact

Relates to #1716

Example Usage

import { ethers } from "hardhat";
import { Artifacts } from "hardhat/internal/artifacts";
import { Artifact } from "hardhat/types";

export async function getArtifact(contract: string): Promise<Artifact> {
  const artifactsPath: string = "./artifacts";

  const artifacts = new Artifacts(artifactsPath);
  return artifacts.readArtifact(contract);
}

async function main() {
  const artifact = await getArtifact("Greeter");

  const Factory = await ethers.getContractFactoryFromArtifact(artifact);

  const greeter = await Factory.deploy("Hello, Hardhat!");

  await greeter.deployed();

  console.log("Greeter deployed to:", greeter.address);

  const response = await greeter.greet();

  console.log("First Response", response);

  const alternateGreeter = await ethers.getContractAtFromArtifact(
    artifact,
    greeter.address
  );

  const secondResponse = await alternateGreeter.greet();

  console.log("Second Response", secondResponse);
}

// We recommend this pattern to be able to use async/await everywhere
// and properly handle errors.
main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

TODO

• support artifact in signature of getContractFactoryFromArtifact
• support artifact in signature of getContractAtFromArtifact
• resolve type issue in consuming lib
• determine and update any docs affected

[changeset-bot]

🦋 Changeset detected

Latest commit: 1f796dc

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@nomiclabs/hardhat-ethers	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[kanej]

I have test locally with newly created advanced typescript project, and we no longer get the type clash with typechain overriding the method signatures - getContractFactoryFromArtifact, getContractAtFromArtifact