Introduction

Introduced in version 7.0, Polymesh no longer requires each tokenized asset to have a unique ticker. Instead, each native asset on Polymesh has a unique Asset ID assigned - a 16-byte UUID generated by Polymesh when the asset is created on-chain. A unique ticker can optionally be linked to the Asset ID during the creation of an asset or any time thereafter.

Users can register a ticker and then create an asset associated with it when ready, or they can create an asset first and attach a ticker later.

Prerequisites

• A verified Polymesh Account.
• Enough POLYX balance on the account to cover transaction and protocol fees. Registering a new ticker currently has a 25 POLYX protocol fee. This fee is also charged when directly creating an asset without first registering a ticker in a separate transaction.

Register a unique ticker

1. Navigate to the Polymesh App.
2. For the account at the top, select your account in your wallet.
   
3. For the extrinsic, select “asset”, then "registerUniqueTicker(ticker)".
4. Enter a ticker symbol with a 0x prefix in HEX format. It should look like this as per the following screenshot:
   Click here to see this image at full resolution.
   Note: Use a HEX converter like this one. For the Output delimiter string, select "None".
   Example: Your ticker name is "TESTKN", which is "544553544B4E" in HEX. This HEX value should be padded with zeros to be 24 bytes like "544553544B4E00000000000" with a 0x prefix, so the value you should enter is "0x544553544B4E00000000000".
   Shorter ticker names than 12 characters in HEX should be also padded with zeros up to 12 characters.
   
5. Once all data are filled, click on Submit transaction then confirm and sign the transaction with your wallet. 

Common errors and solutions

• TickerAlreadyRegistered: The ticker is already registered to someone else. Try registering a different ticker.
• TickerTooLong: The ticker cannot be more than 12 characters. Try a shorter ticker name.
• TickerNotAlphanumeric: The ticker has non-alphanumeric parts. Only numeric characters are allowed.

Link a ticker to an asset ID

A unique asset ID is created when an asset is issued on Polymesh. A ticker can then be linked to an Asset ID anytime.

1. Navigate to the Polymesh App.
2. For the account at the top, select your account in your wallet.
   
3. For the extrinsic, select “asset”, then "linkTickerToAssetId(ticker, assetId)".
   
   Click here to see this image at full resolution.
   
4. Enter a ticker symbol with a 0x prefix in HEX format as per the screenshot below:
   
   Click here to see this image at full resolution.
   Note: Use a HEX converter like this one. For the Output delimiter string, select "None".
   Example: Your ticker name is "TESTKN", which is "544553544B4E" in HEX. This HEX value should be padded with zeros to be 16 bytes like "544553544B4E00000000000" with a 0x prefix, so the value you should enter is "0x544553544B4E00000000000".
   Shorter ticker names than 12 characters in HEX should be also padded with zeros up to 12 characters.
   
5. Enter the Asset ID to the assetId field. 
   Click here to see this image at full resolution.
   Note: Use a HEX converter like this one. For the Output delimiter string, select "None".
   Example: Your Asset ID is "ASSETIDTEST", which is "4153534554494454455354" in HEX. This HEX value should be padded with zeros to be 16 bytes like "0x4153534554494454455354000000000" with a 0x prefix, so the value you should enter is "0x544553544B4E00000000000".
   Shorter Asset ID's than 16 characters in HEX should be also padded with zeros up to 16 characters. ASCII characters are also allowed, but should be padded with spaces up to 16 characters.
6. Once all data are filled, click on Submit transaction then confirm and sign the transaction with your wallet. 

Common errors and solutions

• TickerRegistrationNotFound: The ticker registration associated to the ticker was not found.
• InvalidAssetIdentifier: Some `AssetIdentifier` was invalid.
• InvalidTickerCharacter: Invalid ticker character - valid set: A`..`Z` `0`..`9` `_` `-` `.` `/`.
• TickerIsAlreadyLinkedToAnAsset: The given ticker is already linked to an asset.
• TickerNotRegisteredToCaller: The ticker doesn't belong to the caller.

Unlink a ticker from asset ID

This action removes the link between a ticker and an asset. A ticker can be unlinked anytime from the Asset ID.

1. Navigate to the Polymesh App.
2. For the account at the top, select your account in your wallet.
   
3. For the extrinsic, select “asset”, then "unlinkTickerFromAssetId(ticker, assetId)".
   
   Click here to see this image at full resolution.
   
4. Enter the ticker symbol with a 0x prefix in HEX format as per the screenshot below:
   
   Click here to see this image at full resolution.
   Note: Use a HEX converter like this one. For the Output delimiter string, select "None".
   Example: Your ticker name is "TESTKN", which is "544553544B4E" in HEX. This HEX value should be padded with zeros to be 16 bytes like "544553544B4E00000000000" with a 0x prefix, so the value you should enter is "0x544553544B4E00000000000".
   Shorter ticker names than 12 characters in HEX should be also padded with zeros up to 12 characters.
   
5. Enter the Asset ID to the assetId field. 
   
   Click here to see this image at full resolution.
   Note: Use a HEX converter like this one. For the Output delimiter string, select "None".
   Example: Your Asset ID is "ASSETIDTEST", which is "4153534554494454455354" in HEX. This HEX value should be padded with zeros to be 16 bytes like "0x4153534554494454455354000000000" with a 0x prefix, so the value you should enter is "0x544553544B4E00000000000".
   Shorter Asset ID's than 16 characters in HEX should be also padded with zeros up to 16 characters. ASCII characters are also allowed, but should be padded with spaces up to 16 characters.
6. Once all data are filled, click on Submit transaction then confirm and sign the transaction with your wallet. 

Common errors and solutions

• TickerNotRegisteredToCaller: The ticker doesn't belong to the caller.
• TickerIsNotLinkedToTheAsset: The given ticker is not linked to the given asset.