How yggdrasil-network/yggdrasil-go works
Yggdrasil is an end-to-end encrypted IPv6 overlay network. The primary workflow configures a node, establishes peer links, routes IPv6 packets, and exposes them to applications through a TUN interface or the mobile packet API. The graph also preserves peer discovery, administration, and key-generation capabilities. Some startup wiring is only partially excerpted; those relationships are marked dashed with no evidence path rather than inferred as confirmed calls.
Main entry points: core.go Overlay core · main.go Node daemon · mobile.go Mobile API · multicast.go Peer discovery
Components 18
User entrypoints
- Node daemon
cmd/yggdrasil/main.go - Mobile API
contrib/mobile/mobile.go - Admin CLI
cmd/yggdrasilctl/main.go
Overlay networking
- Overlay core
src/core/core.go - Packet routing
src/core/proto.go - Peer links
src/core/link.go - Peer discovery
src/multicast/multicast.go
Packet interfaces
- IPv6 packet bridge
src/ipv6rwc/ipv6rwc.go - TUN adapter
src/tun/tun.go
Operations and identity
- Configuration
src/config/config.go - Address derivation
src/address/address.go - Admin socket
src/admin/admin.go - Key generator
cmd/genkeys/main.go - Key search utility
contrib/yggdrasil-brute-simple/yggdrasil-brute-multi-ed25519.c
Other components
- Node operator
- IPv6 applications
- Remote Yggdrasil peers
- Host network interfaces
Connections 23
- Node operator → Node daemon: starts or configures
README.md - Node operator → Admin CLI: requests status
cmd/yggdrasilctl/main.go - Node daemon → Configuration: loads configuration
- Node daemon → Overlay core: starts node
- Node daemon → Peer discovery: starts discovery
- Node daemon → TUN adapter: sets up interface
- Mobile API → Configuration: generates config
contrib/mobile/mobile.go - Mobile API → Overlay core: starts node
contrib/mobile/mobile.go - Mobile API → Peer discovery: starts discovery
contrib/mobile/mobile.go - Mobile API → IPv6 packet bridge: sends and receives
contrib/mobile/mobile.go - Overlay core → Address derivation: derives addresses
src/core/core.go - Overlay core → Peer links: manages peer links
- Overlay core → Packet routing: routes packets
- Peer links → Remote Yggdrasil peers: exchanges encrypted traffic
- Peer discovery → Overlay core: uses node identity
src/multicast/multicast.go - Peer discovery → Host network interfaces: discovers interfaces
src/multicast/multicast.go - IPv6 packet bridge → Overlay core: writes packets
src/ipv6rwc/ipv6rwc.go - TUN adapter → IPv6 packet bridge: bridges packets
- IPv6 applications → TUN adapter: sends and receives IPv6
README.md - Admin CLI → Admin socket: sends JSON requests
cmd/yggdrasilctl/main.go - Admin socket → Overlay core: queries node state
- Key generator → Address derivation: derives candidate address
cmd/genkeys/main.go - Key search utility → Node operator: prints candidate keys
contrib/yggdrasil-brute-simple/yggdrasil-brute-multi-ed25519.c