https://github.com/scroll-tech/token-list
Scroll Token List
https://github.com/scroll-tech/token-list
Last synced: 9 months ago
JSON representation
Scroll Token List
- Host: GitHub
- URL: https://github.com/scroll-tech/token-list
- Owner: scroll-tech
- License: mit
- Created: 2022-12-08T02:13:37.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T15:03:36.000Z (about 1 year ago)
- Last Synced: 2025-03-28T16:08:22.127Z (10 months ago)
- Language: JavaScript
- Homepage:
- Size: 680 KB
- Stars: 105
- Watchers: 16
- Forks: 63
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Scroll Token List
The Scroll Token List serves as a source of truth for services such as the Scroll Bridge UI.
## Adding a token to the list
### Create a folder for your token
Create a folder inside the [data folder](https://github.com/scroll-tech/token-list/tree/main/data) with the same name as the symbol of the token you are trying to add. For example, if you are adding a token with the symbol "ETH" you must create a folder called ETH.
### Add a logo to your folder
Add a logo to the data folder you just created. Your logo MUST be an SVG called `logo.svg`. Your logo should be at least 200x200 pt minimum and 256x256 pt preferred.
### Create a data file
Add a file to your folder called `data.json` with the following format:
```json
{
"name": "Token Name",
"symbol": "SYMBOL",
"decimals": 18,
"description": "A multi-chain token",
"website": "https://token.com",
"twitter": "@token",
"tokens": {
"ethereum": {
"address": "0x1234123412341234123412341234123412341234"
},
"scroll": {
"address": "0x2345234523452345234523452345234523452345"
},
"sepolia": {
"address": "0x5678567856785678567856785678567856785678"
},
"scroll-sepolia": {
"address": "0x6789678967896789678967896789678967896789"
}
}
}
```
You can use the `getL2ERC20Address` method in [L1GatewayRouter.sol](https://github.com/scroll-tech/scroll/blob/develop/contracts/src/L1/gateways/L1GatewayRouter.sol) to get your L2 address.
### Create a pull request
Open a [pull request](https://github.com/scroll-tech/token-list/pulls) targeting `main` branch with the changes that you've made. Please only add one token per pull request to simplify the review process. This means two new files inside one new folder. If you want to add multiple tokens, please open different PRs for each token.