Skip to content

Releases: ethereum/go-ethereum

Eezo Shunt (v1.17.1)

03 Mar 12:47
@fjl fjl
v1.17.1
16783c1

Choose a tag to compare

View all tags
Eezo Shunt (v1.17.1) Latest
Latest

This is a bug fix release and is recommended for all users. It resolves a regression in snap sync, as well as several security issues.

Geth

  • The engine API no longer enables plain-text HTTP2, due to some reports of incompatibilities with the teku CL (#33922)
  • The new --metrics.influxdb.interval flag allows changing the metrics reporting interval. (#33767)
  • Geth has a new inspect-trie subcommand that prints information about node counts at all state trie depths (#28892)

Core

  • Some Amsterdam fork-related changes:
  • Payload building had a fix that could prevent the CL from receiving the latest built payloads (#33908)

Networking

  • Geth no longer supports p2p protocol version eth/68 (#33511)
  • A rare crash in p2p request tracking is resolved (#33940)
  • The transaction pool, and specifically the blobpool, saw some fixes that reduce relaying transactions that likely won't make it into the chain, or have already been included on chain recently. This should reduce txpool traffic (#33607, #33887, #33923, #33893)
  • In v1.17.0, a regression in snap-sync was introduced that would cause sync to fail when using --history.chain=postmerge (#33865)
  • Snap-sync had a bug where peer connections would stop being used after a timeout or similar event. This wasn't too noticeable for mainnet sync because of peer churn (#33790)
  • Unexpected state delivered by peers is now reported during snap-sync (#33898)
  • P2P listener metrics now record handshake timeouts correctly (#33539)

RPC

  • eth_estimateGas now honors the user-supplied access list (#33849)
  • New RPC method: eth_getStorageValues (#32591)
  • New RPC method: testing_buildBlockV1 (#33656)

Build

  • This release is built with Go 1.25.7 (#33874)
  • Our official Docker images are experimentally built with Go 1.26 (#33899)

For a full rundown of the changes please consult the Geth 1.17.1 release milestone.

As with all our previous releases, you can find the:

Assets 2
Loading

Eezo-Inlaid Circuitry (v1.17.0)

17 Feb 16:15
@fjl fjl
v1.17.0
0cf3d3b

Choose a tag to compare

View all tags
Eezo-Inlaid Circuitry (v1.17.0)

This is a feature release, with all accumulated development from the last 3 months. See below for the highlights.

Note that this release contains multiple critical security fixes, as well as many bug fixes, and is recommended for all users. However, if you are cautious about upgrades, you can also install v1.16.9 which has just the critical security fixes. Specifically, this release fixes CVE-2026-26313, CVE-2026-26314, CVE-2026-26315.

We recommend recreating your p2p node key after installing this update, which you can do by removing the DATADIR/geth/nodekey file before restarting geth. Note this will cause a change in the p2p node ID, which may break static peering setups.

Highlights

Path-based Archive Node with Proofs

The path-based archive node can now serve proofs (via eth_getProof) for the state of older blocks.

You can configure the block range that supports proving independently from other archive state availability. Specifically, you can use the --history.trienode command-line flag to set the amount of blocks for which tree nodes will be tracked.

This feature is disabled by default. Note that state history cannot easily be recovered once deleted, as it can only be generated by processing blocks. However, you can enable trienode history (and/or state history) at any time to turn a full node into a partial archive node, keeping state from that point in time onwards.

#32727, #32621, #33551, #32981, #33399, #32913, #33303, #33584, #33329, #33681, #33103, #33098, #33515, #32247

EraE History Support

Geth now suports the EraE file format, an archival format for post-merge chain history.

#32157, #33827

OpenTelemetry Tracing

OpenTelemetry tracing is now supported by the RPC server, including support for distributed tracing.
We have also added some tracing spans for block processing via the engine API, i.e. engine_newPayload.

#33599, #33452, #33780, #33521

All Changes

Geth CLI

  • The geth version-check subcommand has been removed. This command checked the geth website for signed vulnerability notices, and would tell if updates are necessary (#33498)
  • There is now a --miner.maxblobs command-line flag to set a limit on blobs included in built blocks (#33129, #33302)
  • Geth now supports continuous profiling with Grafana Pyroscope (#33623)
  • A rare bug that could halt block production in geth --dev mode was fixed (#33146)
  • A new --rpc.rangelimit flag configures the maximum block range for eth_getLogs (#33163)
  • geth --exitwhensynced will now set the finalized and safe block (#33038)
  • geth --ethstats now reports the newPayload processing time to the stats server (#33395)
  • A lot of minor issues in Geth's command-line flag processing have been fixed (#33379, #33338, #33330, #32999, #33279, #33252)
  • The evm blocktest command can now read filenames from stdin when no path is provided (#32824)

Fork Implementation

Core

  • The crypto/ecies library allowed extraction of the private key used for key derivation via observation of response timing. We recommend rotating the node key after applying this update. (#33669)
  • When a missing block is encountered during tx unindexing, Geth will now skip it and move on instead of entering an infinite loop. (#33573)
  • Geth now optionally collect and export metrics about the total state size (#33254, #33376, #33415)
  • There is a new OnStateUpdate hook, which is called after all state of a block has been committed. This gives access to the changeset of the block. (#33490)
  • Some minor tracing bugs have been fixed (#32919, #33148, #33644, #33214)
  • Various minor issues in the freezer database have also been fixed (#33747, #33025, #33203, #33344)
  • The setHead operation now unsets the finalized block, in cases where the rolled-back block range extends before it. (#33486)
  • The SignatureValues method of types.Signer now reports an error for invalid signature sizes (#33647)
  • Geth prints detailed log messages for 'slow blocks' (#33655, #33525, #33442, #32812, #33659, #33532)
  • Pebble configuration has been tweaked for improved performance (#33697, #33353, #33315)
  • A rare crash in the log indexer related to reorg handling has been fixed (#33810)
  • Internal state diff size accounting has been corrected, so state diffs will now be flushed to the disk store less often (#33505)
  • Since the keccak256 hash function variant used by Ethereum no longer has a fast-path in the standard library, we have vendored the keccak implementation back into our repository (#33323)

Library

  • The RLP library now has a RawList type for dealing with un-decoded lists in a more convenient way (#33755, #33834, #33840, #33841)
  • The low-level RLP iterator and uses of it have been improved (#33245, #33188, #33820)
  • Clef can now sign blob transactions with cell proofs (#32910)
  • Fixed some corner-case bugs in metrics exporting (#33749, #33748)
  • The hardware wallet library now supports the Ledger Nano Gen5 and correctly enables EIP-712 signing for all supported versions. (#33297, #33113)
  • SignTextWithPassphrase now works correctly with all supported hardware wallets (#33138)
  • Some minor bugs were fixed in the keystore implementation (#33606, #33602, #33090)
  • The bitutil.XORBytes function has been deprecated in favor of stdlib package crypto/subtle (#33331)
  • A memory leak in the beacon chain light client was fixed (#33483)

RPC

  • eth_getTransactionByHash now returns the blockTimestamp as part of the transaction object (#33709)
  • Error codes for some conditions in eth_simulateV1, eth_getLogs, eth_getStorageAt have been improved to better comply with the execution RPC spec (#33007, #33320, #33282)
  • eth_simulateV1 now selects the correct set of precompiles for the simulated header (#33363)
  • eth_sendTransaction and eth_fillTransaction now default to EIP-1559 (#33058)
  • The GraphQL implementation has received some bug fixes for cases where a resolved item is not found. (#33184, #33225)
  • In GraphQL, the gasPrice is now retrievable for transaction types 0x3 and 0x4 (#33542)
  • The RPC server now enables plain-text HTTP2 for improved performance (#33812)
  • The RPC client no longer sends spurious RST_STREAM HTTP2 frames (#33122)
  • Some minor JSON encoding bugs have been fixed in ethclient (#33693, #33242, #33464)
  • The gethclient has a new wrapper of the callTracer (#31510)
  • In the callTracer, reported logs now contain an index field which is the index of the log within the transaction (#33629)

P2P Networking

  • The transaction pool heartbeat mechanism had some fixes for potential resource leaks (#33704)
  • The eth and snap protocol implementations nows validates most p2p messages before decoding their content. This improves security and sync performance in some cases. (#33835)
  • The blob transaction pool has seen some bug fixes and now accepts nonce-gapped transactions to a very limited extent (#32717, #33775, #33474, #33352, #33301, #33260)
  • Snap sync status is now tracked better, ensuring a snap sync will not be triggered accidentally by the engine API (#33157)
  • The snap sync scheduler was improved to better protect the trie database against accidential mutations while the node is processing blocks. This resolves some edge cases where the database could be corrupted (#33428)
  • The header sync implementation was fixed to better deal with setHead operations during sync (#33481)
  • Peer connections delivering stale transactions will be penalized less, since delivery of a few stale transactions is a common occurrence. (#32725)
  • Peers announcing transactions of one type, and delivering a different type, are now disconnected as penalty (#33378)
  • Similarly, peers delivering invalid KZG proofs will now be disconnected (5b99d2b)
  • The transaction pool has new metrics for the number of accounts with transactions (#33646, #33654)

For a full rundown of the changes please consult the Geth 1.17.0 release milestone.

As with all our previous releases, you can find the:

Loading

Shield Focusing Module (v1.16.9)

17 Feb 16:06
@fjl fjl
v1.16.9
95665d5

Choose a tag to compare

View all tags
Shield Focusing Module (v1.16.9)

This is a security hot-fix release. Specifically, this release fixes CVE-2026-26314, CVE-2026-26315.

We recommend recreating your p2p node key after installing this update, which you can do by removing the DATADIR/geth/nodekey file before restarting geth. Note this will cause a change in the p2p node ID, which may break static peering setups.

As with all our previous releases, you can find the:

Loading

Moisture Filters (v1.16.8)

13 Jan 16:05
@fjl fjl
v1.16.8
abeb78c

Choose a tag to compare

View all tags
Moisture Filters (v1.16.8)

This is a security fix release and is recommended for all users. It resolves two p2p
vulnerabilities reported through the Ethereum Foundation bug bounty program.

As with all our previous releases, you can find the:

Loading

Ballistic Drift Stabilizer (v1.16.7)

04 Nov 12:28
@fjl fjl
v1.16.7
b9f3a3d

Choose a tag to compare

View all tags
Ballistic Drift Stabilizer (v1.16.7)

This is a re-roll of v1.16.6, including an important fix in the KZG cryptography library.

This release enables the Fusaka hardfork on Ethereum mainnet.

The Fusaka fork is scheduled to occur at 2025-12-03 21:49:11 UTC.
Please upgrade your node to v1.16.7 in time for the fork.

This release also enables two blob-parameter-only (BPO) upgrades.
These upgrades change protocol parameters to increase the available blob capacity.

  • BPO1 on2025-12-09
  • BPO2 on 2026-01-07

Fusaka

  • Set mainnet timestamps for Osaka (#33063)
  • Enable Fusaka for geth --dev mode (#32917)

RPC

  • Add eth_sendRawTransactionSync which waits until either a timeout or the transaction is mined. This feature is mostly useful on L2s with lower blocktimes. (#32830, #32930, #32929)
  • Add support for eth_simulateV1 in ethclient (#32856)
  • Fix for an issue that might crash debug_traceCall (#33015)
  • Fix for an issuer where local transactions were not persisted to the journal (#32921)

Core

  • Fix for a cryptographic vulnerability in c-kzg-4844. This is only exploitable post-Fusaka. (#33093)
  • Add geth --genesis flag as an alternative to running geth init genesis.json (#32844)
  • Fix for receipt insertion during ERA file import. (#32934)
  • Work on getting the trie node history in order to serve historical eth_getProof request with the new path-based archive node. (#32907, #32914, #32937)
  • Further work on cmd/keeper, our guest program for zkVMs (#32816)
  • Various optimizations (#32971, #32916, #32965, #32946)

Networking

  • New metrics for tracking slow peers (#32964)
  • Fix for an issue where disconnected peers were not removed in txFetcher (#32947)

For a full rundown of the changes please consult the Geth 1.16.6 and 1.16.7 release milestones.

As with all our previous releases, you can find the:

Loading

Leather Wrapping (v1.16.6)

03 Nov 16:54
@fjl fjl
v1.16.6
386c3de

Choose a tag to compare

View all tags
Leather Wrapping (v1.16.6)

⚠️ Do not use v1.16.6 for the Fusaka upgrade! Please use v1.16.7, which contains an important security fix. ⚠️

This release enables the Fusaka hardfork on Ethereum mainnet
The fork is scheduled to occur at 2025-12-03 21:49:11 UTC.
This release also enables the BPO1 and BPO2 forks for mainnet at 2025-12-09 and 2026-01-07 respectively.

Fusaka

  • Set mainnet timestamps for Osaka (#33063)
  • Enable Fusaka for geth --dev mode (#32917)

RPC

  • Add eth_sendRawTransactionSync which waits until either a timeout or the transaction is mined. This feature is mostly useful on L2s with lower blocktimes. (#32830, #32930, #32929)
  • Add support for eth_simulateV1 in ethclient (#32856)
  • Fix for an issue that might crash debug_traceCall (#33015)
  • Fix for an issuer where local transactions were not persisted to the journal (#32921)

Core

  • Add geth --genesis flag as an alternative to running geth init genesis.json (#32844)
  • Fix for receipt insertion during ERA file import. (#32934)
  • Work on getting the trie node history in order to serve historical eth_getProof request with the new path-based archive node. (#32907, #32914, #32937)
  • Further work on cmd/keeper, our guest program for zkVMs (#32816)
  • Various optimizations (#32971, #32916, #32965, #32946)

Networking

  • New metrics for tracking slow peers (#32964)
  • Fix for an issue where disconnected peers were not removed in txFetcher (#32947)

For a full rundown of the changes please consult the Geth 1.16.6 release milestone.

As with all our previous releases, you can find the:

Loading

Coolant Cells (v1.16.5)

16 Oct 08:01
@fjl fjl
v1.16.5
737ffd1

Choose a tag to compare

View all tags
Coolant Cells (v1.16.5)

This is a maintenance release. We are issuing this release mostly to add a conversion path for blob proofs submitted via eth_sendRawTransaction. See https://blog.ethereum.org/2025/10/15/fusaka-blob-update for more information.

RPC

  • eth_sendRawTransaction has an upgrade path for blob proofs after the Fusaka fork. Note this is temporary. We will remove support for blob proof conversion during the v1.17.x release cycle, please update RPC client libraries to support cell-level (v1) proofs. (#32849)
  • eth_subscribe now supports a transactionReceipts subscription. There is also a wrapper in ethclient for this new subscription type. (#32697, #32869)
  • eth_simulateV1 was fixed to return the block timestamp in logs, like eth_getLogs does. (#32831)
  • In the abigen v2 runtime, BoundContract.Transfer will now verify that the contract has a payable fallback or receive method. (#32374)
  • A keccak256preimage tracer has been added. (#32569)

Networking

  • The eth protocol handler will now drop peers sending duplicated transactions. This is to unify behavior with other client implementations. (#32728)
  • A regression in the discovery system could cause high CPU usage under synthetic conditions (i.e. in tests). (#32912)
  • A very rare shutdown hang related to peer discovery is resolved. (#32572)
  • The eth protocol test suite has a new post-merge test chain and saw some bug fixes for flakey tests. (#32834, #32850)

Core

  • Our freezer implementation now supports partial reads, i.e. reading just a slice out of a larger stored value. This functionality is used for the archive node state history. (#32132)
  • The trie database now implements a storage layer for 'trie history', a precursor to serving historical state proofs for the path-based archive node. (#32596)
  • The txpool/valid.meter metric has been corrected. (#32845)
  • The engine API saw some fixes related to fork compatibility checks. (#32800, #32731)

For a full rundown of the changes please consult the Geth 1.16.5 release milestone.

As with all our previous releases, you can find the:

Loading

Bioelectric Infusers (v1.16.4)

26 Sep 09:41
@fjl fjl
v1.16.4
41714b4

Choose a tag to compare

View all tags
Bioelectric Infusers (v1.16.4)

This release enables the Osaka (Fusaka) fork on testnets. We also enable two blob-parameter only (BPO) forks for the testnets.

  • Holesky

    • Osaka at time 1759308480 (2025-10-01 08:48:00 UTC)
    • BPO1 at time 1759800000 (2025-10-07 01:20:00 UTC)
    • BPO2 at time 1760389824 (2025-10-13 21:10:24 UTC)

  • Sepolia

    • Osaka at time 1760427360 (2025-10-14 07:36:00 UTC)
    • BPO1 at time 1761017184 (2025-10-21 03:26:24 UTC)
    • BPO2 at time 1761607008 (2025-10-27 23:16:48 UTC)

  • Hoodi

    • Osaka at time 1761677592 (2025-10-28 18:53:12 UTC)
    • BPO1 at time 1762365720 (2025-11-05 18:02:00 UTC)
    • BPO2 at time 1762955544 (2025-11-12 13:52:24 UTC)

With BPO1 and BPO2, the blob capacity of these networks will increase as follows:

  • BPO1: max blobs/block: 15, target: 10
  • BPO2: max blobs/block: 21, target: 14

As of this release, the default block gas limit is set to 60M gas.
This is the recommended limit that we, as client authors, feel comfortable with.

CLI commands

  • geth snapshot and related commands no longer fail due to not finding the trie journal file. (#32531)
  • A regression in geth snapshot dump and geth export-preimages is resolved. (#32650)
  • We have added an experimental zkVM 'guest program', keeper, to the source tree. (#32543, #32638, #32736)

RPC

  • eth_call and related operations were fixed to not apply the EIP-7825 per-transaction gas limit when executing under Osaka fork rules. (#32641)
  • For eth_getLogs and other log filtering operations, it is now possible to configure the number of addresses allowed in the filter using the --rpc.logquerylimit flag. (#32327)
  • Starting Geth with the --state.size-tracking option enables collection of precise state size numbers, which can be read using the debug_stateSize endpoint. (#32362)
  • The new debug_executionWitness and debug_executionWitnessByHash methods create a block witness for stateless execution. (#32216)

Tracing & ABIGEN

  • There is a new CodeChangeV2 hook, with a CodeChangeReason parameter. (#32525, #32535)
  • In certain corner-cases related to SELFDESTRUCT, OnBalanceChange was not invoked. (#32526)
  • BoundContract in accounts/abi/bind/v2 now exposes an Address method. (#32559)

Core

  • The EVM MODEXP precompiled account has seen some optimizations to improve performance for worst-case inputs. We are especially grateful for @GottfriedHerold's work on improving the underlying math/big library. (#32527, #32553, #32568, #32576)
  • The blobpool will now perform a migration to the v1 blob proof format around the time of the fork. (#31966, #32577, #32534, #32656, #32716)
  • engine_getBlobs has been updated for improved spec compliance and to deal with the conversion of the blob tx proofs. (#32536, #32538, #32578)
  • The path-based state database has seen some fixes to prevent database corruption, which could sometimes occur when Geth is terminated abnormally, e.g. by a short stop timeout in Docker. (#32557, #32447)
  • All engine API operations, and eth_config, now support BPO-style forks. (#32589, #32615, #32636, #32579)
  • This release includes some work towards supporting historical state proofs in the path-based archive node implementation. (#32418, #32523, #32649)
  • Pebble stall counter are now correctly reported for each opened database. (#32563)

Networking

  • The node discovery iterator was updated to improved geth startup time and reactivity when the node table becomes empty. (#32517, #32518)
  • A hang in the 'eth' protocol test suite was resolved. (#32551)

Build

  • The KZG proof libraries have been updated to the latest release to fix a vulnerability. Fortunately, the vulnerability would only have become usable after the Osaka fork, so there is no risk for users of current versions. (#32640, #32639)
  • go-ethereum now requires Go 1.24 or later. (#32584, #32598)
  • This release is built with Go 1.25.1 (#32593)
  • execution-spec-tests has been bumped to v5.1.0 (#32592, #32742)

Contributors

GottfriedHerold
Loading

Impact Restrictors (v1.16.3)

02 Sep 08:42
@gballet gballet
v1.16.3
d818a9a

Choose a tag to compare

View all tags
Impact Restrictors (v1.16.3)

What's Changed

This is a maintenance release to prepare for the Fusaka release next week. It contains a state history rewrite, fixes for the Osaka devnets, performance improvements, and a few bug fixes.

Fusaka

  • Fix: use blob parameters from current header #32424
  • Convert legacy sidecar in Osaka #32347

Core

  • Stabilize tx relay peer selection #31714
  • Reduced number of allocation when comparing transactions #31912
  • Rework tracer and track origin value of dirty nodes #32306
  • Avoids loading the same blob tx multiple times #32190
  • Fix modexp input check #32363
  • GetBlockReceipts also handles pending blocks #32461
  • Tree node prefetching for increased loader performance #32134
  • Parallelized db inspect #32506

RPC

  • Apply precompile overrides in DoEstimateGas #31795
  • Fix uncle reward accounting in supply_tracer #31882
  • Checks ErrGasLimitTooHigh in conditions in gas estimator #32348
  • Implement EIP-7910 - eth_config JSON-RPC Method #32239
  • Add SetWebsocketReadLimit in RPC Server #32279
  • graphql: add query depth limit to prevent DoS attacks #32344
  • Adds codeHash to prestateTracer's account structure #32391
  • Remove deprecated method debug_seedHash #32495

Others

  • Introduce the TransitionState object #31634 and #32366
  • Fix ledger version check for EIP-155 support #32417
  • Fix: don't return an error when a nil peer is found in GetHeader #32369
  • Add support for Go 1.25 #32425 and #32412
  • Add trie depth-tracking metrics #32388 and #32507
  • Implement EIP-7864 - binary trees 32365
  • Improved ETA calculation #32521

For a full rundown of the changes please consult the Geth 1.16.3 release milestone.

As with all our previous releases, you can find the:

Loading

Sprouted Seed Vial (v1.16.2)

04 Aug 14:13
@rjl493456442 rjl493456442
v1.16.2
dd1ebac
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Sprouted Seed Vial (v1.16.2)

This is a maintenance release that includes implementations of the Fusaka EIPs, along with
several new features, optimizations, and bug fixes. Upgrading to this version is optional,
but feedback from those who do is greatly appreciated.

Fusaka:

  • Implement EIP-7825 - Transaction Gas Limit Cap. (#31824,#32230)
  • Implement EIP-7934 - RLP Execution Block Size Limit. (#31990)
  • Implement EIP-7939 - CLZ opcode. (#31989,#32172)
  • Implement EIP-7918 - Blob base fee bounded by execution cost. (#31965)
  • Implement EIP-7951 - Precompile for secp256r1 Curve Support. (#31991)
  • Implement EIP-7892 - Blob Parameter Only Hardforks. (#32193)
  • Implement EIP-7883 - ModExp Gas Cost Increase. (#32231)
  • Add Block-level accessList structure. (#31948)
  • Limit the max blobs in blob transaction. (#32246)

Core:

  • Reduce the memory allocation in trie hash function. (#31902)
  • Improve the background sync mechanism of the freezer. (#32135)
  • Introduce file-based state journal. (#32060)
  • Fix the dropping oversized transaction announcements. (#32210)
  • Fix the condition that disables direct ancient sync mode. (#32188)
  • Add an interface for the jump destination analysis cache. (#32143)
  • Fix incorrect address length in historical state reader. (#32248)
  • Fix a dead lock in state history indexer. (#32260)
  • Expose SigHash of SetCodeAuthorization for customized signing. (#32298)

RPC:

  • Reject eth_getLogs requests that include both block hash and block range. (#31877)
  • Fix block overrides in debug_traceCall. (#32183)
  • Introduce debug_sync to perform a trusted full chain sync. (#32177,#32149)

Others:

  • Add automatic package aliasing in rlp code generator. (#31148)
  • Add the metrics for tracking snap sync duration. (#32258)
  • Update checkpoints for blsync and filtermaps. (#32336)
  • Add test suite for ENRRequest. (#32303)

For a full rundown of the changes please consult the Geth 1.16.2 release milestone.

As with all our previous releases, you can find the:

Loading