Hello and welcome to Trust Wallet assets info contribution guide. We appriciate your effort to open-source. Token repository https://github.com/trustwallet/assets (repo) is a source of images used by Trust Wallet including:
- ERC20 tokens on Ethereum compatible networks supported by Trust Wallet such as:
- Ethereum (ETH)
- Ethereum Classic (ETC)
- POA Network (POA)
- TomoChain (TOMO)
- GoChain (GO)
- Wanchain (WAN)
- Callisto Network (CLO)
- Thunder Token (TT)
-
BEP2 Binance DEX token (native marketplace on Binance Chain)
-
TRC10 tokens on TRON blockchain
-
coins integrated in Wallet Core
-
dApp images available in
Browser
section in Trust Wallet and at https://dapps.trustwallet.com. Folder for upload -
Coming soon: token info, token price, blacklisted and whitelisted tokens (mostly scam/spam ones)
- Prepare image requrimetns
- Get familiar with folder strcture, will give you understanding where asset image should be placed
- Add asset guide
- file extension:
png
. UppercasePNG
considered invalid. - name:file name requirements for:
logo.png
name, but folder naming where they placed is most important part of contribution - size:
256px by 256px
- background: preferably transparent
- use simple drag and drop online service tinypng to optimize image size
blockchains
folder contains many subfolders and represents chains e.g. ethereum
, binance
...
assets
folder contains token folders named by smart contract address in lowercase register and inside of it logo.png
- image representation
info
folder contains for now only logo.png
that represents coin image
.
├── blockchains
│ └──ethereum
│ │ └──assets
│ │ │ └──0x0a2d9370cf74da3fd3df5d764e394ca8205c50b6
│ │ │ └──logo.png
│ │ └──info
│ │ └──logo.png
| └──binance
│ │ └──assets
│ │ │ └──one-5f9
│ │ │ └──logo.png
│ │ └──info
│ │ └──logo.png
| └──tron
│ └──assets
│ │ └──1002000
│ │ └──logo.png
│ └──info
│ └──logo.png
├── ...
Uploading:
- Ethereum ERC20 token folder
- Binance DEX BEP2 token token folder
- TRON TRC10 token token folder
Process adding new tokens may look complicated at first glance, but once you completed it will be way easier do it next time:
- Follow image requirements
- Proceed to https://github.com/trustwallet/assets
- Press on
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
- In
Commit changes
box:
Add files via upload
add meaningfull comment what you adding to the repo- optional: In
Add an optional extended description
write a comment about upload - optional: adjust fork branch nam
- Click on
Propose changes
- Press on
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 crate new branch:
git clone [email protected]:YOUR_HANDLE/assets.git
cd tokens
git 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 -A
git 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:
https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/<contract_address_lowercase>/logo.png
Base URL for coin image:
https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/<coin_name_lowercase>/info/logo.png
Examples:
Coin logo, e.g Bitcoin:
https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/bitcoin/info/logo.png
ERC20:
https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0x006bea43baa3f7a6f765f14f10a1a1b08334ef45/logo.png
BEP-2:
https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/binance/assets/ankr-e97/logo.png
TRC-10:
https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/tron/assets/1002000/logo.png
- Trust Wallet - iOS and Android
- 0x Tracker - The 0x Protocol Trade Explorer and news aggregator