Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Project: kinetic-atlas

Stage: 16 — The Multi-TLD Proxy Daemon

Reading Time: 25 mins


What Is This?

kinetic-atlas is a standalone daemon that acts as a universal HTTP proxy bridge. While the standard kinetic-daemon only knows about the .kin network, Atlas dynamically routes traffic to any Kinetic network fork (e.g., .alt, .game, .local) based on a central registry.

It allows ISPs or homelab users to run a single daemon that provides resolution and P2P proxying for the entire Kinetic ecosystem.


Architecture

  1. GitHub-backed Registry: Atlas configurations for different TLDs are distributed as .json files hosted in a GitHub repository (kinetic-atlas).
  2. Dynamic Swarm Management: It spawns full libp2p nodes dynamically on-demand for whatever TLD is requested.
  3. HTTP Proxy: Intercepts standard web traffic, determines the target TLD, and routes the P2P proxy request through the correct libp2p swarm.
  4. Auto-Updater: Periodically syncs the registry from GitHub, adding new TLDs without a daemon restart.

Files

  • 02_registry_swarms.md — The TldRegistry loader and on-demand SwarmManager.
  • 03_proxy_updater.md — The HTTP proxy interceptor and the background auto-updater.