Merge

.github/workflows/action_lint.yml

@@ -0,0 +1,10 @@
+name: Github-Action linter
+on:
+  pull_request:
+  merge_group:
+jobs:
+  actionlint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4.2.2
+      - uses: reviewdog/action-actionlint@v1

.github/workflows/build.yml

@@ -0,0 +1,27 @@
+name: Build
+on:
+  pull_request:
+  merge_group:
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4.2.2
+        with:
+          submodules: recursive
+
+      - name: Get changed files
+        id: changed-files
+        uses: step-security/changed-files@v45.0.1
+
+      - name: Check changed files
+        run: |
+          for file in ${{ steps.changed-files.outputs.all_changed_files }}; do
+            ./gradlew clean run --args="verbose singleChainCheck $file"
+          done
+
+      - name: Build
+        run: |
+          ./gradlew run
+

.github/workflows/deploy.yml

@@ -0,0 +1,37 @@
+name: Build
+on:
+  push:
+    branches: [ master ]
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout	
+        uses: actions/checkout@v4.2.2
+        with:
+          submodules: recursive
+      - name: Build
+        run: |
+          ./gradlew run
+      - name: Set Node.js 18.x
+        uses: actions/setup-node@v4.2.0
+        with:
+          node-version: 18.x
+      - name: Run yarn install
+        uses: borales/actions-yarn@v4
+        with:
+         dir: 'website'
+         cmd: install # will run `yarn install` command
+      - name: Run yarn build
+        uses: borales/actions-yarn@v4
+        with:
+          dir: 'website'
+          cmd: run build # will run `yarn test` command     
+      - name: Merge
+        run: |
+          cp -a output/. website/public/
+      - name: Deploy
+        uses: JamesIves/github-pages-deploy-action@4.1.4
+        with:
+          branch: gh-pages
+          folder: website/public

.github/workflows/post_merge_comment.yml

@@ -0,0 +1,15 @@
+on:
+  pull_request_target:
+    types: [closed]
+jobs:
+  comment_on_merged_pr:
+    if: github.event.pull_request.merged
+    runs-on: ubuntu-latest
+    name: Comment after PR merge
+    steps:
+      - name: Comment PR
+        uses: thollander/actions-comment-pull-request@v2
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          message: |
+            PR merged - please consider contributing some funds to lists.eth

.github/workflows/pr_intro_comment.yml

@@ -0,0 +1,14 @@
+on:
+  pull_request_target:
+    types: [opened]
+jobs:
+  comment_on_pr:
+    runs-on: ubuntu-latest
+    name: Comment after PR is submitted
+    steps:
+      - name: Comment PR
+        uses: thollander/actions-comment-pull-request@v2
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          message: |
+            You successfully submitted a PR! Due to the amount of PRs coming in: we will only look at PRs that the CI is happy with. We can also not hold your hand getting the CI green - just look how others that where merged did it and RTFM. So as long as there is any CI check that reports an error - no human will look at this. You might be able to ask for some support after supporting the project - e.g. by sending funds to lists.eth. When you fixed things after a requested change - then you also need to (re-)request a review.

.github/workflows/prettier_check.yml

@@ -0,0 +1,23 @@
+name: Run prettier check
+
+on:
+  push:
+  pull_request:
+  merge_group:
+
+jobs:
+  prettier:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repo
+        uses: actions/checkout@v4.2.2
+      - uses: actions/cache@v4
+        name: Configure npm caching
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-npm-${{ hashFiles('**/workflows/prettier.yml') }}
+          restore-keys: |
+            ${{ runner.os }}-npm-
+      - name: Run prettier
+        run: |-
+          npx prettier --check '_data/*/*.json'

.github/workflows/validate_json.yml

@@ -0,0 +1,25 @@
+name: Check JSON Schema
+
+on:
+  push:
+  pull_request:
+  merge_group:
+
+jobs:
+  validate_json:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Check out repo
+      uses: actions/checkout@v4.2.2
+    - uses: actions/cache@v4
+      name: Configure npm caching
+      with:
+        path: ~/.npm
+        key: ${{ runner.os }}-npm-${{ hashFiles('**/workflows/validate_json.yml') }}
+        restore-keys: |
+          ${{ runner.os }}-npm-
+    - name: Run JSON Validation
+      working-directory: ./tools
+      run: |-
+        npm install
+        node schemaCheck.js

.gitignore

@@ -5,3 +5,11 @@ _site
 .env
 node_modules
 .idea
+output
+.gradle
+model/bin
+model/build
+processor/bin
+processor/build
+httpsloader/build
+httpsloader/bin

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "website"]
+	path = website
+	url = https://github.com/FrederikBolding/chainlist.git

.jitpack.yml

@@ -0,0 +1 @@
+jdk: openjdk11

.prettierignore

@@ -0,0 +1,7 @@
+# Using Prettier for JSON files only in _data
+
+# Command to format all existing JSON files
+# npx prettier --write --ignore-unknown _data
+
+model
+processor

.prettierrc.json

@@ -0,0 +1,6 @@
+{
+    "trailingComma": "es5",
+    "tabWidth": 2,
+    "semi": false,
+    "singleQuote": false
+}

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2018 
+Copyright (c) 2026
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,14 +1,13 @@
 # EVM-based Chains
 
-The source data is in _data/chains. Each chain has its own file with the filename being the [CAIP-2](https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-2.md) representation as name and `.json` ans extension.
+The source data is in _data/chains. Each chain has its own file with the filename being the [CAIP-2](https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-2.md) representation as name and `.json` as extension.
 
-## Example
+## Example:
 
 ```json
 {
   "name": "Ethereum Mainnet",
   "chain": "ETH",
-  "network": "mainnet",
   "rpc": [
     "https://mainnet.infura.io/v3/${INFURA_API_KEY}",
     "https://api.mycryptoapi.com/eth"
@@ -19,6 +18,7 @@ The source data is in _data/chains. Each chain has its own file with the filenam
     "symbol": "ETH",
     "decimals": 18
   },
+  "features": [{ "name": "EIP155" }, { "name": "EIP1559" }],
   "infoURL": "https://ethereum.org",
   "shortName": "eth",
   "chainId": 1,
@@ -33,7 +33,8 @@ The source data is in _data/chains. Each chain has its own file with the filenam
 }
 ```
 
-when an icon is used in either the network or a explorer there must be a json in _data/icons with the name used (e.g. in the above example there must be a `ethereum.json` and a `etherscan.json` in there) - the icon jsons look like this:
+When an icon is used in either the network or an explorer, there must be a JSON in _data/icons with the name used.
+(e.g. in the above example there must be a `ethereum.json` and a `etherscan.json` in there) - The icon JSON files look like this:
 
 ```json
 
@@ -49,9 +50,10 @@ when an icon is used in either the network or a explorer there must be a json in
 ```
 
 where:
- * the URL must be a IPFS url that is publicly resolveable
- * width and height are optional - but when one is there then the other must be there also
+ * The URL MUST be publicly resolvable through IPFS
+ * width and height MUST be positive integers
  * format is either "png", "jpg" or "svg"
+ * size MUST be less than 250kb
 
 If the chain is an L2 or a shard of another chain you can link it to the parent chain like this:
 
@@ -67,9 +69,9 @@ If the chain is an L2 or a shard of another chain you can link it to the parent
 }
 ```
 
-where you need to specify type 2 and the reference to an existing parent. The field about bridges is optional.
+where you need to specify the type and the reference to an existing parent. The field about bridges is optional.
 
-You can add a `status` field e.g. to `deprecate` a chain (a chain should never be deleted as this would open the door to replay attacks)
+You can add a `status` field e.g. to deprecate (via status `deprecated`) a chain (a chain should never be deleted as this would open the door to replay attacks)
 Other options for `status` are `active` (default) or `incubating`
 
 ## Aggregation
@@ -78,45 +80,78 @@ There are also aggregated json files with all chains automatically assembled:
  * https://chainid.network/chains.json
  * https://chainid.network/chains_mini.json (miniaturized - fewer fields for smaller filesize)
 
+## Constraints
+
+ * the shortName and name MUST be unique - see e.g. EIP-3770 on why
+ * if referencing a parent chain - the chain MUST exist in the repo
+ * if using an IPFS CID for the icon - the CID MUST be retrievable via `ipfs get` - not only through some gateway (means please do not use pinata for now)
+ * for more constraints you can look into the CI
+
 ## Collision management
 
- If different chains have the same chainID we list the one with the oldest genesis.
+ We cannot allow more than one chain with the same chainID - this would open the door to replay attacks.
+ The first pull request gets the chainID assigned. When creating a chain we can expect that you read EIP155 which states this repo.
+ All pull requests trying to replace a chainID because they think their chain is better than the other will be closed.
+ The only way to get a chain reassigned is when the old chain gets deprecated. This can e.g. be used for testnets that are short-lived. But then you will get the redFlag "reusedChainID" that should be displayed in clients to warn them about the dangers here.
+
+## Getting your PR merged
+### before PR is submitted
+
+Before submitting a PR, please ensure all checks pass by running:
+
+```bash
+$ ./gradlew run
+
+BUILD SUCCESSFUL in 7s
+9 actionable tasks: 9 executed
+```
+
+Additionally, run Prettier to format your JSON according to the style [defined here ](https://github.com/ethereum-lists/chains/blob/master/.prettierrc.json)
+e.g. run
+
+```
+npx prettier --write _data/*/*.json
+```
+
+### Once PR is submitted
+
+ * Make sure CI is green. There will likely be no review when the CI is red.
+ * When making changes that fix the CI problems - please re-request a review - otherwise it is too much work to track such changes with so many PRs daily
 
 ## Usages
-### Wallets
- * [WallETH](https://walleth.org)
- * [TREZOR](https://trezor.io)
+### Tools
+ * [MESC](https://paradigmxyz.github.io/mesc)
 
 ### Explorers
  * [Otterscan](https://otterscan.io)
 
+### Wallets
+ * [WallETH](https://walleth.org)
+ * [TREZOR](https://trezor.io)
+ * [Minerva Wallet](https://minerva.digital)
+
 ### EIPs
  * EIP-155
  * EIP-3014
  * EIP-3770
  * EIP-4527
 
-### Listing sites 
- * [chainlist.org](https://chainlist.org) or [networklist-org.vercel.app](https://networklist-org.vercel.app) as a staging version with a more up-to-date list
- * [chainid.network](https://chainid.network)
- * [networks.vercel.app](https://networks.vercel.app)
+### Listing sites
+ * [chainid.network](https://chainid.network) / [chainlist.wtf](https://chainlist.wtf)
+ * [chainlist.org](https://chainlist.org)
+ * [Chainlink docs](https://docs.chain.link/)
+ * [dRPC Chainlist - Load-balanced public nodes](https://drpc.org/chainlist)
  * [eth-chains](https://github.com/taylorjdawson/eth-chains)
  * [EVM-BOX](https://github.com/izayl/evm-box)
- * [chaindirectory.xyz](https://www.chaindirectory.xyz)
- * [chain-list.org](https://chain-list.org)
- * [DefiLlama's chainlist](https://chainlist.defillama.com/)
- * [chainlist.network](https://chainlist.network/)
+ * [evmchain.info](https://evmchain.info)
  * [evmchainlist.org](https://evmchainlist.org)
- * [evmchainlist.com](https://evmchainlist.com)
- * [thechainlist.io](https://thechainlist.io)
- * [chainlist.info](https://chainlist.info)
- * [chainmap.io](https://chainmap.io) 
- * [chainlist.in](https://www.chainlist.in)
- * [chainz.me](https://chainz.me)
+ * [networks.vercel.app](https://networks.vercel.app)
+ * [Wagmi compatible chain configurations](https://spenhouet.com/chains)
+ * [chainlist.simplr.sh - Info packaged single pager](https://chainlist.simplr.sh)
 
 ### Other
  * [FaucETH](https://github.com/komputing/FaucETH)
  * [Sourcify playground](https://playground.sourcify.dev)
-
+ * [Smart Contract UI](https://xtools-at.github.io/smartcontract-ui)
 
  * Your project - contact us to add it here!