reth_gnosis v2 is a major milestone in our journey of using reth for Gnosis Chain. We bring all the goodness of upstream reth's v2 along with major additions for Gnosis.
Storage v2
Reth uses the V2 hot/cold storage layout by default for new databases. Read more here: https://reth.rs/run/storage/
Pre-merge execution
reth_gnosis can now execute blocks since genesis (AuRa + POSDAO + post-merge), making "post-merge state imports" obsolete. State imports are still supported with the opt-in flag "--gnosis.import-post-merge-state true", but it locks you to storage v1. Default mode starts with storage-v2 and full-sync.
Snapshot downloads
Taking inspiration from reth, reth_gnosis also comes with modular snapshots. You can use reth download to download a minimal/full/archive node snapshot, instead of syncing from genesis. This uses storage-v2, and significantly reduces sync times.
Minimal mode
New pruning configurations enable a much lighter node. If you don't need archival data, running a full or even minimal node (rather than the default archival node) will keep your disk requirements low. For example, validators can use the --minimal flag during downloads and running the node.
Minimal node size (last week of May)
- Chiado: 19 GB
- Gnosis: 150 GB
Reth v2
All the other good things that ship with reth v2, such as Parallel State Calculation, Reducing Data Redundancy and Tiered Storage. You can read more about this here: https://www.paradigm.xyz/2026/04/releasing-reth-2-0
Important
The reth db migrate-v2 command is not supported on reth_gnosis v2.0.0
v2.0.0 is compatible with all previous versions. If you already have a node with storage-v1, running reth_gnosis v2.0.0 will continue using storage-v1. We will enable the migrate command in a future release, but it is probably easier and faster for you to just re-sync your node with snapshot downloads.
Quick shorthands
Validators
reth download --chain gnosis --minimal && reth node --chain gnosisRPC Providers or Indexers
reth download --chain gnosis --archive && reth node --chain gnosisDApp Backend
reth download --chain gnosis --full && reth node --chain gnosisWhat's Changed
- (feat) AuRa logic - Genesis through Paris by @debjit-bw in #125
- Patch fix for gnosis-primitives by @debjit-bw in #127
- enable era export in cli by @debjit-bw in #129
- feat: add versioning support with git metadata for reth_gnosis by @debjit-bw in #131
- feat: add snapshot API URL support for Gnosis Chain and Chiado by @debjit-bw in #130
- refuse migrate command by @debjit-bw in #133
- feat: update reth_gnosis version to 2.0.0 by @debjit-bw in #132
Full Changelog: v1.2.1...v2.0.0