Trust Developer
Search…
Repository Details
Repository Details
Collections
The token repository contains the following collections:
- 1.
- 3.
- 4.DApp logos displayed in
Browsersection of the Trust Wallet app, and bookmarks icons - 5.Staking validators information, such as name:
image,validator_id,website_url - 6.
- 7.Token and coin information
- 8.
Repository structure
The
blockchains folder contains several subfolders corresponding to blockchain networks, such as ethereum, binance, etc.The
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, and the info.json file.For other networks the address must be specified as it was originated on the chain, e.g TRON TRC10:
1002000, TRON TRC20: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t etc.The
info folder contains a logo.png that represents the coin image.The
validators folder contains folders: assets same structure as above and list.json information about validators.The
denylist.json and allowlist.json, present in some chain folders like ethereum and 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.Checksum format
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.
Layout
1
.
2
├── blockchains
3
│ └──ethereum
4
│ │ └──assets
5
│ │ │ └──0x0a2D9370cF74Da3FD3dF5d764e394Ca8205C50B6 // address folder
6
│ │ │ └──logo.png // token logo
7
| | | └──info.json // optional token info
8
│ │ └──info
9
│ │ │ └──logo.png // chain coin logo
10
| | │ └──info.json // chain coin info
11
│ │ └──allowlist.json // list of accepted tokens
12
│ │ └──denylist.json // list of blocked tokens
13
| |
14
| └──binance
15
│ │ └──assets
16
│ │ │ └──ONE-5F9
17
│ │ │ └──logo.png
18
| | | └──info.json
19
│ │ └──info
20
│ │ └──logo.png
21
| └──tron
22
│ | └──assets
23
│ | │ └──1002000
24
│ | │ | └──logo.png
25
| | | | └──info.json
26
| | | └──TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
27
| | | └──logo.png
28
| | | └──info.json
29
| | |
30
│ | └──info
31
│ | └──logo.png
32
| | └──info.json
33
| |
34
| └──cosmos
35
│ │ └──info
36
| | | └──logo.png
37
| | | └──info.json
38
| | |
39
│ │ └──validators
40
│ │ | └──assets
41
| | | └──cosmosvaloper1clpqr4nrk4khgkxj78fcwwh6dl3uw4epsluffn
42
| | | └──logo.png
43
| | |
44
| | └──list.json
45
├── ...
Copied!
Contribution Guidelines
Contribution Use Cases
Add new asset
- 1.
- 2.Get familiar with our folder structure, it will give you an understanding where assets should be placed
- 3.
- 4.
Update and remove an existing asset
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:
- 1.Update information about the smart contract
- 2.
Smart contract address update procedure:
- 1.Rename old contract address in coresponding coin folder to new contract e.g.:
- 2.Remove smart contract e.g.:
1
`rm -r ./blockchains/<COIN>/assets/<OLD_CONTRACT_ADDRESS>/`
2
3
`rm -r ./blockchains/ethereum/assets/0x19fFfd124CD9089E21026d10dA97f8cD6B442Bff/`
Copied!
- 1.Commit changes and make a PR (pull request)
Image Requirements
- File name：
logo.png, all lowercase. Extension:png(uppercasePNGis considered invalid). - Dimension: recommended
256 x 256 pixels, maximum512 x 512 pixels, aspect ratio should be 1:1. - File size: maximum 100kB. Tip: optimize image size, e.g. using simple drag-and-drop online service tinypng.
- Edges and background:
- Logos are displayed cropped to a circular mask, a circle fitting in the square shape. Thus the corners of the logo image will not be visible. The logo should fit in the circle, but also fill it as much as it possible, i.e. there should not be unused spaces on the sides/top/bottom.
- Logos should look OK with white/lightgray background as well as on black/darkgray background (night mode). For dark themed logos use white contour lines to make sure they stand out on dark background as well.
- Avoid using transparency inside the logo, as the color beneath the transparent layer is changing (light or dark). Use transparency only outside of the logo.
- It is recommended to use the Assets web app (guide), as it shows a preview of the logo with both light and dark background and circular cropping.
Info.json Contents
The
info.json file contains basic information about the token/project.It has following required fields:
name: name of the tokentype: such as ERC20, BEP2, BEP20, TRC20, TRC10, ...symbol: the token symboldecimals: number of decimal digits used in the amounts (e.g. 18 for ETH)description: a few sentence summary of the token/projectwebsite: project web siteexplorer: URL of the token explorer pagestatus:"active"id: the id/contract/address of the token, same as the subfolder namelinks: Array withname/urlpairs, for social media links, documentation, etc. List of currently supported types:github,whitepaper,twitter,telegram,telegram_news,medium,discord,reddit,facebook,youtube,coinmarketcap,coingecko,blog,forum,docs,source_code. Note: thesocialssection is no longer used.tags: Assigning these tags to tokens helps place them on appropriate token menus and ensures your token is evaluated correctly in conditions. List of currently supported tags:stablecoin,wrapped,synthetics,nft,governance,defi,staking,staking-native,privacy,nsfw,binance-peg,deflationary,memes,gamefi.
If in doubt about fields, look around / search in existing info.json files.
Sample
info.json:1
{
2
"name": "Trust Wallet Token",
3
"website": "https://trustwallet.com",
4
"description": "Utility token to increase adoption of cryptocurrency.",
5
"explorer": "https://explorer.binance.org/asset/TWT-8C2",
6
"type": "BEP2",
7
"symbol": "TWT",
8
"decimals": 8,
9
"status": "active",
10
"id": "TWT-8C2",
11
"links": [
12
{
13
"name": "github",
14
"url": "https://github.com/trustwallet/"
15
},
16
{
17
"name": "twitter",
18
"url": "https://twitter.com/TrustWalletApp"
19
},
20
{
21
"name": "reddit",
22
"url": "https://reddit.com/r/trustapp"
23
}
24
]
25
"tags": [
26
"governance"
27
]
28
}
Copied!
dApp image naming requirements
<subdomain>.<domain_name>.pnge.g: https://app.compound.finance/ =>app.compound.finance.pnghttps://kyberswap.com/ =>kyberswap.com.png
dApp submission and listing requirements
- Test dApp inside Trust Wallet on iOS and Android devices
Staking validators requirements
- 2.Add validator logo image to
blockchains/<chain>/validators/assets/<validator_address>/logo.pngsee images requirements - 3.
Common Uploads
- 1.
- 2.
- 3.
- 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
How To Add Files
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.
Basics, Prerequisites
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.
Adding files using Assets App
A new token can be submitted using the Assets application. See also: https://community.trustwallet.com/t/how-to-submit-a-token-logo-using-assets-app/82957
- 1.
- 2.Press the Log in with Github button. If not yet logged in (in the current browser session), you need to log in to Github
- 3.First time you will need to authorize the Assets app to access your Github account.
- 4.Upload the logo file.
- 5.Fill the token contract. For some tokens (ERC20) some fields are auto-filled (symbol, decimals, etc.).
- 6.Fill in additional fields, symbol, decimals, description, links, etc.
- 7.Press the Check button.
- 8.If all is OK, press the Create Pull Request button. A PR will be created.
Token Status
active - Token meets the standard requirements in circulation (number of holders and transactions).spam - Token that is distribtued to a large number of recepients that have no inherent value or has been verified as a dishonest scheme or fraud.abandoned - Token with very low activity (below 100 token transfers a year), migrated to mainnet or to a new contract.No longer active
Last modified 6d ago
Copy link