@kumbaya_xyz/default-token-list 1.1.0 → 1.1.2

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 CHANGED
@@ -6,12 +6,49 @@ This NPM module and GitHub repo contains the default token list used in the Kumb
6
6
 
7
7
  ## Adding a token
8
8
 
9
- To request that we add a token to the list,
10
- [file an issue](https://github.com/kumbaya-xyz/default-token-list/issues/new?assignees=&labels=token+request&template=token-request.md&title=Add+%7BTOKEN_SYMBOL%7D%3A+%7BTOKEN_NAME%7D).
9
+ The preferred way to request a token listing is to **open a pull request** against this repository. The Kumbaya team will review and verify the submission before merging.
11
10
 
12
- ### Disclaimer
11
+ If you can't open a PR, you can [file an issue](https://github.com/Kumbaya-xyz/default-token-list/issues/new?assignees=&labels=token+request&template=token-request.md&title=Add+%7BTOKEN_SYMBOL%7D%3A+%7BTOKEN_NAME%7D) instead — but issues take longer to triage and the same validation criteria apply.
13
12
 
14
- Note filing an issue does not guarantee addition to this default token list.
15
- We do not review token addition requests in any particular order, and we do not
16
- guarantee that we will review your request to add the token to the default list.
13
+ ### What to include in your PR
14
+
15
+ **1. Logo image** add a PNG to `src/assets/<chainId>/`
16
+
17
+ - Filename must be the **checksummed contract address** (e.g. `0x021ee124cF23D302A7f725AE7a01B77A8ce9782B.png`)
18
+ - Resolution: **500x500 pixels**
19
+ - Format: **PNG** with transparent background preferred
20
+ - Reasonable file size (ideally under 100KB)
21
+
22
+ **2. Token entry** — add an object to the relevant chain file in `src/tokens/`
23
+
24
+ - MegaETH Mainnet (chainId `4326`): `src/tokens/megaeth.json`
25
+ - MegaETH Testnet (chainId `6343`): `src/tokens/megaeth-testnet.json`
26
+
27
+ Use this template:
28
+
29
+ ```json
30
+ {
31
+ "chainId": 4326,
32
+ "address": "0x...",
33
+ "name": "",
34
+ "symbol": "",
35
+ "decimals": 18,
36
+ "logoURI": "https://raw.githubusercontent.com/Kumbaya-xyz/default-token-list/refs/heads/main/src/assets/4326/0x....png"
37
+ }
38
+ ```
39
+
40
+ The `address` and the filename in `logoURI` must both use the **checksummed** form of the contract address.
41
+
42
+ ### Validation criteria
43
+
44
+ The full review criteria are not published, but at a minimum a token is expected to:
45
+
46
+ - Be deployed and verified on the target chain (source code visible on the block explorer)
47
+ - Have a unique, non-misleading `name` and `symbol` (no impersonation of existing tokens or projects)
48
+ - Have non-trivial on-chain liquidity and a reasonable trading history
49
+ - Use a standard ERC-20 implementation without unusual transfer hooks, blacklists, mint authorities, or other behaviour that could harm users (any non-standard behaviour must be clearly disclosed in the PR description)
50
+ - Have a public-facing presence: working website, active social channels, or other verifiable project information
51
+ - Provide a logo that the project owner has the rights to distribute
52
+
53
+ PRs that do not meet these expectations may be closed without merging. Submitting a PR does not guarantee inclusion, and inclusion in this list is not an endorsement — users should always do their own research.
17
54
 
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "Kumbaya Default",
3
- "timestamp": "2026-02-19T18:40:21.825Z",
3
+ "timestamp": "2026-04-28T01:34:50.529Z",
4
4
  "version": {
5
5
  "major": 1,
6
6
  "minor": 1,
7
- "patch": 0
7
+ "patch": 2
8
8
  },
9
9
  "tags": {},
10
10
  "logoURI": "https://raw.githubusercontent.com/Kumbaya-xyz/default-token-list/refs/heads/main/src/icon/kumbaya-256.png",
@@ -53,6 +53,14 @@
53
53
  "decimals": 18,
54
54
  "logoURI": "https://raw.githubusercontent.com/Kumbaya-xyz/default-token-list/refs/heads/main/src/assets/4326/0x551DFe38994eC53c9E7E18084D73893225Eea3bf.png"
55
55
  },
56
+ {
57
+ "chainId": 4326,
58
+ "address": "0x28B7E77f82B25B95953825F1E3eA0E36c1c29861",
59
+ "name": "MEGA",
60
+ "symbol": "MEGA",
61
+ "decimals": 18,
62
+ "logoURI": "https://raw.githubusercontent.com/Kumbaya-xyz/default-token-list/refs/heads/main/src/assets/4326/0x28B7E77f82B25B95953825F1E3eA0E36c1c29861.png"
63
+ },
56
64
  {
57
65
  "chainId": 4326,
58
66
  "address": "0x9367A0c482703d8d9bda995B03f8E71056a72500",
@@ -77,6 +85,14 @@
77
85
  "decimals": 18,
78
86
  "logoURI": "https://raw.githubusercontent.com/Kumbaya-xyz/default-token-list/refs/heads/main/src/assets/4326/0x88887bE419578051FF9F4eb6C858A951921D8888.png"
79
87
  },
88
+ {
89
+ "chainId": 4326,
90
+ "address": "0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34",
91
+ "name": "USDe",
92
+ "symbol": "USDe",
93
+ "decimals": 18,
94
+ "logoURI": "https://raw.githubusercontent.com/Kumbaya-xyz/default-token-list/refs/heads/main/src/assets/4326/0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34.png"
95
+ },
80
96
  {
81
97
  "chainId": 4326,
82
98
  "address": "0xFAfDdbb3FC7688494971a79cc65DCa3EF82079E7",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kumbaya_xyz/default-token-list",
3
- "version": "1.1.0",
3
+ "version": "1.1.2",
4
4
  "description": "The Kumbaya default token list",
5
5
  "type": "module",
6
6
  "main": "build/index.js",