Components

The network ships as a library plus central, relay, and client services.

Auranet is implemented in shared network code plus separate central, relay, and client services. The library lives under lib/auranet_proto, while the current service applications live under apps/network.

Python integration

Load Auranet support before importing `.auranet` modules.

The current Python path uses the shared importer under lib/auranet_proto.loader. Compatibility code still exists in apps/network/auranet_v2, but new code should import through the shared library.

from lib.auranet_proto.loader import install_auranet_importer

install_auranet_importer()

from lib.auranet_proto.v2.auranet_network import AuranetUDPSocket

Roles

Central, relay, and client do different jobs.

Central

Registers permanent identities, tracks network metadata, and anchors discovery for other Auranet services.

Relay

Bridges reachability when peers cannot or should not connect directly, while preserving the session identity.

Client

Creates sessions, exchanges messages, and talks to relay or central services when the calling application needs them.

Security posture

Production deployments must provision real keys.

Shared-key encryption defaults exist for development, but production deployments should provide an explicit shared key and identity material through configuration rather than leaning on test defaults.

Keys

Provision shared encryption keys and identity keys outside the repo.

Python

Install the importer before loading `.auranet` modules in Python.

Products

Let product sites, such as AetherGate, own their own public experience while reusing the shared Auranet network.