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

In this section, we walk through the process of installing MetaMask, configuring it on the Harmony network, and importing an existing account using a previously generated private key.

Click here to install the MetaMask extension on your browser. It can be installed on most desktop browsers. Just click on the installation button to begin the process. Once installed, continue to the next section to add the Harmony network to your new wallet.

In order to create a new account, click on the icon on top as shown by the image below and then on Create Account:

On next window, provide an account name and then click the Create button to complete the step.

Adding Harmony to MetaMask

Open MetaMask and click the list of networks at the top, then select "Add Network".

Fill the Endpoint Information

You will be prompted for additional information. Use the table below to complete the step. Below you will see multiple options for RPC URL and Chain ID corresponding to mainnet vs testnet, and the various shards within each.

The example below shows the configuration that needs to be done to connect to Harmony Mainnet on Shard 0:

Click the Save button and your configuration should be done!

Retrieving the 0x Equivalent Address

• For mainnet, go to https://explorer.harmony.one/#/ (Mainnet). For testnet, go to https://explorer.testnet.harmony.one/#/.

• Search for your one1 address at the top.

• At top of the screen, toggle the address format from ONE to ETH.

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

You now have the 0x address which corresponds to your one1 address.

Sending a Regular Transaction

To send a transaction on MetaMask, click on Send button and on next window paste the destination address starting with 0x, fill the amount you want to send, click on Next, and then click on continue.

Receiving a Regular Transaction

In order to receive a transaction, simply share the 0x address format with the sender.

Adding a Custom Token

Open MetaMask, select the Harmony network, then click the Assets tab. Near the bottom, click "Import Tokens" and complete the empty fields.

Add the Token Contract Address, Token Symbol, and the Decimals value. Note the Token Symbol and Decimals may auto-populate. These details are usually provided by the token creator.

See "Importing 1BTC Token" as an example.

Complete the step by clicking on "Add Custom Token". Your custom HRC20 Token will show up in MetaMask along with its balance.

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.

1. Obtaining a Private Key

Importing an account is done by taking an existing private key and importing it into MetaMask. How you obtain the private key is dependent on the wallet in use.

For the Harmony Chrome extension wallet, click the Menu button at the top right, click Export Private Key, enter your password, and copy the private key displayed.

2. Using a Private Key

Click on the icon on top as shown by the image below and then on Import Account:

On next window, select the option to import from a Private Key, paste your key and click on Import to complete the step.

Your account should now be imported.