libp2p

libp2p is a modular networking stack for P2P applications. Originally extracted from IPFS, it is now a standalone project used by Ethereum 2.0, Filecoin, Polkadot, and many other systems. It is the most explicit implementation of the layered protocol architecture pattern.

Philosophy

libp2p treats every networking concern as a swappable module:

No single transport: TCP, QUIC, WebSocket, WebRTC, and WebTransport are all first-class.

No single security protocol: Noise and TLS 1.3 are negotiated per-connection.

No single multiplexer: mplex, yamux, or QUIC-native multiplexing.

No single discovery mechanism: Kademlia DHT, mDNS, rendezvous, bootstrap lists.

Key Protocols

Identify: peers exchange metadata (supported protocols, listen addresses, agent version, public key) on connection. The foundation for protocol negotiation.

Kademlia DHT: the primary peer and content routing mechanism. Provider records enable content-addressed discovery. The IPFS Amino DHT is one of the largest Kademlia networks.

GossipSub: mesh-based PubSub with peer scoring; carries Ethereum beacon chain attestations and block proposals.

AutoNAT: detect whether the peer is publicly reachable; determines DHT server vs client mode.

Circuit Relay v2: lightweight relay protocol for NAT traversal fallback, with resource limits.

DCUtR (Direct Connection Upgrade through Relay): coordinate hole punching after initial relay connection, upgrading to direct connectivity.

Bitswap: block exchange protocol for IPFS content retrieval, tracking per-peer storage ledgers.

Rendezvous: lightweight discovery service for finding peers interested in the same topic.

Peer Identity

Each libp2p node has a Peer ID: a multihash of its public key (typically Ed25519). Peer IDs are the foundation of Identity and Capabilities in the libp2p ecosystem. Connections are authenticated at the transport layer via Noise or TLS, binding each connection to a verified Peer ID.

Implementations

go-libp2p: the reference implementation, used by IPFS (Kubo) and Filecoin (Lotus).

rust-libp2p: used by Polkadot/Substrate, Lighthouse (Ethereum), and other Rust P2P projects.

js-libp2p: browser and Node.js; enables web-native P2P via WebRTC and WebTransport.

nim-libp2p: used by Nimbus (Ethereum consensus client).

Testground: a testing platform for libp2p networks, supporting large-scale simulation with thousands of nodes.

How libp2p Connects to Everything Else

libp2p underpins IPFS and Filecoin and provides the networking layer for Ethereum 2.0. It competes with Hyperswarm as a general P2P networking library. Its security features (peer scoring, signed records, authenticated transports) address many P2P threat vectors. Its modularity embodies the design patterns of layered architecture and defense in depth. Compliance applies to relay operators in the libp2p network.