Deploy a smart contract on Monad using Hardhat

Hardhat is a comprehensive development environment consisting of different components for editing, compiling, debugging, and deploying your smart contracts.

Requirements

Before you begin, install a Node.js version supported by your Hardhat version:

Hardhat 2: Node.js v20.0.0 or later
Hardhat 3: Node.js v22.13.0 or later

If you are on Windows, we strongly recommend using WSL 2 when following this guide.

When deploying to Monad, set evmVersion: "osaka" in your Hardhat Solidity compiler settings. For example:

solidity: {
  settings: {
    evmVersion: "osaka",
  },
},

Hardhat 2
Hardhat3

1. Create a new Hardhat project

You can use the hardhat-monad template to create a new project with Monad configuration already set up.hardhat-monad is a Hardhat template with Monad configuration.

Clone the repository to your machine using the command below:

git clone https://github.com/monad-developers/hardhat-monad.git
cd hardhat-monad

2. Install dependencies

npm install

3. Create an .env file

cp .env.example .env

Edit the .env file with your private key:

PRIVATE_KEY=your_private_key_here

Protect your private key carefully. Never commit it to version control, share it in public repositories, or expose it in client-side code. Your private key provides full access to your funds.

4. Deploy the smart contract

The following commands use Hardhat Ignition:

Deploying to the local hardhat node

Run hardhat node by running:

npx hardhat node

To deploy the example contract to the local hardhat node, run the following command in a separate terminal:

npx hardhat ignition deploy ignition/modules/Counter.ts

Deploying to Monad Testnet

Ensure your private key is set in the .env file.Deploy the contract to Monad Testnet:

npx hardhat ignition deploy ignition/modules/Counter.ts --network monadTestnet

Redeploy the same code to a different address:

npx hardhat ignition deploy ignition/modules/Counter.ts --network monadTestnet --reset

Deploying to Monad Mainnet

Ensure your private key is set in the .env file.Deploy the contract to Monad Mainnet:

npx hardhat ignition deploy ignition/modules/Counter.ts --network monadMainnet

Redeploy the same code to a different address:

npx hardhat ignition deploy ignition/modules/Counter.ts --network monadMainnet --reset

1. Create a new Hardhat3 project

You can use the hardhat3-monad template to create a new project with Monad configuration already set up for Hardhat3.hardhat3-monad is a Hardhat3 template with Monad configuration.To learn more about Hardhat3, please visit the Getting Started guide.

Clone the repository to your machine using the command below:

git clone https://github.com/monad-developers/hardhat3-monad.git
cd hardhat3-monad

2. Install dependencies

npm install

3. Set up your private key

Create a .env file in the project root:

PRIVATE_KEY=your_private_key_here
ETHERSCAN_API_KEY=your_etherscan_api_key_here

Protect your private key carefully. Never commit your .env file or expose your private key. Your private key provides full access to your funds.

4. Deploy the smart contract

The following commands use Hardhat Ignition:

Deploying to a local chain

npx hardhat ignition deploy ignition/modules/Counter.ts

Deploying to Monad Testnet

Ensure your .env file is set up with your private key.

npx hardhat ignition deploy ignition/modules/Counter.ts --network monadTestnet

Deploying to Monad Mainnet

Ensure your .env file is set up with your private key.

npx hardhat ignition deploy ignition/modules/Counter.ts --network monadMainnet

Next Steps

Check out how to verify the deployed smart contract on MonadVision.

Introduction

Developer Essentials

Tooling and Infrastructure

Reference

Guides

Resources

Deploy a smart contract on Monad using Hardhat

Requirements

1. Create a new Hardhat project

2. Install dependencies

3. Create an .env file

4. Deploy the smart contract

Deploying to the local hardhat node

Deploying to Monad Testnet

Deploying to Monad Mainnet

1. Create a new Hardhat3 project

2. Install dependencies

3. Set up your private key

4. Deploy the smart contract

Deploying to a local chain

Deploying to Monad Testnet

Deploying to Monad Mainnet

Next Steps

​Requirements

​1. Create a new Hardhat project

​2. Install dependencies

​3. Create an .env file

​4. Deploy the smart contract

​Deploying to the local hardhat node

​Deploying to Monad Testnet

​Deploying to Monad Mainnet

​1. Create a new Hardhat3 project

​2. Install dependencies

​3. Set up your private key

​4. Deploy the smart contract

​Deploying to a local chain

​Deploying to Monad Testnet

​Deploying to Monad Mainnet

​Next Steps

Requirements

1. Create a new Hardhat project

2. Install dependencies

3. Create an .env file

4. Deploy the smart contract

Deploying to the local hardhat node

Deploying to Monad Testnet

Deploying to Monad Mainnet

1. Create a new Hardhat3 project

2. Install dependencies

3. Set up your private key

4. Deploy the smart contract

Deploying to a local chain

Deploying to Monad Testnet

Deploying to Monad Mainnet

Next Steps