Skip to content

Conversation

raa-dev
Copy link
Contributor

@raa-dev raa-dev commented May 5, 2024

  • devp2p section added into the sidebar
  • devp2p page and it's scaffoling added

@raa-dev raa-dev linked an issue May 5, 2024 that may be closed by this pull request

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

@raa-dev raa-dev added documentation Improvements or additions to documentation enhancement New feature or request page-request Add a new page labels May 27, 2024

This comment was marked as outdated.

This comment was marked as outdated.

@raa-dev raa-dev force-pushed the 148-devp2p branch 2 times, most recently from 988b4ed to 1236e8a Compare May 27, 2024 05:33
@eth-protocol-fellows eth-protocol-fellows deleted a comment from github-actions bot May 27, 2024

This comment was marked as outdated.

This comment was marked as outdated.

@raa-dev raa-dev mentioned this pull request Apr 24, 2025
4 tasks

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

@raa-dev raa-dev marked this pull request as ready for review May 7, 2025 05:15
@raa-dev raa-dev requested a review from taxmeifyoucan May 7, 2025 05:19
@raa-dev
Copy link
Contributor Author

raa-dev commented May 7, 2025

Hey there

I finally merged the two devp2p PRs into one. I cherry-picked @RazorClient meaningful commits. I think it's ready for review.
I rebased the current branch with the latest changes from main, so the process implied to fixing some conflicts and updating some typos from pectra page.

Also, I don't know why but the spell check is still pointing two "words" but if you check where they come from, they are part of an hex address. I tried to wrap it into `` , but it didn't work and I do not think it worths to add them to the wordlist... any suggestions here?

Any further suggestion from the review process, i'll be in touch. @raxhvl @taxmeifyoucan

Pd. I suggest to mark the other PR #365 as abandoned/closed, and once the current one is ready for merging let's use the squash one.

cc. @SiddharthV1

@raa-dev raa-dev requested a review from raxhvl May 7, 2025 05:27
@raxhvl
Copy link
Member

raxhvl commented May 7, 2025

Thanks @raa-dev for wrapping this up. I will review it.

Also fixed the spell check error.

Copy link
Contributor

@taxmeifyoucan taxmeifyoucan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks a lot for putting this all together! I think the page is great.

Regarding technical details, maybe @angaz could provide more feedback


> :warning: This article is a [stub](https://en.wikipedia.org/wiki/Wikipedia:Stub), help the wiki by [contributing](/contributing.md) and expanding it.
This section will cover the networking protocol used by the Execution Layer (EL).
First, we will provide some background on computer networks and then we will dive into the
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think EL networking page should go as far as explaining OSI, it can assume some prior knowledge. There is a lot of existing resources and your explanation is also good so maybe it could live somewhere in development resources and be referenced here and CL networking as knowledge dependency

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just to be on the same page here. Would this imply to remove the OSI introduction section, right?
I took a look at the dev resources and most of them -if not all- were external sources. Want me to refer the books I based the section from there?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would move the section elsewhere and reference it maybe with other sources. You can create a page in development section dedicated to networking with your explanation and links to all relevant resources

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moved the networking overview to the dev resources already. Left some useful information as part of the introduction though.
Please mark the conversation as resolved if you consider it that way, otherwise i'll follow up any further comment/suggestion

Where ENR is the Ethereum Node Record, a standard format for connectivity for nodes. Which it is explained below.

---
Currently, the execution clients are using the [Discv4 protocol](https://github.com/ethereum/devp2p/blob/master/discv4.md) for the discovery process, although it is planned to be migrated to [Discv5](https://github.com/ethereum/devp2p/blob/master/discv5/discv5.md) in the future.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe at least some clients already support both but v4 wasn't fully deprecated yet? The point is it's definitely used already

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Afaik the goal is a migration from v4 to v5. As of the discv5 page from devp2p says it's a WIP still, so I don't know if I'm missed something regarding to the deprecation.
I'll dig about this a bit in order to confirm it and update the section

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's a pretty old page, discv5 is the standard today in CL and Portal network, EL is slower to transition but not sure what is the latest, which clients support it

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch there, thanks for the comment! Really appreciated it! I took some time to dive in some of the execution clients in order to verify the discv5 status, and as you mentioned most of them implemented already. I added a table in the section to reflect this status as of today. In each one of the clients I attached the github references

This comment was marked as outdated.

@raxhvl raxhvl changed the title gh-148 adding devp2p section feat: DevP2P May 19, 2025
@raxhvl raxhvl merged commit 11484c0 into main May 19, 2025
2 checks passed
@github-project-automation github-project-automation bot moved this from In progress to Done in V1.0 Wiki Release May 19, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request page-request Add a new page

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

DevP2P

4 participants