Skip to main content

XCM Asset Registration

Overview

This step mostly concerns the technical side of asset registration, but once we have opened channels, we should agree on which assets to bridge. The most common and expected assets are native assets. E.g. ACA from Acala or GLMR from Moonbeam.

The first step here is to create a local asset on our network which will represent the token. We will use permissioned asset_id (root-only). Asset metadata should reflect what’s used on the reserve parachain, e.g. asset name, symbol name, and number of decimals.

We use unit minimal balance (existential deposit) for supported foregin assets.

Regarding asset location, let’s take ACA token as a reference { "parents": 1, "interior": { "X2": [{ "Parachain": 2000 }, { "GeneralKey": [0, 128] } ]}}.

We will need to register the mapping between our local created asset Id and that MultiLocation.

Local asset Id will be chosen from a pre-determined range, starting at 2^64 and increasing from there.

2 ** 64 + offset

For offset 0, this will produce the permissoned asset id: 18446744073709551616.

Request to Add XCM Asset

To add an XCM asset on Astar or Shiden you will need to create a proposal on our forum. Create your proposal in the correct category:

We have created a template that you can use to post your proposal. You can find the template here.

Workflow

Create Proposal

After creating your proposal, we will inform our community, and it is expected that you follow up in case there are any questions. To continue with the next step you will need to be approved by our council (governance), which will be done via poll on our forum.

Mapping Asset

After your proposal receives approval from our council, we will map your asset into our network.