The Harmony network is a fast and open-source blockchain similar to Ethereum. The Harmony Mainnet runs most Ethereum DApps in 2 secs and has 100 times lower fees – both of which are better than what you’ll typically get on the Ethereum network.
Metamask on the other hand is the most popular non-custodial wallet in the crypto space. It is used by millions of crypto investors across multiple operating systems to purchase, store, and trade cryptocurrencies and other digital assets with ease.
Since the Harmony mainnet is an EVM-compatible network just like Ethereum, you can configure Metamask to connect to the Harmony Blockchain in a few steps.
If you’re looking for a way to add Harmony ONE to your Metamask wallet, then you’re in the right place as this article contains a complete guide on how to add Harmony to Metamask easily.
How To Add Harmony To Metamask (Quick Guide)
- Launch the Metamask extension/mobile app and unlock your account.
- Click on [Ethereum Mainnet].
- Select [Add Network].
- Enter the correct RPC details for the Harmony Mainnet and click [Save].
- Transfer Harmony (ONE) tokens to your Metamask wallet.
How To Add Harmony To Your Metamask Wallet (Step By Step Guide)
To add the Harmony Network to your Metamask wallet, you need to first get the correct custom RPC endpoint for the Harmony mainnet which will be included later in this guide.
Once you have the custom RPC endpoint for the Harmony mainnet, all you have to do is input it in the correct fields on the Metamask extension or mobile app then click on [Save] to add Harmony to your wallet.
Below is a step-by-step guide on how you can add the Harmony network to Metamask easily.
Step 1: Launch Metamask and input your account to unlock the wallet.
First, launch the Metamask extension by clicking on the Metamask logo in the extensions area of your web browser. Metamask is supported on all the top desktop web browsers.
On the Metamask main window, enter your account password and click on [Unlock] to unlock your wallet.
Step 2: Click on [Ethereum Mainnet].
Once you’re on the main Metamask dashboard (after unlocking your wallet, click on [Ethereum Mainnet] to reveal a dialog with all available (configured) networks on your Metamask wallet.
Step 3: Now, click [Add Network] on the dialog.
On the dialog, click on [Add Network] to add a new network (Harmony in this case) to your Metamask wallet.
Step 4: Enter the Harmony Mainnet custom RPC endpoint and click [Save].
On the next page, input the custom RPC endpoint for the Harmony Main Network outlined below in the appropriate fields as seen in the next screenshot.
- Network Name: Harmony Mainnet
- New RPC URL: https://api.harmony.one
- Chain ID: 1666600000
- Currency Symbol: ONE
- Block Explorer URL: https://explorer.harmony.one/
Once you have filled all the fields correctly, click on [Save] to add Harmony to Metamask.
After this, the Harmony network should be added and selected automatically as the default network on your Metamask wallet.
If it is not selected, go back to the Metamask main window and click on [Ethereum Mainnet] then select “Harmony Mainnet” from the list of available networks on the dialog.
How To Add Harmony ONE To Metamask Mobile App (Android & iOS)
Adding the Harmony Main Network to your wallet on the Metamask mobile app for either iOS or Android is quite easier and less technical when compared to the process of doing the same on the Metamask browser extension.
On the Metamask mobile app, some of the popular networks (of which Harmony is included) are already pre-configured, you just need to select the correct network – Harmony – and tap on [Approve] to add the network to your wallet and it will be added automatically without any additional steps.
Below is how you can add the Harmony Network to your wallet on the Metamask mobile app for iPhone and Android.
Step 1: Launch the Metamask app and unlock your wallet.
Launch the Metamask app on your mobile device and enter your account password to unlock it.
Depending on the device and OS, you may be able to unlock your wallet using any of the available biometric methods like Face ID, fingerprint, or Face Unlock if enabled on your Metamask account.
Once your wallet is unlocked, tap on the menu icon on the top left corner of the Metamask app home screen/dashboard.
Next, tap on [Settings] from the menu items.
Step 4: Select [Networks] on the Settings page.
On the Metamask Settings page, select [Networks] to view all available networks on your wallet.
Step 5: Now, tap [Add Network].
Now, tap on [Add Network] to add a new network.
Step 6: Select [Harmony Mainnet Shard 0] from the list on the “Popular” tab.
On the “Popular” tab, tap on [Harmony Mainnet Shard 0] to add the Harmony Mainnet to your wallet.
Step 7: Tap on [Approve] to add the network.
Finally, tap on [Approve] to add the Harmony network to your Metamask wallet.
After this, the Harmony network should be added to your wallet and selected as the default network on the Metamask app on your device.
How Transfer Harmony (ONE) To Your Metamask Wallet Easily
To completely utilize Metamask on the Harmony network, you will also need to transfer some native Harmony tokens ($ONE) to your Metamask wallet from an exchange or external wallet which holds some ONE tokens.
If you don’t currently hold any Harmony (ONE) tokens, we recommend using Binance to purchase some ONE tokens since the token is supported by the exchange, and most importantly, it can be transferred out to external wallets like Metamask.
You can sign up for a free Binance account using this link.
Once you have created an account on Binance, purchase some ONE tokens using your credit/debit card, direct bank deposit, third-party payment providers, or via P2P before moving on with the guide below. Binance provides an excellent tutorial on how to do that in this article.
To transfer ONE from Binance to your Metamask Wallet, you need to copy your default Metamask wallet address first since Metamask only provides one wallet address which is used across multiple (compatible) blockchains/networks.
Once you have copied your wallet address, you will need to convert your wallet address to “one1” format before proceeding to transfer crypto. If you try transferring native ONE tokens to your default wallet address from Binance, you will be met with an “Invalid address” error.
To convert your “0x” wallet address to the “one1” format, simply head over to the Harmony Explorer website (https://explorer.harmony.one/) and paste your wallet address in the Search field.
Once you have pasted the wallet address, the page should briefly reload and you will see your new one1 address format just like in the screenshot below. Copy your new Metamask ONE wallet address to the clipboard by clicking on the Copy icon just before the address.
Once you have copied the one1 format of your wallet address from the Harmony Explorer website, hop on the Binance mobile app (or website), tap on [Wallets], and select [Funding] to navigate to your funding wallet.
Next, tap on [Withdraw], search for “ONE” and select “ONE Harmony” from the results. Now, select [Send via Crypto Network] from the bottom dialog.
On the next page, enter your one1 wallet address format in the wallet address section then select “Harmony” as the network to be used for the transaction.
Enter the amount of Harmony (ONE) tokens to be transferred to your Metamask wallet from Binance and tap on [Withdrawal].
Now, tap on [Submit] and complete the 2-step verification by providing the code sent to your phone number, email, and/or authenticator app (Google or Binance authenticator).
Finally, head back to your Metamask wallet and refresh your ONE balance to view the updated balance.
The transaction can take anywhere from 5 – 20 mins to complete so you have to be a bit patient just in case the tokens aren’t available in your wallet.
MetaMask Harmony ONE Invalid Address: How To Fix
If you get an “Invalid Address” error when trying to transfer ONE from an external wallet or crypto exchange (like Binance) to your Metamask, it is because you’re attempting to transfer Harmony to an incompatible wallet address format.
Metamask provides only one (default) wallet address to be used across multiple networks on your wallet and this address is in the “0x” format.
The Harmony network is incompatible with the “0x” wallet address format that you get from Metamask, instead, it uses the “one1” address format and you need to convert your wallet address from the “0x” format to the “one1” format before you can initiate a transaction on the Harmony network.
Converting your wallet address to the “one1” format is quite easy. All you need to do is visit the Harmony Explorer website (https://explorer.harmony.one/) and enter your Metamask wallet address in the search field.
The website will convert your wallet address to the “one1” format without any additional steps and this “one1” address format can be used to transfer $ONE tokens t your Metamask wallet without any issues.
Wrapping Up
Since Harmony is an EVM-compatible network, it can be added to Metamask just like other blockchains which are compatible with the Ethereum Virtual Machine (EVM).
To add Harmony to your Metamask wallet, you first need to get the correct custom RPC endpoint for the Harmony Main Network.
Once you have gotten this import detail (which is also included in this article), you can then head over to the Metamask extension and add the network to your wallet using the RPC details for the Harmony Mainnet.
On the Metamask mobile app, the process of adding the Harmony network to your wallet is a little bit different and quite easier when compared to the browser extension.
If you use the Metamask mobile app, all you need to do is select “Harmony Mainnet Shard 0” from the list of networks available in the “Popular” tab then tap on [Approve] and the Harmony network will be added to our wallet automatically.
