Updated on January 17, 2023
Prepare for The Merge
If you’re running one or more Teku beacon nodes and validators on Ethereum Mainnet, prepare for The Merge by:
- Configuring the execution client.
- Configuring the fee recipient.
- Staying up to date on Teku releases.
You can make the configuration changes in Teku’s configuration file before The Merge.
You can also test Teku with Hyperledger Besu on the Merge testnet.
Configure the execution client
Before The Merge, validators require an execution client to get deposits for block proposals. Block proposals are intermittent, and a validator can get the data from other blocks if its execution client is offline.
After The Merge, execution clients will play a more crucial role in executing transactions. Service providers that provide execution layer access, such as Infura, won’t be adequate for a beacon node to continue to function on the network. You must set up an execution client for each beacon node you maintain, using the following steps. You can use any execution client with Teku.
- After The Merge, a beacon node won’t be able to have a failover execution client; a validator client will need a beacon node and execution client pair to provide failover functionality.
- When planning your solution, take into account that the traffic between the execution client and beacon node will be relatively high.
1. Configure the execution endpoint
After The Merge, you can’t use
eth1-endpoint to specify an external execution layer provider.
This option will be replaced by specifying
ee-endpoint for each beacon node.
2. Sync the execution client
Validators can’t produce attestations or blocks without a fully synced execution endpoint. To expedite network participation, sync your execution client on Ethereum Mainnet before the Merge configuration (Bellatrix) comes online.
3. Configure the JSON Web Token
JSON Web Token (JWT) authentication is used to secure the communication between the beacon node and execution client. You can generate a key for signing JWTs using a command line tool, for example:
openssl rand -hex 32 > token.txt
Provide the signing key to Teku using the
configuration option, and to the execution client using its configuration options.
For example, provide the key to Hyperledger Besu using the
Configure the fee recipient
After The Merge, execution layer transactions will be included in beacon node blocks, and validators will earn transaction fees. You can configure the recipient of these fees for each validator key.
For simpler configurations, configure the beacon node (and validator client if
run in a separate process) with a default fee recipient using
This fee recipient will be used for any duties performed by the beacon node.
For more complex configurations, provide a proposer configuration file that defines the default fee recipient plus
non-default fee recipients for any validators using the
A full consensus client (beacon node and validator client combined) can use either configuration option.
A stand-alone validator client should only specify
validators-proposer-config, and its attached beacon node should
Once Bellatrix is scheduled for activation on Mainnet, Teku will be released with updated configuration for Mainnet. Ensure your Teku client and execution client is up to date before Bellatrix is enabled.
You can follow Teku notifications by: