Skip to content

Report capabilities of the node that answered, not the one described - #80

Open
hjohn wants to merge 1 commit into
mainfrom
docs/node-capabilities-redirect
Open

hjohn wants to merge 1 commit into
mainfrom
docs/node-capabilities-redirect

Conversation

@hjohn

@hjohn hjohn commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

NodeInfo.capabilities could only be populated when the NodeInfo happened to describe the node answering the request. On a redirect it describes a different node, whose capabilities the answering node cannot know, so the field was left unset - which is precisely the case where a client is otherwise left with no way to learn anything.

Moved to PlatformInfo, where it unambiguously means "the capabilities of the node that answered this request" and is therefore always populated, redirect or not. A client that follows a redirect asks the next node for its own; a client that stops following already holds the capabilities of the node it is connected to.

Removed from NodeInfo outright rather than reserved, as the field has not been published.

@hjohn
hjohn requested a review from a team as a code owner October 27, 2026 15:53
@hjohn
hjohn requested review from MGathier, m1l4n54v1c and trimoq and removed request for a team October 27, 2026 15:53
NodeInfo.capabilities could only be populated when the NodeInfo happened
to describe the node answering the request, so it was absent on every
redirect - which is precisely when a client is left without a way to
learn anything. Moved to PlatformInfo, where it unambiguously means "the
capabilities of the node that answered this request" and is therefore
always populated, redirect or not.

A client that follows a redirect asks the next node for its own; a client
that stops following already holds those of the node it is connected to.
@hjohn
hjohn force-pushed the docs/node-capabilities-redirect branch from d5b13c5 to 7026fd6 Compare October 27, 2026 16:14
@hjohn hjohn changed the title Document when NodeInfo.capabilities is absent Report capabilities of the node that answered, not the one described Oct 27, 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.

2 participants