Interacting with your Tanssi Substrate Appchain Using Talisman¶

Introduction¶

Developers and users of Tanssi Substrate appchains have a variety of options when it comes to wallets. Talisman is a great option, as it provides full native support for both Substrate and Ethereum accounts. This guide focuses on the Substrate API. You can also check out a similar guide for configuring Talisman for use with your Tanssi EVM appchain.

Talisman is a Web3 wallet that natively supports Substrate (Polkadot) and Ethereum accounts. The Talisman wallet browser extension is available on Google Chrome, Brave, and Firefox, and a corresponding asset dashboard is accessible at app.talisman.xyz

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

Setting Up Talisman¶

First, download and install the Talisman extension. This guide will first cover creating a new wallet and later address importing an existing one. Review the terms and conditions, then press Get Started.

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

Create a Substrate Account¶

To create your first Polkadot account in Talisman, take the following steps:

1. Select the Polkadot option
2. Give your account a name
3. Press Create

After creating your first account, you'll 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.

Importing an Existing Substrate Account¶

Of course, you can import an existing Substrate account into Talisman. To do so, take the following steps:

1. Press Add Account
2. Press Import
3. Select Import via Recovery Phrase

On the following screen, take the following steps:

1. Select the Polkadot account type
2. Provide a name for your account
3. Paste in your seed
4. Select which accounts you'd like to import
5. Press Import

Connecting Talisman to the Tanssi Dancebox TestNet¶

Talisman already comes pre-configured with support for the Tanssi Dancebox TestNet. You just need to first ensure that you have enabled support for TestNets on Talisman. Remember that the Tanssi Dancebox TestNet itself is not a appchain; it is the Substrate-based parachain that orchestrates and manages the launch of Tanssi appchains. To configure your Talisman to work with Dancebox, take the following steps:

1. Open the Talisman extension and click on the Talisman logo
2. Select Settings
3. Ensure that Enable testnets is checked

If you have a balance of Dancebox tokens, you'll see your account balance on the homepage of the Talisman wallet. If you don't have a balance of Dancebox tokens, the network will be omitted from your list of assets.

Connecting Talisman to Your Substrate Appchain¶

To configure Talisman for your Tanssi Substrate appchain, open the Talisman extension and click on the More Options tab. Click on Settings > Networks & Tokens > Manage Networks.

1. Slide the network slider to Polkadot
2. Check the Enable testnets box
3. Press Add Network

On the following page, you'll then be prompted to enter the network details for your Tanssi appchain. For demonstration purposes, the Dancebox TestNet is used here, but you can substitute these details for your own Tanssi appchain. To add your Tanssi appchain to Talisman, take the following steps:

1. Paste in the RPC URL of your Tanssi appchain. Other parameters will be auto-populated
2. Optionally, enter the block explorer URL of your Tanssi appchain, if applicable
3. Check the This is a testnet box if applicable
4. Press Add Network

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.

The Talisman 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 Talisman extension and click on the polkadot.js.org heading at the top. To configure Talisman 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 1. The value will change depending on the number of accounts you are connecting

Your Talisman wallet is now connected to Polkadot.js Apps. After refreshing Polkadot.js Apps, you should see your Talisman 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

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