The Trust Wallet Token Repository https://github.com/trustwallet/assets is a comprehensive, up-to-date collection of information about several thousands (!) of crypto tokens. Trust Wallet uses token logos from this source, alongside a number of other projects.
The repository contains token info from several blockchains, info on dApps, staking validators, etc. For every token a logo and optional additional information is available (such data is not available on-chain).
Such a large collection can be maintained only through a community effort, so contributions are welcome, primarily from token projects.
For adding an ERC20 token:
fork the Github repository
prepare a logo file, according to the rules below, but must importantly: PNG format, max. pixel size of 512x512 and max. file size of 100kB.
add/upload the logo file named
logo.png to the folder
where the last part is the token contract address in checksum format, such as
Create a PR to the main repo
Pay the processing fee
The token repository contains the following collections:
TRC10, TRC20 tokens on TRON blockchain
Crypto price providers map: CoinMarketCap
Token and coin info
Smart contract deprecation/upgrade. Read more.
blockchains folder contains several subfolders corresponding to blockchain networks, such as
assets subfolder contains token folders named by smart contract address, in checksum format for Ethereum like networks.
This folder should contain the
logo.png image file.
For other networks the address must be specified as it was originated on the chain, e.g TRON TRC10:
1002000, TRON TRC20:
info folder contains a
logo.png that represents the coin image.
validators folder contains folders:
assets same structure as above and
list.json information about validators.
allowlist.json, present in some chain folders like
binance, contain list of approved tokens and banned tokens. Trust Wallet will never show denylisted tokens, and only allowlisted tokens are shown in the token search results.
For Ethereum like networks, contract folders must be named according to the so-called Checksum Format, with mixed lowercase and uppercase letters, such as
0x89d24A6b4CcB1B6fAA2625fE562bDD9a23260359. Non-checksum addresses (e.g. all lowercase) are considered invalid.
You can find the checksum address by searching on etherscan.io, for example stablecoin DAI the checksum address is located at the top left corner of the page and has both uppercase and lowercase characters. Or convert Ethereum address to Checksum address.
.├── blockchains│ └──ethereum│ │ └──assets│ │ │ └──0x0a2D9370cF74Da3FD3dF5d764e394Ca8205C50B6 // address folder│ │ │ └──logo.png // token logo| | | └──info.json // optional token info│ │ └──info│ │ │ └──logo.png // chain coin logo| | │ └──info.json // chain coin info│ │ └──allowlist.json // list of accepted tokens│ │ └──denylist.json // list of blocked tokens| || └──binance│ │ └──assets│ │ │ └──ONE-5F9│ │ │ └──logo.png| | | └──info.json│ │ └──info│ │ └──logo.png| └──tron│ | └──assets│ | │ └──1002000│ | │ | └──logo.png| | | | └──info.json| | | └──TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t| | | └──logo.png| | | └──info.json| | |│ | └──info│ | └──logo.png| | └──info.json| || └──cosmos│ │ └──info| | | └──logo.png| | | └──info.json| | |│ │ └──validators│ │ | └──assets| | | └──cosmosvaloper1clpqr4nrk4khgkxj78fcwwh6dl3uw4epsluffn| | | └──logo.png| | || | └──list.json├── ...
Get familiar with our folder structure, it will give you an understanding where assets should be placed
Pay the merge fee
Whenever you updating or deleting an asset on behalf of the asset owner or just found outdated information, please provide a link to the source saying about changes. That will help to speed up the review process.
This instruction wil be helpfull if you want to:
Update information about the smart contract
Deprecate or update contract address
Smart contract address update procedure:
Rename old contract address in coresponding coin folder to new contract e.g.:
Remove smart contract e.g.:
`rm -r ./blockchains/<COIN>/assets/<OLD_CONTRACT_ADDRESS>/``rm -r ./blockchains/ethereum/assets/0x19fFfd124CD9089E21026d10dA97f8cD6B442Bff/`
Commit changes and make a PR (pull request)
File location: must be placed in the correct folder and subfolder within the folder structure.
PNG is considered invalid.
logo.png, all lowercase.
256 x 256 pixels or
512 x 512 pixels.
Background: preferably transparent (should fit dark mode as well; deny logos need light border/background).
File size: maximum 100kB. Tip: optimize image size, e.g. using simple drag-and-drop online service tinypng.
Integrate deep linking
Add logo as dApp supported wallet
Test dApp inside Trust Wallet on iOS and Android devices
Add validator logo image to
blockchains/<chain>/validators/assets/<validator_address>/logo.png see images requirements
Check chain specific requirements.
Uploading: 1. Ethereum ERC20 token folder 2. Binance DEX BEP2, BEP8 token token folder 3. TRON TRC10, TRC20 token token folder 4. Add Cosmos validator image 5. Add Tezos validator info 6. Add Ethereum contract address to denylist 7. Add TRON TRC10 ID or TRC20 owner contract address to allowlist
If you are not familiar with GitHub or Git, the process of adding new tokens may look complicated at first glance, but it consists of only a few steps, and is not very complicated.
The assets repository is maintained in GitHub, the largest hosting for open source projects. You need a GitHub account to interact with it.
To do changes in the assets repository, you need to create a personal copy called a fork.
Once the changes are prepared inside the fork, you need to create a pull request to the main repository. Upon review the maintainers will accept your pull request, and the changes will be incorporated.
Proceed to https://github.com/trustwallet/assets
Fork in the top right corner, wait for process to complete.
Note: if you already have a fork, it should be updated: easiest is to remove the fork and create it afresh.
Navigate to desire chain folder you want to add asset
Prepare on your local drive a folder corresponding to the token cortact.
Copy the logo image as
logo.png into the folder (and optional info file).
Simply drag and drop the folder to active window
Commit changes box:
Add files via upload add meaningfull comment what you adding to the repo
Add an optional extended description write a comment about upload
optional: adjust fork branch name
Create pull request
The steps are similar to using the web page, but the desktop app has more control for overwriting the files, branching, pushing.
Fork the repository to your own GitHub account
Clone fork and create new branch:
git clone email@example.com:YOUR_HANDLE/assets.gitcd assetsgit checkout -b <branch_name>
Add asset to appropriate directory, the folder strcture documentation will help you
Commit and push to your fork
git add -Agit commit -m “Add <token_name>”git push origin <branch_name>
From your repo clone page make a new PR (pull request)
Due to an increasing number of pull request (and proportional checking & merging effort), a modest fee is required for processing a pull request, payable in cryptocurrency. Follow the instructions in the pull request for completing the fee payment.
See the fee FAQ
Contributions in a pull request are verified by an automated build. The checks fail if something is wrong, like to logo is too large or an Ethereum contract is not in checksum format. Checks the exact error message in the build to find out the problem.
A merge conflict happens if the same file has been modified in the pull request, and also in the master branch since the fork was created. With assets repo, this typically caused by using a fork that was created long ago. The simplest solution in this case is to delete your pull request, delete your fork, create a new fork, and create a new PR. Alternatively, a merge conflict can be resolved using git command line, but Git skills are required. A pull request can also happen when overriding an existing logo.
After PR was merged, it may take some time, but not longer than one hour, until search will show the new logo.
Both clients, Android and iOS keep old image cache for up to a few days. In order to see changes immediately, reinstall Trust Wallet. But as always, make sure you have a backup of all your wallets.
A process of removing smart contract information such as (token logo and info) from this repository. Removed contract address will be added to the denylist and, as a result, will no longer be present in token search results inside the TW app. Why would you want to do this ?. You are contract owner or just good samaritan who noticed contract to be no longer "active" and was an upgrade and abandoned by owning organization, involved in a scam, mimicking by its name or/and symbol a real contract. All facts must be supported with a link to any resource proving these statements.
--> For developers
0x Tracker - The 0x Protocol Trade Explorer and news aggregator.
Uniswap - Uniswap is a protocol for automated token exchange on Ethereum.
LinkDrop - A customer acquisition platform for DApps. The easiest crypto onboarding.
Aragon − Aragon is platform and network for decentralized organizations.
SpiderDEX - Decentralized exchange for crypto collectibles.
Zerion — A simple interface to decentralized finance.
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.