Hardhat is an Ethereum development environment that provides an easy way to deploy smart contracts, run tests and debug Solidity code locally.

In this tutorial, you will learn how to set up Hardhat and use it to build, test and deploy a simple smart contract.

What you will do

  • Set up Hardhat

  • Create a simple smart contract

  • Compile contract

  • Test contract

  • Deploy contract

Setting up the development environment

There are a few technical requirements before we start. Please install the following:

Once we have those installed, you need to create an npm project by going to an empty folder, running npm init, and following its instructions to install Hardhat. Once your project is ready, you should run:

npm install --save-dev hardhat

To create your Hardhat project, run npx hardhat in your project folder. Let’s create the sample project and go through these steps to try out a sample task and compile, test and deploy the sample contract.

The sample project used here comes from the Hardhat Quickstart guide, as well as its instructions.:::

Creating a project

To create a sample project, run npx hardhat in your project folder. You should see the following prompt

$ npx hardhat
888    888                      888 888               888
888    888                      888 888               888
888    888                      888 888               888
8888888888  8888b.  888d888 .d88888 88888b.   8888b.  888888
888    888     "88b 888P"  d88" 888 888 "88b     "88b 888
888    888 .d888888 888    888  888 888  888 .d888888 888
888    888 888  888 888    Y88b 888 888  888 888  888 Y88b.
888    888 "Y888888 888     "Y88888 888  888 "Y888888  "Y888

πŸ‘· Welcome to Hardhat v2.9.9 πŸ‘·β€

? What do you want to do? …
❯ Create a JavaScript project
  Create a TypeScript project
  Create an empty hardhat.config.js

Choose the JavaScript project and go through these steps to compile, test and deploy the sample contract.

Checking the contract

The contracts folder contains Lock.sol, which is a sample contract which consistis of a simple digital lock, where users could only withdraw funds after a given period of time.

// SPDX-License-Identifier: UNLICENSED
pragma solidity ^0.8.9;

// Import this file to use console.log
import "hardhat/console.sol";

contract Lock {
    uint public unlockTime;
    address payable public owner;

    event Withdrawal(uint amount, uint when);

    constructor(uint _unlockTime) payable {
            block.timestamp < _unlockTime,
            "Unlock time should be in the future"

        unlockTime = _unlockTime;
        owner = payable(msg.sender);

    function withdraw() public {
        // Uncomment this line to print a log in your terminal
        // console.log("Unlock time is %o and block timestamp is %o", unlockTime, block.timestamp);

        require(block.timestamp >= unlockTime, "You can't withdraw yet");
        require(msg.sender == owner, "You aren't the owner");

        emit Withdrawal(address(this).balance, block.timestamp);


Setting up the contract

  • Go to hardhat.config.js

  • Update the hardhat-config with matic-network-credentials

  • Create .env file in the root to store your private key

  • Add Polygonscan API key to .env file to verify the contract on Polygonscan. You can generate an API key by creating an account


module.exports = {
  defaultNetwork: "gil-Testnet",
  networks: {
    hardhat: {
    gil-Testnet: {
      url: "https://rpc.giltestnet.com",
      chainId: 1452,
      gasPrice: 20000000000,
      accounts: [process.env.PRIVATE_KEY]
  etherscan: {
    apiKey: {
      gil: "abc"
    customChains: [
        network: "gil",
        chainId: 1452,
        urls: {
          apiURL: "http://explorer.giltestnet.com/api",
          browserURL: "https://explorer.giltestnet.com/"
  solidity: {
    version: "0.8.9",
    settings: {
      optimizer: {
        enabled: true,
        runs: 200

Note that the file above requires DOTENV, for managing environment variables and also ethers and etherscan. Make sure to install all those packages.

Find more instructions on how to use DOTENV on this page.

Compiling the contract

To compile the contract, you first need to install Hardhat Toolbox:

npm install --save-dev @nomicfoundation/hardhat-toolbox

Then, simply run to compile:

npx hardhat compile

Testing the Contract

To run tests with Hardhat, you just need to type the following:

npx hardhat test

Deploying on G.I.L. Testnet

Run this command in root of the project directory:

npx hardhat run scripts/deploy.js --network gil-testnet

The contract will be deployed on Gauss Induction Labs Testnet, and you can check the deployment status here: https://explorer.giltestnet.com

Congratulations! You have successfully deployed Greeter Smart Contract. Now you can interact with the Smart Contract.

Quickly Verify contracts on G.I.L. Explorer

Run the following commands to quickly verify your contract on the G.I.L. Explorer. This makes it easy for anyone to see the source code of your deployed contract. For contracts that have a constructor with a complex argument list, see here.

npm install --save-dev @nomiclabs/hardhat-etherscan
npx hardhat verify --network gil-testnet "CONTRACT_ADDRESS"

Last updated