Skip to content
You are reading the Teku development version documentation and some features may not be available in the stable release. You can switch to the stable version using the version box at the bottom of the screen.

Updated on May 20, 2022

The Merge

The Ethereum upgrade known as The Merge will merge the Beacon Chain into Ethereum Mainnet, turning Mainnet into a combination of an execution layer and consensus layer. The Merge will transition Mainnet from proof of work to proof of stake consensus.

You can prepare Teku for The Merge and test Teku with Hyperledger Besu on the Kiln Merge testnet.

Execution and consensus clients

After The Merge, a full Ethereum Mainnet node will be a combination of an execution client (previously called an Ethereum 1.0 client) and a consensus client (previously called an Ethereum 2.0 client).

Execution and consensus clients communicate with each other using the Engine API.

Ethereum Merge node

Execution clients

Execution clients, such as Besu, manage the execution layer, including executing transactions and updating the world state. Execution clients serve JSON-RPC API requests and communicate with each other in a peer-to-peer network.

Consensus clients

Consensus clients, such as Teku, contain beacon node and validator client implementations. The beacon node is the primary link to the Beacon Chain (consensus layer). The validator client performs validator duties on the consensus layer. Consensus clients serve REST API requests and communicate with each other in a peer-to-peer network.

What happens during The Merge

Before The Merge, the execution and consensus clients’ configurations will be updated to listen for a certain total terminal difficulty (TTD) to be reached on the execution endpoint.

Teku will periodically request information about the execution client’s configuration to check that they agree on the configuration and can connect. Teku will log warnings if the configuration doesn’t match.

The consensus layer will enable the Merge configuration (Bellatrix) before reaching the TTD. Once the execution layer blocks reach the TTD, the Beacon Chain will merge into Ethereum Mainnet, and Ethereum will move to a proof of stake network.

After The Merge, a Mainnet node operator must run both an execution client and a beacon node at the same time. To become a validator, you must also run a validator client (either in the same process as the beacon node or separately).

After The Merge, in addition to validators earning rewards for performing validator duties, fee recipients will also earn rewards for the inclusion of execution layer transactions.

You can prepare Teku for The Merge.

Questions or feedback? You can discuss issues and obtain free support on Teku Discord channel.
For paid professional support by Consensys, contact us at [email protected].