MeshSky Docs
Architecture
A high-level tour of the MeshSky network — feeders at the edge, AirBridge in the middle, ControlTower at the apex.
MeshSky is built as three cooperating tiers bound together by a single gossip protocol. Every tier is independently operable, and every node is verifiable from cryptographically signed inputs.
The three tiers
1. Feeders
Feeders are the edge of the mesh. A feeder is any device that:
- Listens to one or more aviation radio bands (ADS-B 1090, UAT 978, Mode-S, ACARS, …).
- Time-stamps each reception with a sub-microsecond clock (typically GPS-disciplined).
- Signs the resulting observation record with its long-lived feeder key.
- Streams those records to one or more AirBridge relays.
A feeder can be a $35 Raspberry Pi with an RTL-SDR, an OpenWrt router, or a rack-mounted multi-channel SDR. The protocol is identical.
2. AirBridge
AirBridge is the gossip layer. AirBridge nodes:
- Accept signed observations from many feeders.
- De-duplicate, batch, and fan-out observations to peer relays.
- Maintain a Voronoi-style geographic shard map so most traffic stays regional.
- Speak QUIC to peers and TLS+TCP to feeders that can’t speak QUIC.
A healthy mesh has many AirBridges per region. They peer with each other in a small-world topology so any observation reaches every interested ControlTower in well under 200 ms.
3. ControlTower
ControlTower is the apex. ControlTower nodes:
- Ingest the gossiped observation stream.
- Fuse ADS-B, Mode-S, and MLAT solutions into authoritative tracks.
- Compute MLAT solutions for non-cooperative aircraft.
- Maintain feeder reputation rollups.
- Expose a REST + streaming public API.
Crucially, anyone can run a ControlTower. Outputs are reproducible from the signed observation log, so consumers can verify the network end-to-end.
How it fits together
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ ControlTower│ ←→ │ ControlTower│ ←→ │ ControlTower│
└──────┬──────┘ └──────┬──────┘ └──────┬──────┘
│ │ │
▼ ▼ ▼
┌──────────────────────────────────────────────────┐
│ AirBridge mesh │
│ (regional gossip relays, QUIC peering) │
└─────────────────────┬────────────────────────────┘
│
┌────────────┼────────────┐
▼ ▼ ▼
┌────────┐ ┌────────┐ ┌────────┐
│ Feeder │ │ Feeder │ │ Feeder │
└────────┘ └────────┘ └────────┘
Design principles
- Verifiable, not trusted. Every output is reducible to signed inputs.
- No single point of failure. Lose any tier of any region; the mesh routes around the loss.
- Bandwidth-aware. The protocol negotiates compression and sample rates per peer.
- Open by default. Implementations, the spec, and the data are all public.
- Privacy-respecting. Operators choose what to share, with first-class fuzzing & opt-in identity.