docs(tutorials): add 'How Ethereum Addresses Are Generated' tutorial #16480
Conversation
ndubuisi-ugwuja
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. |
|
Thanks @ndubuisi-ugwuja! Will try to get some eyes on this over the next week or two |
|
Hey @ndubuisi-ugwuja, appreciate the work here! Taking a look through, few initial thoughts... My first take is that the vast majority of this doesn't really seem like a "tutorial." This feels much more like details that we would expect to see in the Docs... Typically the tutorials are designated for follow-along guide that developers can walk through to actually do something, and the only part that feels doable here is the "Simple code snippets you can paste and try JavaScript" section, which isn't really guided, but more just told to copy/paste, making assumptions that they know how to set up ethers.js, etc. There is already a page dedicated to Accounts on Ethereum... that page introduces a handful of the concepts you're outlining here. Would be careful with potentially repeating the information there, but we could focus on how to expand from there. IMO, using this to expand on the docs to include more detailed information about how derivations happen, for example from mnemonic > tree of private keys > public keys > address, would be informative, and fill a gap that currently seems to exist in the docs. I'm imagining something that helps explain the steps involved in Ian Coleman's BIP-39 demo. I would see this living at a new sub-page to the /developers/docs/ pages. I could also see this as a more intermediate-to-advanced topic, imagining some more explanation along the way about how this math works, akin to a page such as this Elliptic Curve explainer on learnmeabitcoin.com (just an idea for inspiration) Alternatively, if we want to keep this as a "tutorial" then I would suggest we try trim down explanations that are already explained elsewhere (linking out where needed), and instead adding more details for how a developer could step through some tools to learn the details. To me this would include using libraries that demonstrate what's involved at each step of the derivation, so developers can get a firm grasp of how this works. This could also include the "easy path" of how to set up and use ethers.js to simply generate keys. Let me know your thoughts and how you'd like to proceed! |
|
I guess my last thought after posting and re-reading you original post, if you do want to keep this as a tutorial for beginners, again, would just try to focus on clear and simply step-by-step instructions that would get someone started with the local tools needed, with some example inputs, expected outputs, and how they could use this while building. Try to harness the existing docs where possible for the non-guided parts. |
|
Feedback on “How Ethereum Addresses Are Generated” Tutorial
Hi Wackerow,
Thank you so much for taking the time to review my submission and share
such thoughtful feedback. I completely understand your points — after
rereading the piece, I agree that it leans more toward a conceptual
explanation than a step-by-step tutorial.
I’d like to proceed by expanding it into a *Docs sub-page *like you
mentioned - /developers/docs/ pages , focusing on how derivations happen
from mnemonic → seed → private key → public key → address. I believe this
direction will fit better alongside the existing “Accounts” documentation
and fill the gap you mentioned around derivation and address generation.
I’ll make sure the updated version aligns with the existing docs structure
and references relevant pages where needed.
Please let me know if that approach sounds good before I begin revising.
Best regards,
*Ndubuisi Ugwuja*
@ndubuisi-ugwuja <https://github.com/ndubuisi-ugwuja>
…On Tue, Oct 21, 2025 at 1:50 AM wackerow ***@***.***> wrote:
*wackerow* left a comment (ethereum/ethereum-org-website#16480)
<#16480 (comment)>
I guess my last thought after posting and re-reading you original post, if
you do want to keep this as a tutorial for beginners, again, would just try
to focus on clear and simply step-by-step instructions that would get
someone started with the local tools needed, with some example inputs,
expected outputs, and how they could use this while building. Try to
harness the existing docs where possible for the non-guided parts.
—
Reply to this email directly, view it on GitHub
<#16480 (comment)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/BIN4RMJQZ6WCBWGK3D3KEF33YV7MJAVCNFSM6AAAAACI4FXEZ2VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTIMRUGI3DENBUGQ>
.
You are receiving this because you were mentioned.Message ID:
***@***.***>
|
|
sgtm!... cc: @konopkja @mnelsonBT re: dev docs addition planning, if you have any thoughts to add here @ndubuisi-ugwuja Would recommend starting with an outline posted as a new issue.. ping us in there and we can take it from there! Going to close this PR out for now to keep things clean.. Thanks! |
github-actions
bot
added
the
abandoned
2 participants
Description
This pull request adds a new beginner-friendly tutorial titled “How Ethereum Addresses Are Generated.”
It explains step-by-step how Ethereum addresses are derived from private keys using elliptic curve cryptography (secp256k1) and Keccak-256 hashing.
The tutorial covers:
File added:
public/content/developers/tutorials/how-ethereum-addresses-are-generated/index.md
The goal of this tutorial is to help newcomers and technical learners understand the cryptographic foundations of Ethereum addresses in a clear and beginner-friendly way.
Related Issue
N/A – this is a new tutorial contribution.