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 is open source and community-owned, focused on bringing Reticulum capabilities to the Rust ecosystem with clear APIs, reproducible behavior, and portable deployment options.

Features

• Cryptographic mesh networking
• Identity-based trust and routing primitives
• Modular architecture for constrained and general-purpose systems
• Multiple transport options (TCP, serial, Kaonic)
• Example clients for testing and integration

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

License

This project is licensed under the MIT license.

Maintained by FreeTAKTeam and contributors.