Nostr Event Kinds Registry =========================== Fleetmesh utilizes Nostr (NIP-01) as its decentralized event dissemination and discovery substrate. Every event published or routed by a Fleetmesh node belongs to a standardized kind registered in ``schema/kinds.json``. Event Kind Classifications -------------------------- Nostr defines four distinct event lifecycles: - **Regular (1000–9999)**: Stored permanently; historic events are retained. - **Replaceable (10000–19999)**: Only the latest event per author (``pubkey``) is retained by relays and eventstores. - **Ephemeral (20000–29999)**: Not stored permanently; forwarded in real-time to active subscribers. - **Parameterized Replaceable (30000–39999)**: Only the latest event per ``(pubkey, d)`` coordinate is retained. Registered Fleetmesh Event Kinds -------------------------------- .. list-table:: :widths: 10 25 15 50 :header-rows: 1 * - Kind - Name - Class - Description & Key Tags * - ``11801`` - **Node Descriptor** - Replaceable - Advertises node capabilities (``c``), transport endpoints (``endpoint``), accepted Cashu mints (``mint``), PaidFetch prices (``price``), and sidecar endpoints (``grasp-endpoint``, ``ncontainer-endpoint``, ``magpie-endpoint``). * - ``11802`` - **Node Revocation** - Replaceable - Revokes a compromised or decommissioned node identity. Required tag: ``reason``; optional tag: ``successor``. * - ``11803`` - **Compute Offer** - Replaceable - Advertises verifiable and non-deterministic compute capabilities (Wasm, ZK-SNARKs, Bacalhau, LLM). Required tags: ``executor``, ``expiration``; optional tags: ``limit``, ``pay``, ``runtime``. * - ``21801`` - **Node Heartbeat** - Ephemeral - Broadcasts liveness telemetry without per-peer attribution. Required tag: ``class``; optional tags: ``endpoints``, ``load``, ``retiring``. * - ``21802`` - **Diagnostic Telemetry** - Ephemeral - Opt-in coarse-binned node-wide diagnostic counters over a sample window. Required tag: ``sample_window``; optional tags: ``metric``, ``expiration``. * - ``30801`` - **Peer Grant Envelope** - Addressable - Blinded bilateral peering capacity grant encrypted to the subject with NIP-44 v2. Required tags: ``d`` (HKDF-blinded coordinate), ``commit``, ``scheme``, ``window``, ``epoch``, ``expiration``. * - ``30802`` - **Conformance Report** - Addressable - Adverse-only divergence report (outcomes ``S1``–``S4``) citing a grant issued by the reporter and inline signed evidence. Required tags: ``d``, ``outcome``, ``grant``, ``windows``, ``evidence``, ``expiration``. * - ``30803`` - **Coverage Claim** - Addressable - Attests shard event coverage (``asserted`` or ``best-effort``) and NIP-77 set fingerprints, optionally carrying a signed first-hand ``handover`` chain. Required tags: ``d``, ``filter``, ``completeness``. * - ``30804`` - **Gossip Topic Membership** - Addressable - Admin-signed roster of authorized member pubkeys for a ``gossip/1.0`` epidemic broadcast topic. Required tags: ``d``, ``member``, ``expiration``. * - ``30810`` - **Compute Ask** - Addressable - Order-book entry requesting compute execution with a pre-bound workload commitment. Required tags: ``d``, ``commit``, ``executor``, ``bid``, ``deadline``, ``fuel_max``, ``verify``, ``expiration``. * - ``30811`` - **Job Receipt** - Addressable - Blinded compute execution receipt encrypted to the buyer with NIP-44 v2 (or cleartext with buyer consent). Required tags: ``d``, ``commit``, ``scheme``, ``expiration``. Kind 11801: Node Descriptor Specification ----------------------------------------- The **Node Descriptor** is the cornerstone of network discovery in Fleetmesh. Required Tags ^^^^^^^^^^^^^ - ``class``: Declares node tier (e.g. ``anchor``, ``relay``, ``edge``). - ``protocol``: Target protocol identifier (``fleetmesh/0.1-draft``). - ``c``: Capability tag (one tag per capability, repeated). Because Nostr relays index single-letter tags, ``c`` tags allow clients to filter for nodes offering specific protocols (e.g. ``peering/1.0``, ``budget/1.0``, ``blob/1.0``, ``grasp/1.0``) without downloading full registries. - ``expiration``: Unix timestamp indicating when this descriptor expires. Optional & Sidecar Tags ^^^^^^^^^^^^^^^^^^^^^^^ - ``endpoint``: Reachable connection addresses: - WebSocket: ``ws://...`` or ``wss://...`` - Iroh QUIC: ``iroh://@:`` - FIPS / DoD: ``fips://...`` - ``mint``: URL of an accepted Cashu ecash mint (for PaidFetch settlements). - ``price``: Default pricing structure (``["price", "fetch", "", "msat"]``). - ``grasp-endpoint``: URL for the node's GRASP git-http sidecar (kinds 30617/30618). - ``ncontainer-endpoint``: URL for the ncontainer OCI container image gateway (kind 30624). - ``magpie-endpoint``: URL for the Magpie media asset repository. Example Node Descriptor Event ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: json { "kind": 11801, "pubkey": "d4e2a7b8c9f1...", "created_at": 1791835000, "tags": [ ["class", "anchor"], ["protocol", "fleetmesh/0.1-draft"], ["c", "peering/1.0"], ["c", "budget/1.0"], ["c", "blob/1.0"], ["c", "grasp/1.0"], ["endpoint", "iroh://z6Mkh...198.51.100.10:11801"], ["endpoint", "wss://node-1.fleetmesh.org/relay"], ["mint", "https://mint.fleetmesh.org"], ["price", "fetch", "100", "msat"], ["grasp-endpoint", "https://git.fleetmesh.org"], ["expiration", "1791921400"] ], "content": "Fleetmesh Tier-1 Anchor Node (Bristol Core)", "id": "7a3f8b91...", "sig": "e5c2b09a..." }