EphemeralNet

شبكة P2P آمنة مع Relay مخصص لبيئات NAT المعادية، مبنية بلغة C++20.

نسيان قابل للبرمجة لتخزين نظير-إلى-نظير عالي الضمانات.

لماذا EphemeralNet؟

تصمم Shardian بنية تحتية للفرق التي تأخذ ضمانات الحذف على محمل الجد بقدر ما تأخذ السرية. EphemeralNet هو برنامجنا الخفي البحثي بلغة C++20 للبيانات التي يجب أن تختفي: بروتوكول P2P يستخدم دلالات وقت البقاء (TTL) المفروضة كقيد من الدرجة الأولى. فبدلاً من تحويل أسراب BitTorrent الأسلوب إلى سياسات احتفاظ مرتجلة، يعامل EphemeralNet كل بيان (manifest) ومقطع (chunk) وتلميح توجيه كمادة قابلة للاستهلاك يُتفاوض على عمرها عند الحافة ويُفرض تشفيرياً.

يشغّل كل عقدة برنامج eph، وهو برنامج خفي مدمج يتيح مقبس تحكم مستوحى من gRPC وسطح CLI للتحكم عن بُعد. تجمع النواة بين DHT من نوع Kademlia واعية بـ TTL وجلسات ChaCha20/HMAC، ومشاركة السر لـ Shamir لسحق المفاتيح، وخطافات تنظيف حتمية بحيث تتبخر الحالة منتهية الصلاحية عبر طبقات التخزين وجداول التوجيه والـ manifests في الوقت نفسه. والنتيجة هي شبكة شبكية (mesh) تستطيع تبادل المعلومات والتخزين والجلب مثل طبقة CDN حديثة — مع ضمان خروج البيانات من الوجود في الموعد المحدد.

على عكس الأنظمة الأرشيفية، يحسّن EphemeralNet من أجل الصحة الزمنية: إذ يتحقق من أن المقطع لا يمكن أن يعيش بعد موعده النهائي، حتى لو كانت النظائر غير متصلة. وهذا ما يجعله مثالياً لغرف بيانات الحوادث، والتحريرات التعاونية المؤقتة، وأي حمل عمل يحتاج إلى حواجز حماية قائمة على الثقة الصفرية عند الحذف.

البنية المعمارية عالية المستوى

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

أبرز الميزات

• Kademlia أصلية لـ TTL: توجيه بمسافة XOR مع بيانات انتهاء صلاحية لكل إدخال بحيث تدمّر الإعلانات نفسها دون تدخل من المشغّل.
• تشفير E2EE في كل مكان: ChaCha20-Poly1305 للنقل، وHMAC-SHA256 لسلامة البروتوكول، واشتقاق مفاتيح جلسة دائرية لكل نظير.
• انتهاء صلاحية المفاتيح المدعوم بـ Shamir: تُجزَّأ مفاتيح فك التشفير عبر DHT؛ وعند انتهاء صلاحية الأجزاء، تصبح البيانات غير قابلة للاسترداد حتى لو بقيت المقاطع في الذاكرات المؤقتة.
• إثبات عمل لطائرة التحكم: تغلف PoW التكيفية عمليات المصافحة والتخزين والـ manifests لكبح إساءة استخدام Sybil مع إبقاء النظائر الصادقة سريعة.
• اختراق NAT مع احتياط Relay: تعلّم مدمج لـ STUN/TURN، ونقاط نهاية عامة تُرقّى تلقائياً، وخادم Relay موجّه بالأحداث لدفعات عالية الانتشار.
• نظافة تخزين حتمية: طبقات ذاكرة وقرص اختيارية، ومسح آمن، وتدقيقات TTL، وخطافات إشعار تزامن التنظيف مع سحب الـ manifest.
• المراقبة أولاً: مصدّرات Prometheus لانحراف TTL وضغط PoW وتشبع DHT وصحة كل نظير لإبقاء مهندسي الموثوقية (SRE) في صدارة الأسراب المتفلتة.
• تماثل CLI/daemon: يتيح نفس ثنائي eph كلًا من الخدمة الخلفية وسطح تحكم عن بُعد لعمليات صديقة للأتمتة.

التثبيت السريع

تقوم نصوص التثبيت بتنزيل أحدث إصدار من GitHub، وتضع eph على PATH، وتطبع تعليمات المتابعة.

الاستخدام

# 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

البناء من المصدر

# 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

استخدم -DEPHEMERALNET_BUILD_TESTS=OFF لتخطي ثنائيات الاختبار أو -GNinja إذا كنت تفضل بنيات Ninja.

التوثيق

الدليل التشغيلي الكامل ومرجع البروتوكول وأدلة المراقبة متوفرة في eph.shardian.com. تتوفر نسخ دون اتصال ضمن docs/ للمراجعة في البيئات المعزولة.

المساهمة والترخيص

طلبات السحب (Pull Requests) مرحب بها — ابدأ باقتراح في docs/todo.md أو افتح مناقشة على GitHub لنوائم على النطاق. يجب أن تتضمن الوحدات الجديدة ملاحظات التصميم وخطافات القياس واختبارات حتمية ضمن tests/.

صدر EphemeralNet بموجب رخصة MIT. بمساهمتك فأنت توافق على أن عملك سيُرخَّص بموجب MIT وأن لديك الحق في ذلك.