EphemeralNet

Un réseau P2P sécurisé avec Relay personnalisé pour NAT hostiles, construit en C++20.

Oubli programmable pour un stockage pair-à-pair à haute assurance.

Pourquoi EphemeralNet?

Shardian conçoit une infrastructure pour les équipes qui prennent les garanties de suppression aussi au sérieux que la confidentialité. EphemeralNet est notre démon de recherche en C++20 pour les données qui doivent disparaître : un protocole P2P qui utilise une sémantique de durée de vie (TTL) appliquée comme contrainte de première classe. Au lieu de transformer des essaims de type BitTorrent en politiques de rétention ad-hoc, EphemeralNet traite chaque manifeste, fragment et indice de routage comme un matériel consommable dont la durée de vie est négociée à la périphérie et cryptographiquement appliquée.

Chaque nœud exécute eph, un démon compact qui expose une socket de contrôle inspirée de gRPC et une interface en ligne de commande de type distant. Le noyau associe une DHT Kademlia sensible à la TTL avec des sessions ChaCha20/HMAC, le partage de secret de Shamir pour la pulvérisation des clés, et des hooks de nettoyage déterministes afin que l'état expiré s'évapore simultanément des couches de stockage, des tables de routage et des manifestes. Le résultat est un maillage qui peut gossiper, stocker et récupérer comme un overlay de CDN moderne — tout en garantissant que les données disparaissent selon le calendrier prévu.

Contrairement aux systèmes d'archivage, EphemeralNet optimise la correction temporelle : il vérifie qu'un fragment ne peut pas survivre à son échéance, même si les pairs se déconnectent. Cela le rend idéal pour les salles de données d'incident, les modifications collaboratives temporaires et toute charge de travail nécessitant des garde-fous Zero Trust pour la suppression.

Architecture de haut niveau

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

Points forts des fonctionnalités

• Kademlia natif TTL : routage par distance XOR avec métadonnées d'expiration par entrée afin que les annonces s'autodétruisent sans intervention de l'opérateur.
• E2EE partout : ChaCha20-Poly1305 pour le transport, HMAC-SHA256 pour l'intégrité du protocole et dérivation de clé de session roulante par pair.
• Expiration de clé basée sur Shamir : les clés de déchiffrement sont fragmentées dans la DHT ; lorsque les fragments expirent, les données deviennent irrécupérables même si des fragments persistent dans les caches.
• Preuve de travail du plan de contrôle : des enveloppes PoW adaptatives pour les opérations de handshake, de stockage et de manifeste afin d'atténuer les abus Sybil tout en gardant les pairs honnêtes rapides.
• Traversée NAT + repli relay : apprentissage STUN/TURN intégré, points de terminaison publics auto-promus et un serveur relay piloté par événements pour les rafales à forte fan-out.
• Hygiène de stockage déterministe : niveaux mémoire et disque optionnels, effacement sécurisé, audits TTL et hooks de notification qui synchronisent le nettoyage avec le retrait du manifeste.
• Observabilité d'abord : exportateurs Prometheus pour la dérive TTL, la pression PoW, la saturation DHT et la santé par pair pour garder les SRE en avance sur les essaims incontrôlés.
• Parité CLI/démon : le même binaire eph expose à la fois le service d'arrière-plan et une surface de contrôle distante pour des opérations automatisables.

Installation rapide

Les scripts d'installation téléchargent le dernier artifact de version depuis GitHub, placent eph dans votre PATH et impriment des instructions de suivi.

Utilisation

# 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

Construction à partir des sources

# 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

Utilisez -DEPHEMERALNET_BUILD_TESTS=OFF pour ignorer les binaires de test ou -GNinja si vous préférez les builds Ninja.

Documentation

Le manuel d'opérations complet, la référence du protocole et les guides d'observabilité se trouvent sur eph.shardian.com. Des copies hors ligne sont miroirées sous docs/ pour une revue en environnement isolé.

Contributions et licence

Les pull requests sont les bienvenues—commencez par une proposition dans docs/todo.md ou ouvrez une Discussion GitHub pour que nous puissions nous aligner sur le périmètre. Les nouveaux modules doivent inclure des notes de conception, des hooks de télémétrie et des tests déterministes sous tests/.

EphemeralNet est publié sous la licence MIT. En contribuant, vous acceptez que votre travail soit sous licence MIT et que vous avez le droit de le faire.