ethereum-lists/chains
49.9
Weak · 13 November 2026
639
lines of production code
Kotlin
with JavaScript
7
measurements over time
What this system is
Features
Add HTTPS-based chain list loader
The httpsloader module now provides a function to fetch the list of supported chains from the remote https://chainid.network/chains.json endpoint. This enables users to load chain data over HTTPS using OkHttp and Moshi for JSON parsing, replacing or supplementing local/static sources with up-to-date remote information.
httpsloader · high confidence
Add chain data validation and cleanup tools
New utility scripts have been added to the tools directory to maintain data integrity for chain definitions. The schemaCheck.js tool validates that chain files conform to the defined JSON schema and ensures the filename matches the chain ID according to CAIP-2 standards. Additionally, rmNetwork.js is provided to remove the deprecated 'network' parameter from all chain files in the \_data/chains directory.
tools · high confidence
Added icon for QAZt75XixnEtFzqHTrJa8kJkV4ccXWaXqeMeqM8BcBomQc
A new SVG icon file has been added to the \_data/iconsDownload directory for the chain identified by the IPFS hash QAZt75XixnEtFzqHTrJa8kJkV4ccXWaXqeMeqM8BcBomQc. This addition ensures the chain is visually represented in the interface.
_\data/iconsDownload · high confidence
Initial repository structure and build tooling setup
This change establishes the foundational structure for the EVM-based chains data repository. It introduces the Gradle wrapper (gradlew/gradlew.bat) and configuration to handle data validation and aggregation tasks, alongside Prettier configuration for consistent JSON formatting. The repository is initialized with a comprehensive README detailing the CAIP-2 based chain data schema, constraints, and usage guidelines, along with a maintainer checklist to guide PR submissions. Additionally, it sets up a Jekyll-based website as a git submodule and configures build artifacts (like \_site and .gradle) to be ignored.
(repo-wide) · high confidence
Behavioural changes
New validation rules and icon handling for chain data
The processor now enforces stricter validation on chain data, including support for new fields like 'title', 'status', and 'redFlags' (specifically 'reusedChainId'), while deprecating the 'network' field. Icon handling has been updated to allow JPG formats, enforce a 250KB size limit (with a list of legacy CIDs exempted), and verify that icons are properly referenced and not unused. Additionally, the system now checks that explorer URLs return valid HTTP status codes (allowing 403s) and validates RPC schemas and connectivity.
processor/src/main/kotlin/org/ethereum/lists/chains · high confidence
Refactor chain data model with new fields and EIP-3091 explorer filtering
The chain model now includes optional title and native currency details, while the network field has been removed. Explorer data is now structured with a standard field, enabling automatic filtering to show only EIP-3091 compliant explorers by default.
model · high confidence
Validation logic for chain data is extracted into dedicated exception classes
The validation rules for chain metadata files are now enforced through a comprehensive set of specific exception types defined in the model layer. This change introduces strict checks for various data fields, including ensuring RPC URLs are valid lists of strings, explorer URLs start with http or https and return 2XX status codes, and native currency symbols are non-blank, untrimmed, and under 7 characters. It also adds validation for new or updated fields such as 'redFlags', 'faucets', 'parent' chain references, and a 'status' field (allowing incubating, active, or deprecated), while preventing invalid short names like '\*' and ensuring icon files are referenced.
processor/src/main/kotlin/org/ethereum/lists/chains/model · high confidence
Test coverage
Added invalid chain data fixtures for validation testing; Added validation tests for chain data integrity.
Dependencies
Initial dependency configuration for Kotlin and Node.js tooling
This change introduces the initial dependency manifests for the project, establishing the build environment for the Kotlin-based modules (processor, model, httpsloader) and the Node.js tooling. The Kotlin modules are configured with Kotlin 2.4.20, KEthereum 0.86.0, and various libraries including OkHttp, Moshi, Klaxon, and ImageIO. The Node.js tools directory adds \ajv\ (version 8.11.0) as a development dependency for JSON schema validation.
(dependencies) · high confidence
Update Gradle wrapper to version 9.7.1
The project's Gradle wrapper has been updated to use version 9.7.1. This change ensures that builds will automatically download and use this specific Gradle distribution, providing consistency across development and CI environments and leveraging any improvements or bug fixes included in this release.
gradle · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 44 → 50 (+6.1)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.
Lenses
- Code Health 70 → 67 (-3.4)
- Architecture 98 → 98 (+0.3)
- Maturity 52 → 52 (+0.0)
- Readiness 19 → 35 (+15.5)
- Security 85 → 76 (-9.2)
Resolved (3)
- Dependency hygiene PARTLY measured — Maven/Gradle declarations read, no dependency graph resolved
- No ADRs found
- Off-boarding risk: anonymized user #1
New (34)
- Dependency hygiene PARTLY measured — Gradle build resolved part of the dependency graph, currency reported but not scored
- No ADRs found (processor/build.gradle)
- Off-boarding risk: anonymized user #1
- Outdated (compile): com.google.auto.service:auto-service-annotations
- Outdated (compile): com.google.devtools.ksp:symbol-processing
- Outdated (compile): com.google.devtools.ksp:symbol-processing-api
- Outdated (compile): com.google.errorprone:error_prone_annotations
- Outdated (compile): com.google.guava:failureaccess
- Outdated (compile): com.google.guava:guava
- Outdated (compile): com.google.j2objc:j2objc-annotations
- Outdated (compile): com.squareup.moshi:moshi
- Outdated (compile): com.squareup.moshi:moshi-kotlin-codegen
- Outdated (compile): com.squareup.okhttp3:okhttp
- Outdated (compile): com.squareup.okio:okio
- Outdated (compile): com.squareup.okio:okio-jvm
- Outdated (compile): com.squareup:kotlinpoet
- Outdated (compile): com.squareup:kotlinpoet-ksp
- Outdated (compile): commons-logging:commons-logging
- Outdated (compile): org.checkerframework:checker-qual
- Outdated (compile): org.hamcrest:hamcrest-core
- …and 14 more
Changes since last survey
- 52 commits — 50 feature/other, 2 fixes
By area
- _data/chains — 47 commits
- .github/workflows — 2 commits
- .github/dependabot.yml — 1 commit
- gradle/wrapper — 1 commit
- processor/build.gradle — 1 commit
Notable commits
- fix: Fix Elysium explorer URLs (99901, 99801) (#9040)
- fix: Update chain 3666 metadata: rename to Jouleverse, fix RPC, add icon (#8925)
- change: Add 16ane Sepolia Testnet (164632) and 16ane Mainnet (16463) as incubating (#8937)
- change: Add BlueChain (chainId 2583) (#8940)
- change: Add BrainChain (274663) and BrainChain Testnet (274630) (#8930)
- change: Add Codex Scan explorer to Arbitrum One (42161) (#8988)
- change: Add Codex Scan explorer to Avalanche C-Chain (43114) (#8991)
- change: Add Codex Scan explorer to BNB Smart Chain Mainnet (56) (#8944)
- change: Add Codex Scan explorer to Base (8453) (#8943)
- change: Add Codex Scan explorer to Ethereum Mainnet (1) (#8942)
- change: Add Codex Scan explorer to OP Mainnet (10) (#8989)
- change: Add Codex Scan explorer to Polygon Mainnet (137) (#8990)
- change: Add Codex Scan explorer to Robinhood Chain (4663) (#8987)
- change: Add Elysium mainnet (99901) and testnet (99801) (#9027)
- change: Add Eoraptor (chainId 2679) (#8920)
- change: Add Gully Chain Testnet (485590) (#8928)
- change: Add INKG Sovereign EVM (chainId 777001) (#8932)
- change: Add Liberium chain ID 767366 as incubating (#8921)
- change: Add OneX Smart Chain (5559) and OneX Smart Chain Testnet (5775) (#8931)
- change: Add Ostia DevNet (770101) (#8924)
- …and 32 more
Architecture
- Unchanged — 0 containers · 1 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
ethereum-lists/chains was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 5720ba15ecb583221b67b2273dd2535f80c54882 — the exact code this score is about.
- Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.63+preprod-4a8cc97a9484.