Hello and welcome to Trust Wallet assets info contribution guide. We appreciate your effort to open-source. Token repository https://github.com/trustwallet/assets (repo) is a source of images used by Trust Wallet including:
BEP2 Binance DEX token (native marketplace on Binance Chain)
TRC10, TRC20 tokens on TRON blockchain
Staking validators info available on Trust Wallet Staking Platform
Coming soon: token info, token price
Prepare image requirements
Get familiar with folder strcture, will give you understanding where asset image should be placed
Pay a Pull Reqest Fee
File location: must be placed in the correct folder and subfolder within the folder structure.
PNG is considered invalid.
256px by 256px or
512px by 512px.
Background: preferably transparent (should fit dark mode as well; black logos need light border/background).
File size: up to 100KB. Tip: optimize image size, e.g. using simple drag-and-drop online service tinypng.
blockchains folder contains many subfolders and represents chains e.g.
assets folder contains token folders named by smart contract address in
checksum address for Ethreum like networks and inside of it
logo.png - image representation. Note: Lowercased or uppercased contract addresses considered invalid. You can find checksum address by searching on etherscan.io, for example stablecoin DAI checksum address located at the top left corner of the page and has both uppercase and lowercase characters. Or convert Ethereum address to Checksum address. For other networks address must be specified as it was originated on a chain, e.g TRON TRC10:
1002000, TRON TRC20:
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t etc ...
info folder contains for now only
logo.png that represents coin image
validators folder contains folders:
assets same structure as above and
list.json information about validators.
whitelist.json files you may find in folders like
ethereum but not limited to, contain list of address approved based on many criterias (TODO add criterias) and disapproved based on factors such as scam, outdated, abandoned contracts etc ... .
.├── blockchains│ └──ethereum│ │ └──assets│ │ │ └──0x0a2D9370cF74Da3FD3dF5d764e394Ca8205C50B6 // address folder│ │ │ └──logo.png // address logo│ │ └──info│ │ └──logo.png // coin logo| || └──binance│ │ └──assets│ │ │ └──ONE-5F9│ │ │ └──logo.png│ │ └──info│ │ └──logo.png| └──tron│ | └──assets│ | │ └──1002000│ | │ | └──logo.png| | | └──TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t| | | └──logo.png| | |│ | └──info│ | └──logo.png| || └──cosmos│ │ └──info| | | └──logo.png| | |│ │ └──validators│ │ | └──assets| | | └──cosmosvaloper1clpqr4nrk4khgkxj78fcwwh6dl3uw4epsluffn| | | └──logo.png| | || | └──list.json├── ...
Ethereum ERC20 token folder
Binance DEX BEP2 token token folder
TRON TRC10, TRC20 token token folder
Add Cosmos validator image
Add Tezos validator info
Add Ethereum contract address to blacklist
Add TRON TRC10 ID or TRC20 owner contract address to whitelist
Process adding new tokens may look complicated at first glance, but once you completed it will be way easier do it next time:
Proceed to https://github.com/trustwallet/assets
Fork in the top right corner, wait for process to complete
Navigate to desire chain folder you want to add asset
Prepare folder with image on your computer
Simply drag and drop folder from step 5 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 nam
Create pull request
Once tests have completed and verified that your image follows all requirements, a maintainer will merge it. In 5-10 minutes your token will have the updated image instead of plain logo in Trust Wallet
Fork the repo to your own github account
Clone fork and create new branch:
git clone [email protected]:YOUR_HANDLE/assets.gitcd assetsgit branch <branch_name>git checkout <branch_name>
Add asset to appropriate directory, here folder strcture to 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 PR
Both clients, Android and iOS keep old image cache for up to 7 days. In order to see changes immediately, reinstall Trust Wallet. But as always, make sure you have a backup of all your wallets.
Base URL for token image:
Base URL for coin image:
Coin logo, e.g Bitcoin: