glamsterdam-compat-lab 0.3.3 → 0.3.4

package/README.md

@@ -8,7 +8,7 @@ This is community open-source tooling. It is not official Ethereum Foundation to
 
 ## Why this exists
 
-The Ethereum Foundation Ecosystem Support Program has a Glamsterdam-focused wishlist that calls out developer tooling, impact analysis, explorer/indexer support, validator tooling, monitoring tooling, and data-driven research. Glamsterdam planning currently includes scheduled work around Block-Level Access Lists and ePBS, plus considered work around gas repricing, native ETH transfer logs, contract-size changes, state creation costs, calldata costs, and related areas.
+The Ethereum Foundation Ecosystem Support Program has a Glamsterdam-focused wishlist that calls out developer tooling, impact analysis, explorer/indexer support, validator tooling, monitoring tooling, and data-driven research. Glamsterdam planning currently includes scheduled work around Block-Level Access Lists, ePBS, native ETH transfer logs, contract-size changes, calldata floor costs, access-list costs, state-creation gas, and related EVM changes, plus considered and proposed work tracked through the local EIP registry.
 
 The final Glamsterdam scope and exact parameters may change. This project keeps assumptions in a versioned EIP registry so detector behavior can be updated without rewriting every scanner.
 
@@ -36,14 +36,14 @@ pnpm glamsterdam scan-bytecode fixtures/bytecode/storage-heavy.hex
 Install the published CLI from npm:
 
 ```sh
-npm install -g glamsterdam-compat-lab@0.3.3
+npm install -g glamsterdam-compat-lab@0.3.4
 glamsterdam eips
 ```
 
-The v0.3.3 GitHub release tarball remains available as a reproducible release artifact:
+The v0.3.4 GitHub release tarball remains available as a reproducible release artifact:
 
 ```sh
-npm install -g https://github.com/CruzMolina/glamsterdam-compat-lab/releases/download/v0.3.3/glamsterdam-compat-lab-0.3.3.tgz
+npm install -g https://github.com/CruzMolina/glamsterdam-compat-lab/releases/download/v0.3.4/glamsterdam-compat-lab-0.3.4.tgz
 ```
 
 See [docs/release.md](docs/release.md) for maintainer release checks and npm publishing notes.
@@ -72,14 +72,19 @@ Each scanner accepts `--registry <path>` and `--thresholds <path>` so EIP metada
 
 ## Public dataset seed
 
-Fixture provenance lives in [fixtures/provenance.json](fixtures/provenance.json). The first deterministic dataset seed lives in [datasets/public-seed](datasets/public-seed) and includes generated JSON reports, default-vs-research threshold comparisons for bytecode and trace fixtures, a `summary.json` file with aggregate counts, and CSV exports (`reports.csv`, `findings.csv`, `summary.csv`) for spreadsheet and warehouse import.
+Fixture provenance lives in [fixtures/provenance.json](fixtures/provenance.json). The first deterministic dataset seed lives in [datasets/public-seed](datasets/public-seed) and includes generated JSON reports, default-vs-research threshold comparisons for bytecode and trace fixtures, a `summary.json` file with aggregate counts, `readiness.json` sourced from the EIP registry and client matrix, and CSV exports for spreadsheet and warehouse import.
+
+The static dataset browser lives at [site/public-seed/index.html](site/public-seed/index.html). It is generated entirely from committed dataset files and can be opened directly in a browser for summary charts, report filters, text search, per-report, per-comparison, per-finding, and readiness source detail pages, raw JSON links, and fixture/provenance links. Index filters are reflected in the URL so filtered views can be shared.
 
 See [docs/dataset.md](docs/dataset.md) for the dataset file contract and [examples/public-seed-analysis.md](examples/public-seed-analysis.md) for lightweight analysis snippets.
 
-Regenerate it with:
+Regenerate and verify it with:
 
 ```sh
 pnpm dataset:generate
+pnpm dataset:check
+pnpm site:generate
+pnpm site:check
 ```
 
 ## What the scanners can detect
@@ -133,7 +138,7 @@ Each scanner returns a `CompatibilityReport`:
 
 ```json
 {
-  "toolVersion": "0.3.3",
+  "toolVersion": "0.3.4",
   "fork": "glamsterdam",
   "target": {
     "kind": "bytecode",
@@ -221,7 +226,7 @@ Release publishing notes live in [docs/release.md](docs/release.md).
 
 ## Roadmap
 
-See [ROADMAP.md](ROADMAP.md) for planned phases. Phase 0 is released as `v0.1.0`; `v0.2.0` starts Phase 1 with RPC transaction trace ingestion and broader trace fixture coverage; `v0.3.0` adds baseline comparison reports; `v0.3.1` expands public-safe fixture and dataset coverage; `v0.3.2` adds packaged CSV dataset exports; `v0.3.3` adds additional public Geth and Reth trace fixture coverage.
+See [ROADMAP.md](ROADMAP.md) for planned phases. Phase 0 is released as `v0.1.0`; `v0.2.0` starts Phase 1 with RPC transaction trace ingestion and broader trace fixture coverage; `v0.3.0` adds baseline comparison reports; `v0.3.1` expands public-safe fixture and dataset coverage; `v0.3.2` adds packaged CSV dataset exports; `v0.3.3` adds additional public Geth and Reth trace fixture coverage; `v0.3.4` adds the static public-seed browser, detail/finding pages, and sourced readiness visibility exports.
 
 ## Disclaimer
 

package/ROADMAP.md

@@ -52,7 +52,7 @@ Goal: compare compatibility reports across profiles and, later, across current-c
 
 ## Phase 2: Public Dataset
 
-Status: seeded after `v0.3.0`; expanded with public-safe trace, indexer, and validator fixture coverage in `v0.3.1`; packaged CSV exports added in `v0.3.2`; additional public Geth and Reth trace fixtures added in `v0.3.3`.
+Status: seeded after `v0.3.0`; expanded with public-safe trace, indexer, and validator fixture coverage in `v0.3.1`; packaged CSV exports added in `v0.3.2`; additional public Geth and Reth trace fixture coverage added in `v0.3.3`; the static public-seed browser, detail/finding pages, and readiness exports are released in `v0.3.4`.
 
 Goal: publish reproducible compatibility research.
 
@@ -66,11 +66,14 @@ Goal: publish reproducible compatibility research.
 
 ## Phase 3: Devnet Integration
 
+Status: started in `v0.3.4` with sourced readiness exports and static readiness pages.
+
 Goal: track moving client and spec readiness without hardcoding guesses.
 
 - Ingest public devnet and client compatibility metadata
 - Track spec/client changes against registry entries
 - Expand validator/operator compatibility matrix workflows
+- Export source freshness, EIP status groupings, devnet participants, and matrix rows through the public dataset and static site
 
 ## Phase 4: Dashboard
 

package/data/client-compat/clients.example.json

@@ -1,6 +1,6 @@
 {
   "fork": "glamsterdam",
-  "lastUpdated": "2026-05-12",
+  "lastUpdated": "2026-05-13",
   "sources": [
     {
       "type": "public-interop-recap",
@@ -219,6 +219,40 @@
         }
       ]
     },
+    {
+      "name": "lodestar",
+      "role": "consensus",
+      "versions": [
+        {
+          "version": "ethpandaops/lodestar:glamsterdam-devnet-2",
+          "status": "partial",
+          "source": {
+            "type": "public-devnet-spec",
+            "url": "https://notes.ethereum.org/@ethpandaops/glamsterdam-devnet-2",
+            "retrievedAt": "2026-05-13",
+            "claim": "The glamsterdam-devnet-2 Kurtosis example lists lodestar with image ethpandaops/lodestar:glamsterdam-devnet-2 as a consensus-layer participant."
+          },
+          "notes": "Devnet image only. This is not a production Lodestar release compatibility claim."
+        }
+      ]
+    },
+    {
+      "name": "prysm",
+      "role": "consensus",
+      "versions": [
+        {
+          "version": "ethpandaops/prysm-beacon-chain:glamsterdam-devnet-3-minimal",
+          "status": "partial",
+          "source": {
+            "type": "public-devnet-spec",
+            "url": "https://notes.ethereum.org/@ethpandaops/glamsterdam-devnet-2",
+            "retrievedAt": "2026-05-13",
+            "claim": "The glamsterdam-devnet-2 Kurtosis example lists prysm with image ethpandaops/prysm-beacon-chain:glamsterdam-devnet-3-minimal as a consensus-layer participant."
+          },
+          "notes": "Devnet image only. This is not a production Prysm release compatibility claim."
+        }
+      ]
+    },
     {
       "name": "teku",
       "role": "consensus",
@@ -235,6 +269,40 @@
           "notes": "Devnet image only. This is not a production Teku release compatibility claim."
         }
       ]
+    },
+    {
+      "name": "nimbus",
+      "role": "consensus",
+      "versions": [
+        {
+          "version": "ethpandaops/nimbus-eth2:glamsterdam-devnet-2-minimal",
+          "status": "partial",
+          "source": {
+            "type": "public-devnet-spec",
+            "url": "https://notes.ethereum.org/@ethpandaops/glamsterdam-devnet-2",
+            "retrievedAt": "2026-05-13",
+            "claim": "The glamsterdam-devnet-2 Kurtosis example lists nimbus with image ethpandaops/nimbus-eth2:glamsterdam-devnet-2-minimal as a consensus-layer participant."
+          },
+          "notes": "Devnet image only. This is not a production Nimbus release compatibility claim."
+        }
+      ]
+    },
+    {
+      "name": "grandine",
+      "role": "consensus",
+      "versions": [
+        {
+          "version": "ethpandaops/grandine:glamsterdam-devnet-2-minimal",
+          "status": "partial",
+          "source": {
+            "type": "public-devnet-spec",
+            "url": "https://notes.ethereum.org/@ethpandaops/glamsterdam-devnet-2",
+            "retrievedAt": "2026-05-13",
+            "claim": "The glamsterdam-devnet-2 Kurtosis example lists grandine with image ethpandaops/grandine:glamsterdam-devnet-2-minimal as a consensus-layer participant."
+          },
+          "notes": "Devnet image only. This is not a production Grandine release compatibility claim."
+        }
+      ]
     }
   ],
   "devnets": [