Skip to content

enr-entries/snap.md: add the snap entry - #287

Open
MysticRyuujin wants to merge 1 commit into
ethereum:masterfrom
MysticRyuujin:enr-snap-entry
Open

MysticRyuujin wants to merge 1 commit into
ethereum:masterfrom
MysticRyuujin:enr-snap-entry

Conversation

@MysticRyuujin

@MysticRyuujin MysticRyuujin commented Oct 12, 2026 •

Copy link
Copy Markdown

Closes #286.

Add enr-entries/snap.md. The entry value is a list of the snap versions that a node serves:

  • []: snap/1 only. This is the value that go-ethereum writes today, so existing records keep their meaning.
  • [1, 2]: snap/1 and snap/2.
  • [2]: snap/2 only.

DNS discovery lists select snap servers by this entry, for example devp2p nodeset filter -snap and the snap.* trees of EIP-1459. Before this change, no specification defined the entry, and the entry could not show which versions a node serves. snap/2 (EIP-8189) is not compatible with snap/1, so a node that looks for snap/2 servers needs the version list. The EIP-8189 update in ethereum/EIPs#12493 refers to this format.

The spec also says:

  • A node adds the entry only when it serves snap requests, not while it only uses snap to synchronize.
  • Implementations ignore list elements that they do not understand.
  • A node that looks for a specific version selects on the list, not on the presence of the entry.

Client changes that write this format:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Specify the "snap" ENR entry and how it signals snap versions

1 participant