1. Fleetmesh Core Library (fleetmesh_core)

The fleetmesh_core package implements the normative, transport-independent foundations of the Fleetmesh protocol. It is designed to be lightweight, dependency-minimized, and verifiable across environments.

1.1. Modules Overview

Subsystem

Modules & Responsibilities

Cryptographic Primitives (fleetmesh_core.crypto)

Secp256k1 & Ed25519 signing, Schnorr signatures, ECDH key agreements, NIP-44 ChaCha20-Poly1305 giftwrapping, BN254 Groth16 zk-verification.

Identity & Addressing (fleetmesh_core.identity)

Decentralized Identifiers (DID), DIDComm message envelopes, CID formatting, Iroh ticket decoding, and origin validation.

Peering & Reputation (fleetmesh_core.peering)

Peering manifest management, complaint logging, reputation projection, bad-peer scoring, and network coverage accounting.

Accounting & Capacity (fleetmesh_core.accounting)

Cashu ecash token validation, tier limit enforcement, capacity-based pricing ladders, sliding-window credit metering, and settlement.

Storage & Synchronization (fleetmesh_core.storage)

Negentropy range-based set reconciliation, Blossom authorization events, linked-data DAG traversal, and store abstraction.

Services & Lifecycle (fleetmesh_core.services)

Service lifecycle state machines, telemetry collection, NIP-90 DVM execution manifests, and nsite publishing.

Wire Protocol & Encodings (fleetmesh_core.wire)

Canonical CBOR serialization, JSON Schema validation, frame packaging, and wire protocol version negotiation.

Conformance & Verification (fleetmesh_core.conformance)

Conformance harness, test vectors, and formal operation verification.

1.2. Package Documentation

fleetmesh executable reference implementation.

Standard library only, no I/O, no clock, no network, and every constant read from schema/. Contains reference mechanisms for Nostr event storage, reconciliation, peering, accounting, capacity management, and reporting.