@eth-optimism/tokenlist 6.3.25 → 6.3.27
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -14
- package/dist/index.d.ts +1 -1
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +2 -2
- package/dist/index.mjs.map +1 -1
- package/dist/{optimism.tokenlist-59b26487.d.ts → optimism.tokenlist-81d47c4f.d.ts} +2 -2
- package/dist/optimism.tokenlist.d.ts +1 -1
- package/dist/optimism.tokenlist.js +2 -2
- package/dist/optimism.tokenlist.js.map +1 -1
- package/dist/optimism.tokenlist.mjs +2 -2
- package/dist/optimism.tokenlist.mjs.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,15 +1,14 @@
|
|
|
1
1
|
# Superchain Token List
|
|
2
2
|
|
|
3
|
-
The Superchain token list is used as the source of truth for the [Optimism bridge UI](https://app.optimism.io/bridge) and [Base bridge UI
|
|
3
|
+
The Superchain token list is used as the source of truth for the [Optimism bridge UI](https://app.optimism.io/bridge) and [Base bridge UI](https://bridge.base.org/deposit) which are the main portals for moving assets between Layer 1 and Layer 2.
|
|
4
4
|
|
|
5
5
|
## Review process and merge criteria
|
|
6
6
|
|
|
7
7
|
### Process overview
|
|
8
8
|
|
|
9
9
|
1. Follow the instructions below to create a PR that would [add your token to the list](#adding-a-token-to-the-list).
|
|
10
|
-
2.
|
|
11
|
-
3.
|
|
12
|
-
4. Wait for final approval.
|
|
10
|
+
2. Wait for a reviewer to kick off the [automated checks](#automated-checks).
|
|
11
|
+
3. After the automated checks pass and a reviewer approves the PR, then it will automatically be merged.
|
|
13
12
|
|
|
14
13
|
**Note:** The standard bridge does *not* support certain ERC-20 configurations:
|
|
15
14
|
|
|
@@ -18,27 +17,37 @@ The Superchain token list is used as the source of truth for the [Optimism bridg
|
|
|
18
17
|
|
|
19
18
|
### Automated checks
|
|
20
19
|
|
|
21
|
-
Note that if your token was grandfathered in before the validation was added, your token may fail validation when you edit it. If this is the case you need to add additional fields that were since added such as website field.
|
|
22
|
-
|
|
23
20
|
Our CI performs a series of automated checks on every PR.
|
|
24
|
-
|
|
21
|
+
These automated checks take place as part of the `Validate PR` check.
|
|
22
|
+
Some issues raised by CI will trigger an error and must be resolved before your PR will be approved.
|
|
25
23
|
These issues are marked below as "auto-reject" issues.
|
|
26
|
-
Other issues will
|
|
24
|
+
Other issues will surface a warning, and will require a manual review from a reviewer.
|
|
27
25
|
These issues are marked below as "requires manual review".
|
|
28
26
|
|
|
29
27
|
- Given tokens actually exist on all specified chains (auto-reject)
|
|
30
28
|
- L1 tokens are verified on Etherscan (auto-reject)
|
|
31
|
-
- Description
|
|
32
|
-
- Website exists and loads properly (auto-reject)
|
|
29
|
+
- Description is under 1000 characters (auto-reject)
|
|
33
30
|
- Token `name`, `symbol`, and `decimals` matches on-chain data (auto-reject)
|
|
34
31
|
- If `overrides` are used (requires manual review)
|
|
35
|
-
- L2 token was deployed by the StandardTokenFactory (requires manual review)
|
|
36
|
-
- Ethereum token listed on the [CoinGecko Token List](https://tokenlists.org/token-list?url=https://tokens.coingecko.com/uniswap/all.json)
|
|
32
|
+
- L2 token was deployed by the [StandardTokenFactory](https://github.com/ethereum-optimism/optimism/blob/develop/packages/contracts/contracts/L2/messaging/L2StandardTokenFactory.sol) or is an [L2StandardERC20](https://github.com/ethereum-optimism/optimism/blob/develop/packages/contracts/contracts/standards/L2StandardERC20.sol) token that uses the standard L2 bridge address (`0x4200000000000000000000000000000000000010`) (requires manual review)
|
|
33
|
+
- Ethereum token listed on the [CoinGecko Token List](https://tokenlists.org/token-list?url=https://tokens.coingecko.com/uniswap/all.json)(requires manual review)
|
|
37
34
|
- *Why CoinGecko? CoinGecko's token list updates every hour which means we get token list updates very quickly. CoinGecko also uses an in-depth [listing criteria](https://www.coingecko.com/en/methodology).*
|
|
38
35
|
|
|
36
|
+
#### Debugging Automated checks failures
|
|
37
|
+
If your automated checks failed, you can see the reason for the failure by downloading `validation-artifacts.zip`, unzipping it and opening the `validation_results.txt` file. To locate the `validation-artifacts` follow these steps:
|
|
38
|
+
|
|
39
|
+
1. Click on the `Details` link for `Validate PR` check in your PR
|
|
40
|
+
2. Click `Summary` in the left panel
|
|
41
|
+
3. Find the section on the page labeled `Artifacts` and click on `validation-artifacts`
|
|
42
|
+
4. After download of `validation-artifacts.zip`, unzip it and open `validation_results.txt`
|
|
43
|
+
|
|
44
|
+
If you make changes and need to run the validation check again, you will need to wait for a reviewer to approve the checks to run again. However, if you do not want to wait for a reviewer to approve the checks to run again to see if the failures have been resolved, you can run the validation checks locally by running:
|
|
45
|
+
```
|
|
46
|
+
npx tsx ./bin/cli.ts validate --datadir ./data --tokens <data folder name (e.g. ETH)>
|
|
47
|
+
```
|
|
39
48
|
### Final approval
|
|
40
49
|
|
|
41
|
-
All PRs are subject to a light-weight final approval, even if not marked as `requires manual review`.
|
|
50
|
+
All PRs are subject to a light-weight final approval, even if not marked as `requires manual review`. If you are adding a token to a `Base` chain (e.g. `base-goerli`) please add [@roberto-bayardo](https://github.com/roberto-bayardo) as a reviewer.
|
|
42
51
|
|
|
43
52
|
## Adding a token to the list
|
|
44
53
|
|
|
@@ -168,4 +177,4 @@ Your pull request will be validated by a series of automated checks. If one of t
|
|
|
168
177
|
|
|
169
178
|
### Wait for the token list to update automatically
|
|
170
179
|
|
|
171
|
-
Once your PR is merged, the token list will update automatically to include your token. Please do NOT update the token list directly. All token list updates will be handled automatically when PRs are merged into the `master` branch.
|
|
180
|
+
Once your PR is merged, the token list will update automatically to include your token. Please do NOT update the token list (`optimism.tokenlist.json`) directly. All token list updates will be handled automatically when PRs are merged into the `master` branch.
|
package/dist/index.d.ts
CHANGED
package/dist/index.js
CHANGED
|
@@ -41,7 +41,7 @@ var keywords = [
|
|
|
41
41
|
"layer2",
|
|
42
42
|
"infrastructure"
|
|
43
43
|
];
|
|
44
|
-
var timestamp = "2023-04-
|
|
44
|
+
var timestamp = "2023-04-12T19:10:57.968Z";
|
|
45
45
|
var tokens = [
|
|
46
46
|
{
|
|
47
47
|
chainId: 1,
|
|
@@ -2606,7 +2606,7 @@ var tokens = [
|
|
|
2606
2606
|
var version = {
|
|
2607
2607
|
major: 6,
|
|
2608
2608
|
minor: 3,
|
|
2609
|
-
patch:
|
|
2609
|
+
patch: 27
|
|
2610
2610
|
};
|
|
2611
2611
|
var optimism_tokenlist_default = {
|
|
2612
2612
|
name,
|