What is Hardhat?

Hardhat is a development environment for Ethereum software. It consists of different components for editing, compiling, debugging and deploying your smart contracts and dApps, all of which work together to create a complete development environment.


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:

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


module.exports = {
  defaultNetwork: "buitenzorg",
  networks: {
    hardhat: {
    buitenzorg: {
      url: "https://rpc-testnet.gitshock.com/buitenzorg",
      accounts: [process.env.PRIVATE_KEY]
  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

And this is an expected output:

Deploying on Gitshock Buitenzorg

Run this command in root of the project directory:

npx hardhat run scripts/deploy.js --network buitenzorg

The contract will be deployed on Matic's Mumbai Testnet, and you can check the deployment status here: Gitshock Scan

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

Last updated