No description
Find a file
2026-01-26 09:09:51 +01:00
examples test: add links to multihop example 2025-10-24 18:05:44 +02:00
proto/kaonic feat: add qpsk modulation support to kaonic iface 2025-10-29 14:04:37 +02:00
src Merge pull request #51 from BeechatNetworkSystemsLtd/path-requests 2026-01-20 11:29:48 +01:00
tests fix: hop_test cases run in parallel by using unique ports in each test 2026-01-17 19:01:39 +01:00
.gitignore chore: update git ignore 2025-06-10 22:31:40 +03:00
build.rs feat: add qpsk modulation support to kaonic iface 2025-10-29 14:04:37 +02:00
Cargo.lock feat: add serde attributes to generated kaonic proto structures 2025-07-03 13:30:14 +03:00
Cargo.toml test: complete test cases for direct and remote path requests 2026-01-17 08:52:08 +01:00
CONTRIBUTING.md docs: add guidelines for contributors 2026-01-26 09:09:51 +01:00
LICENSE Initial commit 2024-07-18 11:11:22 +01:00
README.md Create README.md 2025-06-18 13:06:10 +01:00

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/