Skip to main content

MetaMask

Connect your Metamask wallet with Evmos.

The MetaMask browser extension is a wallet for accessing Ethereum-enabled applications and managing user identities. It can be used to connect to Evmos through the official testnet or via a locally-running Evmos node.

note

If you are planning on developing on Evmos locally and you haven’t already set up your own local node, refer to the quickstart tutorial, or follow the instructions in the GitHub repository.

Adding a New Network​

Open the MetaMask extension on your browser, you may have to log in to your MetaMask account if you are not already. Then click the top right circle and go to Settings > Networks > Add Network and fill the form as shown below.

note

You can also lookup the EIP155 Chain ID by referring to chainlist.org. Alternatively, to get the full Chain ID from Genesis, check the Chain ID documentation page.

metamask networks settings

Here is the list of fields that you can use to paste on Metamask:

  • Mainnet

    • Network Name: Evmos Mainnet
    • New RPC URL: https://eth.bd.evmos.org:8545
    • Chain ID: 9001
    • Currency Symbol (optional): EVMOS
    • Block Explorer URL (optional): https://escan.live

  • Testnet

    • Network Name: Evmos Testnet
    • New RPC URL: https://eth.bd.evmos.dev:8545
    • Chain ID: 9000
    • Currency Symbol (optional): tEVMOS
    • Block Explorer URL (optional): https://evm.evmos.dev

  • Local Node

    • Network Name: Evmos Local
    • New RPC URL: http://localhost:8545/
    • Chain ID: http://localhost:8545/
    • Currency Symbol (optional): tEVMOS
    • Block Explorer URL (optional): n/a

Import Account to Metamask​

Automatic Import​

Once you have added Evmos to the Metamask Networks, you can automatically import your accounts by:

  1. Go to the official EVM Chain ID Registry website: chainlist.org
  2. Search for "Evmos"chainlist.org website
  3. Click the Connect Wallet button under Evmos Testnetadd accounts via chainlist

Manual Import​

Close the Settings, go to My Accounts (top right circle) and select Import Account. You should see an image like the following one:

metamask manual import account page

Now you can export your private key from the terminal using the following command. Again, make sure to replace dev0 with the name of the key that you want to export and use the correct keyring-backend:

evmosd keys unsafe-export-eth-key dev0

Go back to the browser and select the Private Key option. Then paste the private key exported from the unsafe-export-eth-key command.

Your account balance should show up as 1 tEVMOS and do transfers as usual.

tip

If it takes some time to load the balance of the account, change the network to Main Ethereum Network (or any other than Localhost 8545 or Evmos) and then switch back to Evmos.

Reset Account​

If you used your Metamask account for a legacy testnet/mainnet upgrade, you will need to reset your account in order to use it with the new network. This will clear your account's transaction history, but it won't change the balances in your accounts or require you to re-enter your Secret Recovery Phrase.

danger

Make sure you download your account state to persist public account addresses and transactions before clearing your wallet accounts.

Go to Settings > Advanced and click the Reset Account button as shown below:

Metamask Account Reset

Download Account State​

To see your Metamask logs, click the top right circle and go to Settings > Advanced > State Logs. If you search through the JSON file for the account address you'll find the transaction history.

Registering for Evmos Domains​

Evmos Domains are modelled after the Ethereum Name Service (ENS), link here, Evmos users can register for an Evmos Domains with the help of this service. This service will use Metamask to connect and allow users to search for a name not taken. The registration process will take some EVMOS token.