1. Canonical Schemas & Protocols (fleetmesh_schema)
The schema repository defines the canonical, machine-readable specifications that govern the entire Fleetmesh network. It acts as the single authoritative source of truth across all implementations—including the Python reference (fleetmesh_core and meshnode), the Rust control CLI (meshctl), the relay bridge (fleetmesh-strfry), and external ecosystem integrations.
1.1. Design Principles
Protocol Immutability & Verifiability: Core protocol constants, event kind registries, and message formats are cryptographically hashed into an authoritative protocol digest (
schema/DIGEST). Two nodes must agree on this digest to establish higher peering tiers.Draft 2020-12 Formal Schemas: Every Nostr event kind, DIDComm message envelope, decrypted payload, and manifest resource is formally defined using standard JSON Schema Draft 2020-12 specifications under
schemas/.Declarative Kubernetes-Style Manifests: Infrastructure resources (nodes, peerings, grant policies, compute providers) use the Kubernetes CRD conventions (
apiVersion: fleetmesh.org/v1alpha1).Zero-Overhead Python Access: The fleetmesh_schema Python package provides lightweight, cached access to all schema definitions with zero runtime dependencies.
1.2. Repository Structure
Directory / File |
Description |
|---|---|
|
Normative cryptographic primitives, window timeframes, rate ceilings, and pricing ladders. |
|
Formal definitions and tagging rules for all Fleetmesh Nostr event kinds (11801–31803). |
|
Wire message envelope definitions for all DIDComm protocol families. |
|
The SHA-256 hash over canonical representations of constants, kinds, and messages. |
|
Supported protocol capability URIs ( |
|
Catalogue of conformance operations and test vectors used by |
|
Directory tree of JSON Schema Draft 2020-12 documents organized by plane. |
|
Declarative CRD manifests ( |
|
Installable Python package exposing cached loaders and path helpers. |
1.3. Validation Suite
To validate all manifests and schemas against their Draft 2020-12 meta-schemas:
python3 schema/scripts/check-manifests.py
python3 schema/scripts/validate-schemas.py
1.4. Specifications Reference
Specification |
Description |
|---|---|
Canonical Nostr event kinds registry (11801–31803), required and optional tags, and semantics. |
|
Wire message catalog and DIDComm protocol families (peering, budget, transport, compute, sync, blossom). |
|
Declarative Kubernetes-style CRD manifests (MeshNode, Peering, GrantPolicy, ComputeProvider, Routers). |
|
The protocol digest verification system (schema/DIGEST), cryptographic hashing, and drift defense. |
|
Formal JSON Schema Draft 2020-12 specifications directory structure and validation workflows. |
|
Python fleetmesh_schema module documentation (path, schema_path, load_json, text, digest). |