Set Up Developer Environment

Configure your development environment to build and deploy on Mezo using Hardhat or Foundry.

Configure your Hardhat or Foundry development environment for Mezo to start building and deploying smart contracts.

Before You Begin

Before you can deploy applications, you will need an Ethereum wallet with BTC to pay for gas fees.

Connect Your Wallet

Learn how to connect your wallet to Mezo

For advanced chain configuration and network parameters, see the Chains Configuration Guide.

Testnet Configuration

Network Details

Parameter	Value
Network Name	Mezo Testnet
Chain ID	31611
Currency	BTC (18 decimals)
Block Explorer	explorer.test.mezo.org

RPC Endpoints

Protocol	URL
HTTPS	https://rpc.test.mezo.org
WSS	wss://rpc-ws.test.mezo.org

Get Testnet BTC

To pay for gas fees on the Testnet, you will need Testnet BTC.

1. Visit the Mezo Faucet

   Obtain Testnet BTC from the official Mezo Faucet.

   The faucet is protected by a CAPTCHA to prevent abuse.
2. Setup Your Wallet

   Ensure you have a browser wallet installed that supports Ethereum (EVM), such as MetaMask.

Hardhat Configuration

1. Install Hardhat

   If you are new to Hardhat, use the Hardhat Quick Start guide to learn how to install and initialize your project.

2. Configure Network

   To configure Hardhat for Mezo Testnet, modify your hardhat.config.js (or .ts) file:

   hardhat.config.js

   module.exports = {
     defaultNetwork: "mezotestnet",
     networks: {
       mezotestnet: {
         url: "https://rpc.test.mezo.org",
         chainId: 31611,
         accounts: ["YOUR_PRIVATE_WALLET_KEY"] // Use environment variables for security
       }
     },
     solidity: {
       version: "0.8.28",
       settings: {
         evmVersion: "london",
         optimizer: {
           enabled: true,
           runs: 200
         }
       }
     },
   };
   

   Always use environment variables to store private keys. Never commit private keys to version control.

Foundry Configuration

1. Install Foundry

   If you are new to Foundry, use the Foundry Getting Started guide to learn how to install and initialize your project.

2. Configure Network

   To configure a Foundry project for Mezo Testnet, set the following in your foundry.toml:

   foundry.toml

   [profile.default]
   chain_id = 31611
   eth_rpc_url = "https://rpc.test.mezo.org"
   evm_version = 'london'
   

Mainnet Configuration

Network Details

Parameter	Value
Network Name	Mezo Mainnet
Chain ID	31612
Currency	BTC (18 decimals)
Block Explorer	explorer.mezo.org

RPC Providers

For production deployments, it is recommended to use a dedicated RPC provider for higher rate limits and stability.

Provider	HTTPS	WSS
Boar	https://rpc-http.mezo.boar.network	wss://rpc-ws.mezo.boar.network
Imperator	https://rpc_evm-mezo.imperator.co	wss://ws_evm-mezo.imperator.co
Validation Cloud	https://mainnet.mezo.public.validationcloud.io	wss://mainnet.mezo.public.validationcloud.io
dRPC NodeCloud	https://mezo.drpc.org	wss://mezo.drpc.org

Hardhat Configuration

To configure Hardhat for Mezo Mainnet, modify your hardhat.config.js (or .ts) file:

hardhat.config.js

module.exports = {
  defaultNetwork: "mezomainnet",
  networks: {
    mezomainnet: {
      url: "https://rpc-http.mezo.boar.network",
      chainId: 31612,
      accounts: ["YOUR_PRIVATE_WALLET_KEY"] // Use environment variables for security
    }
  },
  solidity: {
    version: "0.8.28",
    settings: {
      evmVersion: "london",
      optimizer: {
        enabled: true,
        runs: 200
      }
    }
  },
};

Always use environment variables to store private keys. Never commit private keys to version control.

Foundry Configuration

To configure a Foundry project for Mezo Mainnet, set the following in your foundry.toml:

foundry.toml

[profile.default]
chain_id = 31612
eth_rpc_url = "https://rpc-http.mezo.boar.network"
evm_version = 'london'

Multi-Network Configuration

For projects that need to support both Testnet and Mainnet, you can configure multiple networks:

hardhat.config.js

module.exports = {
  networks: {
    mezotestnet: {
      url: "https://rpc.test.mezo.org",
      chainId: 31611,
      accounts: [process.env.TESTNET_PRIVATE_KEY]
    },
    mezomainnet: {
      url: "https://rpc-http.mezo.boar.network",
      chainId: 31612,
      accounts: [process.env.MAINNET_PRIVATE_KEY]
    }
  },
  solidity: {
    version: "0.8.28",
    settings: {
      evmVersion: "london",
      optimizer: {
        enabled: true,
        runs: 200
      }
    }
  },
};

Next Steps

Deploy Contracts

Start deploying your smart contracts to Mezo using your configured environment

Mezo Passport

Integrate wallet support for both Bitcoin and EVM wallets

MUSD Integration

Integrate MUSD stablecoin into your dApp

dApp Requirements

Review requirements for featuring in Mezo Market