hardhat-etherscan-abi

hardhat-etherscan-abi

Hardhat plugin that fetches verified contract ABI from Etherscan.

What

This plugin adds extra features on top of @nomiclabs/hardhat-ethers. It supports mainnet, bsc, and most common testnets.

Installation

npm install --save-dev hardhat-etherscan-abi

And add the following statement to your hardhat.config.js:

require("hardhat-etherscan-abi");

Or, if you are using TypeScript, add this to your hardhat.config.ts:

import "hardhat-etherscan-abi";

Tasks

This plugin creates no additional tasks.

Environment extensions

This object has adds some extra hardhat-etherscan-abi specific functionalities by adding new extra fields to hre.ethers

Helpers

These helpers are added to the ethers object:

export async function getVerifiedContractAt(
  hre: HardhatRuntimeEnvironment,
  address: string,
  signer?: ethers.Signer
): Promise<ethers.Contract>;

Usage

You need to add the following Etherscan config to your hardhat.config.js file:

module.exports = {
  networks: {
    mainnet: { ... }
  },
  etherscan: {
    // Your API key for Etherscan
    // Obtain one at https://etherscan.io/
    apiKey: "YOUR_ETHERSCAN_API_KEY"
  }
};

Then use the function:

const contract = await hre.ethers.getVerifiedContractAt('<address>');

It requires only contract address and will fetch the ABI for the contract automatically from Etherscan