Skip to content

Interacting with your Tanssi EVM Appchain Using MetaMask


Developers building dApps on top of Tanssi EVM appchains 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 appchain.

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 appchain.


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).


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

Metamask Setup Interface

Once you've clicked on the option that adapts to your needs, follow the steps, and you should be all setup.


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.

Importing account from private key metamask menu

Next, click on Import Account.

Importing account from private key account switcher menu

Finally, enter the private keys of the account you are trying to import. Once you've entered the private key, click on Import.

Paste your account key into MetaMask

You should end up with an imported Account 2 that looks like this:

MetaMask displaying your new Account 2

Connect MetaMask to your Tanssi EVM Appchain

Once you have MetaMask installed and have created or imported an account, you can connect it to your Tanssi EVM appchain. To do so, take the following steps:

  1. Click in the upper left network selector menu
  2. Select Add Network

Add new network in Metamask menu

Next, go to the bottom of the page and click on Add network manually:

Add network manually in Metamask

Here, you can configure MetaMask for the following networks:

Variable Value
Network Name EVM Appchain Dancebox
Chain ID 5678
Symbol (Optional) TANGO
Block Explorer (Optional)

To do so, fill in the following information:

  1. Network name - name that represents the network you are connecting to
  2. RPC URL - RPC endpoint of the network
  3. Chain ID - chain ID of the Ethereum compatible network
  4. Symbol - (optional) symbol of the native token of the network
  5. Block Explorer - (optional) URL of the block explorer
  6. Once you've verified all the information, click on Save

Add network in Metamask

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 Appchain Dancebox, the network added in this example.

Successfully added a network in Metamask

Interact with the Network

Once you've connected Metamask to your Tanssi EVM appchain, you can start using your wallet by:

  • Requesting TANGO tokens from the demo EVM appchain 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
The information presented herein has been provided by third parties and is made available solely for general information purposes. Tanssi does not endorse any project listed and described on the Tanssi Doc Website ( Tanssi Foundation does not warrant the accuracy, completeness or usefulness of this information. Any reliance you place on such information is strictly at your own risk. Tanssi Foundation disclaims all liability and responsibility arising from any reliance placed on this information by you or by anyone who may be informed of any of its contents. All statements and/or opinions expressed in these materials are solely the responsibility of the person or entity providing those materials and do not necessarily represent the opinion of Tanssi Foundation. The information should not be construed as professional or financial advice of any kind. Advice from a suitably qualified professional should always be sought in relation to any particular matter or circumstance. The information herein may link to or integrate with other websites operated or content provided by third parties, and such other websites may link to this website. Tanssi Foundation has no control over any such other websites or their content and will have no liability arising out of or related to such websites or their content. The existence of any such link does not constitute an endorsement of such websites, the content of the websites, or the operators of the websites. These links are being provided to you only as a convenience and you release and hold Tanssi Foundation harmless from any and all liability arising from your use of this information or the information provided by any third-party website or service.
Last update: May 10, 2024
| Created: September 6, 2023