List view
# ZHTP Alpha Features - Functional Description **For:** Milestone descriptions, release notes, project management --- ## Feature 1: Decentralized Storage Search **Functional Description:** Distributed storage system with intelligent search capabilities. Users can query the DHT network to find and retrieve data stored across peer nodes without centralized indexes. The search algorithm uses Kademlia XOR distance to route queries to the K=20 closest nodes, which either return the requested data or provide addresses of closer nodes for recursive lookup. **Key Capabilities:** - DHT-based key-value storage with FIND_VALUE operations - Geographic proximity search (find storage nodes near GPS coordinates) - Automatic data replication across 20 nodes for redundancy - REST API endpoints for search queries (`GET /api/storage/search`) - CLI search command (`zhtp storage search <query>`) **Current Status:** Backend complete, frontend search UI pending **Technical Specs:** - Storage protocol: Kademlia DHT - Replication factor: K=20 nodes - Query latency: <500ms (P95) - Data persistence: TTL-based with automatic refresh --- ## Feature 2: Autonomous Mesh Networking **Functional Description:** Peer-to-peer mesh network enabling nodes to automatically discover, connect, and route traffic through each other without central coordination. Combines mDNS local discovery, DHT-based routing tables, and multi-hop message forwarding to create a resilient, self-organizing network topology. **Key Capabilities:** - Automatic peer discovery via mDNS (local network) and bootstrap nodes (internet) - Kademlia DHT routing with 160-bit NodeId address space - Multi-hop message routing through intermediate peers - Dynamic route optimization based on latency and availability - Automatic topology updates when peers join/leave **Current Status:** ⚠️ Code complete, runtime blocked by NodeId architecture issue (fix in progress: Phase 1 & 2) **Technical Specs:** - Discovery: mDNS (local) + bootstrap nodes (global) - Routing: XOR distance-based (Kademlia) - Message TTL: Configurable hop limit - Network healing: Automatic re-routing on node failure --- ## Feature 3: Bluetooth Low Energy Mesh **Functional Description:** Bluetooth 5.0 mesh networking protocol enabling device-to-device communication without internet connectivity. Implements custom GATT services for ZHTP message exchange with automatic peer discovery via BLE advertising, multi-hop routing to extend range beyond single-device limits, and low-power operation for battery-constrained devices. **Key Capabilities:** - BLE 5.0 advertising for automatic peer discovery (no manual pairing) - Custom GATT service with ZHTP-specific characteristics (RX/TX) - Multi-hop mesh routing extends range beyond 100m - Platform support: Linux (BlueZ), macOS (CoreBluetooth), Windows - Connection pooling (manage up to 7 concurrent BLE connections) **Current Status:** ✅ Fully functional **Technical Specs:** - Protocol: BLE 5.0 with custom GATT services - Range: ~100m outdoor, ~30m indoor (single hop) - Throughput: ~100 kbps - Latency: ~50ms peer-to-peer - Power: BLE low-energy mode (months on coin cell for beacons) - Max concurrent connections: 7 (BLE limitation) --- ## Feature 4: Sovereign Identity with Instant Citizenship **Functional Description:** Quantum-resistant digital identity system with automatic citizenship onboarding. Users generate post-quantum Dilithium2 + Kyber1024 keypairs, receive a DID identifier (`did:zhtp:{key_id}`), and are automatically provisioned with three BIP39 wallets, DAO voting rights, and UBI registration. Complete onboarding process executes in under 60 seconds with no KYC requirements. **Key Capabilities:** - Post-quantum keypair generation (Dilithium2 signing + Kyber1024 encryption) - DID creation: `did:zhtp:{hex(public_key.key_id)}` - Automatic wallet creation: 3 wallets with BIP39 seed phrases (primary, savings, trading) - DAO membership: 1 vote per citizen, proposal creation rights - UBI registration: 100 ZHTP/month automatic payouts - Welcome bonus: 1000 ZHTP initial balance - Identity storage: DHT-based with encrypted private data **Current Status:** ✅ Fully functional **Technical Specs:** - Cryptography: Dilithium2 (2420-byte signatures), Kyber1024 (encryption) - DID format: `did:zhtp:{64-char-hex}` (256-bit key_id) - Wallet derivation: BIP39 12-word seed phrases - Onboarding time: <60 seconds - Storage: DHT (public data) + encrypted DHT (private data) - API: REST endpoint `POST /api/identity/register` - CLI: `zhtp identity create <username>` --- ## Feature Integration **How Features Work Together:** 1. **Identity** provides cryptographic verification for all network operations 2. **Mesh Networking** routes messages between verified identities 3. **Bluetooth** extends mesh connectivity to offline/remote scenarios 4. **Storage** persists identity records, messages, and user data across the network **Data Flow Example:** ``` User creates identity (Feature 4) → NodeId derived from DID → Node joins mesh network (Feature 2) → Announces via Bluetooth (Feature 3) → Identity stored in DHT (Feature 4 + Feature 1) → Other nodes discover via search (Feature 1) → Mesh routes messages to NodeId (Feature 2) ```
No due date•19/20 issues closed