# magicred-1/anon0mesh architecture

> Architecture diagram of the GitHub repository magicred-1/anon0mesh, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/magicred-1/anon0mesh
- Repository: https://github.com/magicred-1/anon0mesh

## Overview

##### 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

## Diagram (Mermaid)

```mermaid
graph TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        ExpoRouter(["Expo Router"]):::presentation
        ReactScreens(["React UI Screens"]):::presentation
        UIWidgets(["UI Widgets"]):::presentation
    end

    %% Domain/Business Logic Layer
    subgraph "Domain/Business Logic Layer"
        MeshNetworkingManager(["MeshNetworkingManager"]):::domain
        GossipSyncManager(["GossipSyncManager"]):::domain
        GCSFilter(["GCSFilter"]):::domain
        PacketIdUtil(["PacketIdUtil"]):::domain
        NoiseManager(["NoiseManager"]):::domain
        NoiseSession(["NoiseSession"]):::domain
        BackgroundMeshManager(["BackgroundMeshManager"]):::domain
        SolanaTransactionManager(["SolanaTransactionManager"]):::domain
        BeaconManager(["BeaconManager"]):::domain
        SolanaWalletManager(["SolanaWalletManager"]):::domain
        SolanaTransactionRelay(["SolanaTransactionRelay"]):::domain
        useSolanaWallet(["useSolanaWallet Hook"]):::domain
        SolanaConstants(["Solana constants"]):::domain
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer"
        subgraph BLEStack
            BLEFactory(["BLEFactory"]):::infra
            BLECentralServer(["BLECentralServer"]):::infra
            BLEPeripheralServer(["BLEPeripheralServer"]):::infra
            BLEPacketEncoder(["BLEPacketEncoder"]):::infra
            BLEUtils(["BLEUtils"]):::infra
            BLEConstants(["BLEConstants"]):::infra
        end
        SolanaRPCClient(["Solana RPC Client"]):::infra
        ProxyProgramContainer(["proxy_transfer_program"]):::infra
        ProxyFrontend(["Proxy Frontend"]):::infra
        ProxySolanaClient(["Proxy Solana Client"]):::infra
        OnChainProgram(["On-chain Anchor Program"]):::infra
    end

    %% External Systems
    subgraph "External Systems"
        MobileDevices(["Mobile Devices (BLE Mesh)"]):::external
        SolanaRPC(["Solana Blockchain RPC"]):::external
    end

    %% Connections
    ExpoRouter --> ReactScreens
    ExpoRouter --> UIWidgets
    ReactScreens --> MeshNetworkingManager
    UIWidgets --> MeshNetworkingManager

    MeshNetworkingManager --> BLEFactory
    BLEFactory --> BLECentralServer
    BLEFactory --> BLEPeripheralServer
    BLECentralServer --> MobileDevices
    BLEPeripheralServer --> MobileDevices

    MobileDevices --> GossipSyncManager
    GossipSyncManager --> GCSFilter
    GossipSyncManager --> PacketIdUtil
    GossipSyncManager --> NoiseManager
    NoiseManager --> NoiseSession
    NoiseManager --> GossipSyncManager

    BackgroundMeshManager --> MeshNetworkingManager

    ReactScreens --> SolanaTransactionManager
    SolanaTransactionManager --> SolanaWalletManager
    SolanaTransactionManager --> SolanaTransactionRelay
    SolanaTransactionManager --> useSolanaWallet
    SolanaTransactionManager --> SolanaConstants

    SolanaWalletManager --> BeaconManager
    BeaconManager --> SolanaRPCClient
    SolanaRPCClient --> SolanaRPC

    BeaconManager --> ProxyFrontend
    ProxyFrontend --> ProxySolanaClient
    ProxySolanaClient --> OnChainProgram
    OnChainProgram --> SolanaRPC

    %% Click Events
    click ExpoRouter "https://github.com/magicred-1/anon0mesh/tree/main/app/"
    click ReactScreens "https://github.com/magicred-1/anon0mesh/tree/main/components/screens/"
    click UIWidgets "https://github.com/magicred-1/anon0mesh/tree/main/components/ui/"
    click MeshNetworkingManager "https://github.com/magicred-1/anon0mesh/blob/main/components/networking/MeshNetworkingManager.tsx"
    click GossipSyncManager "https://github.com/magicred-1/anon0mesh/blob/main/src/gossip/GossipSyncManager.ts"
    click GCSFilter "https://github.com/magicred-1/anon0mesh/blob/main/src/gossip/GCSFilter.ts"
    click PacketIdUtil "https://github.com/magicred-1/anon0mesh/blob/main/src/gossip/PacketIdUtil.ts"
    click NoiseManager "https://github.com/magicred-1/anon0mesh/blob/main/src/noise/NoiseManager.ts"
    click NoiseSession "https://github.com/magicred-1/anon0mesh/blob/main/src/noise/NoiseSession.ts"
    click BackgroundMeshManager "https://github.com/magicred-1/anon0mesh/blob/main/src/background/BackgroundMeshManager.ts"
    click BLEFactory "https://github.com/magicred-1/anon0mesh/blob/main/src/networking/bluetooth/BLEFactory.ts"
    click BLECentralServer "https://github.com/magicred-1/anon0mesh/blob/main/src/networking/bluetooth/BLECentralServer.ts"
    click BLEPeripheralServer "https://github.com/magicred-1/anon0mesh/blob/main/src/networking/bluetooth/BLEPeripheralServer.native.ts"
    click BLEPacketEncoder "https://github.com/magicred-1/anon0mesh/blob/main/src/networking/bluetooth/BLEPacketEncoder.ts"
    click BLEUtils "https://github.com/magicred-1/anon0mesh/blob/main/src/networking/bluetooth/BLEUtils.ts"
    click BLEConstants "https://github.com/magicred-1/anon0mesh/blob/main/src/networking/bluetooth/constants/BLEConstants.ts"
    click SolanaTransactionManager "https://github.com/magicred-1/anon0mesh/blob/main/src/solana/SolanaTransactionManager.ts"
    click BeaconManager "https://github.com/magicred-1/anon0mesh/blob/main/src/solana/BeaconManager.ts"
    click SolanaWalletManager "https://github.com/magicred-1/anon0mesh/blob/main/src/solana/SolanaWalletManager.ts"
    click SolanaTransactionRelay "https://github.com/magicred-1/anon0mesh/blob/main/src/solana/SolanaTransactionRelay.ts"
    click useSolanaWallet "https://github.com/magicred-1/anon0mesh/blob/main/src/solana/useSolanaWallet.ts"
    click SolanaConstants "https://github.com/magicred-1/anon0mesh/blob/main/src/solana/constants.ts"
    click ProxyProgramContainer "https://github.com/magicred-1/anon0mesh/tree/main/proxy_transfer_program/"
    click ProxyFrontend "https://github.com/magicred-1/anon0mesh/tree/main/proxy_transfer_program/app/"
    click ProxySolanaClient "https://github.com/magicred-1/anon0mesh/tree/main/proxy_transfer_program/app/solana/client/"
    click OnChainProgram "https://github.com/magicred-1/anon0mesh/tree/main/proxy_transfer_program/programs/proxy_transfer/src/"

    %% Styles
    classDef presentation fill:#cce5ff,stroke:#0066cc,color:#000;
    classDef domain fill:#d4edda,stroke:#228B22,color:#000;
    classDef infra fill:#fff3cd,stroke:#ff8c00,color:#000;
    classDef external fill:#e2e3e5,stroke:#6c757d,color:#000;
```
