How to Add an Asset to Token List

[trusty]

How to Add Asset to Token List

What is This Guide For?

This guide shows a step by step procedure on how a token can be added to the Token List.
Learn more here: What is a Token List?

What Do I Need?

These are just suggested applications that you can use to easily navigate the assets repo

• GitHub Desktop
• Visual Studio Code
• Details about the token, namely Token Name, Symbol, Contract Address and Decimals

Fees for Submissions

Please be advised that there will be a small fee of TWT or BNB for every submission to the Trust Wallet repo. Please be advised that this is a non-refundable fee. Make sure that your token meets the criteria specified on this article.

Subsequent submissions (e.g. updates to logos, names, or rebranding) will require additional fee payment.

Steps for Token Listing

1. Using Github Desktop, clone the assets repo on your computer.
   

   

2. Once it is completely synced, Open the repo by tapping on “Open in Visual Studio Code”
   

   

3. For this guide, we will try to add Illuvium (ILV) that is an ERC20 token on the Ethereum blockchain. Take note of the token contract address, and decimals.
   

   

4. Using Visual Studio Code, navigate to the Ethereum folder (since this is an ERC20 token), and then click on the tokenlist.json file.

5. Scroll down to the bottom, then add the following lines which describes the new token that will be added. You can follow this format:

        {
            "asset": "c60_t0x767FE9EDC9E0dF98E07454847909b5E959D7ca0E",
            "type": "ERC20",
            "address": "0x767FE9EDC9E0dF98E07454847909b5E959D7ca0E",
            "name": "Illuvium",
            "symbol": "ILV",
            "decimals": 18,
            "logoURI": "https://assets.trustwalletapp.com/blockchains/ethereum/assets/0x767FE9EDC9E0dF98E07454847909b5E959D7ca0E/logo.png",
            "pairs": []
        }

Make sure to add a comma on the last added token. See the example below:

6. Save your changes.
   

   

7. Go back to Github Desktop then create a New branch. The name should be related to the changes you are trying to submit.
   

   
   
   
   

8. Create the pull request and provide as much details as you can to justify the submission.
   

   
   
   
   

9. Submit the pull request and pay the fee once the bot asks for it.

10. A maintainer will review and approve the submission. The pull request will be merged to the repository.

When Will The Token be Listed?

A maintainer will merge the pull request after further verification. This will be done as soon as possible. There will be notification emails sent to the one who submitted the pull request if there is anything needed or errors need to be corrected.
Once the pull request has been merged, the token list will be updated. The new token will be shown on DEX-Swap section of the app.

Disclaimer
Trust Wallet team allows anyone to submit new assets to this repository. However, this does not mean that we are in direct partnership with all of the projects.

Trust Wallet team will reject projects that are deemed as scam or fraudulent after careful review. Trust Wallet team reserves the right to change the terms of asset submissions at any time due to changing market conditions, risk of fraud, or any other factors we deem relevant.

Find out the other ways you can contribute here.