Interacting with your Tanssi EVM Appchain Using MetaMask¶

Introduction¶

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.

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

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.

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

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

Here, you can configure MetaMask for the following networks:

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

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.

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