KIP-311: permissionless P2P Network Topology#112
Merged
Merged
Conversation
hyunsooda
reviewed
Apr 21, 2026
- Remove the Roster feature (R5); the existing Node Discovery and dial protocol is sufficient for CN mesh convergence within the one-epoch lead time the validator lifecycle provides. - Replace MaxCN/MaxEN/MinEN with discoverTargets / dialTarget / peerTarget, indexed as [observer role][counterparty role] to match the implementation. - Add R3 "Peer Budgets" gathering the three targets as normative MUSTs; strip redundant per-role caps from R4 (CN Acceptance) and R5 (EN Acceptance), and point R6 (Sync Discipline) at the dialTarget[CN][EN] floor. Renumber subsequent Rs accordingly. - Add rationale "Why the existing discovery and dial protocol suffices for CN mesh convergence" decomposing the few-minutes convergence budget and noting the discoverTargets[CN][CN]=100 headroom over |peerNodes|. - Fold "Why BN performs no admission filtering" and "Why R2 enforces only on ConnType == CN" into one subsection; note BN holds no Layer 2 peer slots. - Clarify in Terms and Backwards Compatibility that ConnType == PN is treated equivalently to ConnType == EN by all post-fork nodes, so no PN-specific handling is required.
hyunsooda
approved these changes
May 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Proposed changes
This PR adds new KIP-311: Permissionless P2P Network Topology
Types of changes
Checklist
Put an x in the boxes that apply. You can also fill these out after creating the PR. If you're unsure about any of them, don't hesitate to ask. We're here to help! This is simply a reminder of what we are going to look for before merging your code.
I have read the CLA Document and I hereby sign the CLAin first time contributionRelated issues
#111
Further comments