Skip to content

kip-311: split P2P activation between the fork block and node upgrade - #129

Open
hyunsooda wants to merge 1 commit into
kaiachain:mainfrom
hyunsooda:kip-311-p2p-activation-scope
Open

kip-311: split P2P activation between the fork block and node upgrade#129
hyunsooda wants to merge 1 commit into
kaiachain:mainfrom
hyunsooda:kip-311-p2p-activation-scope

Conversation

@hyunsooda

@hyunsooda hyunsooda commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Proposed changes

Backwards Compatibility says legacy P2P behavior, including static AuthorizedNodes, continues unchanged until the fork block. Implementations cannot honor that for the node-local rules: AuthorizedNodes is removed outright, and gating discovery, dialing and peer budgets on the fork block would make every CN re-peer at the one block where consensus depends on them already being online.

Activation is now split by what each rule depends on: R4 and R6 read AddressBookV2 and apply at the fork block; R1, R2, R3 and R5 are node-local and apply at node upgrade.

Types of changes

  • Bugfix
  • KIP Proposal
  • KIP Improvement

Checklist

  • Used the suggested template: https://github.com/kaiachain/KIPs/blob/main/kip-template.md
  • I have read the CLA and signed by comment I have read the CLA Document and I hereby sign the CLA in first time contribution
  • I have added necessary documentation (if appropriate)
  • Any dependent changes have been merged and published in downstream modules

Related issues

Further comments

@hyunsooda hyunsooda self-assigned this Jul 28, 2026
Backwards Compatibility says legacy P2P behavior, including static
AuthorizedNodes, continues unchanged until the fork block. Implementations
cannot honor that for the node-local rules: AuthorizedNodes is removed outright,
and gating discovery, dialing and peer budgets on the fork block would make
every CN re-peer at the one block where consensus depends on them already being
online.

Split activation by what each rule depends on instead. R4 and R6 read
AddressBookV2 and apply at the fork block; R1, R2, R3 and R5 are node-local and
apply at node upgrade.

Rejected: gate every rule on the fork block | forces a network-wide re-peer at
  the fork block, and kbn has no chain to read a height from
Rejected: frame this as R2 contradicting Backwards Compatibility | R2 can be
  read as implicitly post-fork like R1, so the mismatch is with the
  implementation, not within the document
Confidence: high
Scope-risk: narrow
@hyunsooda
hyunsooda force-pushed the kip-311-p2p-activation-scope branch from 65ca676 to c1dd5fc Compare July 28, 2026 03:47
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.

1 participant