EphemeralNet

적대적 NAT 환경을 위한 맞춤형 릴레이를 갖춘 안전한 P2P 네트워크, C++20으로 구축됨.

고신뢰 P2P 스토리지를 위한 프로그래밍 가능한 망각.

왜 EphemeralNet인가?

Shardian은 삭제 보장을 기밀성만큼 중요하게 여기는 팀을 위한 인프라를 설계합니다. EphemeralNet은 반드시 사라져야 하는 데이터를 위한 C++20 연구 데몬입니다. 즉, 강제된 TTL(Time-to-Live) 의미론을 일급 제약 조건으로 사용하는 P2P 프로토콜입니다. BitTorrent 스타일 스웜을 임시 보존 정책으로 변형하는 대신, EphemeralNet은 모든 매니페스트, 청크, 라우팅 힌트를 가장자리에서 수명이 협상되고 암호화로 강제되는 소모성 재료로 취급합니다.

모든 노드는 gRPC에서 영감을 받은 제어 소켓과 원격 스타일 CLI를 제공하는 소형 데몬 eph를 실행합니다. 커널은 TTL 인지 Kademlia DHT를 ChaCha20/HMAC 세션, 키 분쇄를 위한 Shamir의 Secret Sharing, 그리고 결정적 정리 훅과 결합하여 만료된 상태가 스토리지 계층, 라우팅 테이블, 매니페스트에서 동시에 증발하도록 합니다. 그 결과 현대 CDN 오버레이처럼 가십, 저장, 인출이 가능한 메시가 탄생하며, 데이터가 일정에 따라 존재에서 사라지는 것을 보장합니다.

아카이브 시스템과 달리 EphemeralNet은 시간적 정확성을 최적화합니다. 피어가 오프라인 상태가 되더라도 청크가 마감 시한을 초과하여 존재할 수 없음을 검증합니다. 따라서 사고 데이터 룸, 임시 공동 편집, 삭제에 Zero Trust 가드레일이 필요한 모든 워크로드에 이상적입니다.

High-Level Architecture

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

주요 기능

• TTL 네이티브 Kademlia: 항목별 만료 메타데이터를 사용한 XOR 거리 라우팅으로, 운영자 개입 없이 알림이 자동으로 폐기됩니다.
• 모든 곳에서 E2EE: 전송에는 ChaCha20-Poly1305, 프로토콜 무결성에는 HMAC-SHA256, 피어별 롤링 세션 키 파생을 사용합니다.
• Shamir 기반 키 만료: 복호화 키가 DHT 전반에 분산(shard)됩니다. 샤드가 만료되면 청크가 캐시에 남아 있어도 데이터는 복구 불가능해집니다.
• 컨트롤 플레인 작업 증명: 적응형 PoW가 핸드셰이크, 저장, 매니페스트 작업을 감싸서 정직한 피어의 속도를 유지하면서 Sybil 남용을 무디게 합니다.
• NAT 통과 + 릴레이 폴백: 내장 STUN/TURN 학습, 자동 승격 공개 엔드포인트, 높은 팬아웃 버스트를 위한 이벤트 기반 릴레이 서버.
• 결정적 스토리지 위생: 인메모리 및 선택적 디스크 계층, 안전한 삭제, TTL 감사, 매니페스트 철회와 정리를 동기화하는 알림 훅.
• 관측 가능성 우선: TTL 드리프트, PoW 압력, DHT 포화, 피어별 상태에 대한 Prometheus 익스포터를 제공하여 SRE가 통제 불능 스웜보다 앞서 대처할 수 있게 합니다.
• CLI/데몬 동등성: 동일한 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를 사용하거나, Ninja 빌드를 선호한다면 -GNinja를 사용하세요.

문서

전체 운영 핸드북, 프로토콜 참조, 관측 가능성 가이드는 **eph.shardian.com**에 있습니다. 오프라인 복사본은 에어갭 검토를 위해 docs/ 아래에 미러링되어 있습니다.

기여 및 라이선스

Pull Request를 환영합니다. docs/todo.md에 제안을 올리거나 GitHub Discussion을 열어 범위를 맞추세요. 새 모듈에는 설계 노트, 원격 측정 훅, tests/ 아래의 결정적 테스트가 포함되어야 합니다.

EphemeralNet은 MIT 라이선스로 배포됩니다. 기여함으로써 귀하의 작업이 MIT로 라이선스되며 그렇게 할 권리가 있음에 동의하게 됩니다.