System Architecture

BLACKBOX is a self-contained command node. The browser app is the cockpit; underneath it, four independent subsystems run locally — mesh radio, on-device AI, Web3 keys, and the robotics function layer. None require a central server. The optional internet link is only used to settle queued transactions and refresh map tiles.

Dashed = intermittent / optional connectivity. Solid = always-available local path. Every settlement leaving Web3 Keys for a chain first passes the Quantum-Secure gate (§ below), and third-party ERC-20 issuers attach via the StateMesh overlay. Each numbered feature below has its own flowchart.

Feature index

Operations: 1 Mesh Network · 2 Local AI Assistant · 2b Local AI Chat & Model Library · 3 FunctionGemma Robotics · 4 Device-to-Device Mesh · 4b D2D File & Voice + Radar · 5 Tactical Map · 5b Mesh Chat. Value: 6 Web3 Wallet · 6b Mesh Payment Hub · 6c Quantum-Secure Settlement · 7 Offline Airdrop / NWO UBI · 8 BlackBox Market · 9 StateMesh hub. Survival & Field: 10 Survival Manual · 11 Repair & Knowledge · 12 Sensors & Devices · 12b Universal Remote · 12c RFID / NFC · 13 Boot / Recovery · 19 Health Diagnostics. Tools & Library: 14 Field Notes · 15 Data Tools · 15b Calculator · 16 Knowledge Library · 18 Transmissions (radio · weather · cached data). System: 17 NWO R&D · 20 Edge Upgrades. Mission Control also carries 1b local field controls (lamp/SOS · camera · alarm). An Instruction Manual page gives step-by-step how-to for every feature.

1 · Mesh Network

Meshtastic over LoRa gives multi-kilometre, license-free, battery-sippy links with no cell tower or WiFi. Each node relays for the others, so coverage grows as you add radios. BLACKBOX reads telemetry (signal, SNR, battery, hop count) and renders the topology live.

// node telemetry shape consumed by the dashboard
{ id:"n1", name:"Alpha-1", lat:58.13, lng:8.00,
  signal:-45, snr:9.5, battery:85, hops:1,
  status:"online", lastSeen:"12s" }

2 · Local AI Assistant

A quantized LLM (llama.cpp, or FunctionGemma for tool-calling) runs on the device. It answers tactical questions from cached telemetry, so it keeps working with the antenna unplugged. Prompts never leave the node.

2b · Local AI Chat & Model Library

A conversational assistant that talks to a local Ollama server (default localhost:11434) with on-device RAG over uploaded documents — no API keys, nothing leaves the device. The Model Library lists 13 phone-sized models (Qwen 3, Gemma 3, Llama 3.2/3.1, Phi-3/4, SmolLM2, Mistral) with official HuggingFace links; a robot-mind agent skips the library and registers its own model as the endpoint.

Solid = on-device, offline. Dashed = one-time model download (online); inference afterwards is fully offline.

3 · FunctionGemma · Robotics

Natural-language commands are parsed on-device into typed function calls against the offline-capable subset of the NWO Robotics API (drawn from the agent skill file): edge inference, robot control & state, the ROS2 bridge for physical robots, embodiment/calibration, tactile, and safety/E-stop — every call here runs on the operator's own device or LAN with no cloud and no Render auth. Cloud-only endpoints (billing, on-chain tier upgrades, dataset hub, GPU fine-tune, discovery registry) are excluded by design. Output routes to robots through a self-hosted API, the ROS2 bridge, a local MQTT broker, or the LiteRT C++ runtime on a Jetson/Pi. Safety-critical calls require confirmation.

// parsed intent → offline NWO Robotics endpoint
{ "name":"robot_command",
  "endpoint":"POST /api-robotics?action=execute",
  "offline":true,
  "arguments":{ "robot_id":"go2_001",
    "instruction":"move forward", "distance_m":2 } }

Repo: github.com/RedCiprianPater/functiongemma-integration · benchmarks reach ~3200 tok/s GPU prefill on iPhone 15 Pro.

4 · Device-to-Device Mesh

Phones extend the mesh without infrastructure. The web app pairs two devices over WebRTC on a shared hotspot; the native build adds BLE, WiFi-Direct, and Apple Multipeer so messages and signed airdrops hop phone-to-phone even with all radios down.

4b · D2D File Transfer, Walkie-Talkie & Radar

Over the paired channel an agent can send files (text/PDF/DOC/image/audio, chunked at 16 KB with backpressure, 40 MB cap) and use push-to-talk voice (record → channel → auto-play, with the few-seconds delay this implies off-grid). A thin-line radar plots in-range peers at approximate distance; tapping a blip focuses the talk/file controls.

5 · Tactical Map (TAK / CoT)

Cursor-on-Target objects (friendly / neutral / hostile) plotted on Leaflet over OpenStreetMap. Tiles cache for offline use; if tiles are unavailable a vector grid map renders instead, so positions are never lost.

// CoT object — shareable across the mesh
{ type:"friendly", lat:58.131, lng:8.004,
  label:"Team Alpha", how:"m-g", time:"2026-..." }

5b · Mesh Chat

Text relayed hop-by-hop over LoRa, encrypted and internet-free. Slash commands run in-chat and reply inline as SYSTEM messages — /help /summary /nodes /battery /weather /wallet /scan /clear (case-insensitive). Address the local AI with @bot. All inbound mesh text is treated as data, not commands (prompt-injection defence).

6 · Web3 Wallet

MetaMask handles Base/Ethereum signatures; Cashu/Lightning carries sats for instant off-grid payments. The wallet reads real on-chain balances (ETH via eth_getBalance, STATE via ERC-20 balanceOf on mainnet) and reacts to account/chain changes. Keys never leave the device.

6b · Mesh Payment Hub

Send STATE, ETH or BTC to anyone on the mesh — a paired peer in range or any address relayed until a node finds a link. Shows nearby active users (one-tap Pay), recent recipients (fast repeat), and a persistent ledger; each transfer exposes its path and whether it has reached the chain.

6c · Quantum-Secure Settlement gate

Every mesh→on-chain settlement passes a gate that applies the strongest available scheme and reports which one actually ran — CRYSTALS-Dilithium only if a real PQC library is present, else Ed25519, else ECDSA P-256, else a SHA-256 commitment. For EVM the chain settles via native ECDSA and the post-quantum attestation is detached and anchorable; for BTC the attestation is off-chain only (Bitcoin L1 cannot verify it). If the gate can't run, it falls back to a plain tx and says so.

// settlement envelope produced by the gate
{ asset:"STATE", scheme:"Ed25519", quantumActive:false,
  attestation:{ commit:"0x…", sig:"0x…", pq:false },
  verification:{ ok:true, mode:"simulated" },
  onchainVerifiable:true, anchor:"keccak-anchor:…" }

7 · Offline Airdrop Engine

The differentiator for off-grid value distribution: an operator with no connectivity can still sign a gasless EIP-2612 / EIP-712 claim, store it locally, and let it ride the mesh to whichever node has a link — that node broadcasts it on-chain. This is how $STATE UBI keeps flowing during a blackout.

// signed claim queued for mesh broadcast
{ campaign:"$STATE UBI", amount:1000,
  to:"0x…", chainId:8453,
  signature:"0x…", status:"queued-offline",
  ts:1750000000 }

8 · BlackBox Market

List goods, digital files or services; get paid in BTC, ETH or NWO STATE — online or fully offline. Listings persist locally and broadcast as mesh promos with a geolocation ping plotted on the tactical map; buyers pay by scanning a QR from a nearby device. Fulfilment is pickup / delivery / remote (digital) / pickup-or-delivery.

9 · StateMesh

The configuration hub for the hybrid blockchain×LM mesh (see the StateMesh Whitepaper in NWO R&D). Any Ethereum developer attaches their own ERC-20; transfers route over the mesh under a detached post-quantum attestation and settle on Ethereum. Node operators manage radios and share models; each connected token gets a dashboard with mesh transaction history, the nodes that relayed each transfer, and quick send/receive.

// StateMesh settlement envelope
Σ = ( tx_native , α , ρ )
α = { scheme, c=keccak256(payload), σ_pq, ν_t }
ρ = [ node1, node2, … ]   // relay path, merkle-rooted on-chain

10 · Survival Manual

A fully offline field reference embedded as JS constants — 30 topics covering priorities & mindset, survival kit, water, fire, shelter, first aid, signaling, food, edible & poisonous plants, hunting & trapping, fish & fishing, navigation, knots & ropework, hygiene & sanitation, medicine & illness, clothing & warmth, weather, food preservation, power & light, security, morale, terrain-specific survival (polar, desert, tropical, mountain, sea), urban disasters, travel planning, rations and fitness. Searchable with no connectivity, on any device or bootable USB. Source inspiration: SAS Survival Handbook (2009) by John 'Lofty' Wiseman — content here is summarised and reworded.

11 · Repair & Knowledge

Electrical and mechanical troubleshooting plus the vital functions a community must keep running — 7 topics: no power, soldering, mechanical, radio / comms, water systems, power grid, sanitation & medical. An offline assistant, instruction set, and test reference, embedded as JS constants.

12 · Sensors & Devices

Reads every sensor the device exposes — geolocation (with speed/heading/altitude), battery, network, motion/orientation, and on capable phones the Generic Sensor API: gyroscope, accelerometer, magnetometer (with compass heading) and ambient light. Connects peripherals over Web Serial / WebUSB / WebHID / Web Bluetooth, recognizes them via a vendor/class database (Arduino, ESP32, FTDI, PN532, Flipper, ACR122U…), and re-attaches already-authorized devices automatically on load (plug-and-play). Each accepted device registers back on Mission Control.

12b · Universal Remote

A full button panel (power, inputs, numeric, transport, volume/channel, navigation) for TVs and A/V receivers by brand. Browsers have no native IR, so the panel drives a connected IR blaster (USB/serial/BLE — e.g. a Flipper or IRtoy) or a networked TV API; without a blaster it emits the code to the feed so an attached bridge can transmit it.

12c · RFID / NFC

Reads tags via Web NFC (NDEF, on Android Chrome) or a connected USB/serial reader (PN532, ACR122U, Proxmark); shows UID + records, and writes NDEF text/URLs. Protocol selectable (ISO14443-A/MIFARE, ISO15693, NFC-F, EM4100, NDEF).

13 · Boot / Recovery

Carry BLACKBOX on a bootable USB so it survives a dead OS, plus a guided recovery console for machines that will not start. The builder writes Ubuntu + this app to a USB that auto-launches as a Chromium kiosk; envCheck() runs a structured self-check. The terminal shows copy-paste recovery commands (Linux/macOS/Windows) — reference only, not remote execution.

14 · Field Notes

Markdown notes that never leave the device — stored locally with live preview and export-all to USB. Mission logs, observations, coordinates, recipes. Works fully offline.

15 · Data Tools

Encoding, hashing and transforms — 17 operations: Base64 encode/decode, to/from hex, URL encode/decode, ROT13, reverse, UPPERCASE, lowercase, JSON pretty/minify, to binary, SHA-1/256/512, text stats. Every operation runs client-side; nothing is uploaded.

16 · Knowledge Library

Embeds a local kiwix-serve so an agent can browse .zim archives offline: full Wikipedia (with images), Medicine (WikiMed/WikiProjectMed), Wiktionary, iFixit, survival & prepping libraries, Project Gutenberg. A single file cannot bundle terabytes, so BLACKBOX embeds the local server inline and points to the archive downloads.

17 · NWO R&D

An in-app PDF reader hosting the two research papers behind the system: Paper I (the two-path mesh substrate) and Paper II (the StateMesh Whitepaper, published on ResearchGate). The theory ships with the tool.

15b · Calculator

A multi-function calculator inside Data Tools: standard, scientific (trig, log, powers, roots, factorial), and programmer (hex/dec/bin, bitwise) modes, an expression evaluator (mathjs with a safe parser fallback — no eval), a unit converter (length, mass, temperature, data, speed) and a history. All client-side.

18 · Transmissions

A radio receiver and media player, a weather station, and a cached-data board in one view. The tuner drives a connected SDR/receiver (RTL-SDR over Web Serial/USB) across FM, AM, NOAA weather (162.400–162.550 MHz) and emergency/service frequencies (air 121.5, marine 16, GMRS/PMR446); the local player plays audio files fully offline. The weather station fetches a keyless forecast online and caches it for offline, alongside device barometer/light/heading. The cached data sources board (quakes, space weather/Kp, ISS, BTC/ETH) stays readable offline with a last-updated timestamp and refreshes when reconnected.

1b · Mission Control — local field controls

The Local widget carries compact field tools that drive real device hardware. A lamp button toggles the camera torch via the MediaStreamTrack torch capability (falling back to a full-screen white "monitor light" when no torch exists), with an SOS button that flashes it in morse. A camera button opens a modal with live preview, photo capture and local video recording (MediaRecorder → downloadable file, nothing uploaded), selectable across phone or USB cameras. An alarm button beside Locate sounds a WebAudio siren through the speaker. Each is honest about hardware: no torch → screen lamp; no camera → states it.

19 · Health Diagnostics

A categorised health surface in seven tabs. Live Sensors groups metrics by aspect (cardiac, respiratory/oxygen, metabolic, temperature, body/activity, neuro/BCI) and streams from Bluetooth health profiles (heart rate, thermometer, glucose, SpO₂, blood pressure, weight). Clinical Connectivity lists avenues for ECG (incl. nwocardiac.cloud), BCI/EEG, point-of-care labs, microscope/ultrasound/X-ray (DICOM bridge) and therapeutic pumps over Web Serial/USB/BLE. Reference tabs cover a Medicine Index (class, shape, dose, side-effects), Illnesses (symptoms + treatment), Supplements/herbals/vitamins, and Equipment how-to. A field-note-style Supply Inventory tracks medical stock locally with expiry flags and export. All content is informational, with the same medical disclaimer the rest of the app uses.

20 · Edge Upgrades

A single page (view-edge) wires ten upgrades to existing surfaces — each panel runs what the browser can do natively now, and exposes a clearly-labelled hook for an optional library that lives next to index.html: Whisper.cpp WASM for full-offline transcription, Transformers.js + ONNX for semantic-search embeddings, an RTL-SDR demod module for WebUSB radio capture, liboqs-js for CRYSTALS-Dilithium signing, and Automerge/RxDB for true CRDT sync. The Edge page also registers an inline Service Worker (PWA self-launch), copies the single-file app to a peer over D2D, exports/imports last-write-wins sync patches, and seals BLE biometric reads with the WebCrypto gate. Honest by construction — each output reports the scheme that actually ran.

Endpoint Coverage

BLACKBOX is wired to the local subsystems only — there is no hard dependency on nwo.capital. The FunctionGemma layer mirrors 45+ NWO Robotics endpoints, exposed through MQTT/ROS2 so robots respond even when the cloud API is unreachable.

Credits — based on Blackbox Node by wadadawadada (offline-first command post). Extended for the NWO ecosystem: φ branding, Web3, FunctionGemma robotics, D2D mesh and the offline airdrop engine.