Yggdrasil Network
- title
- Yggdrasil Network
- type
- concept
- summary
- Experimental overlay IPv6 mesh network where each node's address is derived from its public key; routing is location-independent and decentralized
- tags
- networking, mesh, p2p
- created
- 2026-05-10
- updated
- 2026-05-10
Yggdrasil is an overlay mesh network where every node has a stable IPv6 address derived from its public key. The address doesn't depend on the node's physical location or its underlying ISP-assigned IP โ connectivity is established through peer links (manual, link-local discovery, or public peer lists), and routing is end-to-end without central coordinators.
Topologically it's a tree-with-shortcuts: the network elects a root and builds a spanning tree for fallback routing, but actively discovers shorter paths between any two nodes. This gives the cryptographic-identity guarantees of Tor/I2P and the addressing guarantees of CJDNS without requiring either the onion-routing overhead or the CJDNS routing weirdness.
Use cases:
- Decentralized application networking โ Matrix federation (Dendrite has a Yggdrasil transport), distributed databases that need stable peer identities
- NAT traversal โ every node has a routable IPv6 even behind double-NAT
- Local-mesh fallback โ link-local autopeering creates ad-hoc networks without internet uplink
- Circumvention โ though not designed for anonymity, the public-peer-list model + carrier-network abstraction makes it composable with Tor/I2P/SOCKS for russia-vpn-bypass-state-2026-04-shaped problems
The network is small (low thousands of public peers as of 2026). It's "experimental" in the project's own framing โ production networks should treat it as research-grade.
Reference implementations:
yggdrasil-network/yggdrasil-goโ official, daemon-shaped, runs a system TUN interfaceasciimoth/yggโ fork separatingyggliblibrary fromyggddaemon, adds in-process userspace TCP/IP stack (asciimoth-ygg)
For the embedded-library walkthrough, see yggdrasil-embedded-go.