Harmonyswap
Search…
⌃K

Setting up Metamask

MetaMask is an extension for accessing Harmony enabled distributed applications, or "Dapps" in your browser!
The extension injects the Harmony web3 API into every website's javascript context, so that dapps can read from the blockchain.

Installing Metamask

Click here to install the Metamask extension on your browser. It can be installed using the Google Chrome Browser. Just click on the installation button and it should be automatically installed.

Setting up Metamask

By default Metamask supports the Ethereum blockchain, but since Harmony is EVM compatible it can be used the same way by setting a custom RPC endpoint.

1. Adding a Custom RPC Endpoint

In order to connect to the Harmony Network, a custom RPC Endpoint needs to be added. On top click on the network you are connected to and then select Custom RPC:
Adding a Custom RPC

2. Filling the Endpoint Information

Fill it accordingly to the Harmony Network and shard you want to connect to.
Use the RPC URL of Shard 0 if you want to send/receive transactions from exchanges or do any staking transaction type.
Field
Mainnet
Testnet
Network Name
Harmony Mainnet
Harmony Testnet
New RPC URL
https://api.harmony.one
https://s1.api.harmony.one
https://s2.api.harmony.one https://s3.api.harmony.one
https://api.s0.b.hmny.io
https://api.s1.b.hmny.io
https://api.s2.b.hmny.io
https://api.s3.b.hmny.io
Chain ID
(use number only)
Shard 0: 1666600000
Shard 1: 1666600001
Shard 2: 1666600002
Shard 3: 1666600003
Shard 0: 1666700000
Shard 1: 1666700001
Shard 2: 1666700002
Shard 3: 1666700003
Currency symbol (optional)
ONE
ONE
Block Explorer URL (optional)
In order to configure Metamask with Binance Smart Chain (BSC) check the documenation here.
The example below shows the configuration that needs to be done to connect to Harmony Mainnet on Shard 0:
Click now on the Save button and your configuration should be done!

Creating a New Account

In order to create a new account, click on the icon on top as shown by the image below and then on Create Account:
Create account
On next window, fill it with the account you want to choose and click on Create button. You should have succesfully created a new account!

Importing an Account

There is a known issue on MetaMask where after the restoration of a wallet, MetaMask shows a different account with missing funds. Please make sure you use the same RPC network details as the one used in the original wallet. For example, if your original wallet was on the Harmony RPC network but your new wallet is on POKT RPC network, you may not see your original account.

1. Using a Private Key

Click on the icon on top as shown by the image below and then on Import Account:
Importing Account
On next window, select the option to import from a Private Key, paste your key and click on Import button:
You should have successfully imported your account from the Private Key!

Regular Transactions

You can receive transactions to addresses starting with both one1 and 0x. However, Metamask does not allow you to send transactions to addresses starting with one1, you need to get the equivalent 0x address of this same address. For that, follow the procedures below.

Getting the 0x Equivalent Address

address format
  • Copy the 0x address format by clicking on the small icon right to the address
Equivalent 0x Address

Sending a Regular Transaction

To send a transaction on Metamask click on Send button and on next window copy paste the destination address starting with 0x, fill the amount you want to send, click on Next and then on Confirm.
If your transaction fails due to insufficient gas, set the Gas Limit to 25000

Receiving a Regular Transaction

In order to receive a transaction, just share the 0x address format. One Wallet supports sending regulars transactions to either addresses starting with 0x or one1.

HRC20/HRC721 Transactions

Adding a Custom Token

On Metamask click on Add Token and on next window select Custom Token. Fill it with the contract address starting with 0x, Token Symbol of the token and the Decimals of Precision which is usually 18:
add token
Custom Token
Now click on Next and then Add Tokens. Your custom HRC20 Token will show up on a new page. It will also be available on the main Metamask window on the Assets tab.

Sending a HRC20/HRC721 Transaction

Click on the asset you want to send your tokens from on the Asset tab. Click on Send button and on next window copy paste the destination address starting with 0x, fill the amount you want to send, click on Next and then on Confirm.

Receiving a HRC20/HRC721

In order to receive a transaction, just share the 0x address format of your wallet. One Wallet supports sending HRC20/HRC721 transactions to either addresses starting with 0x or one1.