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. |
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.