Introduction

Polymesh is built with Substrate, which is a framework and a set of modules for creating a blockchain. Substrate provides tools that offer low-level access to everything that happens on a Substrate network and these tools work with Polymesh.

The Polymesh Substrate App is such a tool. It is typically used by developers to explore the blockchain and transactions in depth.

Update an asset with the Polymesh App

Update asset identifiers (Security Identifiers):

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 "updateIdentifiers(ticker, identifiers)", as per the below screenshot:
   
   Click here to see this image at full resolution.
   
   
4. Ticker: Enter a ticker symbol in HEX format with a 0x prefix. It should look like as the following screenshot:
   
   Click here to see this image at full resolution.
   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 or 24 characters.
   You can use a tool such as this HEX converter. For the “Output delimiter string” select “None”.
   
   
5. Asset identifier: Select the appropriate asset identifier from the dropdown menu, then enter the value below in its original format. In this example, we are adding a CUSIP identifier to our asset:
   
   Click here to see this image at full resolution.
   Approved values per asset identifiers:
   - CUSIP: 9 characters
   - CINS: 9 characters
   - ISIN: 12 characters
   - LEI: 20 characters
   - FIGI: 12 characters
   
   
6. Once all data are filled, click on "Submit transaction" then sign the transaction with your wallet. You will see a green popup if the transaction were successful.
   
   
   Click here to see this image at full resolution.

7. You can verify the updated asset identifier in the Polymesh Token Studio.
   

Add a custom identifier (Asset Metadata):

With Asset Metadata, asset issuers are able to capture various simple metadata about their assets on chain.

• Issuers can set local asset metadata type only. Local types are unique for each ticker.
• Asset metadata can be permanently locked, or locked for a limited amount of time (1 month, 1 year, etc...).

To add a custom metadata to your asset, please follow the process below:

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 "registerAndSetLocalAssetMetadata(ticker, name, spec, value, detail)", as per the below screenshot:
   
   
   Click here to see this image at full resolution.
   
4. Ticker: Enter a ticker symbol in HEX format with a 0x prefix. It should look like as the following screenshot:
   
   Click here to see this image at full resolution.
   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.
   You can use a tool such as this HEX converter. For the “Output delimiter string” select “None”.
   
   
5. You can add URL, description and type definition by enabling the "include option" toggle.
   Values should be in HEX format, same process as for the ticker:
   
   Click here to see this image at full resolution.
   
   
6. Value: Enter the value for the asset metadata. It should be in its original format, numbers and letters are allowed. You can also upload a file instead by enabling the "file upload" toggle:
   
   Click here to see this image at full resolution.
   
   
7. Once all data are filled, click on "Submit transaction" then sign the transaction with your wallet. You will see a green popup if the transaction were successful.
   
   
   Click here to see this image at full resolution.

If you have any questions, feel free to open a conversation with our support team through the Polymesh Community page.