Interacting with your Tanssi EVM Network Using MetaMask¶
Introduction¶
Developers building dApps on top of Tanssi-powered EVM networks can leverage their Ethereum compatibility features by integrating known Ethereum wallets, such as MetaMask. By doing so, they can use the injected library MetaMask provides to interact with the Tanssi EVM network.
This guide takes you through all the necessary steps: from installing Metamask, to setting up a wallet, and finally connecting it to your Tanssi EVM network.
Note
You should never share your seed phrase (mnemonic) or private key with anyone. This gives them direct access to your funds. This guide is for educational purposes only.
Install the MetaMask Extension¶
First, you'll start with a fresh and default MetaMask installation from the Chrome store. After downloading, installing, and initializing the extension, follow the Get Started steps to setup the wallet. In there, you need to create a wallet, set a password, and store your secret backup phrase (this gives direct access to your funds, so make sure to store these in a secure place).
Note
The Metamask browser extension is compatible with Chrome, Chromium based browsers (such as Microsoft Edge and Opera), and Firefox. Metamask is also available as a mobile app for iOS and Android devices.
Setup a Wallet¶
After installing MetaMask, the setup will automatically open a new task with a welcome screen. Here, you are offered two options:
- Create a new wallet - you'll go through some steps to get a new seed phrase. Ensure you store this phrase securely and you don't share it publicly
- Import an existing wallet - you already have a seed phrase stored, and you want to restore an account from that recovery phrase
Once you've clicked on the option that adapts to your needs, follow the steps, and you should be all setup.
Note
Multiple accounts can be derived from a seed phrase by changing what is known as the address index. By default, when creating or importing an account from the seed phrase, you get the account with the address index 0. You can get the other indexes by just adding new accounts in the main Metamask screen.
Import Accounts¶
Once you've created a wallet or imported an existing one, you can also import any account into MetaMask if you hold the private keys.
For this example, you'll use private keys from the development account. Click the account switcher button to import an account using its private keys. That is where it says Account 1.
Next, click on Import Account.
Finally, enter the private keys of the account you are trying to import. Once you've entered the private key, click on Import.
You should end up with an imported Account 2 that looks like this:
Connect MetaMask to your Tanssi EVM Network¶
Once you have MetaMask installed and have created or imported an account, you can connect it to your Tanssi EVM network. To do so, take the following steps:
- Click in the upper left network selector menu
- Select Add Network
Next, go to the bottom of the page and click on Add network manually:
Here, you can configure MetaMask for the following networks:
Variable | Value |
---|---|
Network Name | EVM Network Dancebox |
RPC URL | https://fraa-dancebox-3001-rpc.a.dancebox.tanssi.network |
Chain ID | 5678 |
Symbol (Optional) | TANGO |
Block Explorer (Optional) | https://fra-dancebox-3001-bs.a.dancebox.tanssi.network/ |
To do so, fill in the following information:
- Network name - name that represents the network you are connecting to
- RPC URL - RPC endpoint of the network
- Chain ID - chain ID of the Ethereum compatible network
- Symbol - (optional) symbol of the native token of the network
- Block Explorer - (optional) URL of the block explorer
- Once you've verified all the information, click on Save
Once you've added the network, you'll be redirected to a screen stating that you've successfully added a network. Furthermore, you'll be prompted to Switch to EVM Network Dancebox, the network added in this example.
Interact with the Network¶
Once you've connected Metamask to your Tanssi EVM network, you can start using your wallet by:
- Requesting TANGO tokens from the demo EVM network faucet
- Sending a token transfer to another address
- Adding ERC-20s to Metamask and interacting with them
- Adding ERC-721s to Metamask and interacting with them
| Created: September 6, 2023