Register External Assets¶

Introduction¶

Cross-chain asset transfer is crucial because it enables the seamless movement of digital assets across different appchains, enhancing interoperability, liquidity, and user experience. To enable asset transfers to and from two appchains, first, a bidirectional channel must be open between them. Thanks to the Tanssi dApp, opening a channel is an easy and quick task. Please refer to the Manage Cross-Chain Communication Channels article to know how to do it.

Once your appchain's communication channels are established, you can register other chain's assets (external assets) to start operating. This guide will walk you through the process of registering external assets using the Tanssi dApp.

Checking Prerequisites¶

For the examples in this guide, you will need to have the following:

• A Tanssi appchain (Dedicated) running runtime 500 or above
• The account you used when registering the appchain, imported in any of the supported wallets
• Your appchain's Sudo account, also imported in any of the supported wallets

Retrieving the Registration Account¶

If you're unsure what your registration account is, you can query it directly from the Tanssi orchestrator chain, which keeps records of every registered appchain. To do so, head to the Chain state section on the Polkadot.js Apps connected to the orchestrator chain for snap appchains or dedicated appchains, and take the following steps:

1. Select the registrar storage module
2. Select registrarDeposit
3. Insert your appchain ID
4. Press + icon

You'll see the registration account at the bottom.

Retrieving the Sudo Account¶

If you're unsure what your Tanssi appchain's Sudo account is, you can find it in your Tanssi Dashboard underneath the Properties section.

Accessing the External Assets Registration Panel¶

The Tanssi dApp makes it easy for the appchain governor to manage cross-chain communication configurations. It allows requesting new channels, accepting incoming channel opening requests, closing existing channels, managing external assets, and more. To access the cross-chain management panel, head to the Tanssi dApp, and then:

1. Click on the Manage button
2. Click on the XCM button

The panel will show your appchain's cross-chain configuration along with several available actions. Regarding external assets, the relevant elements you are presented with are:

1. Registered Assets panel - this section will group and present to you all registered assets your appchain already has available
2. Registered Assets List - already registered external assets will be displayed in this section, along with their associated information such as asset name, symbol, ID, total supply, and appchain ID where it is native
3. Asset Registration - this option allows you to select other available external assets and register them. The following section explains how to do it

Register an External Asset¶

Provided your appchain has already established bidirectional communicaction channels with another appchain, the appchain governor can register external assets.

To do so, click on Asset Registration and then:

1. Select at least one of the available assets from the list
2. Click on Register

You'll be asked to sign the transaction, and once it's gone through, the external asset will be available locally.