Fleetmesh Documentation
Fleetmesh is a zero-trust peer-to-peer mesh built on Nostr. Every node has its own keys and a signed descriptor, talks to the world through Nostr relays, answers to an operator key, and carries end-to-end encrypted mail for the nodes and browser leaves it mediates.
These are the docs for 0.5.0-dev.0. Some of what the reference pages describe - other transports such as Iroh and FIPS, compute, the bridges - is in the code but experimental: off unless a config switches it on, and not supported in the alpha. Experimental features lists it all, and each page about one of them says so at the top.
New here? Get started installs the tools and walks through your first fleet and a browser leaf app, each in a few minutes on one machine.
System Architecture
The Fleetmesh ecosystem comprises a suite of interoperable software offerings, libraries, and canonical schema definitions:
Software / Package |
Description |
|---|---|
The normative, cross-platform reference library providing cryptographic primitives, DID/identity handling, wire encoding, accounting, capacity pricing, and conformance vectors. |
|
The high-performance host daemon implementing the 6 architectural planes, 29 decoupled compartments, transport ladder (WebSocket; Iroh QUIC and FIPS experimental), and pluggable sidecars. |
|
Declarative fleet management CLI written in Rust. Provides non-destructive hot-reconciliation ( |
|
High-throughput relay bridge interfacing nodes with the C++/LMDB strfry Nostr relay. Supports in-process compartment operation, write-policy filtering, bilateral grant enforcement, and bulk JSONL data piping. |
|
Canonical machine-readable schemas, event kind registries (11801–31803), DIDComm wire definitions, Kubernetes-style CRD manifests, JSON Schema Draft 2020-12 specifications, and the authoritative protocol digest. |
|
Detailed design whitepapers covering compartment boundaries, economic models, transport fallback mechanisms, storage engines, and pluggable protocols. |
Documentation Contents
Get started
Core Protocol Library
- 1. Fleetmesh Core Library (
fleetmesh_core) - 2. Cryptographic Primitives (
fleetmesh_core.crypto) - 3. Identity & Addressing (
fleetmesh_core.identity) - 4. Peering & Reputation (
fleetmesh_core.peering) - 5. Accounting & Capacity (
fleetmesh_core.accounting) - 6. Storage & Synchronization (
fleetmesh_core.storage) - 7. Services & Lifecycle (
fleetmesh_core.services) - 8. Wire Protocol & Encodings (
fleetmesh_core.wire) - 9. Conformance & Verification (
fleetmesh_core.conformance)
Meshnode Host Daemon
- 1. Meshnode Host Daemon (
node) - 2. Application Host & Subsystems (
fleetmesh_node.app) - 3. The Six Architectural Planes (
fleetmesh_node.planes) - 4. Transport Subsystem (
fleetmesh_node.transport) - 5. Storage Engines & Backends (
fleetmesh_node.storage) - 6. Pluggable Protocol Packages (
fleetmesh_node.protocols)- 6.1. Protocol Lifecycle & Extension Points
- 6.2. Package Registry & Manager
- 6.3. p2panda Protocol Suite (
fleetmesh_node.protocols.p2panda) - 6.4. Rhio Protocol Suite (
fleetmesh_node.protocols.rhio) - 6.5. Nostr Protocol Suite (
fleetmesh_node.protocols.nostr) - 6.6. AT Protocol Suite (
fleetmesh_node.protocols.atproto) - 6.7. ActivityPub Protocol Suite (
fleetmesh_node.protocols.activitypub) - 6.8. Secure Scuttlebutt Suite (
fleetmesh_node.protocols.ssb) - 6.9. Protocol Sidecar Daemons (
sidecar)
- 7. Nostr Protocol Layer (
fleetmesh_node.protocols.nostr) - 8. Command Dispatcher & CLI (
fleetmesh_node.commands) - 9. Compartment Framework (
fleetmesh_node.compartment) - 10. Configuration Engine (
fleetmesh_node.config) - 11. Channels & Metrics (
fleetmesh_node.channels/fleetmesh_node.metrics) - 12. Keystore & Enclave (
fleetmesh_node.keystore) - 13. Node Interfaces (
fleetmesh_node.interfaces) - 14. Daemon CLI & Entrypoint (
fleetmesh_node.meshnode)
meshctl CLI & Orchestration
Strfry Relay Bridge
Canonical Schemas & Protocols
Architecture & Specs
- 1. Architecture & Protocol Specifications
- 1.1. Fleetmesh Architecture Overview
- 1.2. Compartments Architecture
- 1.3. Mechanisms & Architectural Invariants
- 1.4. Implementing a Second Node
- 1.5. Protocol Conformance Catalogue
- 1.6. Protocol Versioning & Wire Digest
- 1.7. Extending the Mesh Node
- 1.8. Updates & Release Verification
- 1.9. Codebase Guide
- 1.10. Pluggable Protocol Architecture & Ecosystem Interoperability
- 1.11. Protocol Interoperability & External Standards
- 1.12. Storage Backends & Engine Design
- 1.13. Sidecars & Pluggable Bridges
- 1.14. Paid Fetch & Cashu Micropayments
- 1.15. Verified Compute Methods & Execution Fabrics
- 1.16. Non-Deterministic Compute & Workload Routing
- 1.17. FIPS Native Transport Architecture
- 1.18. Running Over FIPS
- 1.19. Discovery, libp2p, and FIPS
- 1.20. Record-Then-Answer Accounting
- 1.21. Reversible Apoptosis & Capacity Shedding
- 1.22. Video Streaming & High-Demand Transit Routing