How Solana Gossip Really Works: A Byte-Level Journey Into the Devnet

A complete walkthrough of building a working gossip client from scratch, debugging wire format mismatches byte-by-byte, and finally talking to the Solana devnet entrypoint.

Table of Contents

1. The Dream
2. The Gossip Protocol in 60 Seconds
3. Our Starting Point
4. The Debugging Journey
   • Phase 1: Ping Works, PullRequest Gets Ignored
   • Phase 2: Chasing the Wrong Clue (Version struct)
   • Phase 3: The CrdsValue hash Trap
   • Phase 4: The REAL Root Cause — ContactInfo Serialization
5. Byte-by-Byte Wire Format Analysis
   • How Bincode Serializes Things
   • The Version Struct: 17 bytes → 12 bytes
   • The ContactInfo Struct: 307 bytes → 65 bytes
   • The CrdsValue: 32 bytes of hash poison
6. The Complete Devnet Conversation
   • Message 1: Ping (132 bytes)
   • Message 2: Pong (132 bytes)
   • Message 3: PullRequest (1232 bytes)
   • Message 4: Entrypoint’s Ping (132 bytes)
   • Message 5: PullResponse (505-1232 bytes)
7. The Complete File-by-File Change Log
8. What We Still Get Wrong (and Why It Doesn’t Matter)
9. How to Run It Yourself
10. All Reference Files in Agave Source