Update Withdrawal Keys for Ethereum Validator (BLS to Execution Change or 0x00 to 0x01) with ETHDO
A simplified guide to help you update your validators BLS 0x00 credentials to execution withdrawal 0x01 credentials using the ETHDO tool by wealdtech.
A simplified guide to help you update your validators BLS 0x00 credentials to execution withdrawal 0x01 credentials using the ETHDO tool by wealdtech.
Greetings, fellow ETH staker! If you were staking before April 2, 2021, setting ETH withdrawal (0x01) credentials was not yet released and so, this guide is relevant for you.
As of the Shapella upgrade, ETH validators with 0x00 credentials should update to 0x01 credentials to enable partial withdrawals, the sweeping of excess ETH > 32.
If your validator previously voluntarily exited or you now would like to stop validator duties, you'll need to set your withdrawal credentials to fully reclaim your staked ETH.
Your validator's mnemonic keys (the offline 24 word secrets)
A ETH staking node using Ubuntu or Linux, also known as online computer.
A USB storage key for moving files between the offline and online computer.
If you no longer have a synced full node, use option 1.
Option 2 uses your own consensus client to generate chain information.
Congrats! Your BLS to Execution change is now pending in a queue, waiting to be included in a block.
Up to 16 BLS to Execution changes are included in each proposed block.
Depending on the withdrawal queue size, your withdrawal change may take up to a few days to be finalized.
Terminology: prefix of 0x01 = "Type 1" = execution withdrawal credentials = Withdrawals enabled
As a partial withdrawal, periodically every few days any amount of ETH over 32 will be automatically swept to your withdrawal address.
Official Consensus Layer Withdrawal References
An ETH withdrawal address you control the private keys to, ideally one from a hardware wallet. DO NOT USE A EXCHANGE ADDRESS!
An offline air-gapped computer. Create a Linux Live USB like or ; needs a USB key.
Familiarize yourself with the .
Download Ethdo v1.30.0 from Github
Example output of a validator with BLS credentials.
Download Ethdo v1.30.0 from Github
Example output of a validator with BLS credentials.
Run the following command to call your consensus client and generate a list of active validators with relevant information for use on your offline computer. In order to generate this list from your local beacon node, is enabled; otherwise the default fallback beacon node, , will be called.
Double check your work as this is permanent once set!
FINAL REMINDER: DO NOT USE AN EXCHANGE ETH ADDRESS AS YOUR WITHDRAWAL ADDRESS
If you no longer have a synced full node, you can alternatively upload change-operation.json
file to
Prysm:
Nimbus:
Lighthouse:
Teku:
Lodestar:
Ethdo official withdrawals guide:
Attestant's Post:
Find Ethstaker frens on the Discord!
Use reddit: , or , or
: We build this guide exclusively by community support!π
Feedback or pull-requests:
Alternatively, check your favorite beacon chain explorer such as and for the 0x01 credentials.
reference: