Gnosis hardfork support

• rpc: fix panic on GetEthV1BeaconBlobs (#17992) by @domiwei in #18232
• rpc: fix invalid key error code in eth_getStorageAt by @canepat in #18238
• cl/beacon: add single_attestation event topic support (#18142) by @domiwei in #18277
• Gnosis Balancer by @mh0lt in #18282
• bittorrent: torrent excessive wantPeers event fix by @anacrolix in #18256

Full Changelog: v3.3.1...v3.3.2

• We have new Docs and HelpCenter: https://docs.erigon.tech/
• Support of historical eth_getProof (#12984). It requires
  --prune.include-commitment-history flag.

RPC

• rpc: fix txpool_content crash: unknown by @canepat in #18120

CL

• Caplin: Simplified peer refreshing (#18123) by @domiwei in #18152

TxPool

• txpool: remove double PopWorst() in pending pool overflow by @AskAlexSharov in #18159

Sync

• Torrent client fixes by @anacrolix in #18179

Full Changelog: v3.3.0...v3.3.1

• rpc: fix txpool_content crash: unknown by @canepat in #18119
• version by @AskAlexSharov in #18057

Full Changelog: v3.2.3...v3.2.4

This release doesn't have any disk-format changes (only software features).

• We have new Docs and HelpCenter: https://docs.erigon.tech/
• Support of historical eth_getProof (#12984). It requires
  --prune.include-commitment-history flag.

RPC

• eth_simulateV1: Complete implementation of Ethereum simulation API with support for state overrides, blob
  transactions, block overrides, and historical state roots (#15771)
• eth_createAccessList: StateOverrides parameter support (#17653)
• eth_call support blockOverrides (#17261)
• trace_filter: Block tags support (#17238)
• debug_traceTransaction: Self-destruct operation validation (EIP 6780) (#17728)
• eth_getTransactionReceipt: Pre-Byzantium transaction handling (#17479, #17509)
• eth_estimateGas: Improved handling with StateOverrides (#17914, #17295)
• debug_traceCall: System contract execution support (#17339)
• Blob transaction and blob base fee override support (#17313)

Consensus & Execution

• EIP-7928: BlockAccessList type support (#17544)
• EIP-7934: EstimateGas capped by MaxTxnGasLimit in Osaka (#17251)
• EIP-7702 transaction support in (r *Receipt) decodeTyped (#17412)
• Rewrite bytecode support for post-Merge blocks (#17770)

Changed

Execution Engine

• Experimental Parallel Exec (#16922)
• MAX_PENDING_PARTIALS_PER_WITHDRAWALS_SWEEP for Gnosis (#17501)
• Reduce goroutines amount produced by BitTorrent library (#17765)
• Up base image to Go 1.25-trixie (#17837)

Removed

• PoW mining was removed in #17813, which resulted in --chain=dev not being able to produce new blocks. Going forward
  we'll either sunset --chain=dev or switch it to mock CL (see #14753). If you need --chain=dev, please use Erigon
  3.2
• Holesky network support removed (#17685)
• eth/67 protocol support removed (#17318)
• SkipAnalysis VM optimization removed (#17217)

Full Changelog: v3.2.3...v3.3.0

• Caplin: add getBlobs support (fusaka) by @Giulio2002 in #17840

Full Changelog: v3.2.2...v3.2.3

v3.2.2 schedules Fusaka on Ethereum mainnet on December 3, 2025 at 09:49:11pm UTC. Thus it is a mandatory update for all Ethereum mainnet users.

New features

• Schedule Fusaka on Ethereum mainnet in #17736 by @yperbasis
• Tool to fetch and recover blobs from a remote beacon API in #17611 by @Giulio2002

Full Changelog: v3.2.1...v3.2.2

v3.2.1 is a bugfix release recommended for all users, especially validators.

Fixes

• Fix validators producing bad blocks on Hoodi in #17487 by @mh0lt
• RPC: fix "insufficient funds for gas * price + value" error in traces retrieval for a specific block (Issues #16909, #17232) in #17523 by @antonis19
• RPC: fix no changes and filter not found in eth_getFilter* (Issue #17246) in #17350 by @canepat
• RPC: debug_traceCall fix avoid to trace sysContract (Issue #17220) in #17360 by @lupin012
• CL: fix initial previous_version in fork_schedule (Issue #17262) in #17331 by @domiwei

Improvements

• Ethereum mainnet default block gas limit is raised to 60M in #17321 by @yperbasis
• CL: Allow blob requests after Fusaka in #17500 by @domiwei

Full Changelog: v3.2.0...v3.2.1

Erigon 3.2.0 "Quirky Quests" has a complete implementation of Fusaka and schedules it on the test nets (#17197):

• Holesky on Wednesday, 1 October 2025 08:48:00 UTC
• Sepolia on Tuesday, 14 October 2025 07:36:00 UTC
• Hoodi on Tuesday, 28 October 2025 18:53:12 UTC

Fixes

• Re-org/unwind fixes (#17105, #17165) by @taratorio
• RPC: Fixes to eth_getProof (#16220, #16251, #16564, #16606, #16687) by @awskii
• tracer: fix prestates for EIP7702 transactions (#16497) by @nebojsa94

Improvements

• New EL block downloader (#16270, #16673) by @taratorio
• Caplin p2p improvements (#16719, #16995) by @Giulio2002
• EVM: MODEXP precompile performance improvements (#16579, #16583, #16396, #17151) by @chfast & @yperbasis
• execution: more accurate bad block responses (#16994) by @taratorio
• Block builder: improve txpool polling (#16412) by @taratorio
• execution/stagedsync: handle sync loop block limit exhaustion (#16268) by @taratorio
• RPC: Apply batch limit to WebSocket/IPC connections (#16255) by @grandchildrice
• RPC: Estimate gas align to geth (#16397) by @lupin012
• snapshotsync: add support for --snap.download.to.block (#16938) by @taratorio

New features

• Complete Fusaka implementation (#16183, #16185, #16186, #16187, #16184, #16391, #16401, #16207, #16420, #16428, #16494, #16457, #16644, #16928, #16945, #17060, #16989, #17076, #17169) by @taratorio, @yperbasis, @Giulio2002 and @domiwei
• Implement eth/69 (#15279, #17186, #17171) by @shohamc1
• RPC: implement new eth_config spec (#16218, #16410) by @taratorio
• RPC: impl admin_RemovePeer (#16292) by @lupin012

Full Changelog: v3.1.0...v3.2.0

Erigon 3.2.0 "Quirky Quests" has a complete implementation of Fusaka and schedules it on the test nets (#17197):

• Holesky on Wednesday, 1 October 2025 08:48:00 UTC
• Sepolia on Tuesday, 14 October 2025 07:36:00 UTC
• Hoodi on Tuesday, 28 October 2025 18:53:12 UTC

Fixes

• Re-org/unwind fixes (#17105, #17165) by @taratorio
• RPC: Fixes to eth_getProof (#16220, #16251, #16564, #16606, #16687) by @awskii
• tracer: fix prestates for EIP7702 transactions (#16497) by @nebojsa94

Improvements

• New EL block downloader (#16270, #16673) by @taratorio
• Caplin p2p improvements (#16719, #16995) by @Giulio2002
• EVM: MODEXP precompile performance improvements (#16579, #16583, #16396, #17151) by @chfast & @yperbasis
• execution: more accurate bad block responses (#16994) by @taratorio
• Block builder: improve txpool polling (#16412) by @taratorio
• execution/stagedsync: handle sync loop block limit exhaustion (#16268) by @taratorio
• RPC: Apply batch limit to WebSocket/IPC connections (#16255) by @grandchildrice
• RPC: Estimate gas align to geth (#16397) by @lupin012
• snapshotsync: add support for --snap.download.to.block (#16938) by @taratorio

New features

• Complete Fusaka implementation (#16183, #16185, #16186, #16187, #16184, #16391, #16401, #16207, #16420, #16428, #16494, #16457, #16644, #16928, #16945, #17060, #16989, #17076, #17169) by @taratorio, @yperbasis, @Giulio2002 and @domiwei
• Implement eth/69 (#15279, #17186, #17171) by @shohamc1
• RPC: implement new eth_config spec (#16218, #16410) by @taratorio
• RPC: impl admin_RemovePeer (#16292) by @lupin012

Full Changelog: v3.1.0...v3.2.0-rc1

Erigon 3.1.0 Pebble Paws is a significant update for node operators and validators, focusing on stability, performance, and efficiency. This release introduces several new features and optimizations, including the default enabling of receipt persistence, a smarter snapshots downloader, and numerous consensus layer improvements and official support for Shutter Network on Gnosis Chain.

Breaking changes

• Port of external RPCDaemon now uses the same WebSocket port as the default for Erigon. (#15643)
• Docker Images: Docker images are now based on Debian. (#16228)
• Go Language Version: The required Go version is now golang 1.24.
• Receipt Persistence: The --persist.receipts flag is now enabled by default for Full and Minimal nodes (more details are provided below).
• Pebble Paws will be the last Erigon release series to officially support Polygon.

How to upgrade

Erigon 3.1 Pebble Paws will work flawlessly with old data. For those who want to ensure they have the absolute latest data files and any recent data-specific fixes, you can optionally perform a manual data upgrade. After upgrading your Erigon binary and having done a back-up of your data directory, just run the command erigon snapshots reset --datadir /your/datadir.

Key features

Disk Footprint and Management

Several improvements furtherly reduced the size of the Ethereum archive nodes while actually storing more data, making the nodes more cost-effective and easier to manage:

• The --persist.receipts flag is now enabled by default for Full and Minimal nodes. This downloads pre-calculated receipts, ensuring a consistent and predictable latency, meaning a more reliable system when interacting with the network, especially during high-traffic periods, and a 10x faster RPC for calls like eth_getLogs.

  • The size of the receipts is 300 GB for the Ethereum mainnet, 1 TB for the Polygon bor-mainnet, and 200 GB for the Gnosis Network. However, this can be disabled with the command --persist.receipts=false. In this case, the RPC calls will generate receipts on demand from the StateHistory. (#16040).

• The size of .ef files was reduced by 50% with better encoding, resulting in smaller archive nodes. (#12907)

• Rolled out phase 1 of history expiry, allowing nodes to drop pre-merge data, which significantly reduces storage requirements and simplifies node maintenance. (#15668)

• Efficiently upgrade the existing data using the new snapshots update and snapshots reset commands, reducing node downtime and resource usage while avoiding a full re-sync.

• Several optimization have been implemented to reduce latency, lower disk I/O, and optimize VM and snapshot operations, resulting in faster, more efficient node operation and easier maintenance (#14135, #14902, #15115, #15092, #16140).

Networking and Performance

• Faster and more reliable syncing: the new Bittorrent web seed implementation downloads entire files in a single stream instead of making many small-range HTTP requests, resulting in faster syncing, reduced server load, improved CDN compatibility, and enhanced protection against DDoS attacks. The downloader now automatically switches sources if the snapshot set becomes inaccessible, and once the snapshot files are downloaded, they are marked as read-only to prevent accidental corruption. Torrent logging and status outputs have been upgraded, offering clearer real-time insights into sync speed, estimated completion times, and the root causes of any synchronization stalls. (#15043)

• A new configuration flag now enables independent tuning of web seeding and peer-to-peer (P2P) download speeds, delivering more control over how data is sourced and transferred. (#15912)

• Improved and more reliable experience with faster, more accurate RPC responses, improved error handling, and broader support for new features and tools. (#13795, #13947, #14075, #14093, #14105, #14152, #14803, #14915, #14994, #15948, #16029, #16101)

• Smoother Polygon Network experiences with faster syncing, improved reliability, and better compatibility, thanks to a series of targeted bug fixes and optimizations. (#14056, #14080, #13845, #13807, #15595, #16160, #16035, #15538)

• The new probabilistic filter makes historical queries much faster and more efficient. (#15960)

Protocol

• Improved Caplin (Consensus Layer) reliability and performance with enhanced slot processing, better peer management, optimized block and attestation handling, new validator deposit toolingAore efficient reorg support. These updates provide smoother network participation, easier validator operations, and improved responsiveness. (#13825, #13858, #13883, #13893, #14158, #14128, #14913, #16084, #16083, #16219, #14890, #14875)

• Engine API and EIP Support: This release includes new Engine API methods like GetBlobsV1 and GetBlobsV2. It also implements various Ethereum Improvement Proposals (EIPs) related to blobs and gas, ensuring compatibility with upcoming network changes. (#13975, #15420)

• Added support for the latest protocol upgrades and features—delivering improved compatibility, security, and performance for users. (#14705, #14702, #14672, #15093, #15148, #15450, #15067, #15399, #15519, #15532, #15609, #15688, #14213)

Shutter Network

• Official support for Shutter Network has been added to Erigon Validators on Gnosis Chain, helping prevent malicious Maximal Extractable Value (MEV) attacks by enabling the use of encrypted transactions. (#13725, #13864, #13865, #13983, #14187, #16505, #16554, #16561, #16592, #16590)

• Further information can be found at https://github.com/erigontech/erigon/tree/release/3.1/txnprovider/shutter#shutter

QA and Testing

• Improvemend testing and QA to deliver more reliable releases and higher quality software by expanding automated testing, enforcing stricter failure checks, and enhancing test coverage for every commit. (#13783, #13755, #14094, #13926, #14115, #14100, [#14178](https://github.com/erigontech/e...