Skip to main content
To use Mezo, you need to add the Mezo network to your browser wallet. You can connect using Chainlist for automatic setup or add the network manually.

​
Quick Connect with Chainlist

The easiest way to add Mezo to your wallet is using the Connect Wallet button at Chainlist:
If Chainlist does not work, you can add the network manually using the network details below.

​
Mezo Mainnet Configuration

​
Public RPC Endpoints

ProviderHTTPSWSS
Boarhttps://rpc-http.mezo.boar.networkwss://rpc-ws.mezo.boar.network
Imperatorhttps://rpc_evm-mezo.imperator.cowss://ws_evm-mezo.imperator.co
Validation Cloudhttps://mainnet.mezo.public.validationcloud.iowss://mainnet.mezo.public.validationcloud.io
For higher rate limits and low-latency Mezo RPC, get your free Validation Cloud API key at validationcloud.io/mezo or contact them at validationcloud.io/contact for Enterprise plans.

​
Network Details

ParameterValue
Chain ID31612
CurrencyBTC (18 decimals)
Block Explorerexplorer.mezo.org

​
Mezo Testnet Configuration

​
Public RPC Endpoints

ProtocolURL
HTTPShttps://rpc.test.mezo.org
WSSwss://rpc-ws.test.mezo.org

​
Network Details

ParameterValue
Chain ID31611
CurrencyBTC (18 decimals)
Block Explorerexplorer.test.mezo.org
Building on Mezo? See the Set Up Developer Environment guide for Hardhat and Foundry configuration.

​
Manual Network Setup

If you need to add the network to your wallet manually, follow the instructions for your specific wallet:
1

Open Wallet Settings

Access your wallet’s network settings menu
2

Add Custom Network

Select the option to add a custom network or RPC
3

Enter Network Details

Input the Mezo network details from the tables above:
  • Network Name: Mezo Mainnet (or Testnet)
  • RPC URL: Choose from the available endpoints
  • Chain ID: 31612 for Mainnet or 31611 for Testnet
  • Currency Symbol: BTC
  • Block Explorer: https://explorer.mezo.org/ (or test explorer)
4

Save and Switch

Save the network configuration and switch to the Mezo network

​
Wallet-Specific Guides

​
BTC Wallet Support

BTC wallets are fully supported in the Mezo App and can receive a Mezo network address associated with your BTC wallet. BTC wallets can currently:
  • Bridge BTC assets
  • Bridge EVM assets
  • Borrow, repay, or manage collateral for a loan
  • Purchase items on the MUSD Market
  • Receive assets on the Mezo Network
BTC wallets cannot currently send assets on the Mezo Network. As the network evolves, more features and capabilities will be made available to BTC wallets.

​
OKX Wallet

​
Asset Display Limitation

While you can successfully add the Mezo network to OKX Wallet, there is currently a limitation where Mezo assets may not display directly in the wallet interface. What to check:
  • Verify the Mezo network is added with the correct RPC URL and Chain ID (31612)
  • Check your network selection - ensure Mezo is selected in the top right corner
  • Custom asset limitation - it may not appear in the networks dropdown when adding custom assets

​
Need Help with OKX?

If you’re experiencing issues with displaying Mezo assets or adding custom tokens on OKX Wallet, reach out to OKX Wallet Support on their Discord server for additional guidance and troubleshooting.

​
Troubleshooting

  • Clear your wallet cache and restart your browser
  • Double-check that all network details are entered correctly
  • Try using a different RPC endpoint from the list above
  • Ensure you have BTC or tBTC for gas fees
  • Verify you’re connected to the correct network (Mainnet vs Testnet)
  • Check that your wallet is unlocked and connected to the Mezo App

​
Next Steps

Once your wallet is connected:

Deposit Assets

Bridge Bitcoin to start using Mezo’s features

Borrow MUSD

Access fixed-rate loans against your Bitcoin

​
Developer Resources

To learn how to develop and deploy dApps on Mezo, see the Developer Getting Started documentation.

Build docs developers (and LLMs) love

Get started for freeTalk to us