Skip to main content
SUBMIT A PRSUBMIT AN ISSUElast edit: Oct 17, 2024

EVM Testnet with Metamask Wallet

This tutorial is for how to set up your Metamask wallet to use with EVM testnet on Bittensor. You must run either this step or EVM Localnet with Metamask Wallet tutorial before you can run other tutorials in this section.

blog post: EVM on Bittensor

If you are new to EVM, read this simplified blog post explaining this feature.

For all the EVM tutorials we will use the following:

Step 1. Create a Metamask wallet​

  1. If you don't already have it, install Metamask wallet browser extension.
  2. Create a new account.

Step 2. Add EVM Testnet to Metamask​

  1. Open the EVM Testnet Faucet page.
  2. Click Add Chain to Metamask button at the bottom left. If you have not created a Metamask wallet account this step will prompt you to do so.
  3. The Metamask wallet will then connect to the Faucet page.
  4. Next the Wallet will prompt you, Allow this site to switch the network?. Click Switch network button at the bottom right.
  5. You may need to go back to the EVM Testnet Faucet page and click the Connect button below the Metamask logo in the Hexadecimal Address (0x...) field.

Step 2a. Alternate way of adding EVM Testnet to Metamask​

Alternately, you can also add the EVM testnet to Metamask from within the Metamask wallet. Follow the below steps:

  1. Open Metamask Wallet extension on your browser. Click on the ⋮ (three vertical dots, i.e., vertical ellipsis) at the top right.
  2. Select Settings from the drop-down menu.
  3. Select Networks > Add network.
  4. Click on Add a network manually at the bottom of the networks list.
  5. Enter the following details:
  6. Click Save.
  7. Then click on Switch network.
  8. You may need to go back to the EVM Testnet Faucet page and click the Connect button below the Metamask logo in the Hexadecimal Address (0x...) field.

With the above steps, you have successfully configured your Metamask wallet with the EVM testnet. Next you will request test TAO from the EVM testnet faucet. This test TAO will be directly deposited into your connected Metamask wallet account.

Step 3. Request 1 TAO​

Next you will request and obtain 1 TAO from the EVM testnet faucet. You will use this TAO to run through the tutorials.

  1. After you see your Metamask wallet account's hexadecimal address in the EVM Testnet Faucet, click REQUEST 1 TAO button. Alternately, you can also paste your Metamask wallet account's hexadecimal address in the field above the REQUEST 1 TAO button and click it.
  2. Confirm by checking your Metamask wallet account that you now have 1 TAO in it.
  3. You can also confirm by visiting the Subtensor EVM block explorer URL and looking at Blockchain > Transactions page. You will see a Coin transfer transaction showing 1 TAO transfer to your Metamask wallet address.

Step 4. Copy Metamask wallet private key into config​

In this step you will clone the EVM-Bittensor repo, and copy the private key from your Metamask wallet account and paste it into the configuration file in the repo. This step will ensure that you are not prompted with password each and every step as you run these tutorials.

  1. Clone the Opentensor EVM-Bittensor GitHub repo:

    git clone https://github.com/opentensor/evm-bittensor.git

  2. Create config.js file by copying the config-example.js file:

cp config-example.js config.js
  1. On Metamask wallet extension, your wallet account will have a H160 account address, starting with the 0x prefix (for example: 0x7E5F4552091A69125d5DfCb7b8C2659029395Bdf), and also your wallet account name.
  2. Click on your wallet account name, which will open the drop-down menu.
  3. Click on the ⋮ (three vertical dots, i.e., vertical ellipsis) next to the wallet account and select Account details. It will open a view with a QR code, your wallet account H160 address and a Show private key button.
  4. Click on the Show private key button, enter the password. You will then see the private key for your wallet account. Copy this private key.
  5. Paste this private key into ethPrivateKey string in your config.js file as shown below (mangled for security):
const ethPrivateKey = "02c1c4112233snipsnipsnipgh933aca491e090e0b7xxyy1b124b86d9382b01a8";

Save the config.js file. Now your setup is ready to run the tutorials.