Reticulum-rs

Reticulum-rs is a Rust implementation of the Reticulum Network Stack — a cryptographic, decentralised, and resilient mesh networking protocol designed for communication over any physical layer.

This project brings Reticulum's capabilities to the Rust ecosystem, enabling embedded, and constrained deployments with maximum performance and minimal dependencies.

Features

• 📡 Cryptographic mesh networking
• 🔐 Trustless routing via identity-based keys
• 📁 Lightweight and modular design
• 🧱 Support for multiple transport layers (TCP, serial, Kaonic)
• 🔌 Easily embeddable in embedded devices and tactical radios
• 🧪 Example clients for testnets and real deployments

Structure

Reticulum-rs/
├── src/                 # Core Reticulum protocol implementation
│   ├── buffer.rs
│   ├── crypt.rs
│   ├── destination.rs
│   ├── error.rs
│   ├── hash.rs
│   ├── identity.rs
│   ├── iface.rs
│   ├── lib.rs
│   ├── transport.rs
│   └── packet.rs
├── proto/               # Protocol definitions (e.g. for Kaonic)
│   └── kaonic/
│       └── kaonic.proto
├── examples/            # Example clients and servers
│   ├── kaonic_client.rs
│   ├── link_client.rs
│   ├── tcp_client.rs
│   ├── tcp_server.rs
│   └── testnet_client.rs
├── Cargo.toml           # Crate configuration
├── LICENSE              # License (MIT/Apache)
└── build.rs             

Getting Started

Prerequisites

• Rust (edition 2021+)
• protoc for compiling .proto files (if using gRPC/Kaonic modules)

Build

cargo build --release

Run Examples

# TCP client example
cargo run --example tcp_client

# Kaonic mesh test client
cargo run --example kaonic_client

Use Cases

• 🛰 Tactical radio mesh with Kaonic
• 🕵️‍♂️ Covert communication using serial or sub-GHz transceivers
• 🚁 UAV-to-ground resilient C2 and telemetry
• 🧱 Decentralized infrastructure-free messaging

License

This project is licensed under the MIT license.

© Beechat Network Systems Ltd. All rights reserved. https://beechat.network/