base/node
Everything required to run your own Base node
📋 What's Changed
- > [!IMPORTANT]
- > Required release for node operators running pruned nodes with `base-consensus`, optional release for archive nodes.
- The release updates `base-consensus` and `base-reth-node` to [0.9.1](https://github.com/base/base/releases/tag/v0.9.1)
- Full Changelog: https://github.com/base/node/compare/v0.16.0...v0.16.1
📋 What Changed
- > [!IMPORTANT]
- > Node operators must upgrade Base Mainet nodes to v0.16.0 by 28th May to support Base Azul. See [here](https://docs.base.org/base-chain/node-operators/base-v1-upgrade) for more information.
- As part of this upgrade, support for all clients except for `base-reth-node` and `base-consensus` have been dropped. See [here](https://docs.base.org/base-chain/node-operators/base-v1-upgrade#migrating-execution-layer) for migration details.
- This release updates base-consensus and base-reth-node to [0.9.0](https://github.com/base/base/releases/tag/v0.9.0) to support Base Azul.
📋 What's Changed
- > [!NOTE]
- >
- > This release updates `base/base` to [`0.8.0`](https://github.com/base/base/releases/tag/v0.7.5).
- This release updates `base-consensus` and `base-reth-node` to `0.8.0`. This improves execution and consensus peering reliability on Base Sepolia.
📋 What's Changed
- > [!NOTE]
- >
- > This release updates `base/base` to [`0.7.6`](https://github.com/base/base/releases/tag/v0.7.5).
📋 What's Changed
- > [!NOTE]
- >
- > This release updates `base/base` to [`0.7.5`](https://github.com/base/base/releases/tag/v0.7.5).
- Full Changelog: https://github.com/base/node/compare/v0.15.3...v0.15.4
📋 What's Changed
- > [!NOTE]
- >
- > This release updates `base/base` to [`0.7.4`](https://github.com/base/base/releases/tag/v0.7.4).
- Full Changelog: https://github.com/base/node/compare/v0.15.2...v0.15.3
📋 What's Changed
- > [!NOTE]
- >
- > Fixes a small bug in `base-consensus` where the `L2_ENGINE_RPC_URL` didn't support websocket urls. Now, both `ws://` and `wss://` prefixed urls are supported by `base-consensus`.
- Update Base to 0.7.3 in #1021.
- Full Changelog: https://github.com/base/node/compare/v0.15.1...v0.15.2
💥 Breaking Changes (same as `v0.15.0`)
- > [!IMPORTANT]
- The default consensus layer client is now `base-consensus`. Geth and Nethermind will no longer be supported starting with Base v1.
- Action required:
- Configure new `BASE_NODE` environment variables (see [example env files](https://github.com/base/node/blob/main/.env.mainnet))
- To temporarily opt out, set `USE_BASE_CONSENSUS=false`
📋 Changes
- Switch all entrypoints to use base-consensus authentication (#1001)
- Add legacy OP node flag (#1002)
- Full Changelog: https://github.com/base/node/compare/v0.15.0...v0.15.1
📋 What Changed
- > [!IMPORTANT]
📦 Client Updates
- Base v0.5.1 to v0.7.0: [diff](https://github.com/base/base/compare/v0.5.1...v0.7.0)
- Nethermind 1.36.0 to 1.36.2: [diff](https://github.com/NethermindEth/nethermind/compare/1.36.0...1.36.2)
- op-geth v1.101609.1 to v1.101702.0: [diff](https://github.com/ethereum-optimism/op-geth/compare/v1.101609.1...v1.101702.0)
- op-node v1.16.7 to v1.16.11: [diff](https://github.com/ethereum-optimism/optimism/compare/op-node/v1.16.7...op-node/v1.16.11)
📋 Changes
- Node Client Updates
📋 What's Changed
- chore: remove unused op-reth repo by @meyer9 in https://github.com/base/node/pull/981
- feat: support proofs ExEx by @meyer9 in https://github.com/base/node/pull/980
- chore: updated base-reth to 0.5.1 by @github-actions[bot] in https://github.com/base/node/pull/969
- Full Changelog: https://github.com/base/node/compare/v0.14.7...v0.14.8
📋 Changes
- Node Client Updates
- Base v0.4.0 to v0.4.1
📋 Changes
- Node Client Updates
- Base v0.3.1 to v0.4.0
📋 Changes
- Node Client Updates
- Base v0.3.0 to v0.3.1
- Nethermind v 1.35.3 to 1.36.0
- Geth v1.101603.5 to v1.101608.0
- OP Node v1.16.2 to v1.16.6
- OP Reth v1.9.3 to v1.10.2
✨ New RPCs
- > [!NOTE]
- > These features are only supported in Base Reth
- `base_transactionStatus` - lookup whether a transaction is present in the mempool
- `eth_subscribe` - updated to support Flashblocks
- `pendingLogs`: stream of logs from transactions in Flashblocks
- `newFlashblockTransactions`: stream of transaction hashes that are included in the block
- `newFlashblocks`: stream the pending block as new Flashblocks arrive
📋 Other Changes
- Base Reth
- Flashblock bug fixes and performance improvements
- Nethermind, Geth
- No changes
- Full Changelog: https://github.com/base/node/compare/v0.14.3...v0.14.4
📦 ❗ Mandatory update for Base Mainnet nodes to support the Jovian upgrade on December 2nd.
- Operators of Base Mainnet nodes must upgrade to this release _before_ December 2nd at UTC 16:00:01 UTC (unix timestamp 1764691201).
💥 ⚠️ Breaking Changes (same as `v0.14.1`)
- Similar to `v0.14.1` which was a mandatory upgrade for Base Sepolia node operators, this release also contains the following change and will be applied to mainnet node operators now as well.
🗑️ **`op-reth` Binary Removed, Consolidated into `base-reth-node`**
- The separate `op-reth` binary has been removed and is no longer available.
- All functionality previously provided by `op-reth` has been consolidated into the existing `base-reth-node` binary.
- Impact: If your deployment or scripts explicitly called the `op-reth` binary, you must update them to call `base-reth-node` instead.
- Parameters & Operation: The `base-reth-node` binary is designed to be identical in its command-line parameters and operational behavior to the removed `op-reth`. No parameter changes should be necessary other than the binary name itself.
- Reasoning: This consolidation allows us to more easily introduce and manage Base-specific features within a single, unified client binary.
📋 What's Changed
- chore: updated node-reth, reth by @github-actions[bot] in https://github.com/base/node/pull/661
- Full Changelog: https://github.com/base/node/compare/v0.14.2...v0.14.3
🐛 ❗ Critical bug fix for Base Sepolia Testnet nodes running Geth client
- This release contains a critical [fix to op-geth](https://github.com/ethereum-optimism/op-geth/releases/tag/v1.101603.5) in which historical block sync would halt after the Jovian fork.
- > [!Note]
- > This release is not required for Sepolia nodes running Reth, but is recommended for some performance improvements that come with the bump
- node-reth - v0.2.1: [diff](https://github.com/base/node-reth/compare/v0.2.0...v0.2.1)
- op-geth - v1.101603.5: [diff](https://github.com/ethereum-optimism/op-geth/compare/v1.101603.4...v1.101603.5)
- optimism - op-node/v1.16.2: [diff](https://github.com/ethereum-optimism/optimism/compare/op-node/v1.16.1...op-node/v1.16.2)
🧪 ❗ Mandatory update for Base Sepolia Testnet nodes to support the Jovian upgrade on November 19th.
- Operators of Base Sepolia Testnet nodes must upgrade to this release _before_ November 19th at UTC 16:00:01 UTC (unix timestamp 1763568001).
- Also included is an important reth upgrade for stability and performance.
- > [!Important]
- > This release is highly recommended for Base Mainnet nodes
💥 ⚠️ Breaking Changes
- ---
🗑️ **`op-reth` Binary Removed, Consolidated into `base-reth-node`**
- The separate `op-reth` binary has been removed and is no longer available.
- All functionality previously provided by `op-reth` has been consolidated into the existing `base-reth-node` binary.
- Impact: If your deployment or scripts explicitly called the `op-reth` binary, you must update them to call `base-reth-node` instead.
- Parameters & Operation: The `base-reth-node` binary is designed to be identical in its command-line parameters and operational behavior to the removed `op-reth`. No parameter changes should be necessary other than the binary name itself.
- Reasoning: This consolidation allows us to more easily introduce and manage Base-specific features within a single, unified client binary.
- ---
- optimism - op-node/v1.16.1: [diff](https://github.com/ethereum-optimism/optimism/compare/op-node/v1.14.3...op-node/v1.16.1)
- reth - v1.9.2: [diff](https://github.com/paradigmxyz/reth/compare/v1.9.0...v1.9.2)
- + 3 more
📦 Overview
- Recommended release for Reth node operators to be Jovian ready. This release includes memory bugfixes, flashblock enhancements for reth. Note that op-node/op-geth versions are not yet updated.
📋 What's Changed
- chore: add pruning snapshot capability by @wlawt in https://github.com/base/node/pull/625
- fix: syntax issue with pruning arg by @wlawt in https://github.com/base/node/pull/626
- chore: updated reth, node-reth, nethermind by @github-actions[bot] in https://github.com/base/node/pull/627
✨ New Contributors
- @wlawt made their first contribution in https://github.com/base/node/pull/625
📋 Reth Changelog
- Reth v1.9.0 - [Changelog](https://github.com/paradigmxyz/reth/releases/tag/v1.9.0)
- Full Changelog: https://github.com/base/node/compare/v0.13.5...v0.14.0
📦 Overview
- Recommended release for Reth Flashblock node operators. Includes significant performance improvements and some further bug fixes related to computing the Flashblock pending state.
📋 What's Changed
- chore: updated node-reth by @github-actions[bot] in https://github.com/base/node/pull/622
- Full Changelog: https://github.com/base/node/compare/v0.13.4...v0.13.5
📋 What's Changed
- chore: updated node-reth by @github-actions[bot] in https://github.com/base/node/pull/616
- Full Changelog: https://github.com/base/node/compare/v0.13.3...v0.13.4
📦 Overview
- Recommended release for Reth node operators with Flashblocks enabled to help stabilize flashblock processing and significantly reduce execution errors
📋 What's Changed
- Reth recommended by @anikaraghu in https://github.com/base/node/pull/604
- chore: updated reth, node-reth by @github-actions[bot] in https://github.com/base/node/pull/615
✨ New Contributors
- @anikaraghu made their first contribution in https://github.com/base/node/pull/604
- Full Changelog: https://github.com/base/node/compare/v0.13.2...v0.13.3
📋 What's Changed
- chore: Align Go version by @HoustonOla35 in https://github.com/base/node/pull/582
- chore: bump node-reth commit hash by @haardikk21 in https://github.com/base/node/pull/606
- chore: updated op-geth, optimism, node-reth, nethermind by @github-actions[bot] in https://github.com/base/node/pull/591
- Full Changelog: https://github.com/base/node/compare/v0.13.1...v0.13.2
🧪 ❗ Mandatory update for **_Reth_** Base Sepolia testnet nodes before Fusaka on October 14th.
- This release Supersedes v0.13.0. It updates the Reth client for Base Sepolia Testnet to work with Fusaka, happening on October 14th, at UTC 07:36:00 (unix timestamp 1760427360)
🧪 ❗ Mandatory Update for Base Sepolia testnet Nodes by October 14th, 2025
- This release is required for operators running Base Sepolia testnet nodes to support Ethereum L1's Fusaka hardfork, happening on October 14th, at UTC 07:36:00 (unix timestamp 1760427360).
- > [!WARNING]
- > [!NOTE]
- > This is optional but recommended for Base Mainnet nodes.
- Changelog
- op-node v1.14.1
- [Changelog](https://github.com/ethereum-optimism/optimism/compare/v1.13.7...v1.14.1)
- op-geth v1.101603.1
- + 1 more
📋 What's Changed
- fix: use branch name as tag for branch-tracked dependencies by @cody-wang-cb in https://github.com/base/node/pull/560
- chore: updated nethermind, op-geth, optimism, reth by @github-actions[bot] in https://github.com/base/node/pull/539
- Full Changelog: https://github.com/base/node/compare/v0.12.9...v0.12.10
📦 Overview
- Bumps the Reth node to use Reth 1.8.1, which includes important bug fixes for `eth_call` and `eth_estimateGas`
- Adds support for Flashblocks Reth nodes to offer `eth_call`, `eth_estimateGas`, and `eth_simulateV1` against pending flashblocks state
📋 What's Changed
- Dependency Updater: remove newline char from commit message by @JenabaBa in https://github.com/base/node/pull/515
- Dependency Updater: change workflow to use GITHUB_OUTPUT instead of env by @JenabaBa in https://github.com/base/node/pull/516
- Dependency Updater: fix commit description formatting by @JenabaBa in https://github.com/base/node/pull/520
- Dependency updater: remove hardcoded dependency key from debug line by @GarmashAlex in https://github.com/base/node/pull/522
- fixed typos and removed print by @letmehateu in https://github.com/base/node/pull/521
- fix GitHub markdown syntax for NOTE block in README by @reallesee in https://github.com/base/node/pull/532
- chore: bump node reth to 0.1.8 by @haardikk21 in https://github.com/base/node/pull/545
✨ New Contributors
- @GarmashAlex made their first contribution in https://github.com/base/node/pull/522
- @letmehateu made their first contribution in https://github.com/base/node/pull/521
- @reallesee made their first contribution in https://github.com/base/node/pull/532
- Full Changelog: https://github.com/base/node/compare/v0.12.8...v0.12.9
📦 Critical Update for Reth Node Operators
- Updated to include Reth v1.6.0, which includes a critical fix for `debug_traceTransaction` to ensure the revert reason is included in the response.
📋 What's Changed
- docs(README): the missing reference to Farcaster has been added to the documentation by @operagxoksana in https://github.com/base/node/pull/506
- fix: remove debug print statement and fix error messages in dependency updater by @pashka8 in https://github.com/base/node/pull/510
- chore: updated node-reth, nethermind, reth by @github-actions[bot] in https://github.com/base/node/pull/511
✨ New Contributors
- @operagxoksana made their first contribution in https://github.com/base/node/pull/506
- @pashka8 made their first contribution in https://github.com/base/node/pull/510
- Full Changelog: https://github.com/base/node/compare/v0.12.7...v0.12.8
🐛 Critical fixes for flashblocks-aware reth nodes, optional release for other nodes
- Fixes memory leak and incorrect `BaseFeePerGas` value for flashblocks-aware reth nodes
📋 What's Changed
- dependency updater: support large repos & simplify config by @JenabaBa in https://github.com/base/node/pull/482
- Add Commit Message Feature to Dependency Updater by @JenabaBa in https://github.com/base/node/pull/488
- feat: add additional port configuration options for disc/p2p by @coffeexcoin in https://github.com/base/node/pull/465
- docs (README.md): fix typo "accomodate" by @gap-editor in https://github.com/base/node/pull/491
- Dependency Updater: Add Support for Branch Tracking by @JenabaBa in https://github.com/base/node/pull/495
- Dependency Updater: Github Action Workflow for Scheduled Updater Runs by @JenabaBa in https://github.com/base/node/pull/497
- Dependency Updater: Add Step to Remove commit_message.env by @JenabaBa in https://github.com/base/node/pull/499
- Dependency Updater: Create env Before Commit Message by @JenabaBa in https://github.com/base/node/pull/501
- + 6 more
✨ New Contributors
- @gap-editor made their first contribution in https://github.com/base/node/pull/491
- @github-actions[bot] made their first contribution in https://github.com/base/node/pull/500
- Full Changelog: https://github.com/base/node/compare/v0.12.6...v0.12.7
📋 What's Changed
- Automate Node Upgrade Process: Update Dependencies by @JenabaBa in https://github.com/base/node/pull/477
- Update op-geth for geth-based build by @drwtsn95 in https://github.com/base/node/pull/473
- Automate Node Upgrade Process: Update Script by @JenabaBa in https://github.com/base/node/pull/478
- [StepSecurity] Apply security best practices by @stepsecurity-app in https://github.com/base/node/pull/481
- fix: allow github actions to push packages by @danyalprout in https://github.com/base/node/pull/483
- Upgrade node-reth to v0.1.3 which adopts the v1.15.0 reth version by @0x00101010 in https://github.com/base/node/pull/486
✨ New Contributors
- @JenabaBa made their first contribution in https://github.com/base/node/pull/477
- @drwtsn95 made their first contribution in https://github.com/base/node/pull/473
- @stepsecurity-app made their first contribution in https://github.com/base/node/pull/481
- Full Changelog: https://github.com/base/node/compare/v0.12.5...v0.12.6