Initial commit: OnionCoin prototype with Proof-of-Relay consensusHEADv0.1.0main

OnionCoin is a privacy cryptocurrency that rewards Tor relay operators
through a unique Proof-of-Contribution consensus mechanism.

Core Features:
- Proof-of-Relay: 30% of block rewards go to Tor operators
- Native .onion node identity (no IP exposure)
- Temporal obfuscation protocols
- Dandelion++ over Tor propagation
- Native inheritance system with dead man's switch

Technical Stack:
- Rust workspace with 8 crates
- Ed25519/X25519 cryptography
- arti (Rust Tor client) integration planned
- 10 minute block time, 5-10 TPS design

Status: Prototype
- Consensus logic complete with passing tests (30/33)
- Network layer conceptual design complete
- Tor integration pending
- Testnet launch planned Q3 2026

License: MIT
Author: Gabriele Salati (virebent)
Contact: g48rix@gmail.com
Website: https://www.gabrielesalati.eu
Repository: https://git.virebent.art/virebent/onioncoin

1 files changed, 1285 insertions, 0 deletions

diff --git a/ROADMAP.md b/ROADMAP.md
new file mode 100644
index 0000000..4fbae73
--- /dev/null
+++ b/ROADMAP.md
@@ -0,0 +1,1285 @@
+# OnionCoin Production Roadmap
+
+**Status**: Prototype → Production-Ready → Mainnet Launch
+**Timeline**: 18-24 months (with dedicated team)
+**Current Phase**: Phase 0 (Prototype/Research)
+
+---
+
+## Overview
+
+This roadmap outlines the path from OnionCoin's current prototype state to a production-ready mainnet launch. The development is divided into 6 phases, each with specific milestones, deliverables, and estimated timelines.
+
+**Key Objectives**:
+1. Complete all cryptographic implementations
+2. Build production-grade Tor integration
+3. Conduct comprehensive security audits
+4. Launch testnet with community validators
+5. Deploy mainnet with fair genesis mining
+6. Build ecosystem (wallets, explorers, exchanges)
+
+---
+
+## Phase 0: Prototype & Research (CURRENT)
+
+**Status**: ✅ Complete (October 2024)
+**Duration**: 3 months
+**Team Size**: 1-2 developers
+
+### Deliverables
+- ✅ Core blockchain structure (blocks, transactions, chain)
+- ✅ Conceptual architecture for all modules
+- ✅ Temporal obfuscation protocol design
+- ✅ Proof-of-Contribution consensus specification
+- ✅ Native inheritance system design
+- ✅ Documentation (README, CONSENSUS, INHERITANCE, WHITEPAPER)
+- ✅ Rust project structure with modular crates
+
+### Achievements
+- Demonstrated feasibility of novel concepts
+- Established technical architecture
+- Created comprehensive documentation
+- Open-sourced under MIT license
+
+### What's Missing
+- ⚠ Full cryptographic implementations (ring sigs, bulletproofs)
+- ⚠ Actual Tor integration (currently stubbed)
+- ⚠ Working P2P network layer
+- ⚠ Wallet with GUI
+- ⚠ Security audits
+- ⚠ Testnet deployment
+
+---
+
+## Phase 1: Cryptographic Foundation
+
+**Timeline**: Months 1-4 (16 weeks)
+**Team Size**: 2-3 cryptography specialists + 1 lead developer
+**Estimated Cost**: $80,000 - $120,000 (salaries + audits)
+
+### Objectives
+Complete all cryptographic primitives with production-quality implementations
+
+### Milestone 1.1: Ring Signatures (Weeks 1-4)
+**Owner**: Cryptography Lead
+
+**Tasks**:
+- [ ] Implement LSAG (Linkable Spontaneous Anonymous Group) signatures
+- [ ] Key image generation and verification
+- [ ] Decoy selection algorithm (16-member rings)
+- [ ] Ring member validation (prevent duplicate keys)
+- [ ] Serialization/deserialization
+- [ ] Unit tests (100+ test cases)
+- [ ] Benchmarking (target: <2ms verification)
+
+**Deliverables**:
+- `crypto/ring_signature.rs` fully implemented
+- Test suite with 100% coverage
+- Performance benchmarks documented
+- Example usage in `examples/ring_sig_demo.rs`
+
+**Dependencies**: None
+**Risks**: Complex math, potential timing attacks
+
+### Milestone 1.2: Stealth Addresses (Weeks 3-5)
+**Owner**: Cryptography Developer #1
+
+**Tasks**:
+- [ ] Dual-key derivation (view key + spend key)
+- [ ] One-time address generation
+- [ ] Shared secret computation (ECDH)
+- [ ] Recipient scanning algorithm
+- [ ] Spend key derivation for outputs
+- [ ] Address encoding/decoding (base58/bech32)
+- [ ] Integration with wallet key management
+
+**Deliverables**:
+- `crypto/stealth_address.rs` complete
+- Address format specification document
+- Wallet integration guide
+
+**Dependencies**: Ed25519 primitives (already available)
+**Risks**: Privacy leaks if implemented incorrectly
+
+### Milestone 1.3: Bulletproofs (Weeks 4-8)
+**Owner**: Cryptography Lead + External Audit
+
+**Tasks**:
+- [ ] Integrate `bulletproofs` Rust library (or implement from scratch)
+- [ ] Range proof generation (64-bit values)
+- [ ] Range proof verification
+- [ ] Batch verification optimization
+- [ ] Proof aggregation (multiple outputs in one proof)
+- [ ] Integration with Pedersen commitments
+- [ ] Constant-time implementation (prevent timing attacks)
+
+**Deliverables**:
+- `crypto/bulletproofs.rs` complete
+- Aggregated proof support
+- Security audit report (external)
+
+**Dependencies**: `curve25519-dalek` library
+**Risks**: Performance bottleneck, complex zero-knowledge math
+
+### Milestone 1.4: Zero-Knowledge Time Proofs (Weeks 6-10)
+**Owner**: Cryptography Developer #2
+
+**Tasks**:
+- [ ] Design ZK circuit for time range proofs
+- [ ] Implement prover (generate proof that t ∈ [T_min, T_max])
+- [ ] Implement verifier
+- [ ] Optimize proof size (<500 bytes)
+- [ ] Integration with `TimingMetadata`
+- [ ] Formal verification (if possible)
+
+**Deliverables**:
+- `timing/zk_time_proof.rs` complete
+- Formal specification document
+- Peer-reviewed cryptographic design
+
+**Dependencies**: Bulletproofs framework
+**Risks**: Novel construction, requires peer review
+
+### Milestone 1.5: Hash Functions & Merkle Trees (Weeks 8-12)
+**Owner**: Core Developer
+
+**Tasks**:
+- [ ] Standardize hash function (Blake2b or SHA3-256)
+- [ ] Merkle tree implementation for blocks
+- [ ] Merkle proof generation/verification
+- [ ] Merkle tree for relay work proofs (PoC)
+- [ ] Transaction hash computation (deterministic serialization)
+
+**Deliverables**:
+- `crypto/hash.rs` complete
+- `core/merkle.rs` complete
+- Hash function specification
+
+**Dependencies**: None
+**Risks**: Low (well-understood primitives)
+
+### Milestone 1.6: Comprehensive Testing & Audit (Weeks 10-16)
+**Owner**: QA Lead + External Auditors
+
+**Tasks**:
+- [ ] Integration tests (all crypto components together)
+- [ ] Fuzz testing (detect edge cases)
+- [ ] Constant-time verification (prevent timing attacks)
+- [ ] External cryptographic audit (hire firm like Trail of Bits)
+- [ ] Fix all identified vulnerabilities
+- [ ] Publish audit report
+
+**Deliverables**:
+- Test coverage >95% for all crypto code
+- Published security audit report
+- Remediation report for all findings
+
+**Cost**: $30,000 - $50,000 for external audit
+**Timeline**: 4-6 weeks for audit process
+
+### Phase 1 Completion Criteria
+- ✅ All cryptographic primitives implemented
+- ✅ Security audit passed (no critical/high findings)
+- ✅ Performance benchmarks met (ring sig verify <2ms, bulletproof verify <5ms)
+- ✅ 100% test coverage on crypto code
+- ✅ Documentation complete
+
+**Outcome**: Production-grade cryptography layer ready for integration
+
+---
+
+## Phase 2: Tor Network Integration
+
+**Timeline**: Months 5-8 (16 weeks)
+**Team Size**: 2 network engineers + 1 Tor specialist
+**Estimated Cost**: $70,000 - $100,000
+
+### Objectives
+Build native Tor integration layer for all network communication
+
+### Milestone 2.1: Tor Process Management (Weeks 1-3)
+**Owner**: Network Lead
+
+**Tasks**:
+- [ ] Embed Tor binary in OnionCoin distribution (or require system Tor)
+- [ ] Programmatic Tor process spawning
+- [ ] Tor configuration generation (torrc file)
+- [ ] Health monitoring (detect Tor crashes)
+- [ ] Graceful shutdown handling
+- [ ] Log parsing for errors
+
+**Deliverables**:
+- `network/tor_process.rs` complete
+- Cross-platform support (Linux, macOS, Windows)
+
+**Dependencies**: System `tor` package or bundled binary
+**Risks**: Platform compatibility issues
+
+### Milestone 2.2: Hidden Service Creation (Weeks 2-5)
+**Owner**: Network Engineer #1
+
+**Tasks**:
+- [ ] Hidden service v3 onion address generation
+- [ ] Port forwarding configuration (9333 P2P, 9334 RPC)
+- [ ] Private key persistence (securely store .onion identity)
+- [ ] Descriptor publishing to HSDir
+- [ ] Introduction point management
+- [ ] Rendezvous point handling
+
+**Deliverables**:
+- `network/hidden_service.rs` complete
+- Stable .onion addresses across restarts
+- Automatic hidden service creation on first run
+
+**Dependencies**: Tor control port (9051)
+**Risks**: Tor network reliability, descriptor propagation delays
+
+### Milestone 2.3: Tor Circuit Management (Weeks 4-7)
+**Owner**: Tor Specialist
+
+**Tasks**:
+- [ ] Circuit creation for outbound connections
+- [ ] Stream isolation (different circuits for different purposes)
+- [ ] Circuit health monitoring
+- [ ] Automatic circuit rotation (every 10 minutes)
+- [ ] Bandwidth measurement via Tor
+- [ ] Exit policy handling (for relay work proofs)
+
+**Deliverables**:
+- `network/tor_circuit.rs` complete
+- Bandwidth measurement integration with PoC
+
+**Dependencies**: Tor control protocol
+**Risks**: Tor latency variability, circuit failures
+
+### Milestone 2.4: P2P Networking over Tor (Weeks 5-10)
+**Owner**: Network Lead + Engineer #2
+
+**Tasks**:
+- [ ] Connect to peers via .onion addresses
+- [ ] SOCKS5 proxy configuration
+- [ ] Message serialization (blocks, transactions, handshakes)
+- [ ] Connection pooling (maintain 8-16 peer connections)
+- [ ] Peer discovery via DHT (Kademlia over Tor)
+- [ ] Bootstrap node seeding
+- [ ] Ping/pong keepalive messages
+- [ ] Peer reputation system (ban misbehaving peers)
+
+**Deliverables**:
+- `network/p2p.rs` complete
+- DHT implementation (`network/dht.rs`)
+- Peer discovery working on testnet
+
+**Dependencies**: Tor hidden services operational
+**Risks**: Tor latency causing connection timeouts
+
+### Milestone 2.5: Dandelion++ Implementation (Weeks 8-12)
+**Owner**: Network Engineer #2
+
+**Tasks**:
+- [ ] STEM phase routing (1-4 hops with delays)
+- [ ] Random relay selection (verifiable randomness)
+- [ ] FLUFF phase broadcast
+- [ ] Mixing pool integration
+- [ ] Transaction batching and shuffling
+- [ ] Dummy transaction generation (5-10% of pool)
+
+**Deliverables**:
+- `network/dandelion.rs` complete
+- `timing/mixing_pool.rs` complete
+- Privacy analysis report (anonymity set size)
+
+**Dependencies**: P2P network operational
+**Risks**: Timing attacks on mixing pools
+
+### Milestone 2.6: Relay Work Proof System (Weeks 10-14)
+**Owner**: Network Lead + Core Developer
+
+**Tasks**:
+- [ ] Track relayed OnionCoin traffic (bytes, circuit IDs)
+- [ ] Merkle tree construction for relay proofs
+- [ ] Periodic proof submission (every 10 min)
+- [ ] Verification of relay proofs by validators
+- [ ] Sybil attack prevention (prove actual bandwidth)
+- [ ] Integration with PoC scoring
+
+**Deliverables**:
+- `consensus/relay_proof.rs` complete
+- Relay work tracking in validators
+- Anti-gaming mechanisms documented
+
+**Dependencies**: Tor circuit management, Merkle trees
+**Risks**: Difficult to prevent fake relay proofs
+
+### Milestone 2.7: Network Testing & Optimization (Weeks 12-16)
+**Owner**: QA + All Network Engineers
+
+**Tasks**:
+- [ ] Stress testing (1000+ nodes simulated)
+- [ ] Latency profiling under various Tor conditions
+- [ ] Connection failure handling
+- [ ] Network partition recovery (split-brain scenarios)
+- [ ] Bandwidth optimization (reduce unnecessary traffic)
+- [ ] Testnet deployment with 20+ real nodes
+
+**Deliverables**:
+- Network performance benchmarks
+- Testnet running stable for 2+ weeks
+- Optimization guide for node operators
+
+**Cost**: Cloud infrastructure for testing ($5,000)
+
+### Phase 2 Completion Criteria
+- ✅ All nodes running as .onion hidden services
+- ✅ P2P network stable with 20+ nodes
+- ✅ Dandelion++ working (verified via traffic analysis resistance)
+- ✅ Relay work proofs functional
+- ✅ No network splits or partitions for 2 consecutive weeks
+
+**Outcome**: Production-ready Tor-based P2P network
+
+---
+
+## Phase 3: Consensus & Blockchain
+
+**Timeline**: Months 7-10 (16 weeks, overlaps with Phase 2)
+**Team Size**: 2 blockchain developers + 1 consensus researcher
+**Estimated Cost**: $60,000 - $90,000
+
+### Objectives
+Complete Proof-of-Contribution consensus and finalize blockchain logic
+
+### Milestone 3.1: Contribution Score Calculation (Weeks 1-3)
+**Owner**: Consensus Lead
+
+**Tasks**:
+- [ ] Implement stake component (logarithmic scaling)
+- [ ] Implement relay work component (from Phase 2)
+- [ ] Implement bandwidth component (challenge-response)
+- [ ] Implement uptime component (heartbeat tracking)
+- [ ] Implement storage component (pruning detection)
+- [ ] Weighted aggregation (40% stake, 30% relay, 15% bandwidth, 10% uptime, 5% storage)
+- [ ] Score normalization
+
+**Deliverables**:
+- `consensus/contribution_score.rs` complete
+- Scoring simulation tool (test fairness)
+
+**Dependencies**: Relay work proofs (Phase 2)
+**Risks**: Gaming attacks (validators faking scores)
+
+### Milestone 3.2: Validator Selection Algorithm (Weeks 2-5)
+**Owner**: Blockchain Developer #1
+
+**Tasks**:
+- [ ] Weighted random selection from contribution scores
+- [ ] Deterministic randomness (from previous block hash)
+- [ ] Validator registry (stake locking, registration)
+- [ ] Minimum stake enforcement (10 ONC)
+- [ ] Slashing conditions (conflicting blocks, downtime)
+- [ ] Validator rotation (ensure distribution)
+
+**Deliverables**:
+- `consensus/validator.rs` complete
+- `consensus/selection.rs` complete
+- Slashing mechanism implemented
+
+**Dependencies**: Contribution scoring
+**Risks**: Predictable validator selection (exploit risk)
+
+### Milestone 3.3: Block Production & Validation (Weeks 4-7)
+**Owner**: Blockchain Lead
+
+**Tasks**:
+- [ ] Block header creation (with fuzzy timestamps)
+- [ ] Transaction selection from mempool
+- [ ] Merkle root calculation
+- [ ] Block size limit enforcement (2 MB)
+- [ ] Contribution proof inclusion in blocks
+- [ ] Block signature by validator
+- [ ] Block verification by peers
+- [ ] Orphan block handling
+
+**Deliverables**:
+- `core/block.rs` fully implemented
+- Block validation rules documented
+
+**Dependencies**: Cryptographic functions (Phase 1)
+**Risks**: Consensus bugs causing chain splits
+
+### Milestone 3.4: Chain Reorganization & Finality (Weeks 6-9)
+**Owner**: Blockchain Developer #2
+
+**Tasks**:
+- [ ] Longest chain selection (or GHOST protocol)
+- [ ] Reorg handling (switch to heavier chain)
+- [ ] Finality after 6 confirmations (~60 min)
+- [ ] Checkpointing (every 10,000 blocks)
+- [ ] Long-range attack prevention
+- [ ] State rollback on reorg
+
+**Deliverables**:
+- `core/chain.rs` with reorg logic
+- Finality guarantees documented
+
+**Dependencies**: Block validation
+**Risks**: Reorg bugs causing loss of funds
+
+### Milestone 3.5: UTXO Management (Weeks 7-10)
+**Owner**: Blockchain Developer #1
+
+**Tasks**:
+- [ ] UTXO set (unspent transaction outputs)
+- [ ] UTXO creation on new transactions
+- [ ] UTXO spending and removal
+- [ ] Double-spend prevention (key image checking)
+- [ ] UTXO pruning (old spent outputs)
+- [ ] Efficient lookup (database indexing)
+
+**Deliverables**:
+- `core/utxo.rs` complete
+- Database schema for UTXO set
+
+**Dependencies**: Transaction structure
+**Risks**: Database performance at scale
+
+### Milestone 3.6: Mempool & Transaction Propagation (Weeks 8-12)
+**Owner**: Blockchain Lead
+
+**Tasks**:
+- [ ] Mempool (pending transaction pool)
+- [ ] Transaction validation before mempool entry
+- [ ] Fee-based prioritization
+- [ ] Mempool size limits (prevent DoS)
+- [ ] Transaction expiry (after 24 hours)
+- [ ] Mempool synchronization across peers
+
+**Deliverables**:
+- `core/mempool.rs` complete
+- Transaction relay working on testnet
+
+**Dependencies**: P2P network (Phase 2)
+**Risks**: Mempool spam attacks
+
+### Milestone 3.7: Genesis Block & Fair Launch (Weeks 10-14)
+**Owner**: Consensus Researcher + Lead
+
+**Tasks**:
+- [ ] Genesis block creation (height 0, no pre-mine)
+- [ ] Genesis mining period setup (6 months, 1M ONC distribution)
+- [ ] Early participant bonus calculation (2x → 1x decay)
+- [ ] Genesis validator set (bootstrap with core team, transition to community)
+- [ ] Fair launch announcement strategy
+
+**Deliverables**:
+- `consensus/genesis.rs` complete
+- Genesis mining rules documented
+- Fair launch plan
+
+**Dependencies**: All consensus components
+**Risks**: Perception of unfair distribution
+
+### Milestone 3.8: Consensus Testing (Weeks 12-16)
+**Owner**: QA + All Consensus Developers
+
+**Tasks**:
+- [ ] Simulation testing (10,000+ blocks)
+- [ ] Byzantine fault tolerance tests
+- [ ] 51% attack simulations
+- [ ] Chain reorganization stress tests
+- [ ] Network partition tests
+- [ ] Formal verification (if feasible)
+
+**Deliverables**:
+- Consensus test suite (100+ scenarios)
+- Security analysis report
+- Attack resistance documented
+
+**Cost**: Simulation infrastructure ($3,000)
+
+### Phase 3 Completion Criteria
+- ✅ Consensus produces valid blocks consistently
+- ✅ No chain splits in 1000+ block simulation
+- ✅ Validator selection is fair and unpredictable
+- ✅ Slashing mechanisms working
+- ✅ Genesis mining ready to launch
+
+**Outcome**: Production-ready blockchain consensus
+
+---
+
+## Phase 4: Wallet & User Experience
+
+**Timeline**: Months 9-12 (16 weeks, overlaps with Phase 3)
+**Team Size**: 2 frontend developers + 1 UX designer
+**Estimated Cost**: $50,000 - $80,000
+
+### Objectives
+Build user-friendly wallet applications (CLI, GUI, mobile)
+
+### Milestone 4.1: Core Wallet Library (Weeks 1-4)
+**Owner**: Wallet Lead
+
+**Tasks**:
+- [ ] HD wallet (BIP-32 style hierarchical deterministic keys)
+- [ ] Mnemonic seed generation (12/24 words)
+- [ ] Key derivation (view key, spend key)
+- [ ] Address generation (stealth addresses)
+- [ ] UTXO scanning (detect incoming transactions)
+- [ ] Balance calculation
+- [ ] Transaction creation
+- [ ] Fee estimation
+
+**Deliverables**:
+- `wallet/core.rs` library
+- Wallet file format specification
+
+**Dependencies**: Cryptographic functions (Phase 1)
+**Risks**: Key management bugs (loss of funds)
+
+### Milestone 4.2: CLI Wallet (Weeks 3-6)
+**Owner**: Backend Developer
+
+**Tasks**:
+- [ ] Command-line interface (`onioncoin-wallet`)
+- [ ] Commands: `create`, `restore`, `balance`, `send`, `receive`, `history`
+- [ ] Inheritance commands: `create-will`, `heartbeat`, `recover`
+- [ ] Configuration file support
+- [ ] JSON-RPC interface (for advanced users)
+
+**Deliverables**:
+- `onioncoin-wallet` CLI binary
+- User guide documentation
+
+**Dependencies**: Wallet library
+**Risks**: Poor UX (mitigate with clear error messages)
+
+### Milestone 4.3: GUI Wallet (Desktop) (Weeks 5-10)
+**Owner**: Frontend Lead + UX Designer
+
+**Tasks**:
+- [ ] Cross-platform desktop app (Electron or Tauri)
+- [ ] Wallet creation wizard
+- [ ] Send/receive interface
+- [ ] Transaction history view
+- [ ] Inheritance setup UI
+- [ ] Heartbeat reminders
+- [ ] Settings (fee level, Tor configuration)
+
+**Deliverables**:
+- Desktop wallet app (Linux, macOS, Windows)
+- UX/UI design mockups
+
+**Dependencies**: CLI wallet functionality
+**Cost**: UI/UX design ($5,000)
+**Risks**: Electron bloat (consider Tauri for lighter footprint)
+
+### Milestone 4.4: Mobile Wallet (Light Client) (Weeks 7-12)
+**Owner**: Mobile Developer (contract hire)
+
+**Tasks**:
+- [ ] iOS and Android apps (React Native or Flutter)
+- [ ] Light client protocol (connect to trusted full node)
+- [ ] Simplified UI for small screens
+- [ ] QR code scanning for addresses
+- [ ] Push notifications for incoming payments
+- [ ] Biometric authentication (Face ID, fingerprint)
+
+**Deliverables**:
+- Mobile wallet apps (iOS, Android)
+- App store submission
+
+**Dependencies**: Light client protocol (Phase 5)
+**Cost**: $20,000 - $30,000 for mobile development
+**Risks**: App store approval (privacy concerns)
+
+### Milestone 4.5: Inheritance UI (Weeks 8-11)
+**Owner**: Frontend Lead
+
+**Tasks**:
+- [ ] Will creation wizard (add beneficiaries, percentages)
+- [ ] Shamir secret sharing setup (split seed among friends)
+- [ ] Heartbeat scheduling (auto-send every 90 days)
+- [ ] Recovery interface (for beneficiaries)
+- [ ] Dispute submission
+- [ ] Visual timeline showing unlock schedule
+
+**Deliverables**:
+- Inheritance features in GUI and mobile wallets
+- Inheritance user guide
+
+**Dependencies**: Inheritance system (Phase 5)
+**Risks**: Complex UX (simplify with wizards)
+
+### Milestone 4.6: Wallet Security Audit (Weeks 10-14)
+**Owner**: Security Auditor (external)
+
+**Tasks**:
+- [ ] Code review for key management
+- [ ] Test for wallet file encryption
+- [ ] Verify seed backup/restore
+- [ ] Check for memory leaks (private keys in RAM)
+- [ ] Penetration testing
+
+**Deliverables**:
+- Wallet security audit report
+- Fixes for all critical findings
+
+**Cost**: $10,000 - $20,000
+**Timeline**: 3-4 weeks
+
+### Milestone 4.7: User Documentation (Weeks 12-16)
+**Owner**: Technical Writer (contract)
+
+**Tasks**:
+- [ ] User guide (beginners)
+- [ ] Advanced user manual
+- [ ] Inheritance setup tutorial
+- [ ] FAQ
+- [ ] Video tutorials (optional)
+- [ ] Troubleshooting guide
+
+**Deliverables**:
+- Complete user documentation website
+- Video tutorials (3-5 videos)
+
+**Cost**: $5,000 - $10,000 for technical writing
+
+### Phase 4 Completion Criteria
+- ✅ CLI wallet functional and stable
+- ✅ Desktop GUI wallet released (all platforms)
+- ✅ Mobile wallet in beta testing
+- ✅ Inheritance features working end-to-end
+- ✅ Security audit passed
+- ✅ User documentation complete
+
+**Outcome**: User-friendly wallet ecosystem
+
+---
+
+## Phase 5: Advanced Features & Optimizations
+
+**Timeline**: Months 11-14 (16 weeks, overlaps with Phase 4)
+**Team Size**: 2 developers + 1 researcher
+**Estimated Cost**: $40,000 - $60,000
+
+### Objectives
+Implement inheritance system, light clients, and performance optimizations
+
+### Milestone 5.1: Inheritance System (Weeks 1-6)
+**Owner**: Inheritance Specialist
+
+**Tasks**:
+- [ ] Will creation transaction format
+- [ ] Encrypted beneficiary storage
+- [ ] Shamir secret sharing integration
+- [ ] Heartbeat transaction detection
+- [ ] Progressive unlock calculation (10% → 35% → 70% → 100%)
+- [ ] Recovery transaction creation and verification
+- [ ] Dispute mechanism
+- [ ] Arbiter system (optional trusted third party)
+
+**Deliverables**:
+- `inheritance/` module complete
+- Inheritance test scenarios (100+ cases)
+- INHERITANCE.md documentation finalized
+
+**Dependencies**: Core blockchain (Phase 3)
+**Risks**: Complex state machine, edge cases
+
+### Milestone 5.2: Light Client Protocol (Weeks 4-8)
+**Owner**: Developer #1
+
+**Tasks**:
+- [ ] Block header synchronization (download headers only)
+- [ ] Merkle proof verification (prove UTXO inclusion)
+- [ ] Trusted full node connection (user's own or designated)
+- [ ] Simplified payment verification (SPV)
+- [ ] Bandwidth optimization (minimal data transfer)
+
+**Deliverables**:
+- `wallet/light_client.rs` complete
+- Light client specification document
+
+**Dependencies**: Merkle trees (Phase 1), wallet (Phase 4)
+**Risks**: Trust assumptions (relies on honest full node)
+
+### Milestone 5.3: Performance Optimizations (Weeks 6-10)
+**Owner**: Performance Engineer
+
+**Tasks**:
+- [ ] Bulletproof aggregation (multiple outputs in one proof)
+- [ ] Compact ring signatures (reduce from 2 KB to 1.5 KB)
+- [ ] Database indexing (speed up UTXO lookups)
+- [ ] Parallel block verification (multi-threaded)
+- [ ] Memory pool optimization (reduce RAM usage)
+- [ ] Benchmarking suite
+
+**Deliverables**:
+- Performance improvements documented
+- Benchmarks showing 30-50% speedup
+
+**Dependencies**: All Phase 1-3 components
+**Risks**: Optimization bugs introducing vulnerabilities
+
+### Milestone 5.4: Block Explorer (Weeks 7-12)
+**Owner**: Web Developer (contract)
+
+**Tasks**:
+- [ ] Web-based block explorer
+- [ ] Block and transaction search
+- [ ] Privacy-preserving analytics (no address tracking)
+- [ ] Network statistics (hashrate, validators, transactions)
+- [ ] Charts and visualizations
+- [ ] API for developers
+
+**Deliverables**:
+- Block explorer website (e.g., explorer.onioncoin.io)
+- Public API documentation
+
+**Cost**: $10,000 - $15,000 for web development
+**Risks**: Accidental privacy leaks in explorer
+
+### Milestone 5.5: RPC API & Developer Tools (Weeks 8-12)
+**Owner**: Developer #2
+
+**Tasks**:
+- [ ] JSON-RPC API for node interaction
+- [ ] RPC methods: `getblockcount`, `sendtransaction`, `getbalance`, etc.
+- [ ] Developer SDK (Python, JavaScript libraries)
+- [ ] Example integrations (payment gateway)
+- [ ] API documentation
+
+**Deliverables**:
+- RPC specification
+- SDKs for Python and JavaScript
+- Developer documentation
+
+**Dependencies**: Core node (Phase 3)
+**Risks**: API security issues
+
+### Milestone 5.6: Testing & Stress Testing (Weeks 10-14)
+**Owner**: QA Lead
+
+**Tasks**:
+- [ ] End-to-end integration tests
+- [ ] Load testing (10,000 transactions in mempool)
+- [ ] Chaos engineering (random node failures)
+- [ ] Backwards compatibility tests
+- [ ] Regression testing suite
+
+**Deliverables**:
+- Comprehensive test suite
+- Performance benchmarks under load
+
+**Cost**: Testing infrastructure ($2,000)
+
+### Phase 5 Completion Criteria
+- ✅ Inheritance system working in production
+- ✅ Light client functional for mobile wallets
+- ✅ Performance optimizations deployed
+- ✅ Block explorer live
+- ✅ Developer tools and APIs ready
+
+**Outcome**: Feature-complete platform ready for testnet
+
+---
+
+## Phase 6: Testnet & Security
+
+**Timeline**: Months 13-16 (16 weeks)
+**Team Size**: Full team (8-10 people) + community
+**Estimated Cost**: $60,000 - $100,000 (including bug bounties)
+
+### Objectives
+Deploy public testnet, conduct security audits, build community
+
+### Milestone 6.1: Testnet Deployment (Weeks 1-2)
+**Owner**: DevOps Lead
+
+**Tasks**:
+- [ ] Deploy 10 initial validator nodes (team-operated)
+- [ ] Testnet genesis block creation
+- [ ] Faucet service (distribute test ONC)
+- [ ] Public documentation for joining testnet
+- [ ] Monitoring dashboard (uptime, transactions, validators)
+
+**Deliverables**:
+- Testnet live with 10+ nodes
+- Testnet faucet (faucet.testnet.onioncoin.io)
+- Validator onboarding guide
+
+**Cost**: Cloud infrastructure ($5,000 for 4 months)
+**Timeline**: 2 weeks
+
+### Milestone 6.2: Community Validator Recruitment (Weeks 2-6)
+**Owner**: Community Manager
+
+**Tasks**:
+- [ ] Publish testnet announcement
+- [ ] Recruit 50-100 community validators
+- [ ] Validator support (Discord/Telegram)
+- [ ] Incentives for testnet participation (mainnet airdrop)
+- [ ] Gamification (leaderboard for most reliable validators)
+
+**Deliverables**:
+- 50+ community-run testnet validators
+- Active Discord/Telegram community (500+ members)
+
+**Cost**: Community incentives ($10,000 for mainnet airdrop)
+**Timeline**: 4 weeks
+
+### Milestone 6.3: Bug Bounty Program (Weeks 1-16)
+**Owner**: Security Lead
+
+**Tasks**:
+- [ ] Launch bug bounty (HackerOne or Immunefi)
+- [ ] Reward tiers:
+  - Critical (consensus bugs): $10,000 - $50,000
+  - High (key theft): $5,000 - $10,000
+  - Medium (privacy leaks): $1,000 - $5,000
+  - Low (UI bugs): $100 - $1,000
+- [ ] Triage and fix reported bugs
+- [ ] Publish monthly security reports
+
+**Deliverables**:
+- Bug bounty program live
+- All critical/high bugs fixed
+
+**Cost**: $30,000 - $50,000 for bounties
+**Timeline**: Ongoing (full Phase 6)
+
+### Milestone 6.4: Comprehensive Security Audit (Weeks 4-10)
+**Owner**: External Security Firm
+
+**Tasks**:
+- [ ] Full codebase audit (Trail of Bits, NCC Group, or similar)
+- [ ] Consensus security review
+- [ ] Cryptographic implementation review
+- [ ] Network security testing
+- [ ] Smart contract security (inheritance system)
+- [ ] Publish audit report
+
+**Deliverables**:
+- Security audit report (public)
+- Remediation plan for all findings
+- Re-audit after fixes
+
+**Cost**: $50,000 - $100,000
+**Timeline**: 6-8 weeks
+
+### Milestone 6.5: Testnet Stress Testing (Weeks 6-12)
+**Owner**: QA + Community
+
+**Tasks**:
+- [ ] Coordinated stress test (1000+ transactions simultaneously)
+- [ ] Chain reorg testing (intentional forks)
+- [ ] 51% attack simulation (controlled)
+- [ ] Network partition recovery
+- [ ] Long-running stability (testnet runs for 2+ months)
+
+**Deliverables**:
+- Stress test report
+- Performance under load documented
+- Testnet running stable for 2+ months
+
+**Timeline**: 6 weeks of active testing
+
+### Milestone 6.6: Mainnet Preparation (Weeks 10-14)
+**Owner**: Project Lead
+
+**Tasks**:
+- [ ] Finalize mainnet genesis parameters
+- [ ] Coordinate mainnet launch date
+- [ ] Prepare mainnet announcement
+- [ ] Set up mainnet infrastructure (bootstrap nodes, DNS seeds)
+- [ ] Final code freeze and version tagging (v1.0.0)
+- [ ] Prepare launch communication (blog posts, social media)
+
+**Deliverables**:
+- Mainnet launch plan
+- v1.0.0 release candidate
+
+**Timeline**: 4 weeks
+
+### Milestone 6.7: Final Documentation & Marketing (Weeks 12-16)
+**Owner**: Marketing + Technical Writing
+
+**Tasks**:
+- [ ] Update all documentation for mainnet
+- [ ] Create marketing materials (website, videos, infographics)
+- [ ] Write launch blog post
+- [ ] Prepare press release
+- [ ] Reach out to crypto news outlets (CoinDesk, Decrypt, etc.)
+- [ ] Social media campaign
+
+**Deliverables**:
+- Marketing website (onioncoin.io)
+- Launch announcement materials
+- Media coverage plan
+
+**Cost**: $10,000 - $20,000 for marketing
+**Timeline**: 4 weeks
+
+### Phase 6 Completion Criteria
+- ✅ Testnet running stable for 2+ months
+- ✅ 50+ community validators
+- ✅ Security audit completed with no critical issues
+- ✅ Bug bounty yielded no unfixed critical bugs
+- ✅ Stress testing successful
+- ✅ Mainnet launch plan finalized
+- ✅ Community engaged and growing
+
+**Outcome**: Ready for mainnet launch
+
+---
+
+## Phase 7: Mainnet Launch
+
+**Timeline**: Month 17-18 (8 weeks)
+**Team Size**: Full team + community
+**Estimated Cost**: $30,000 - $50,000 (infrastructure + marketing)
+
+### Objectives
+Launch OnionCoin mainnet with fair genesis mining
+
+### Milestone 7.1: Genesis Block & Bootstrap (Week 1)
+**Owner**: Core Team
+
+**Tasks**:
+- [ ] Create mainnet genesis block (timestamp, hash)
+- [ ] Deploy 5-10 initial bootstrap nodes
+- [ ] Start genesis mining period (6 months, 1M ONC distribution)
+- [ ] Activate Tor relay work rewards (2x bonus for first month)
+- [ ] Monitor network health
+
+**Deliverables**:
+- Mainnet live (block 0)
+- Genesis mining active
+- Bootstrap nodes operational
+
+**Cost**: Infrastructure ($5,000 for 6 months)
+**Timeline**: 1 week
+
+### Milestone 7.2: Public Launch Announcement (Week 1-2)
+**Owner**: Marketing Lead
+
+**Tasks**:
+- [ ] Publish launch blog post
+- [ ] Social media blitz (Twitter, Reddit, BitcoinTalk)
+- [ ] Press release to crypto news outlets
+- [ ] AMA (Ask Me Anything) on Reddit
+- [ ] Launch party (virtual or in-person conference)
+
+**Deliverables**:
+- Media coverage in 3+ major crypto news sites
+- 1,000+ Twitter followers
+- 500+ Reddit upvotes
+
+**Cost**: PR agency ($10,000) + event costs ($5,000)
+**Timeline**: 2 weeks
+
+### Milestone 7.3: Community Validator Onboarding (Week 2-4)
+**Owner**: Community Manager
+
+**Tasks**:
+- [ ] Help users set up validators (tutorials, support)
+- [ ] Distribute initial ONC to early validators (from genesis mining)
+- [ ] Monitor validator distribution (ensure decentralization)
+- [ ] Resolve technical issues quickly
+
+**Deliverables**:
+- 100+ validators within 2 weeks
+- Geographic distribution across 20+ countries
+
+**Timeline**: 2 weeks
+
+### Milestone 7.4: Exchange Listings (Week 4-8)
+**Owner**: Business Development
+
+**Tasks**:
+- [ ] Apply to decentralized exchanges (DEXs):
+  - Uniswap (if possible, may need ERC-20 bridge)
+  - SushiSwap
+  - Pancake Swap
+- [ ] Apply to centralized exchanges (CEXs):
+  - Tier 2: Kraken, Gemini (privacy-friendly)
+  - Tier 3: KuCoin, Gate.io
+  - Avoid: Coinbase (delists privacy coins)
+- [ ] Provide liquidity (market making)
+
+**Deliverables**:
+- Listed on 2+ DEXs
+- Listed on 1+ CEXs (ideally Kraken)
+
+**Cost**: Listing fees ($10,000 - $50,000 per CEX, free for DEXs)
+**Risks**: CEXs may reject privacy coins due to regulation
+
+### Milestone 7.5: Ecosystem Development (Week 4-8)
+**Owner**: Developer Relations
+
+**Tasks**:
+- [ ] Grants program for developers ($100K fund)
+- [ ] Hackathon sponsorship
+- [ ] Developer community (Discord, GitHub)
+- [ ] Example projects:
+  - Payment gateway for e-commerce
+  - Donation platform
+  - Privacy-focused messaging app integration
+
+**Deliverables**:
+- 5+ funded ecosystem projects
+- Developer documentation
+- Active developer community (50+ devs)
+
+**Cost**: $100,000 for grants
+**Timeline**: Ongoing
+
+### Milestone 7.6: First 100 Blocks Celebration (Week 2)
+**Owner**: Community Manager
+
+**Tasks**:
+- [ ] Monitor first 100 blocks
+- [ ] Celebrate milestones (block 1, 10, 100)
+- [ ] Highlight early validators
+- [ ] Collect community feedback
+
+**Deliverables**:
+- Social media posts celebrating early blocks
+- Community engagement
+
+**Timeline**: 2 weeks (100 blocks ≈ 16 hours)
+
+### Milestone 7.7: Post-Launch Monitoring (Week 1-8)
+**Owner**: DevOps + Full Team
+
+**Tasks**:
+- [ ] 24/7 monitoring dashboard
+- [ ] Incident response plan
+- [ ] Hotfix deployment process
+- [ ] Community support (Discord, Telegram)
+- [ ] Weekly status reports
+
+**Deliverables**:
+- Zero critical incidents in first month
+- Quick response to any issues (<1 hour)
+
+**Timeline**: Ongoing (first 2 months critical)
+
+### Phase 7 Completion Criteria
+- ✅ Mainnet live and stable
+- ✅ 100+ validators operating
+- ✅ Genesis mining functional
+- ✅ Exchange listings secured
+- ✅ Community engaged (1000+ users)
+- ✅ Media coverage achieved
+- ✅ No critical bugs in first 2 months
+
+**Outcome**: OnionCoin mainnet successfully launched
+
+---
+
+## Phase 8: Post-Launch Growth (Ongoing)
+
+**Timeline**: Months 19+ (indefinite)
+**Team Size**: Core team + community contributors
+**Estimated Cost**: $50,000 - $100,000/month (salaries, infrastructure, grants)
+
+### Objectives
+Grow ecosystem, maintain network, continuous improvement
+
+### Ongoing Activities
+
+**1. Network Maintenance**
+- Monitor consensus health
+- Deploy security patches
+- Upgrade Tor integration as Tor evolves
+- Quarterly security audits
+
+**2. Community Growth**
+- Marketing campaigns
+- Conference sponsorships
+- Content creation (blog, podcasts, videos)
+- Community events (meetups, hackathons)
+
+**3. Ecosystem Development**
+- Continue grants program
+- Onboard merchants (accept ONC payments)
+- Partnerships with privacy organizations (EFF, Tor Project)
+- Academic research collaborations
+
+**4. Protocol Upgrades**
+- Post-quantum cryptography migration (when quantum threat emerges)
+- Layer-2 scaling solutions (payment channels)
+- Limited smart contracts (covenants for inheritance, escrow)
+- Cross-chain bridges (atomic swaps with BTC, XMR)
+
+**5. Governance**
+- Establish OnionCoin Foundation (non-profit)
+- Community governance for protocol changes
+- Transparent treasury management
+
+---
+
+## Resource Requirements Summary
+
+### Team Composition (Peak, Months 6-12)
+
+| Role | Count | Monthly Salary | Total (6 months) |
+|------|-------|---------------|------------------|
+| Project Lead | 1 | $12,000 | $72,000 |
+| Cryptography Lead | 1 | $10,000 | $60,000 |
+| Cryptography Developer | 2 | $8,000 | $96,000 |
+| Blockchain Developer | 2 | $8,000 | $96,000 |
+| Network Engineer | 2 | $8,000 | $96,000 |
+| Frontend Developer | 2 | $7,000 | $84,000 |
+| Mobile Developer | 1 | $8,000 | $48,000 |
+| DevOps Engineer | 1 | $7,000 | $42,000 |
+| QA Engineer | 1 | $6,000 | $36,000 |
+| Technical Writer | 1 | $5,000 | $30,000 |
+| Community Manager | 1 | $5,000 | $30,000 |
+| **Total Team Cost** | **15** | **$94,000/mo** | **$690,000** |
+
+### Additional Costs
+
+| Category | Amount |
+|----------|--------|
+| Security Audits | $80,000 - $150,000 |
+| Bug Bounties | $30,000 - $50,000 |
+| Cloud Infrastructure (18 months) | $15,000 |
+| Marketing & PR | $30,000 - $50,000 |
+| Legal & Compliance | $20,000 - $40,000 |
+| Grants Program | $100,000 |
+| Exchange Listings | $20,000 - $100,000 |
+| **Total Additional** | **$295,000 - $505,000** |
+
+### Grand Total Budget
+
+**18-Month Development Cost**: $985,000 - $1,195,000
+
+**Monthly Operating Cost (Post-Launch)**: $50,000 - $100,000
+
+---
+
+## Funding Strategy
+
+### Option 1: Venture Capital
+- Raise $1.5M - $2M seed round
+- Give up 20-30% equity
+- Pros: Fast funding, network/connections
+- Cons: Investor pressure, loss of control
+
+### Option 2: Grants & Donations
+- Apply for blockchain grants (Ethereum Foundation, etc.)
+- Open-source community donations (GitHub Sponsors, Gitcoin)
+- Pros: No equity dilution, community-aligned
+- Cons: Slower, uncertain amounts
+
+### Option 3: Fair Launch with Treasury
+- 2% of genesis mining goes to treasury (20,000 ONC)
+- Treasury funds development (if ONC reaches $50, that's $1M)
+- Pros: Aligned with fair launch ethos
+- Cons: Chicken-and-egg (need value first)
+
+### Option 4: Hybrid
+- Small initial funding ($200K-$500K from angel investors or grants)
+- Bootstrap to testnet
+- Raise larger round after testnet success
+- Use genesis treasury for long-term sustainability
+
+**Recommended**: Option 4 (Hybrid approach)
+
+---
+
+## Risk Mitigation
+
+### Technical Risks
+
+| Risk | Probability | Impact | Mitigation |
+|------|------------|--------|------------|
+| Cryptography bugs | Medium | Critical | Multiple audits, formal verification |
+| Consensus failure | Low | Critical | Extensive testing, checkpointing |
+| Tor network limitations | Medium | High | Optimize for Tor, embrace latency |
+| Scaling bottleneck | High | Medium | Layer-2 solutions, performance optimization |
+| Quantum computers | Low (10+ years) | Critical | Post-quantum migration plan |
+
+### Market Risks
+
+| Risk | Probability | Impact | Mitigation |
+|------|------------|--------|------------|
+| Privacy coin ban | Medium | Critical | Decentralized, censorship-resistant (Tor) |
+| Lack of adoption | High | High | Strong marketing, unique features (inheritance) |
+| Competition (Monero) | High | Medium | Differentiate (temporal obfuscation, PoC, inheritance) |
+| Low ONC price | Medium | Medium | Fair launch, real utility (inheritance solves $140B problem) |
+| Exchange delistings | Medium | High | Focus on DEXs, P2P trading |
+
+### Operational Risks
+
+| Risk | Probability | Impact | Mitigation |
+|------|------------|--------|------------|
+| Team turnover | Medium | High | Competitive salaries, equity, open-source community |
+| Funding shortfall | Medium | Critical | Hybrid funding, treasury reserve |
+| Legal issues | Medium | Medium | Legal counsel, compliant launch |
+| Community backlash | Low | Medium | Transparent communication, fair launch |
+
+---
+
+## Success Metrics
+
+### Phase 6 (Testnet)
+- ✅ 50+ community validators
+- ✅ 10,000+ testnet transactions
+- ✅ 2+ months uptime (99.9%)
+- ✅ Security audit passed
+- ✅ 500+ Discord/Telegram members
+
+### Phase 7 (Mainnet Launch)
+- ✅ 100+ mainnet validators (first month)
+- ✅ 1,000+ active wallets
+- ✅ 1,000+ daily transactions
+- ✅ 2+ exchange listings
+- ✅ Media coverage in 3+ major outlets
+
+### Year 1 (Post-Launch)
+- ✅ 500+ validators
+- ✅ 10,000+ active wallets
+- ✅ $10M+ market cap
+- ✅ 5+ ecosystem projects
+- ✅ 99.9% uptime
+
+### Year 3 (Maturity)
+- ✅ 1,000+ validators
+- ✅ 100,000+ active wallets
+- ✅ $100M+ market cap
+- ✅ 20+ ecosystem projects
+- ✅ Academic research papers citing OnionCoin
+
+---
+
+## Conclusion
+
+This roadmap outlines an ambitious but achievable path from OnionCoin's current prototype state to a production-ready, privacy-focused cryptocurrency with revolutionary features.
+
+**Key Milestones**:
+- Month 4: Cryptography complete
+- Month 8: Tor network integration complete
+- Month 10: Consensus finalized
+- Month 12: Wallets ready
+- Month 16: Testnet launched
+- Month 18: Mainnet launch
+
+**Total Cost**: ~$1M - $1.2M for 18 months
+**Team Size**: 10-15 people at peak
+
+**Critical Success Factors**:
+1. **Security first**: Multiple audits, bug bounties
+2. **Fair launch**: No pre-mine, community-driven
+3. **Unique value**: Temporal obfuscation + PoC + inheritance
+4. **Strong community**: Transparent, responsive, engaged
+5. **Regulatory compliance**: Legal counsel, avoid securities classification
+
+**Next Steps**: Secure initial funding ($200K-$500K) to begin Phase 1.
+
+---
+
+**Ready to build the future of private cryptocurrency? Let's make OnionCoin a reality.**