EphemeralNet

Ein sicheres P2P-Netzwerk mit benutzerdefiniertem Relay für feindliche NATs, entwickelt in C++20.

Programmierbares Vergessen für hochzuverlässige Peer-to-Peer-Speicherung.

Warum EphemeralNet?

Shardian entwickelt Infrastruktur für Teams, die Löschgarantien ebenso ernst nehmen wie Vertraulichkeit. EphemeralNet ist unser C++20-Forschungsdaemon für Daten, die verschwinden müssen: ein P2P-Protokoll, das erzwungene Time-to-Live (TTL)-Semantik als erstklassige Einschränkung verwendet. Anstatt BitTorrent-artige Schwärme in Ad-hoc-Aufbewahrungsrichtlinien zu verwandeln, behandelt EphemeralNet jedes Manifest, jeden Chunk und jeden Routing-Hinweis als verbrauchbares Material, dessen Lebensdauer an der Grenze ausgehandelt und kryptografisch erzwungen wird.

Jeder Knoten führt eph aus, einen kompakten Daemon, der einen gRPC-inspirierten Control-Socket und eine Remote-ähnliche CLI bereitstellt. Der Kernel kombiniert ein TTL-bewusstes Kademlia-DHT mit ChaCha20/HMAC-Sessions, Shamir's Secret Sharing zur Schlüsselvernichtung und deterministische Cleanup-Hooks, sodass abgelaufene Zustände gleichzeitig über Speicherebenen, Routing-Tabellen und Manifeste verschwinden. Das Ergebnis ist ein Mesh, das wie ein modernes CDN-Overlay klatschen, speichern und abrufen kann – während garantiert wird, dass die Daten planmäßig aus der Existenz fallen.

Im Gegensatz zu Archivsystemen optimiert EphemeralNet auf zeitliche Korrektheit: Es verifiziert, dass ein Chunk nicht über sein Ablaufdatum hinaus existieren kann, selbst wenn Peers offline gehen. Das macht es ideal für Incident-Data-Rooms, temporäre kollaborative Bearbeitungen und jede Arbeitslast, die Zero-Trust-Leitplanken für das Löschen benötigt.

High-Level-Architektur

flowchart LR
    subgraph "Operator Workstation"
        CLI["eph CLI<br/>(remote shell)"]
    end
    subgraph "Local Host"
        Demon["eph daemon<br/>(control+data kernel)"]
    end
    subgraph Mesh
        DHT["Kademlia DHT<br/>(TTL-indexed)"]
        Relays["STUN/TURN + Relay"]
        Peers["Peer Swarm"]
    end

    CLI -->|gRPC-style control| Demon
    Demon -->|announce/store/fetch| DHT
    Demon -->|NAT traversal| Relays
    Demon <-->|ChaCha20 sessions| Peers

Feature-Highlights

• TTL-natives Kademlia: XOR-Distanz-Routing mit Metadaten zum Verfall pro Eintrag, sodass Ankündigungen ohne Eingriff des Betreibers selbstzerstört werden.
• E2EE überall: ChaCha20-Poly1305 für den Transport, HMAC-SHA256 für Protokollintegrität und rollierende Sitzungsschlüsselableitung pro Peer.
• Shamir-gestützter Schlüsselverfall: Entschlüsselungsschlüssel werden über das DHT verteilt; wenn die Shards ablaufen, werden die Daten unwiederbringlich, selbst wenn Chunks in Caches verweilen.
• Proof-of-Work auf der Steuerungsebene: adaptive PoW-Hüllen für Handshake-, Speicher- und Manifestoperationen, um Sybil-Missbrauch abzustumpfen, während ehrliche Peers schnell bleiben.
• NAT-Traversal + Relay-Fallback: integriertes STUN/TURN-Lernen, automatisch beförderte öffentliche Endpunkte und ein ereignisgesteuerter Relay-Server für hohe Fanout-Bursts.
• Deterministische Speicherhygiene: In-Memory- und optionale Festplattenebenen, sicheres Löschen, TTL-Prüfungen und Benachrichtigungs-Hooks, die die Bereinigung mit dem Zurückziehen von Manifesten synchronisieren.
• Observability zuerst: Prometheus-Exporteure für TTL-Drift, PoW-Druck, DHT-Sättigung und Gesundheit pro Peer, um SREs einen Vorsprung vor außer Kontrolle geratenen Schwärmen zu geben.
• CLI/Daemon-Parität: Dieselbe eph-Binärdatei stellt sowohl den Hintergrunddienst als auch eine Fernsteuerung für automatisierungsfreundliche Operationen bereit.

Schnellstart-Installation

Die Installationsskripte laden das neueste Release-Artefakt von GitHub herunter, platzieren eph auf Ihrem PATH und geben Folgeanweisungen aus.

Verwendung

# Start the daemon with loopback control plane, TCP transport on 45000
PS> eph start --storage-dir C:\temp\ephemeral --control-host 127.0.0.1

# Store a file with a 15-minute TTL; PoW is negotiated automatically
PS> eph store secrets.bin --ttl 900

# Fetch via manifest; direct-only keeps traffic on explicitly advertised peers
PS> eph fetch eph://6c5f... --direct-only --out C:\downloads

# Inspect node health, DHT saturation, and relay status
PS> eph status --verbose

# Check whether a newer CLI release is available
PS> eph update-check

Erstellen aus dem Quellcode

# Configure (creates build/ and toolchain files)
cmake -S . -B build -DCMAKE_BUILD_TYPE=RelWithDebInfo

# Compile all targets (daemon, CLI, relay, tests)
cmake --build build --parallel

# Optional: execute the full test suite
ctest --test-dir build --output-on-failure

Verwenden Sie -DEPHEMERALNET_BUILD_TESTS=OFF, um Testbinärdateien zu überspringen, oder -GNinja, wenn Sie Ninja-Builds bevorzugen.

Dokumentation

Das vollständige Operationshandbuch, die Protokollreferenz und die Observability-Leitfäden befinden sich unter eph.shardian.com. Offline-Kopien werden unter docs/ für luftabgeschirmte Überprüfungen gespiegelt.

Mitwirken & Lizenz

Pull-Requests sind willkommen – beginnen Sie mit einem Vorschlag in docs/todo.md oder eröffnen Sie eine GitHub-Diskussion, damit wir uns über den Umfang abstimmen können. Neue Module sollten Designnotizen, Telemetrie-Hooks und deterministische Tests unter tests/ enthalten.

EphemeralNet wird unter der MIT-Lizenz veröffentlicht. Mit Ihrem Beitrag stimmen Sie zu, dass Ihre Arbeit unter MIT lizenziert wird und dass Sie das Recht dazu haben.