Deploy a smart contract on Monad using Foundry

This guide uses the official Foundry v1.8 or later to compile and deploy a contract on Monad Testnet.

1. Install Foundry

Install the official Foundry installer:

curl -L https://foundry.paradigm.xyz | bash

Follow the installer instructions to add foundryup to your shell, then install the latest stable release:

foundryup

Confirm that forge --version reports v1.8.0 or later. See the Foundry toolkit page for more installation and migration guidance.

2. Create a new foundry project

You can use foundry-monad template to create a new project.Foundry-Monad is a Foundry template with Monad configuration.

The below command uses foundry-monad to create a new foundry project:

forge init --template monad-developers/foundry-monad [project_name]

Alternatively, you can create a foundry project using the command below:

forge init [project_name]

3. Modify Foundry configuration

Update foundry.toml to select the Monad execution environment and configure Monad Testnet:

foundry.toml

[profile.default]
src = "src"
out = "out"
libs = ["lib"]
network = "monad"
# Monad Testnet Configuration
eth-rpc-url = "https://testnet-rpc.monad.xyz"
chain_id = 10143

The network = "monad" setting is the persistent equivalent of passing --network monad. It makes Forge use Monad’s execution rules for local compilation, testing, scripts, and transaction simulation. Foundry selects the active hardfork automatically when interacting with Monad Testnet.

4. Write a smart contract

You can write your smart contracts under the src folder. There is already a Counter contract in the project located at src/Counter.sol.

src/Counter.sol

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

contract Counter {
    uint256 public number;

    function setNumber(uint256 newNumber) public {
        number = newNumber;
    }

    function increment() public {
        number++;
    }
}

5. Compile the smart contract

forge compile

Compilation process output can be found in the newly created out directory, which includes contract ABI and bytecode.

6. Deploy the smart contract

For deploying contracts, we recommend using keystores instead of private keys.

Get testnet funds

Deploying smart contracts requires testnet funds. Claim testnet funds via a faucet.

Deploy smart contract

Using a Keystore (Recommended)
Using a Private Key (Not Recommended)

Using a keystore is much safer than using a private key because keystore encrypts the private key and can later be referenced in any commands that require a private key.Create a new keystore by importing a newly generated private key with the command below.

cast wallet import monad-deployer --private-key $(cast wallet new | grep 'Private key:' | awk '{print $3}')

Here is what the command above does, step by step:

Generates a new private key
Imports the private key into a keystore file named monad-deployer
Prints the address of the newly created wallet to the console

After creating the keystore, you can read its address using:

cast wallet address --account monad-deployer

Provide a password to encrypt the keystore file when prompted and do not forget it.Run the below command to deploy your smart contracts

forge create src/Counter.sol:Counter --account monad-deployer --broadcast

Use the below command to deploy a smart contract by directly pasting the private key in the terminal.

Using a private key is not recommended. You should not be copying and pasting private keys into your terminal. Please use a keystore instead.

forge create --private-key <your_private_key> src/Counter.sol:Counter --broadcast

On successful deployment of the smart contract, the output should be similar to the following:

[⠊] Compiling...
Deployer: 0xB1aB62fdFC104512F594fCa0EF6ddd93FcEAF67b
Deployed to: 0x67329e4dc233512f06c16cF362EC3D44Cdc800e0
Transaction hash: 0xa0a40c299170c9077d321a93ec20c71e91b8aff54dd9fa33f08d6b61f8953ee0

Next Steps

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

Introduction

Developer Essentials

Tooling and Infrastructure

Reference

Guides

Resources

For AI Agents

Deploy a smart contract on Monad using Foundry

1. Install Foundry

2. Create a new foundry project

3. Modify Foundry configuration

4. Write a smart contract

5. Compile the smart contract

6. Deploy the smart contract

Get testnet funds

Deploy smart contract

Next Steps

​1. Install Foundry

​2. Create a new foundry project

​3. Modify Foundry configuration

​4. Write a smart contract

​5. Compile the smart contract

​6. Deploy the smart contract

​Get testnet funds

​Deploy smart contract

​Next Steps

1. Install Foundry

2. Create a new foundry project

3. Modify Foundry configuration

4. Write a smart contract

5. Compile the smart contract

6. Deploy the smart contract

Get testnet funds

Deploy smart contract

Next Steps