Skip to content

Interacting with Your Tanssi Substrate Appchain Using SubWallet


Developers and users of Tanssi Substrate appchains have a variety of options when it comes to wallets. SubWallet is a comprehensive Web3 wallet that natively supports Substrate (Polkadot) and Ethereum accounts. This tutorial centers on the Substrate API, but you can check out a similar tutorial for interacting with SubWallet using the Ethereum API.

The SubWallet wallet browser extension can be downloaded for all supported browsers, including Chrome, Brave, Firefox, and MS Edge. SubWallet also has a mobile app for both iOS and Android, but that is beyond the scope of this guide. A complete online asset dashboard is accessible at

This guide takes you through all the necessary steps, from installing SubWallet to setting up a wallet, connecting it to your Tanssi Substrate appchain, and sending funds.

Creating Your First Substrate Account

First, download and install the SubWallet extension. Creating a new account will generate a seed phrase that can derive multiple Ethereum and Substrate accounts. By default, SubWallet will generate a single Ethereum and a single Substrate account, but you can easily derive more from the same seed phrase. Click Create a new account to get started.

Get started with SubWallet

On the following screen, you'll be prompted to create a password to secure your new wallet.

Create a password for SubWallet

You'll then be prompted to back up your seed phrase. This is an important step, especially because you have the option to later derive additional accounts from this seed phrase.

Back up your seed phrase in SubWallet


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.

Importing an Existing Substrate Account

Of course, you can import an existing Substrate account into SubWallet. To get started, take the following steps:

  1. Press the All accounts button at the top
  2. Press the Import account icon

Import account part 1

On the following screen, select the method by which you would like to import the existing account. If you're importing a Substrate account, you can choose from the seed phrase, Polkadot.js (JSON), or QR code options.

Import existing account part 2

On the following screen, you'll be able to provide the relevant seed phrase, JSON file, or QR code, and you can begin using your new account right away.

Connecting SubWallet to the Tanssi Dancebox TestNet

SubWallet comes pre-configured with support for the Tanssi Dancebox TestNet, but it may not be enabled by default. You just need to head to the Manage networks page to toggle it on. Remember that the Tanssi Dancebox TestNet itself is not an appchain; it is the Substrate-based parachain that orchestrates and manages the launch of Tanssi appchains. To configure your SubWallet to work with Dancebox, press the More Options icon in the upper left corner. Then click Manage networks and take the following steps:

  1. Search for Dancebox
  2. Toggle the slider on to enable support for Dancebox

Toggle support for the Dancebox TestNet

If you have a balance of Dancebox tokens, you'll see your account balance on the homepage of the SubWallet wallet. By default, all balances are hidden in SubWallet, but if you press the eye icon, you can toggle balance visibility.

See your TestNet account balances in SubWallet

Connecting SubWallet to Your Substrate Appchain

To configure SubWallet for your Substrate appchain, press the More Options icon in the upper left corner. Then click Manage networks. Press the + icon. On the following page, you'll then be prompted to enter the network details for your Tanssi appchain. For demonstration purposes, the Tanssi Dancebox Parachain is used here, but you can substitute these details for your own Tanssi appchain. To add your Tanssi appchain to SubWallet, take the following steps:

  1. Paste in the WSS URL of your Tanssi appchain. Other parameters like the parachain ID and token decimals may be auto-populated
  2. Provide a name for your Tanssi appchain
  3. Press Save

Add Network in SubWallet

Connecting to Polkadot.js

To connect your Tanssi Substrate appchain to Polkadot.js Apps, first head to Polkadot.js Apps. In this example, Polkadot.js Apps is connected to the Dancebox TestNet, but you can point Polkadot.js to your Tanssi appchain by clicking on the network dropdown and filling in the WSS endpoint of your Tanssi appchain in the custom endpoint field.

Connect to Polkadot.js Apps

The SubWallet extension will prompt you to select the accounts you'd like to use with Polkadot.js Apps. If it doesn't automatically pop up, you can open the SubWallet extension and click on the Connected icon next to your account at the top. To configure SubWallet to correctly interface with your Tanssi appchain on Polkadot.js Apps, you should take the following steps:

  1. Select the Substrate account(s) that you'd like to use with Polkadot.js Apps
  2. Press Connect

Connect SubWallet to Polkadot.js Apps

Your SubWallet wallet is now connected to Polkadot.js Apps. After refreshing Polkadot.js Apps, you should see your SubWallet account in the Accounts page of Polkadot.js Apps underneath the extension heading.

Sending a Transaction

To send a transaction through the Substrate API, click Send next to your account on Polkadot.js Apps. Then, take the following steps:

  1. Input the send to address
  2. Enter the amount
  3. Press Make Transfer and confirm the transaction in the resulting Polkadot.js pop-up
  4. Press View Details if you'd like to inspect the contents of the transaction
  5. Press Approve to submit the transaction

Send funds through Substrate API with Polkadot.js Apps

You can also send a transaction through the Substrate API directly from the SubWallet extension without using Polkadot.js Apps. To do so, press the Send icon and take the following steps:

  1. Specify the asset to send
  2. Specify the destination chain (in this case, the same chain that you're sending from)
  3. Enter the destination address
  4. Enter the number of tokens to send
  5. Look over the transaction details, then press Transfer and subsequently Approve

Send funds through Substrate API directly in SubWallet

This guide focused specifically on configuring SubWallet to work with your Tanssi Substrate appchain, but SubWallet is also a full-featured wallet for EVM accounts. Under the Ethereum API section, you'll find a similar guide for configuring SubWallet for use with your Tanssi EVM appchain.

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: October 19, 2023