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:
< 8000 ol dir="auto">- 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, TRC20 tokens on TRON blockchain
-
coins integrated in Wallet Core
-
dApp images available in
Browsersection in Trust Wallet and at https://dapps.trustwallet.com and bookmarks icons. read requirments -
Staking validators info avalible on Trust Wallet Staking Platform
-
Coming soon: token info, token price, blacklisted and whitelisted tokens (mostly scam/spam ones)
- Prepare image requirements
- Get familiar with folder strcture, will give you understanding where asset image should be placed
- Add asset guide
- file extension:
png. UppercasePNGconsidered invalid. - name：file name requirements for:
logo.pngname, 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
- Folder for upload
<subdomain>.<domain_name>.pnge.g: https://app.compound.finance/ =>app.compound.finance.pnghttps://kyberswap.com/ =>kyberswap.com.png
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 // 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
| | | └──tgbhcodq1jrwb3zywmfwsrth4rwbil2mzh
| | | └──logo.png
| | |
│ | └──info
│ | └──logo.png
| |
| └──cosmos
│ │ └──info
| | | └──logo.png
| | |
│ │ └──validators
│ │ | └──assets
| | | └──cosmosvaloper1clpqr4nrk4khgkxj78fcwwh6dl3uw4epsluffn
| | | └──logo.png
| | |
| | └──list.json
├── ...
Uploading:
- Ethereum ERC20 token folder
- Binance DEX BEP2 token token folder
- TRON TRC10 token token folder
- Add Cosmos validator info and image
- Add Tezos validator info and image
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
Forkin 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 changesbox:
Add files via uploadadd meaningfull comment what you adding to the repo- optional: In
Add an optional extended descriptionwrite 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 create new branch:
git clone git@github.com: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.pngBase URL for coin image:
https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/<coin_name_lowercase>/info/logo.pngExamples:
Coin logo, e.g Bitcoin:
https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/bitcoin/info/logo.pngERC20:
https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0x006bea43baa3f7a6f765f14f10a1a1b08334ef45/logo.pngBEP-2:
https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/binance/assets/ankr-e97/logo.pngTRC-10:
https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/tron/assets/1002000/logo.pngTRC-20:
https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/tron/assets/tg37muxruah1e8dwsrrmoq79bnzn1yhztb/logo.png- Trust Wallet - iOS and Android
- 0x Tracker - The 0x Protocol Trade Explorer and news aggregator