2019-08-12 05:30:33 +00:00
# Trust Wallet Assets Info
2019-11-08 20:16:54 +00:00
2020-09-10 19:39:29 +00:00
2020-02-04 08:54:44 +00:00
2019-08-12 05:30:33 +00:00
## Overview
2020-08-18 11:51:54 +00:00
Trust Wallet token repository is a comprehensive, up-to-date collection of information about several thousands (!) of crypto tokens.
2019-08-12 05:30:33 +00:00
2020-08-18 11:51:54 +00:00
[Trust Wallet ](https://trustwallet.com ) uses token logos from this source, alongside a number of other projects.
2019-08-12 05:30:33 +00:00
2020-08-18 11:51:54 +00:00
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).
2019-08-12 05:30:33 +00:00
2020-08-18 11:51:54 +00:00
Such a large collection can be maintained only through a community effort, so _contributions are welcome_ ,
primarily from token projects.
2019-08-12 05:30:33 +00:00
2020-09-16 10:53:28 +00:00
Please note that __new tokens are not accepted__ ,
the projects have to be sound, with information available, and __non-minimal circulation__
2020-12-04 10:03:31 +00:00
(for limit details see https://community.trustwallet.com/t/how-to-submit-a-token-logo/3863).
2020-09-16 10:53:28 +00:00
2019-08-20 06:05:58 +00:00
< center > < img src = 'https://raw.githubusercontent.com/trustwallet/assets/master/media/trust-wallet.png' > < / center >
2019-08-12 05:30:33 +00:00
2020-09-18 12:14:01 +00:00
## How to add token
2020-02-04 08:54:44 +00:00
2020-08-18 11:51:54 +00:00
Details of the repository structure and contribution guidelines are listed on the
[Developers site ](https://developer.trustwallet.com/add_new_asset ).
Here is a quick starter summary for the most common use case.
2019-08-12 05:30:33 +00:00
2020-09-18 12:14:01 +00:00
**Adding an ERC20 token checklist**:
2020-11-02 06:35:16 +00:00
- [ ] Make sure your smartcontract has more than 2,500 address holders, otherwise you will be rejected
2020-09-18 12:14:01 +00:00
- [ ] Fork the Github repository
- [ ] Create folder with name of token smartcontact address in [_checksum format_ ](https://developer.trustwallet.com/add_new_asset#checksum_format ) `blockchains/ethereum/assets/<token_smartcontract_address>/` .
2021-02-02 06:32:27 +00:00
- [ ] Tell your designer that token image must be in PNG format, avoid transparent background, recommended size 256x256px, max. 512x512px, with max file size of 100kB, for further details read [image rules ](https://developer.trustwallet.com/add_new_asset#image-requirements ).
2020-09-18 12:14:01 +00:00
- [ ] Upload your logo with file named `logo.png` to previously created folder with smartcontract address, and if you done all correctly your path should look like this. `blockchains/ethereum/assets/0x1234567461d3f8Db7496581774Bd869C83D51c93/logo.png`
- [ ] Create a pull request to the main repo
- [ ] Pay the processing fee
2019-08-12 05:30:33 +00:00
2020-08-18 11:51:54 +00:00
## Documentation
2019-08-12 05:30:33 +00:00
2020-08-18 11:51:54 +00:00
For details, see the [Developers site ](https://developer.trustwallet.com/add_new_asset ):
2019-08-12 05:30:33 +00:00
2020-08-18 11:51:54 +00:00
- [Contribution guidelines ](https://developer.trustwallet.com/add_new_asset#contribution-guidelines )
2019-11-08 18:55:41 +00:00
2020-08-18 11:51:54 +00:00
- [Repository details ](https://developer.trustwallet.com/add_new_asset#repository-details )
2020-06-21 06:21:50 +00:00
2021-02-02 15:18:00 +00:00
## Scripts
There are several scripts available for maintainers:
- `npm run check` -- Execute validation checks; also used in continuous integration.
- `npm run check-sanity` -- Strict subset of checks
- `npm run fix` -- Perform automatic fixes where possible
- `npm run fix-sanity` -- Stricter subset
- `npm run updateAuto` -- Run automatic updates from external sources, executed regularly (GitHub action)
- `npm run update` -- Run manual updates from external sources, for manual use.
- `npm test` -- Run script unit tests
- `npm lint` -- Run Lint static code check
## Trading pair maintenance
Info on supported trading pairs are stored in `tokenlist.json` files.
Trading pairs can be updated --
from Uniswap/Ethereum and Panckaswap/Smartchain -- using update script (and checking in changes).
Minimal limit values for trading pair inclusion are set in the `config.ts` file.
There are also options for force-include and force-exclude in the config.
2020-06-21 06:21:50 +00:00
## Disclaimer
2020-08-18 11:51:54 +00:00
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.
2020-06-21 06:21:50 +00:00
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.
