Skip to content

fix(eth/downloader): include xdc164 peers in idle peer selection#2491

Merged
gzliudan merged 1 commit into
XinFinOrg:dev-upgradefrom
gzliudan:fix-xdc164
Jul 27, 2026
Merged

fix(eth/downloader): include xdc164 peers in idle peer selection#2491
gzliudan merged 1 commit into
XinFinOrg:dev-upgradefrom
gzliudan:fix-xdc164

Conversation

@gzliudan

@gzliudan gzliudan commented Jul 25, 2026

Copy link
Copy Markdown
Collaborator

Proposed changes

This PR fixes the bug: "no peers available or all tried for download" which is introduced in #2470 and cause network stuck.

The xdc/164 protocol (EIP-2364 handshake) was added without updating the idlePeers version ceiling, which was still capped at 101 from the xdc100 era. Once all peers negotiate version 164, HeaderIdlePeers, BodyIdlePeers, ReceiptIdlePeers and NodeDataIdlePeers return empty sets, so fetchParts aborts every skeleton/body/receipt/state fetch with errPeersUnavailable (surfacing as "retrieved hash chain is invalid: no peers available or all tried for download"). Any node falling more than a few blocks behind can then never sync again.

Replace the hardcoded ceilings with a maxProtocolVersion constant covering xdc164 and add a regression test asserting that peers of every supported protocol version are eligible for concurrent downloads.

Types of changes

What types of changes does your code introduce to XDC network?
Put an in the boxes that apply

  • build: Changes that affect the build system or external dependencies
  • ci: Changes to CI configuration files and scripts
  • chore: Changes that don't change source code or tests
  • docs: Documentation only changes
  • feat: A new feature
  • fix: A bug fix
  • perf: A code change that improves performance
  • refactor: A code change that neither fixes a bug nor adds a feature
  • revert: Revert something
  • style: Changes that do not affect the meaning of the code
  • test: Adding missing tests or correcting existing tests

Impacted Components

Which parts of the codebase does this PR touch?
Put an in the boxes that apply

  • Consensus
  • Account
  • Network
  • Geth
  • Smart Contract
  • External components
  • Not sure (Please specify below)

Checklist

Put an in the boxes once you have confirmed below actions (or provide reasons on not doing so) that

  • This PR has sufficient test coverage (unit/integration test) OR I have provided reason in the PR description for not having test coverage
  • Tested on a private network from the genesis block and monitored the chain operating correctly for multiple epochs.
  • Provide an end-to-end test plan in the PR description on how to manually test it on the devnet/testnet.
  • Tested the backwards compatibility.
  • Tested with XDC nodes running this version co-exist with those running the previous version.
  • Relevant documentation has been updated as part of this PR
  • N/A

@coderabbitai

coderabbitai Bot commented Jul 25, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c74cc8f1-df6f-451d-b9e7-fd31e3223a2f

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Fixes a downloader peer-selection regression where the idle peer selectors (used for concurrent header/body/receipt/state downloads) could exclude newer protocol versions (xdc/164), causing sync to stall with errPeersUnavailable once the network upgrades.

Changes:

  • Introduce a maxProtocolVersion ceiling (set to 164) and use it in idle peer selection.
  • Expand HeaderIdlePeers, BodyIdlePeers, ReceiptIdlePeers, and NodeDataIdlePeers to include xdc/164 peers.
  • Add a regression test to ensure peers across supported protocol versions are considered eligible for idle selection.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
eth/downloader/peer.go Replaces hardcoded protocol version ceilings in idle peer selection with a single maxProtocolVersion constant.
eth/downloader/peer_test.go Adds a regression test ensuring idle peer selectors return peers across protocol versions.
Comments suppressed due to low confidence (1)

eth/downloader/peer.go:498

  • BodyIdlePeers now filters out eth/62 peers by setting minProtocol=63, even though body fetching supports v62 (FetchBodies checks p.version < 62). Keep the lower bound at 62 to avoid needlessly excluding compatible peers.
	return ps.idlePeers(63, maxProtocolVersion, idle, throughput)

Comment thread eth/downloader/peer.go Outdated
Comment thread eth/downloader/peer_test.go
The xdc/164 protocol (EIP-2364 handshake) was added without updating the
idlePeers version ceiling, which was still capped at 101 from the xdc100
era. Once all peers negotiate version 164, HeaderIdlePeers, BodyIdlePeers,
ReceiptIdlePeers and NodeDataIdlePeers return empty sets, so fetchParts
aborts every skeleton/body/receipt/state fetch with errPeersUnavailable
(surfacing as "retrieved hash chain is invalid: no peers available or all
tried for download"). Any node falling more than a few blocks behind can
then never sync again.

Replace the hardcoded ceilings with a maxProtocolVersion constant covering
xdc164 and add a regression test asserting that peers of every supported
protocol version are eligible for concurrent downloads.
@gzliudan
gzliudan merged commit 3d1ca15 into XinFinOrg:dev-upgrade Jul 27, 2026
14 checks passed
@gzliudan
gzliudan deleted the fix-xdc164 branch July 27, 2026 04:54
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.

5 participants