Skip to content

Bepto Berachain Upgrade 🤕⛽

Our next upgrade adjusts the effect of BRIP-0002 - Gas Fee Modifications, to eliminate the gas price floor and give us more time to examine the issue more closely.

This is an execution client only hardfork.

WARNING

All node operators — validators and regular RPC — must upgrade their Execution Client to the versions below to continue following the chain.

Upgrade Timeline

DateMilestone
Sep 15, 2025Bera-Reth and Bera-Geth binaries released
Sep 17, 2025 @ 1600 GMT / 1200 EDTBepolia hardfork activates
Sep 30, 2025 @ 1600 GMT / 1200 EDTMainnet hardfork activates

Upgrade Details

Berachain released stand-alone executables and Docker images for Linux ARM and AMD64 architectures for Bera-Reth and Bera-Geth. All clients are easily compiled for other systems and architectures with a few minutes' time; review their respective READMEs for details.

New genesis files are required for Bera-Reth/Geth.

No configuration changes are required.

Upgrade Instructions

TIP

If you duplicate your installation to test the upgrade — which is recommended — don't duplicate these identity files to avoid interfering with your production node's peering:

  • Bera-Reth: discovery_secret
  • Bera-Geth: nodekey
  • Beacon-Kit: priv_validator_key.json

WARNING

If you compile your own build, do so against the recommended release branches.

  1. Stop all clients.

  2. Install the recommended release version of Bera-Geth or Bera-Reth, linked below, into place.

  3. Install the new Reth/Geth genesis files linked below into place, and verify the hash with md5sum <file>. Then:

    • Bera-Reth: overwrite $RETH_DATA/genesis.json.

    • Bera-Geth: run bera-geth init against your Geth data directory with the supplied genesis file. We recommend making this a permanent part of every bera-geth startup, especially in kubernetes. Our recommended startup process now includes this.

      bera-geth init --datadir /path/to/geth/datadir /path/to/eth-genesis.json

  4. Start all clients.

ChainGithub release pageRelease date
Mainnet & BepoliaBera-Geth v1.011602.4Sep 15
Mainnet & BepoliaBera-Reth v1.1.0Sep 15
Bera-Reth/Geth Genesis FileUpdatedDownload link & md5 hash
BepoliaSep 15c27c1162af33f7f5401bcef974a64454
MainnetSep 15a401a53f380e3ce49ef358fead5d3b16

Confirm upgrade

Bera-Geth should log the fork timestamp, and the corresponding clock time in your server's timezone:

txt
bepolia:
 Ready for fork activation                fork=Prague2 date="17 Sep 25 18:00 CEST" remaining=46h5m32s  timestamp=1,758,124,800

mainnet:
 Ready for fork activation                fork=Prague2 date="30 Sep 25 18:00 CEST" remaining=358h4m52s timestamp=1,759,248,000

Bera-Reth should log the fork timestamp:

txt
bepolia:
Berachain Prague2 configuration: {time=1758124800, min_base_fee=0 gwei}

mainnet:
Berachain Prague2 configuration: {time=1759248000, min_base_fee=0 gwei}