Skip to content

Conversation

@mfw78
Copy link

@mfw78 mfw78 commented Jan 21, 2026

Summary

This SWIP introduces a fork digest mechanism that enables nodes to identify compatible peers during network upgrades via the handshake and Hive peer gossip.

Key Features

  • Fork digest calculation. A 4-byte identifier derived from the genesis hash and current fork version.
  • Handshake integration. Nodes reject connections where fork digests do not match.
  • Hive protocol integration. Fork-aware peer gossip filtering prevents nodes from accumulating stale peer lists.
  • Updated BzzAddress signature scheme. The v1 scheme removes the redundant "bee-handshake-" prefix (EIP-191 already provides domain separation).
  • Two-release migration path. Release N makes fork digest optional; Release N+1 makes it mandatory.

Feedback Requested

The exact composition of the genesis hash requires further discussion. Candidates for inclusion:

  • network_id (required)
  • genesis_timestamp
  • Contract addresses (postage stamp, staking, redistribution)
  • Other network-specific parameters

mfw78 added 2 commits January 21, 2026 11:30
Introduce a fork digest mechanism that enables nodes to identify
compatible peers during network upgrades via the handshake and
Hive peer gossip.

Key features:
- 4-byte fork digest derived from genesis hash and fork version
- Handshake integration for connection-time compatibility checks
- Hive protocol integration for fork-aware peer gossip filtering
- Updated BzzAddress signature scheme (v1) removing redundant prefix
- Two-release migration path for backwards compatibility
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