QuackNet
Crowdsourced Global Network Intelligence DePIN
A decentralized physical infrastructure network that pays users to scan WiFi, cellular, and IoT networks globally. Built the full stack: Flutter mobile app, Go backend, Solana smart contracts, Mapbox War Room, 932K+ tower database.
System Architecture
┌─────────────────────────────────────────────────────────────────────┐
│ iPhone / Android │
│ Flutter 3.x App (Riverpod) │
│ │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ 5 Parallel Collectors: │ │
│ │ • GPS (location + accuracy + heading + speed) │ │
│ │ • WiFi (SSID/BSSID + RSSI + channel + standard) │ │
│ │ • Cellular (cell ID + PCI + TAC + EARFCN + 5G NSA/SA) │ │
│ │ • IP (public IP + ISP + ASN) │ │
│ │ • BLE (device type + RSSI + manufacturer data) │ │
│ └─────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────┘
│
POST /v1/scans
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ Go API (Gin 1.24) — Cloud Run │
│ │
│ ├─ JWT Auth (Firebase ID token verification) │
│ ├─ Rate Limiting (token bucket per-IP + per-user) │
│ ├─ Fraud Detection (velocity, frequency, plausibility, signal) │
│ ├─ Quality Scoring (5 data types × 20 pts = max 100) │
│ ├─ Scarcity Multiplier (H3 res-9 hex, 5 tiers: 5x→1x) │
│ └─ Kafka Async Publish (netintel.scan.events) │
└─────────────────────────────────────────────────────────────────────┘
│ │ │
▼ ▼ ▼
┌────────────┐ ┌───────────┐ ┌──────────────────┐
│ PostgreSQL │ │ Kafka │ │ Solana On-Chain │
│ (OLTP) │ │ KRaft │ │ • NTI Token │
│ │ │ │ │ • Rewards Prog │
│ • Users │ │ 6 Topics │ │ • Staking Prog │
│ • Scans │ │ ────── │ │ • Treasury │
│ • Towers │ │ ────── │ │ • Vesting │
│ • Devices │ │ Partition │ └──────────────────┘
│ • Sits │ │ by (UUID) │
│ • Challen │ └───────────┘
│ • Badges │ │
└────────────┘ ▼
│ ┌──────────────────────────┐
│ │ Kafka Consumer (Go ETL) │
│ │ • Deserialize scan JSON │
│ │ • Enrich + Transform │
│ │ • Batch insert (COPY) │
│ └──────────────────────────┘
│ │
│ ▼
│ ┌─────────────────────────┐
│ │ ClickHouse (OLAP) │
│ │ MergeTree + Views │
│ │ │
│ │ • scan_events table │
│ │ • coverage_by_hex │
│ │ • network_stats_carrier │
│ │ • scanner_metrics_user │
│ └─────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ War Room Analytics Dashboard │
│ │
│ • Mapbox GL Maps (3D buildings, terrain, fog layer, custom style) │
│ • H3 Hexgrid Overlay (res 5-9, scarcity zones, color-coded) │
│ • Tower Markers (932K+ with clustering, carrier colored) │
│ • BLE Heatmap (density per hex, 12 manufacturer categories) │
│ • Real-time WebSocket Live Feed (expanding gold ripple rings) │
│ • Challenges System (H3 res-5, geo-indexed, leaderboards) │
│ • Analytics APIs (coverage, networks, timeline, leaderboard) │
└─────────────────────────────────────────────────────────────────────┘
Key Intelligence Engines
Tower Inference: Weighted centroid + trilateration from crowdsourced RSSI data. BLE Positioning: Device classification (12 categories), RSSI→distance estimation, proximity zones. Security Analysis: 9-check vulnerability engine (default credentials, open admin ports, DNS hijacking, WPA audit, UPnP exposure, etc.).
Technology Stack
Flutter 3.x with Riverpod state management, platform channels for native iOS APIs.
Go 1.24 with Gin framework, JWT auth, rate limiting, WebSocket hub.
Kafka 3.8.1 KRaft mode, 6-partition async topic.
ClickHouse 24.3 with materialized views, H3 geo functions.
PostgreSQL 16 with pgx/v5, JSONB, GIN indexes, UUID PKs.
Solana Anchor 0.30.1, SPL Token-2022, 5 on-chain programs.
Uber H3 res 5-9, Mapbox GL v2.20 custom styles, MVT tiles.
GCP Cloud Run, Secret Manager, Artifact Registry.
Firebase Auth, JWT HS256, Sentry crash reporting.
Core Features
5 Parallel Data Collectors
GPS, WiFi, Cellular (5G/LTE), IP, BLE — all captured simultaneously with extended metadata.
War Room Map
Custom Mapbox style with 3D buildings, terrain, H3 hex scarcity zones, 932K+ tower markers, BLE heatmap, real-time pulse.
Tower Inference Engine
Weighted centroid + trilateration from crowdsourced RSSI. Infers cell tower locations without direct iOS CellID access.
BLE Positioning
Device classification (12 categories: AirTag, FastPair, SmartTag, etc.), RSSI→distance, proximity zones, density heatmap.
Real-Time WebSocket
Live feed hub pattern with exponential backoff reconnect. Watch other users' scans appear as golden ripple animations.
Network Security Analyzer
9-check vulnerability engine: default credentials, open admin ports, DNS hijacking, WPA audit, UPnP exposure, and more.
Challenge System
H3 res-5 geo-indexed community challenges with auto-progress tracking, leaderboards, and reward multipliers.
Gamification
15 achievements, agent tier progression (Bronze→Silver→Gold→Diamond→Legendary), zone contribution tracking, referral codes.
Solana Integration
SPL Token-2022 NTI rewards, on-chain transaction signing, wallet linking, staking program, vesting cliff.
Last-Mile Boost
Speed test (download/upload Mbps), latency + jitter, packet loss %, traceroute hops, IXP pings, backbone fiber detection.
Shareable Scan Cards
RepaintBoundary → PNG renders. Share your best scans ("My Diamond in Paris") with friends via system share sheet.
Push Alert System
FCM geo-targeted low-density zone alerts (H3 GridDisk), spam prevention (1 notification/24h), admin-triggered.
Reward System
Users earn NTI tokens based on scan quality and geographic scarcity. Higher-quality data in virgin zones yields maximum rewards.
Quality Score: 20 points per data type (GPS, WiFi, Cellular, IP, BLE) = max 100 pts
Scarcity Multiplier: Based on scan count in same H3 res-9 hex (last 24h)
Max 500 NTI
Max 300 NTI
Max 200 NTI
Max 150 NTI
Max 100 NTI
Fraud Detection Engine
4-check velocity, frequency, plausibility, signal analysis. Scores ≥70 → rejected, ≥40 → halved reward. Prevents bot farming and location spoofing.
Development
Major Milestones
- • Phase 1: Flutter app + Go API + Kafka → ClickHouse pipeline
- • Phase 2: Tower inference engine, BLE positioning, Mapbox War Room
- • Phase 3: Real-time WebSocket, challenges, achievements, push alerts, Solana integration
- • Phase 4: Premium tier, App Store launch, Android, Enterprise API billing
Ready to Explore?
Check out the full architecture documentation, API spec, or dive into the codebase.