Skip to content

spec: add topic-discovery ENR entry; rename discng key#6

Merged
srene merged 1 commit into
masterfrom
feat/enr-topic-discovery-entry
May 19, 2026
Merged

spec: add topic-discovery ENR entry; rename discng key#6
srene merged 1 commit into
masterfrom
feat/enr-topic-discovery-entry

Conversation

@srene
Copy link
Copy Markdown
Member

@srene srene commented May 18, 2026

Summary

  • Adds enr-entries/topic-discovery.md defining the topic-discovery ENR entry, which signals that a node implements the topic discovery capability for Discv5 and is willing to participate in topic service tables, registrations, and lookups.
  • Renames the ENR key in discv5/discv5-theory.md from discng to topic-discovery, and links the theory section to the new entry doc.
  • Fixes a small inconsistency in the previous draft: it stated the value was an unsigned integer but the example showed 1.0. The new entry consistently uses 1.

Entry shape

entry-key   = "topic-discovery"
entry-value = version   (unsigned integer; 1 for the version described in discv5-theory)

Value is an unsigned integer rather than a presence-only flag so future non-backwards-compatible revisions can bump in place; implementations that do not understand a version SHOULD treat the node as if the entry were absent.

Files

  • enr-entries/topic-discovery.md (new)
  • discv5/discv5-theory.md — section "DISC-NG Capability" renamed to "Topic Discovery Capability"; key renamed; cross-link added.

Companion implementation PR

A matching go-ethereum PR will rename the ENR key and Go type names in the reference implementation.

Closes part of #5.

@srene srene linked an issue May 18, 2026 that may be closed by this pull request
Define enr-entries/topic-discovery.md for the TopDisc topic discovery
capability, with version-tagged unsigned-integer value so future
non-backwards-compatible revisions can bump in place.

Cross-reference the new entry from the ENR known-keys table in enr.md
and from the TopDisc Capability section of discv5-theory.md.
@srene srene force-pushed the feat/enr-topic-discovery-entry branch from 41634f9 to 40e8f77 Compare May 19, 2026 09:20
@srene srene merged commit f837e5e into master May 19, 2026
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.

Update enr.md to document protocol-specific ENR entries (including discng)

1 participant