Under normal circumstances, you will likely just select an Execution and Consensus client when you first create your Rocket Pool node and will let them happily run for the life of your Node. However, there are a few situations where you may want to change your client selection. Here are a few examples:
Luckily, the Smartnode stack makes changing clients extremely easy. All it takes is a few changes in the Configuration TUI, and some optional extra commands to back up your existing client data before changing clients.
Prior to changing your Execution client, it's worth noting the following points:
The first step in the process is an optional one: if you like, you can export your existing chain data for your current Execution client. This will let you free up valuable disk space on your node for your new Execution client, and you can keep the old chain data around in case you want to revert back to the old client and pick up where you left off.
Please refer to the Backing Up Your Node guide for details.
To change your selected client, run rocketpool service config
to enter the configuration UI.
Navigate to the Execution Client (ETH1)
section, and select the Execution Client
dropdown:
Open the dropdown with Enter
, use the arrow keys to navigate to your client of choice, and press Enter
again to confirm the selection.
Note that each client has its own unique options, so you may see some additional settings appear in this screen after you select a different client. Feel free to explore through them to see how they affect things.
When you're happy with your choice, press Esc
to return to the main menu, then Tab
to highlight the Review Changes and Save
button.
You will be presented with the review screen, which will show your client selection change:
Press Enter
to accept the changes, and you're done!
Your new Execution client will begin syncing immediately.
As usual, you can follow it with rocketpool service logs eth1
.
We recommend you do this to verify there are no errors, and that it works properly.
Now that the Execution and Consensus layers have merged, taking down your Execution client will also take down your Consensus client until your Execution client has finished resyncing. This means your node will stop attesting and proposing blocks, and it will leak ETH instead of earning it!
To avoid this and continue validating while your Execution client resyncs, please set up a fallback node.
This is not a required step, but we strongly recommend you remove the chain data from your old client now that you've switched to a new one so you can free up disk space for it.
To do this, simply run the following command:
This will delete all of your Execution client data and start it over.
Since you just selected a new Execution client, it won't be affected by this - essentially, all it will do is delete your old chain data.
You should do this as soon as possible after switching clients to prevent unnecessary loss of progress on your new client.
Changing Consensus clients is even easier than Execution clients, thanks to Checkpoint Sync. This feature lets you immediately sync a new Consensus client with the network, so there's no need to preserve your old chain data.
Start by using the rocketpool service config
UI and navigating to the Consensus Client (ETH2)
section.
Next, select the Consensus Client
dropdown:
Open the dropdown with Enter
, use the arrow keys to navigate to your client of choice, and press Enter
again to confirm the selection.
Note that each client has its own unique options, so you may see some additional settings appear in this screen after you select a different client. Feel free to explore through them to see how they affect things.
Next, verify that you're using a Checkpoint Sync provider:
If you don't have a Checkpoint Sync provider configured, you can easily use instructions from here to do it for free!
When you're happy with your choice, press Esc
to return to the main menu, then Tab
to highlight the Review Changes and Save
button.
You will be presented with the review screen, which will show your client selection change:
Press Enter
to accept the changes, and you're done!
Your new Consensus client will begin syncing immediately.
As usual, you can follow it with rocketpool service logs eth2
.
We recommend you do this to verify there are no errors, and that it works properly.