Add withdrawal credentials documentation page#17133
Merged
Merged
Conversation
Buttaa
requested review from
corwintines,
minimalsm,
pettinarip and
wackerow
as code owners
✅ Deploy Preview for ethereumorg ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
github-actions
Bot
added
the
translation 🌍
- Updates command about account types to include 0x02 - Adds link to new withdrawal credentials page
wackerow
reviewed
Jan 22, 2026
|
|
||
| - **New validators:** Choose `0x02`. It's the modern standard with better compounding and flexibility. | ||
| - **Existing 0x01 validators:** Consider converting to `0x02` if you want rewards to compound above 32 ETH or plan to consolidate validators. | ||
| - **Existing 0x00 validators:** Upgrade immediately—you cannot withdraw without updating your credentials. You must first convert to `0x01`, then you can convert to `0x02`. |
Member
There was a problem hiding this comment.
Not sure how I feel about the "upgrade immediately" comment... seems to imply an immediate danger if the user does not, but they can do this at any time.
I get the potential that they could lose access to their keys.. @Buttaa have you seen a lot of cases of people getting locked out over time?
How about softened a little to just:
Suggested change
| - **Existing 0x00 validators:** Upgrade immediately—you cannot withdraw without updating your credentials. You must first convert to `0x01`, then you can convert to `0x02`. | |
| - **Existing 0x00 validators:** Upgrade highly recommended—you cannot withdraw without updating your credentials. You must first convert to `0x01`, then you can convert to `0x02`. |
wackerow
approved these changes
Jan 23, 2026
Member
|
@all-contributors please add @Buttaa for content |
Contributor
|
I've put up a pull request to add @Buttaa! 🎉 |
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a new documentation page explaining validator withdrawal credential types (0x00, 0x01, 0x02) under
/developers/docs/consensus-mechanisms/pos/withdrawal-credentials/.The page covers:
Links to tools for managing and converting credentials (Launchpad, etc.)