ethereumjs · holgerd77 · Mar 24, 2025 · Feb 26, 2025 · Mar 1, 2025 · Mar 8, 2025
diff --git a/package-lock.json b/package-lock.json
diff --git a/packages/binarytree/CHANGELOG.md b/packages/binarytree/CHANGELOG.md
@@ -6,6 +6,14 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 (modification: no type change headlines) and this project adheres to
 [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
-## 0.0.1 - 2025-01-30
+## 10.0.0-rc.1 - [ UNPUBLISHED ]
 
-- Initial development release
+This is the first (and likely the last) round of `RC` releases for the upcoming breaking releases, following the `alpha` releases from October 2024. The releases are somewhat delayed (sorry for that), but final releases can now be expected very very soon, to be released once the Ethereum [Pectra](https://eips.ethereum.org/EIPS/eip-7600) hardfork is scheduled for mainnet and all EIPs are fully finalized. Pectra will then also be the default hardfork setting for all EthereumJS libraries.
+
+### New Versioning Scheme
+
+This breaking release round will come with a new versioning scheme (thanks to @paulmillr for the [suggestion](https://github.com/ethereumjs/ethereumjs-monorepo/issues/3748)), aligning the package numbers on breaking releases for all EthereumJS packages. This will make it easier to report bugs ("bug happened on EthereumJS version 10 releases"), reason about release series and make library compatibility more transparent and easier to grasp.
+
+As a start we bump all major release versions to version 10, these `RC` releases are the first to be released with the new versioning scheme.
+
+**Note: This is the initial developer release of a binary tree package. While we also directly bump the binarytree package version for consistency reasons please be aware that this package is still in a very early stage and not production ready!**
diff --git a/packages/binarytree/package.json b/packages/binarytree/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ethereumjs/binarytree",
-  "version": "0.0.1",
+  "version": "10.0.0-rc.1",
   "description": "Implementation of binary trees as used in Ethereum.",
   "keywords": ["binary", "tree", "trie", "ethereum"],
   "homepage": "https://github.com/ethereumjs/ethereumjs-monorepo/tree/master/packages/binarytree#readme",
@@ -46,8 +46,8 @@
     "tsc": "../../config/cli/ts-compile.sh"
   },
   "dependencies": {
-    "@ethereumjs/rlp": "^6.0.0-alpha.1",
-    "@ethereumjs/util": "^10.0.0-alpha.1",
+    "@ethereumjs/rlp": "^10.0.0-rc.1",
+    "@ethereumjs/util": "^10.0.0-rc.1",
     "@noble/hashes": "^1.7.1",
     "debug": "^4.4.0",
     "ethereum-cryptography": "^3.1.0",

diff --git a/packages/block/CHANGELOG.md b/packages/block/CHANGELOG.md
@@ -6,7 +6,29 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 (modification: no type change headlines) and this project adheres to
 [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
-## 6.0.0-alpha.1 - [ UNPUBLISHED ]
+## 10.0.0-rc.1 - [ UNPUBLISHED ]
+
+This is the first (and likely the last) round of `RC` releases for the upcoming breaking releases, following the `alpha` releases from October 2024. The releases are somewhat delayed (sorry for that), but final releases can now be expected very very soon, to be released once the Ethereum [Pectra](https://eips.ethereum.org/EIPS/eip-7600) hardfork is scheduled for mainnet and all EIPs are fully finalized. Pectra will then also be the default hardfork setting for all EthereumJS libraries.
+
+### New Versioning Scheme
+
+This breaking release round will come with a new versioning scheme (thanks to @paulmillr for the [suggestion](https://github.com/ethereumjs/ethereumjs-monorepo/issues/3748)), aligning the package numbers on breaking releases for all EthereumJS packages. This will make it easier to report bugs ("bug happened on EthereumJS version 10 releases"), reason about release series and make library compatibility more transparent and easier to grasp.
+
+As a start we bump all major release versions to version 10, these `RC` releases are the first to be released with the new versioning scheme.
+
+### Pectra Spec Updates
+
+- Support for EIP-7691 Blob Throughput Increase, PR [#3807](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3807)
+- Support for generalized EL requests coming with EIP-7685 introduction (devnet-4), PR [#3706](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3706)
+- Fix the param resolution for excess gas and blob fee compute, PR [#3841](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3841)
+
+### EthereumJS-wide Error Objects
+
+We have done preparations to allow for handling specific error sub types in the future by introducing a monorepo-wide `EthereumJSError` error class in the `@ethereumjs/util` package, see PR [#3879](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3879). This error is thrown for all error cases within the monorepo and can be specifically handled by comparing with `instanceof EthereumJSError`.
+
+We will introduce a set of more specific sub error classes inheriting from this generic type in upcoming minor releases, and so keeping things fully backwards compatible. This will allow for a more specific and robust handling of errors thrown by EthereumJS libraries.
+
+## 6.0.0-alpha.1 - 2024-10-17
 
 This is a first round of `alpha` releases for our upcoming breaking release round with a focus on bundle size (tree shaking) and security (dependencies down + no WASM (by default)). Note that `alpha` releases are not meant to be fully API-stable yet and are for early testing only. This release series will be then followed by a `beta` release round where APIs are expected to be mostly stable. Final releases can then be expected for late October/early November 2024.
 

diff --git a/packages/block/package.json b/packages/block/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ethereumjs/block",
-  "version": "6.0.0-alpha.1",
+  "version": "10.0.0-rc.1",
   "description": "Provides Block serialization and help functions",
   "keywords": ["ethereum", "block"],
   "homepage": "https://github.com/ethereumjs/ethereumjs-monorepo/tree/master/packages/block#readme",
@@ -42,11 +42,11 @@
     "tsc": "../../config/cli/ts-compile.sh"
   },
   "dependencies": {
-    "@ethereumjs/common": "^5.0.0-alpha.1",
-    "@ethereumjs/rlp": "^6.0.0-alpha.1",
-    "@ethereumjs/mpt": "^7.0.0-alpha.1",
-    "@ethereumjs/tx": "^6.0.0-alpha.1",
-    "@ethereumjs/util": "^10.0.0-alpha.1",
+    "@ethereumjs/common": "^10.0.0-rc.1",
+    "@ethereumjs/rlp": "^10.0.0-rc.1",
+    "@ethereumjs/mpt": "^10.0.0-rc.1",
+    "@ethereumjs/tx": "^10.0.0-rc.1",
+    "@ethereumjs/util": "^10.0.0-rc.1",
     "ethereum-cryptography": "^3.1.0"
   },
   "devDependencies": {

diff --git a/packages/blockchain/CHANGELOG.md b/packages/blockchain/CHANGELOG.md
@@ -6,7 +6,43 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 (modification: no type change headlines) and this project adheres to
 [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
-## 8.0.0-alpha.1 - [ UNPUBLISHED ]
+## 10.0.0-rc.1 - [ UNPUBLISHED ]
+
+This is the first (and likely the last) round of `RC` releases for the upcoming breaking releases, following the `alpha` releases from October 2024. The releases are somewhat delayed (sorry for that), but final releases can now be expected very very soon, to be released once the Ethereum [Pectra](https://eips.ethereum.org/EIPS/eip-7600) hardfork is scheduled for mainnet and all EIPs are fully finalized. Pectra will then also be the default hardfork setting for all EthereumJS libraries.
+
+### New Versioning Scheme
+
+This breaking release round will come with a new versioning scheme (thanks to @paulmillr for the [suggestion](https://github.com/ethereumjs/ethereumjs-monorepo/issues/3748)), aligning the package numbers on breaking releases for all EthereumJS packages. This will make it easier to report bugs ("bug happened on EthereumJS version 10 releases"), reason about release series and make library compatibility more transparent and easier to grasp.
+
+As a start we bump all major release versions to version 10, these `RC` releases are the first to be released with the new versioning scheme.
+
+### Native Node.js EventEmitter Replacement
+
+We removed the last remaining internal Node.js utility dependency to make the packages more browser friendly and replace the native Node.js `EventEmitter` by using the [eventemitter3](https://github.com/primus/eventemitter3) package as a replacement, see PR [#3746](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3746).
+
+The new package is meant to be performant and mostly compatible regarding usage and API.
+
+If you directly import the Node.js event emitter, you need to switch your imports to:
+
+```ts
+import { EventEmitter } from 'events' // old
+import { EventEmitter } from 'eventemitter3' // new
+```
+
+All this might affect you if you listen to events emitted by the `blockchain.events` `EventEmitter` instance.
+
+### Pectra Spec Updates
+
+- Support for generalized EL requests coming with EIP-7685 introduction (devnet-4), PR [#3706](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3706)
+- Add `requestsHash` to genesis block/configuration, PR [#3771](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3771)
+
+### EthereumJS-wide Error Objects
+
+We have done preparations to allow for handling specific error sub types in the future by introducing a monorepo-wide `EthereumJSError` error class in the `@ethereumjs/util` package, see PR [#3879](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3879). This error is thrown for all error cases within the monorepo and can be specifically handled by comparing with `instanceof EthereumJSError`.
+
+We will introduce a set of more specific sub error classes inheriting from this generic type in upcoming minor releases, and so keeping things fully backwards compatible. This will allow for a more specific and robust handling of errors thrown by EthereumJS libraries.
+
+## 8.0.0-alpha.1 - 2024-10-17
 
 This is a first round of `alpha` releases for our upcoming breaking release round with a focus on bundle size (tree shaking) and security (dependencies down + no WASM (by default)). Note that `alpha` releases are not meant to be fully API-stable yet and are for early testing only. This release series will be then followed by a `beta` release round where APIs are expected to be mostly stable. Final releases can then be expected for late October/early November 2024.
 

diff --git a/packages/blockchain/package.json b/packages/blockchain/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ethereumjs/blockchain",
-  "version": "8.0.0-alpha.1",
+  "version": "10.0.0-rc.1",
   "description": "A module to store and interact with blocks",
   "keywords": ["ethereum", "blockchain"],
   "homepage": "https://github.com/ethereumjs/ethereumjs-monorepo/tree/master/packages/blockchain#readme",
@@ -42,17 +42,17 @@
     "tsc": "../../config/cli/ts-compile.sh"
   },
   "dependencies": {
-    "@ethereumjs/block": "^6.0.0-alpha.1",
-    "@ethereumjs/common": "^5.0.0-alpha.1",
-    "@ethereumjs/mpt": "^7.0.0-alpha.1",
-    "@ethereumjs/rlp": "^6.0.0-alpha.1",
-    "@ethereumjs/util": "^10.0.0-alpha.1",
+    "@ethereumjs/block": "^10.0.0-rc.1",
+    "@ethereumjs/common": "^10.0.0-rc.1",
+    "@ethereumjs/mpt": "^10.0.0-rc.1",
+    "@ethereumjs/rlp": "^10.0.0-rc.1",
+    "@ethereumjs/util": "^10.0.0-rc.1",
     "debug": "^4.4.0",
     "eventemitter3": "^5.0.1",
     "lru-cache": "11.0.2"
   },
   "devDependencies": {
-    "@ethereumjs/ethash": "^4.0.0-alpha.1"
+    "@ethereumjs/ethash": "^10.0.0-rc.1"
   },
   "engines": {
     "node": ">=18"

diff --git a/packages/client/CHANGELOG.md b/packages/client/CHANGELOG.md
@@ -6,7 +6,53 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 (modification: no type change headlines) and this project adheres to
 [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
-## 0.10.3 - [ UNPUBLISHED ]
+## 0.10.4 - [ UNPUBLISHED ]
+
+### New JavaScript REPL
+
+This release comes with a new REPL - see PRs [#3781](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3781) and [#3867](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3867). It can be run using the npm script available in the client package:
+
+`npm run repl`
+
+In order to pass parameters to the client while using the repl, you can append it to the npm script command:
+
+`npm run repl -- --gethGenesis /data/genesis.json`
+
+The repl allows access to the JSON-RPC and ENGINE API's from the terminal. For help and a list of supported functions, type `.help` upon repl startup:
+```
+[01-17|09:05:57] INFO Started JSON RPC Server address=http://localhost:8545 namespaces=eth,web3,net,admin,txpool,debug 
+[01-17|09:05:57] INFO Started JSON RPC server address=http://localhost:8551 namespaces=eth,engine rpcEngineAuth=false 
+EthJS > .help
+```
+
+Example usage of repl commands:
+```
+[01-17|09:10:54] INFO Started JSON RPC Server address=http://localhost:8545 namespaces=eth,web3,net,admin,txpool,debug 
+[01-17|09:10:54] INFO Started JSON RPC server address=http://localhost:8551 namespaces=eth,engine rpcEngineAuth=false 
+EthJS > .eth_getBlockByNumber ["latest", true]
+EthJS > {
+  number: '0x0',
+  hash: '0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3',
+  parentHash: '0x0000000000000000000000000000000000000000000000000000000000000000',
+  mixHash: '0x0000000000000000000000000000000000000000000000000000000000000000',
+  nonce: '0x0000000000000042',
+  ...
+```
+
+### RPC Methods
+
+- Added support for `admin_addPeer` method, PR [#3788](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3788)
+- Added support for `debug_verbosity` method, PR [#3809](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3809)
+- Added support for `debug_setHead` method, PR [#3811](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3811)
+
+### Other Changes
+
+- Experimental support for stateful verkle execution (`statefulVerkle` option), PR [#3800](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3800)
+- Fix double execution of a newplayload block on fcu, PR [#3777](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3777)
+- Outdated `LES` respectively `lightServ` support has been removed, PR [#3759](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3759)
+- Engine API adjustments (mainly related to EL requests) along with devnet-4, PR [#3706](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3706)
+
+## 0.10.3 - 2024-10-17
 
 ### Engine API
 

diff --git a/packages/client/archive/libp2p/net/package.json.browser.deps b/packages/client/archive/libp2p/net/package.json.browser.deps
@@ -65,10 +65,10 @@
     "@ethereumjs/evm": "2.1.0",
     "@ethereumjs/rlp": "5.0.1",
     "@ethereumjs/statemanager": "2.1.0",
-    "@ethereumjs/mpt": "7.0.0-alpha.1",
+    "@ethereumjs/mpt": "10.0.0-rc.1",
     "@ethereumjs/tx": "5.1.0",
     "@ethereumjs/util": "9.0.1",
-    "@ethereumjs/vm": "9.0.0-alpha.1",
+    "@ethereumjs/vm": "10.0.0-rc.1",
     "abstract-level": "^1.0.3",
     "body-parser": "^1.19.2",
     "c-kzg": "^2.1.0",

diff --git a/packages/client/package.json b/packages/client/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ethereumjs/client",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "EthereumJS Execution Layer (EL) Client Implementation",
   "keywords": ["ethereum", "ethereumjs", "client", "blockchain", "light sync", "full sync"],
   "homepage": "https://github.com/ethereumjs/ethereumjs-monorepo/tree/master/packages/client#readme",
@@ -48,19 +48,19 @@
     "tsc": "../../config/cli/ts-compile.sh"
   },
   "dependencies": {
-    "@ethereumjs/block": "6.0.0-alpha.1",
-    "@ethereumjs/blockchain": "8.0.0-alpha.1",
-    "@ethereumjs/common": "5.0.0-alpha.1",
-    "@ethereumjs/devp2p": "7.0.0-alpha.1",
-    "@ethereumjs/ethash": "4.0.0-alpha.1",
-    "@ethereumjs/evm": "4.0.0-alpha.1",
+    "@ethereumjs/block": "10.0.0-rc.1",
+    "@ethereumjs/blockchain": "10.0.0-rc.1",
+    "@ethereumjs/common": "10.0.0-rc.1",
+    "@ethereumjs/devp2p": "10.0.0-rc.1",
+    "@ethereumjs/ethash": "10.0.0-rc.1",
+    "@ethereumjs/evm": "10.0.0-rc.1",
     "@ethereumjs/genesis": "0.3.0-alpha.1",
-    "@ethereumjs/mpt": "7.0.0-alpha.1",
-    "@ethereumjs/rlp": "6.0.0-alpha.1",
-    "@ethereumjs/statemanager": "3.0.0-alpha.1",
-    "@ethereumjs/tx": "6.0.0-alpha.1",
-    "@ethereumjs/util": "10.0.0-alpha.1",
-    "@ethereumjs/vm": "9.0.0-alpha.1",
+    "@ethereumjs/mpt": "10.0.0-rc.1",
+    "@ethereumjs/rlp": "10.0.0-rc.1",
+    "@ethereumjs/statemanager": "10.0.0-rc.1",
+    "@ethereumjs/tx": "10.0.0-rc.1",
+    "@ethereumjs/util": "10.0.0-rc.1",
+    "@ethereumjs/vm": "10.0.0-rc.1",
     "@js-sdsl/ordered-map": "^4.4.2",
     "@multiformats/multiaddr": "^12.4.0",
     "@paulmillr/trusted-setups": "^0.1.2",

diff --git a/packages/common/CHANGELOG.md b/packages/common/CHANGELOG.md
@@ -6,7 +6,50 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 (modification: no type change headlines) and this project adheres to
 [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
-## 5.0.0-alpha.1 - [ UNPUBLISHED ]
+## 10.0.0-rc.1 - [ UNPUBLISHED ]
+
+This is the first (and likely the last) round of `RC` releases for the upcoming breaking releases, following the `alpha` releases from October 2024. The releases are somewhat delayed (sorry for that), but final releases can now be expected very very soon, to be released once the Ethereum [Pectra](https://eips.ethereum.org/EIPS/eip-7600) hardfork is scheduled for mainnet and all EIPs are fully finalized. Pectra will then also be the default hardfork setting for all EthereumJS libraries.
+
+### New Versioning Scheme
+
+This breaking release round will come with a new versioning scheme (thanks to @paulmillr for the [suggestion](https://github.com/ethereumjs/ethereumjs-monorepo/issues/3748)), aligning the package numbers on breaking releases for all EthereumJS packages. This will make it easier to report bugs ("bug happened on EthereumJS version 10 releases"), reason about release series and make library compatibility more transparent and easier to grasp.
+
+As a start we bump all major release versions to version 10, these `RC` releases are the first to be released with the new versioning scheme.
+
+### Native Node.js EventEmitter Replacement
+
+We removed the last remaining internal Node.js utility dependency to make the packages more browser friendly and replace the native Node.js `EventEmitter` by using the [eventemitter3](https://github.com/primus/eventemitter3) package as a replacement, see PR [#3746](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3746).
+
+The new package is meant to be performant and mostly compatible regarding usage and API.
+
+If you directly import the Node.js event emitter, you need to switch your imports to:
+
+```ts
+import { EventEmitter } from 'events' // old
+import { EventEmitter } from 'eventemitter3' // new
+```
+
+All this might affect you if you listen to events emitted by the `common.events` `EventEmitter` instance, e.g. to detect hardfork changes.
+
+### Pectra Spec Updates
+
+- Support for generalized EL requests coming with EIP-7685 introduction (devnet-4), PR [#3706](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3706)
+- Add `requestsHash` to genesis block/configuration, PR [#3771](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3771)
+- Allow specifying eip-7840 blobSchedule via geth genesis, PR [#3835](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3835)
+
+### EthereumJS-wide Error Objects
+
+We have done preparations to allow for handling specific error sub types in the future by introducing a monorepo-wide `EthereumJSError` error class in the `@ethereumjs/util` package, see PR [#3879](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3879). This error is thrown for all error cases within the monorepo and can be specifically handled by comparing with `instanceof EthereumJSError`.
+
+We will introduce a set of more specific sub error classes inheriting from this generic type in upcoming minor releases, and so keeping things fully backwards compatible. This will allow for a more specific and robust handling of errors thrown by EthereumJS libraries.
+
+### Other Changes
+
+- Remove Goerli support, PR [#3851](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3851)
+- Fix TTD related failed Geth genesis parsing, PR [#3847](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3847)
+- Fix deposit address for sepolia and holesky, PR [#3882](https://github.com/ethereumjs/ethereumjs-monorepo/pull/3882)
+
+## 5.0.0-alpha.1 - 2024-10-17
 
 This is a first round of `alpha` releases for our upcoming breaking release round with a focus on bundle size (tree shaking) and security (dependencies down + no WASM (by default)). Note that `alpha` releases are not meant to be fully API-stable yet and are for early testing only. This release series will be then followed by a `beta` release round where APIs are expected to be mostly stable. Final releases can then be expected for late October/early November 2024.