A Hardhat plugin that adds a task to deploy fake ERC20 tokens to the hardhat local network.

Usage no npm install needed!

<script type="module">
  import hardhatDeployFakeErc20 from 'https://cdn.skypack.dev/hardhat-deploy-fake-erc20';



Work In Progress

A Hardhat plugin to deploy a configurable number of ERC-20 tokens to the local Hardhat network. This is inteded to be used to help developers quickly deploy ERC20 tokens and mint a beginning balance for each account on the network. This is useful for dApps that interact with multiple ERC20 tokens. The plugin uses OpenZeppelin's ERC-20 contract to create the tokens.


Run the following command to install hardhat-deploy-fake-erc20 in your hardhat project. The pluging requires the @nomiclabs/hardhat-ethers plugin and the Ethereum library ethers.js.

npm install hardhat-deploy-fake-erc20 @nomiclabs/hardhat-ethers ethers@^5.0.0

Import the plugin in your hardhat.config.js:


Or if you are using TypeScript, in your hardhat.config.ts:

import "hardhat-deploy-fake-erc20";

Required plugins


The plugin adds the fakeERC20Network property to hardhat.config.js.

This is an example:

module.exports = {
    fakeERC20Network: {
        tokens: [
                name: "Gold",
                symbol: "GLD",
                defaultMintAmount: "80000000000000000000",
        defaultMintAmount: "80000000000000000000",

tokens - An array of objects that describe the tokens to be deployed to the local network.

Property Required Description
name Yes The name of the ERC20 token
symbol Yes The Symbol of the token
defaultMintAmount No The amount to mint for each user. Overrides global defaultMintAmount

defaultMintAmount - The amount to of each token to minto for each user. This is a fallback if no defaultMintAmount is added to the tokens


The plugin adds the deploy-fake-erc20 task to Hardhat. The task will deploy the tokens described in the fakeERC20Network.tokens array and mint the defaultMintAmount for each user on the network. The task returns the contract address for each token deployed.

npx hardhat deploy-fake-erc20