How magicred-1/anon0mesh works
Project Type and Purpose
• anon0mesh is a mobile-first, offline peer-to-peer mesh networking app built with React Native (Expo) that uses Bluetooth Low Energy (BLE) to form ad-hoc zones and relay both chat messages and optional Solana blockchain transactions.
• It also includes a Rust-based Solana proxy program (“proxy_transfer_program”) for on-chain transaction handling via Anchor.
High-Level Architecture Layers
a. Presentation Layer (Frontend)
• Expo Router “app/” directory with route files and layout (tabs, landing, onboarding).
• React components under “components/” for screens (ChatScreen, WalletScreen, etc.) and UI widgets (BLEStatusIndicator, MessageList, QrScannerModal).
b. Domain/Business Logic Layer
• MeshNetworkingManager (components/networking) – orchestrates BLE mesh.
• GossipSyncManager (src/gossip) – handles the gossip protocol, bloom filters, deduplication.
• NoiseManager (src/noise) – end-to-end encryption sessions.
• SolanaTransactionManager / BeaconManager (src/solana) – handles Solana transaction building, signing, beacon relay.
• BackgroundMeshManager (src/background) – schedules relay & gossip tasks when app is backgrounded.
c. Infrastructure Layer
• BLE abstraction (src/networking/bluetooth) – BLEFactory, BLECentralServer & BLEPeripheralServer implementations.
• Solana RPC client (src/solana/client) – RPC calls, PDA derivation.
• Proxy program (proxy_transfer_program/)
– Frontend (React, routes, SolanaProvider)
– Anchor on-chain program in Rust (programs/proxy_transfer)
– Dockerfile for containerized dev/test
External Systems
• Physical mobile devices forming a BLE mesh network.
• Solana blockchain (RPC nodes).
• (Optional) Your own proxy_transfer_program container + on-chain Anchor program.
Component Interactions & Data Flows
• User taps Send → UI component (MessageInput) calls MeshNetworkingManager.
• MeshNetworkingManager uses BLEFactory to get a BLE central or peripheral instance → advertising and scanning.
• When peers connect, packets go through GossipSyncManager (propagate, dedupe via bloom filters) and NoiseManager (encrypt/decrypt).
• BackgroundMeshManager schedules periodic tasks (relay every 15s, gossip every 30s) via Expo TaskManager or native module.
• For Solana transactions: UI triggers SolanaTransactionManager → signs via SolanaWalletManager → relays via BeaconManager → optionally sends to proxy_transfer_program front end → on-chain Anchor program executes.
• All state lives in-memory; no external database.
Architectural Patterns & Design Principles
• Layered architecture: clear separation of UI, domain logic, infrastructure.
• Modular managers (MeshNetworkingManager, GossipSyncManager, NoiseManager, SolanaTransactionManager).
• Dependency inversion via factories (BLEFactory).
• Event-driven & task-based background processing.
• Secure by design: Noise protocol, TTL on packets, optional Solana signature.
Essential Elements to Capture
• Expo Router (app/)
• React Screens & UI libs (components/)
• MeshNetworkingManager & its use of BLEFactory
• GossipSyncManager & NoiseManager pipeline
• BackgroundMeshManager tasks
• SolanaTransactionManager & BeaconManager path to Solana RPC
• proxy_transfer_program layers (React front end, Anchor program, on-chain state)
• Physical devices forming the mesh