Configure MetaMask Wallet for Rootstock

In this guide, you will learn about the different ways to set up and connect to Rootstock network using MetaMask.

Option 1: Add Rootstock Networks to MetaMask Automatically

Ideal for general users looking to automatically add the Rootstock network to their MetaMask wallet.

1. Install MetaMask on your browser from the official website: https://metamask.io/download/
2. Click on the buttons below to add Rootstock Mainnet and Rootstock Testnet

Loading...

Option 2: Add Rootstock Networks to MetaMask Manually

Ideal for both developers and general users looking to manually add the Rootstock network to their MetaMask wallet.

1. Install Metamask on your browser from the official website: https://metamask.io/download/
2. Open the MetaMask extension.
3. In the network selector (top left corner), choose Add Network.

4. Click on Add Network Manually

5. Fill the required fields to add Rootstock Mainnet or Testnet with the network settings from the table below:

Field	Rootstock Mainnet	Rootstock Testnet
Network Name	Rootstock Mainnet	Rootstock Testnet
RPC URL	https://public-node.rsk.co	https://public-node.testnet.rsk.co
ChainID	30	31
Symbol	RBTC	tRBTC
Block explorer URL	https://explorer.rootstock.io/	https://explorer.testnet.rootstock.io/

Option 3: Add Rootstock Networks to MetaMask Programmatically

Ideal for developers looking to initiate a network switch on MetaMask from a website or dApp. See how to Connect Rootstock to Metamask Programmatically.

Watch the Video Explainer

Limitations

MetaMask does not yet fully comply with the technical specifications of account based addresses on Rootstock. Note that there are workarounds available, which allow most users to use MetaMask on Rootstock successfully.

MetaMask uses the Ethereum value for derivation path, and presently does not allow it to be configured. This means that if you use the same seed phrase in MetaMask and other wallets, you will get a different set of addresses. A workaround for this is to use custom derivation paths when using other wallets that support this feature.

MetaMask does not presently support EIP-1191 checksums. This means that if you use the addresses copied from MetaMask, you may encounter checksum validation errors. A workaround for this is to lowercase the addresses after copying them.

Disclaimer

• Currency may be mistakenly displayed as ETH within some screens of MetaMask. The Rootstock network uses RBTC as its cryptocurrency.
• This tutorial uses the Public Nodes as RPC. You can connect to other nodes or use the Rootstock RPC API.
• The node must enable CORS for browser-based dApps to work.
  • Please review the configuration file reference for CORS settings.

Next Steps

Deploy a dApp on Rootstock or try out the Rootstock Testnet:

• Get test RBTC
• Get test RIF tokens
• View the Quick Starts

If you would like to know more about the values used in the custom network configuration above, check out account based addresses on Rootstock.