Architecture Overview

This page provides a high-level view of the NØNOS-Ecosystem architecture. For deeper technical details, see the Technical Architecture section.

---

System Layers

The NONOS ecosystem consists of four interconnected layers:

╔═══════════════════════════════════════════════════════════════════════╗
║                         APPLICATION LAYER                             ║
║  ┌─────────────────────────────────────────────────────────────────┐  ║
║  │                          BROWSER                             │  ║
║  │  • Native WebView (Rust/Tauri)                                  │  ║
║  │  • Svelte UI Components                                         │  ║
║  │  • Integrated Wallet                                            │  ║
║  │  • Security Level Controls                                      │  ║
║  └─────────────────────────────────────────────────────────────────┘  ║
╠═══════════════════════════════════════════════════════════════════════╣
║                          SERVICE LAYER                                ║
║  ┌───────────────┐  ┌───────────────┐  ┌───────────────────────────┐  ║
║  │  ZK Identity  │  │  Cache Mixer  │  │    Tracking Blocker       │  ║
║  │    Service    │  │    Service    │  │       Service             │  ║
║  └───────────────┘  └───────────────┘  └───────────────────────────┘  ║
║  ┌───────────────┐  ┌───────────────┐  ┌───────────────────────────┐  ║
║  │    Health     │  │    Quality    │  │      Stealth Address      │  ║
║  │    Beacon     │  │    Oracle     │  │        Scanner            │  ║
║  └───────────────┘  └───────────────┘  └───────────────────────────┘  ║
╠═══════════════════════════════════════════════════════════════════════╣
║                          NETWORK LAYER                                ║
║  ┌─────────────────────────────────────────────────────────────────┐  ║
║  │                     P2P NETWORK (libp2p)                        │  ║
║  │  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────────────────┐ │  ║
║  │  │Kademlia │  │GossipSub│  │  Noise  │  │  Yamux Multiplexing │ │  ║
║  │  │   DHT   │  │ Pub/Sub │  │Encryption│  │                    │ │  ║
║  │  └─────────┘  └─────────┘  └─────────┘  └─────────────────────┘ │  ║
║  └─────────────────────────────────────────────────────────────────┘  ║
╠═══════════════════════════════════════════════════════════════════════╣
║                        SETTLEMENT LAYER                               ║
║  ┌─────────────────────────────────────────────────────────────────┐  ║
║  │                    ETHEREUM MAINNET                             │  ║
║  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐  │  ║
║  │  │  NOX Token  │  │   Staking   │  │      Reward Claims      │  │  ║
║  │  │   (ERC-20)  │  │  Contract   │  │        Contract         │  │  ║
║  │  └─────────────┘  └─────────────┘  └─────────────────────────┘  │  ║
║  └─────────────────────────────────────────────────────────────────┘  ║
╚═══════════════════════════════════════════════════════════════════════╝

---

Component Overview

Application Layer

The NOXONE Browser is the user-facing application:

Component	Technology	Purpose
WebView	Tauri (wry/tao)	Native browser rendering
UI	Svelte	Reactive interface components
Wallet	Rust (secp256k1)	Key management, signing
IPC Bridge	window.noxone	Frontend-backend communication

---

Service Layer

NONOS Daemon provides cryptographic privacy services:

Service	Function	Technology
ZK Identity	Anonymous authentication	Poseidon Merkle trees
Cache Mixer	Privacy-preserving caching	AES-GCM + Merkle
Tracking Blocker	Block trackers/fingerprinting	Pattern matching
Health Beacon	Network liveness	GossipSub broadcast
Quality Oracle	Performance metrics	On-chain reporting
Stealth Scanner	Private payments	Viewing key derivation

---

Network Layer

P2P Network connects all nodes:

Protocol	Purpose	Implementation
Kademlia	Peer discovery	DHT routing
GossipSub	Message propagation	Pub/sub topics
Noise	Encryption	XX handshake pattern
Yamux	Multiplexing	Stream management
Identify	Peer info	Protocol negotiation

---

Settlement Layer

Ethereum handles economic settlement:

Contract	Address	Function
NOX Token	0x0a26...9eCA	ERC-20 token
Staking Vault	0xD548...0423	32M NOX pool
Staking Contract	TBA	Stake management

---

Data Flow

Browser Request Flow

┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
│  Browser │────►│  NONOS   │────►│  Anyone  │────►│ Internet │
│   User   │     │  Daemon  │     │ Network  │     │  Target  │
└──────────┘     └──────────┘     └──────────┘     └──────────┘
     │                │                │                │
     │   1. Request   │                │                │
     │───────────────►│                │                │
     │                │  2. Privacy    │                │
     │                │  Processing    │                │
     │                │  (ZK, cache,   │                │
     │                │   trackers)    │                │
     │                │───────────────►│                │
     │                │                │  3. Onion      │
     │                │                │     Routing    │
     │                │                │  (Anyone Net)  │
     │                │                │───────────────►│
     │                │                │                │
     │                │                │  4. Response   │
     │                │                │◄───────────────│
     │                │  5. Process    │                │
     │                │◄───────────────│                │
     │   6. Display   │                │                │
     │◄───────────────│                │                │

Note: NONOS Daemon handles privacy services (ZK identity, cache mixing, tracker blocking). Traffic routing is handled by Anyone Network.

---

Node Reward Flow

┌──────────────────────────────────────────────────────────────────┐
│                        REWARD CYCLE                              │
└──────────────────────────────────────────────────────────────────┘

┌─────────┐         ┌─────────────┐         ┌─────────────────────┐
│  Node   │────────►│   Metrics   │────────►│   Quality Score     │
│ Service │         │  Collector  │         │   Calculation       │
└─────────┘         └─────────────┘         └──────────┬──────────┘
                                                       │
                                                       ▼
┌─────────────────────────────────────────────────────────────────┐
│                         EPOCH END                               │
│                                                                 │
│   Quality Score = (Uptime × 0.30) + (Success × 0.35) +          │
│                   (Latency × 0.20) + (Reliability × 0.15)       │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                      REWARD CALCULATION                         │
│                                                                 │
│   Reward = EpochEmission × (√Stake / TotalWeight) ×             │
│            QualityScore × TierMultiplier × StreakBonus          │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────┐         ┌─────────────┐         ┌─────────────────────┐
│ Pending │────────►│    Claim    │────────►│   NOX Tokens in     │
│ Rewards │         │ Transaction │         │   User Wallet       │
└─────────┘         └─────────────┘         └─────────────────────┘

---

Node Types

Full Node (Recommended)

Participates in all network functions:

┌─────────────────────────────────────────────────────────────────┐
│                         FULL NODE                               │
│                                                                 │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐  │
│  │   Privacy   │  │   Network   │  │      Staking &          │  │
│  │  Services   │  │   Comms     │  │       Rewards           │  │
│  │             │  │             │  │                         │  │
│  │ • ZK ID     │  │ • DHT       │  │ • Stake NOX             │  │
│  │ • Mixer     │  │ • Gossip    │  │ • Earn Rewards          │  │
│  │ • Blocker   │  │ • Beacons   │  │ • Report Metrics        │  │
│  └─────────────┘  └─────────────┘  └─────────────────────────┘  │
│                                                                 │
│  Hardware: 4+ vCPU, 8GB+ RAM, 100GB+ SSD, 1Gbps+                │
│                                                                 │
│  Note: NONOS nodes do NOT route traffic. Traffic routing is     │
│        handled by Anyone Network (separate project).            │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

---

Light Node

Browser-only, uses network services:

┌─────────────────────────────────────────────────────────────────┐
│                        LIGHT NODE                               │
│                                                                 │
│  ┌─────────────────────────────────────────────────────────────┐│
│  │                    NOXONE BROWSER                           ││
│  │                                                             ││
│  │  • Connects to Full Nodes for services                      ││
│  │  • No staking required                                      ││
│  │  • Privacy through network, not operation                   ││
│  └─────────────────────────────────────────────────────────────┘│
│                                                                 │
│  Hardware: Any modern computer/phone                            │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

---

Security Model

Trust Boundaries

┌─────────────────────────────────────────────────────────────────┐
│                      TRUST MODEL                                │
│                                                                 │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │                    TRUSTED                                │  │
│  │  • Your device                                            │  │
│  │  • Your keys (never leave device)                         │  │
│  │  • Open source code (auditable)                           │  │
│  └───────────────────────────────────────────────────────────┘  │
│                                                                 │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │                   TRUSTLESS                               │  │
│  │  • Individual nodes (cryptographic verification)          │  │
│  │  • ZK identity (proves membership without revealing ID)   │  │
│  │  • Rewards (smart contract enforced)                      │  │
│  └───────────────────────────────────────────────────────────┘  │
│                                                                 │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │                    ASSUMED                                │  │
│  │  • Ethereum consensus                                     │  │
│  │  • Cryptographic primitives                               │  │
│  │  • Majority of nodes honest                               │  │
│  └───────────────────────────────────────────────────────────┘  │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

---

Cryptographic Guarantees

Guarantee	Mechanism	Property
Confidentiality	Noise encryption	Traffic unreadable to observers
Integrity	BLAKE3 hashing	Data tampering detected
Authentication	Ed25519 signatures	Node identity verified
Anonymity	ZK proofs	Prove without revealing
Non-linkability	Stealth addresses	Payments unlinkable

---

Integration Points

Browser ↔ Daemon

Local HTTP API on localhost:8420:

GET  /api/status          - Node status
GET  /api/metrics         - Performance metrics
GET  /api/privacy/stats   - Privacy service stats
POST /api/staking/stake   - Stake tokens
POST /api/rewards/claim   - Claim rewards

---

Daemon ↔ Network

GossipSub topics:

nonos/health        - Node liveness beacons
nonos/quality       - Quality metric reports
nonos/peers         - Peer discovery
nonos/announcements - New node registration

---

Daemon ↔ Ethereum

Smart contract calls via ethers-rs:

// Read operations
get_stake(address)
get_pending_rewards(address)
get_tier(address)

// Write operations
stake(amount)
unstake(amount)
claim_rewards()
set_tier(tier)

---

Summary

Layer	Purpose	Technology
Application	User interface	Tauri + Svelte
Service	Privacy features	Rust + ZK proofs
Network	Decentralized mesh	libp2p
Settlement	Economic layer	Ethereum

---

Next: Learn about the Privacy Model or dive into Technical Architecture.