A performant, compliant, and extensible BPv7 DTN solution for the Cloud.
Hardy is a modular implementation of the Bundle Protocol Version 7 (BPv7) as defined in RFC 9171, designed for Delay-Tolerant Networking (DTN) applications. Written in reliable, accessible, asynchronous Rust, many components are rigorously tested using fuzzing to ensure robustness and security.
- Full RFC 9171 BPv7 bundle protocol support
- BPSec (RFC 9172/9173) for bundle security with HMAC-SHA and AES-GCM
- Multiple convergence layer options (TCPCLv4, file-based)
- Pluggable storage backends (SQLite, local filesystem)
- gRPC API for application integration
- OpenTelemetry integration for observability
no_stdcompatible core libraries for embedded use
| Crate | Description |
|---|---|
hardy-bpv7 |
RFC 9171 BPv7 implementation with bundle creation, parsing, and manipulation. Includes BPSec support for integrity (BIB) and confidentiality (BCB) blocks. no_std compatible. |
hardy-bpa |
Complete Bundle Processing Agent library implementing DTN routing, dispatching, RIB management, and CLA interfaces. |
hardy-cbor |
RFC 8949 compliant Canonical CBOR encoder/decoder with streaming API. no_std compatible. |
hardy-eid-patterns |
EID pattern parsing and matching for IPN and DTN URI schemes with glob support. |
hardy-async |
Runtime-agnostic async primitives including TaskPool, BoundedTaskPool, and cancellation tokens. |
hardy-proto |
Protobuf v3 and gRPC API definitions for BPA-to-application and BPA-to-CLA communication. |
hardy-otel |
OpenTelemetry integration for distributed tracing, metrics, and structured logging. |
| Crate | Description |
|---|---|
hardy-sqlite-storage |
SQLite-based metadata storage engine with automatic schema migration. |
hardy-localdisk-storage |
Filesystem-based bundle storage with optional memory-mapped I/O support. |
| Crate | Description |
|---|---|
hardy-tcpclv4 |
RFC 9174 TCPCLv4 implementation with TLS support, session management, and configurable parameters. |
hardy-file-cla |
Simple file-system-based CLA for bundle exchange via watched directories. |
| Crate | Description |
|---|---|
hardy-bpa-server |
Modular BPv7 Bundle Processing Agent server with gRPC API, multiple storage backends, and static routing. |
hardy-tcpclv4-server |
Standalone TCPCLv4 listener and session handler. |
hardy-bpv7-tools |
CLI (bundle) for bundle operations: create, inspect, validate, sign, encrypt, and more. |
hardy-cbor-tools |
CLI (cbor) for CBOR inspection and conversion between binary, CDN, and JSON formats. |
hardy-tools |
General DTN utilities including the bp command for bundle processing. |
- Rust 2024 edition (1.85+)
- Cargo
# Build all packages
cargo build --release
# Build the BPA server with default features
cargo build --release -p hardy-bpa-server
# Run tests
cargo test# Run with a configuration file
./target/release/hardy-bpa-server -c config.toml
# See available options
./target/release/hardy-bpa-server --helpSee the bpa-server README for detailed configuration options.
# Inspect a bundle
bundle inspect bundle.cbor
# Create a new bundle
bundle create --source dtn://node1/ --destination dtn://node2/ --payload "Hello DTN"
# Inspect CBOR data
cbor inspect data.cborSee the bpv7-tools README and cbor-tools README for comprehensive usage guides.
We welcome contributions to the Hardy project! If you would like to contribute, please follow these guidelines:
- Fork the repository and create a new branch for your contribution.
- Make your changes and ensure that the code follows the project's coding style and conventions.
- Write tests to cover your changes and ensure that all existing tests pass.
- Submit a pull request with a clear description of your changes and the problem they solve.
Before contributing, please familiarize yourself with the project's Test Strategy to understand our approach to quality and verification.
By contributing to Hardy, you agree to license your contributions under the project's license.
Hardy is licensed under the Apache 2.0 License.