ExplainerBeginnerDecentralized Networking

What Is IPv8? Definition, How It Works, and Use Cases

IPv8 is an open-source peer-to-peer networking library developed at TU Delft that provides decentralized identity, trust, and communication without central servers. Used in blockchain, decentralized applications, and academic research.

Emanuel De AlmeidaJuly 23, 20269 min read

Level

Beginner

Reading time

9 min

Concept

IPv8 peer-to-peer networking library

Last reviewed

July 23, 2026

If you have run into the term "IPv8" and assumed it was the next step after IPv6, you are not alone, and you are also not quite right. IPv8 is not a new addressing scheme for the internet. It is a peer-to-peer networking library built at TU Delft that helps applications connect directly to one another, identify each other by cryptographic key, and build trust without any central server in the middle.

Key takeaways

  • IPv8 is a P2P overlay networking library, not a new Internet Protocol version.
  • Developed at TU Delft for decentralized identity, trust, and communication.
  • Provides NAT traversal, peer discovery, encrypted channels, and attestation-based identity.
  • Powers Tribler (anonymous BitTorrent) and blockchain research projects.
  • Written in Python with community overlays for application-specific P2P networks.

Quick explanation

In simple terms

IPv8 is a free software toolkit that lets programs talk to each other directly, computer to computer, without needing a central server to connect them.

Technical definition

IPv8 is a Python peer-to-peer networking layer that abstracts endpoints as public key pairs rather than IP addresses. It provides authenticated, optionally anonymized communication, UDP hole-punching for NAT traversal, a custom DHT for peer discovery, and an attestation service using zero-knowledge proofs, all organized into application-defined overlays (communities).

Analogy

Think of the regular internet like the postal system, where every message needs a street address that can change when you move. IPv8 is more like recognizing a friend by their voice on the phone: it does not matter which number they call from, because you know who they are from the signature itself.

Definition

IPv8 is an open-source peer-to-peer networking library from TU Delft that lets applications communicate directly using public keys instead of relying on central servers. Despite the name, it is not a new version of the Internet Protocol.

IPv8 is a networking layer that sits above the regular Internet Protocol and pushes identity, trust, and routing logic out to the applications themselves. Instead of addressing peers by IP address, it identifies them by cryptographic public key, so a connection stays valid even when someone's IP changes or they sit behind a NAT or firewall.

Why it matters

Most apps still depend on central servers that can fail, get blocked, or quietly collect data. IPv8 gives developers a ready-made toolkit for building software where peers find and trust each other directly, which matters for censorship-resistant tools, privacy-focused apps, and decentralized research. It is also a common point of confusion online, since people assume "IPv8" must be the successor to IPv6 when the two are unrelated.

Core concepts

Not IPv6's Successor: A P2P Overlay Library

IPv8 is not a successor to IPv6. It is a Python library for building peer-to-peer overlay networks on top of existing IP networks. Developed by the Blockchain Lab at Delft University of Technology (TU Delft), it provides NAT traversal, peer discovery, and encrypted communication without relying on central servers. The name refers to a vision of identity-layer networking beyond traditional IP addressing.

Decentralized Identity and Attestation

IPv8 includes an attestation system where peers can verify claims about each other (age, membership, credentials) without a central authority. Attestations are cryptographically signed and can be selectively disclosed. This enables decentralized identity verification for applications like anonymous voting, credential sharing, and trust networks.

Tribler and Research Applications

IPv8 powers Tribler, a decentralized BitTorrent client from TU Delft that uses onion routing for anonymous downloading. Beyond Tribler, IPv8 is used in academic research on decentralized marketplaces, blockchain consensus protocols, and self-sovereign identity systems. It provides community overlays where groups of peers form logical networks for specific applications.

How it works

1

Generate a key pair

Each peer creates a cryptographic key pair. The public key becomes its identity, replacing the idea of a fixed IP address.

2

Join an overlay

The peer joins one or more overlays (called communities), each a small purpose-built network for a task such as discovery or anonymous routing.

3

Discover peers

Using a custom NAT-traversing DHT and random-walk strategies, the peer finds neighbors and keeps track of which ones are still responsive.

4

Punch through NATs

UDP hole-punching establishes direct connections between peers even when both sit behind home routers or firewalls.

5

Communicate and build trust

Peers exchange authenticated messages, optionally over onion-routed tunnels, and can attest to claims about each other to build a web of trust.

Use cases

Anonymous file sharing

End users and privacy researchers

IPv8 powers Tribler, a BitTorrent client that adds Tor-style anonymity so users can share files without exposing their IP addresses.

Tribler runs seven IPv8 overlays to handle discovery, anonymous tunnels, and a bandwidth marketplace.

Benefit — Privacy-preserving downloads with no central tracker.

Decentralized identity and attestation

Identity and blockchain developers

The built-in attestation service lets peers vouch for claims about each other using zero-knowledge proofs, enabling self-sovereign identity without a central authority.

One peer can prove it is over 18 to another without revealing its date of birth.

Benefit — Verifiable claims with minimal data disclosure.

Academic and blockchain research

Researchers and students

IPv8 is a common foundation for research into decentralized systems, distributed ledgers, and trust mechanisms at TU Delft and beyond.

Researchers prototype new consensus and reputation systems on top of IPv8 overlays.

Benefit — A ready-made, well-studied P2P substrate for experiments.

Benefits

No central server needed

Peers connect directly to each other, so there is no server to run, pay for, or take offline. A network keeps working as long as some peers are online.

A file-sharing app built on IPv8 stays reachable even if the original developer shuts down all their infrastructure.

Identity that survives IP changes

Peers are identified by public key rather than IP address, so a connection remains valid when someone switches networks or sits behind a NAT.

A laptop moving from office Wi-Fi to a mobile hotspot keeps its IPv8 identity without reconnecting from scratch.

Built-in privacy primitives

IPv8 ships with Tor-style onion routing and zero-knowledge attestation, giving developers cryptographic building blocks for anonymity and selective disclosure.

Tribler uses these primitives to offer anonymous BitTorrent downloads.

Works through NATs and firewalls

UDP hole-punching lets two peers behind home routers talk directly, which is usually the hardest part of building peer-to-peer software.

Two users on separate home networks can connect without configuring port forwarding.

Limitations

Not a mainstream technology

Medium

IPv8 is a research-driven library used mainly by TU Delft projects and applications like Tribler, so the community and third-party support are small compared with mainstream frameworks.

Workaround — Budget time for reading the official documentation and source code, since ready-made tutorials are limited.

Python-only

Medium

The reference implementation (py-ipv8) is written in Python, which can be a constraint for teams working in other languages or needing very high throughput.

Workaround — Wrap IPv8 in a service and communicate with it over a local API from your main application.

Privacy is not automatic

Medium

IPv8 supplies the primitives for anonymity but does not make an application private by default. Developers must design and enable those features themselves.

Workaround — Study how Tribler layers onion routing on top of IPv8 before assuming your app is anonymous.

Confusing name

Low

The IPv8 name is regularly mistaken for a successor to IPv6, which can create false expectations among users and stakeholders.

Workaround — State clearly in your docs that IPv8 is an application-layer library, not an IP version.

Architecture

IPv8 is organized as a stack of overlays running over UDP. A shared networking layer handles peer discovery, NAT traversal, and message serialization, while each overlay (community) implements one application-specific service on top. Higher-level features such as onion routing, a DHT, and the attestation service are themselves overlays that applications can enable as needed.

Myths, corrected

Myth

IPv8 is the next version of the Internet Protocol, the successor to IPv6.

Correction

IPv8 is an application-layer library that runs on top of IPv4/IPv6. It is not a network protocol version and has no relation to IETF IP standards.

Why it happens: The name follows the IPv4 and IPv6 pattern, so people naturally assume it is the next numbered version of the Internet Protocol. The project chose the name partly as a nod to the slow rollout of IPv6, which fuels the confusion.

Myth

IPv8 is a mainstream, widely deployed networking technology used across the internet.

Correction

IPv8 is primarily used in academic research and specific projects like Tribler. It is not a mainstream networking technology.

Why it happens: Because the name sounds like a core internet standard, people assume it must be deployed everywhere. In reality it is a research-driven library used mainly by TU Delft projects and applications built on top of it, such as Tribler.

Myth

Anything built on IPv8 is automatically anonymous and private by default.

Correction

IPv8 provides the building blocks for anonymity (onion routing in Tribler) but is not inherently anonymous. Applications must implement privacy features using IPv8's primitives.

Why it happens: IPv8 is closely tied to Tribler and its Tor-style onion routing, so people assume anonymity comes for free. In practice IPv8 only supplies the cryptographic primitives, and each application has to implement privacy features itself.

Frequently asked questions

What is IPv8?

A Python peer-to-peer networking library from TU Delft that provides decentralized identity, trust, and communication without central servers. It is not a replacement for IPv4 or IPv6.

Is IPv8 a new version of the Internet Protocol?

No. IPv4 and IPv6 are Internet Protocol versions for addressing and routing. IPv8 is an application-layer P2P overlay library that runs on top of existing IP networks. The name is conceptual, not a protocol version.

What are IPv8 use cases?

Decentralized applications, blockchain research, anonymous file sharing (Tribler), self-sovereign identity, decentralized marketplaces, and academic P2P networking research.

How does IPv8 handle identity?

Peers can cryptographically attest to claims about each other without a central authority. Attestations are selectively disclosed, enabling privacy-preserving identity verification.

Conclusion

IPv8 is a Python peer-to-peer networking library from TU Delft that identifies peers by public key, traverses NATs, and offers privacy and attestation primitives. Despite the name, it is not a new version of the Internet Protocol.

Main takeaway

IPv8 is a toolkit for building serverless, privacy-friendly applications, not a replacement for IPv4 or IPv6.

Reader reviews

Rate this articleBe the first to rate
No written reviews yetRate the article above, or be the first to share your experience.

Related articles