Skip to content

KIP-311: reserve cross-type slots via own-mesh peer-target caps#122

Merged
hyunsooda merged 1 commit into
mainfrom
kip-311-cross-type-reservation
Jun 23, 2026
Merged

KIP-311: reserve cross-type slots via own-mesh peer-target caps#122
hyunsooda merged 1 commit into
mainfrom
kip-311-cross-type-reservation

Conversation

@hyunsooda

@hyunsooda hyunsooda commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Proposed changes

Own-mesh peerTargets (CN↔CN, EN↔EN) change from to M − cross-type reservation, so a node's own-type mesh can no longer consume every connection slot and starve the CN↔EN link.

  • Before: own-mesh ; the CN↔EN reservation was implicit, relying on operators sizing M ≥ MaxNodeCount + peerTargets[CN][EN].
  • After: own-mesh capped at M − reservation, so cross-type slots are explicitly reserved regardless of how MaxPhysicalConnections is configured. In the recommended config the cap never binds (identical to ); it only adds a guaranteed floor when maxconnections is undersized.
  • Cross-type reservation values are documented as operator-configurable defaults.

Types of changes

  • Bugfix
  • KIP Proposal
  • KIP Improvement

Checklist

  • Used the suggested template
  • I have read the CLA and signed by comment
  • I have added necessary documentation (if appropriate)
  • Any dependent changes have been merged and published in downstream modules

Related issues

CN-to-CN and EN-to-EN peerTargets change from infinity to `M - cross-reservation`,
so a node's own-type mesh cannot consume every connection and starve the CN<->EN
link. The reservation now holds regardless of how MaxPhysicalConnections is
configured, rather than relying on implicit sizing (MaxNodeCount + reservation).
Cross-type reservation values are documented as operator-configurable defaults.

Rejected: keep peerTargets[CN][CN]=infinity and reserve EN room only via MaxPhysicalConnections sizing | breaks under undersized maxconnections
Confidence: high
Scope-risk: narrow
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@hyunsooda hyunsooda self-assigned this Jun 11, 2026
@hyunsooda hyunsooda marked this pull request as draft June 11, 2026 08:57
@hyunsooda hyunsooda changed the title kip-311: reserve cross-type slots via own-mesh peer-target caps KIP-311: reserve cross-type slots via own-mesh peer-target caps Jun 11, 2026
@hyunsooda hyunsooda marked this pull request as ready for review June 11, 2026 12:46
@hyunsooda hyunsooda merged commit 128f7ef into main Jun 23, 2026
5 of 6 checks passed
@github-actions github-actions Bot locked and limited conversation to collaborators Jun 23, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants