2. 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.

2.1. 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.

2.2. Registered Fleetmesh Event Kinds

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.

2.3. Kind 11801: Node Descriptor Specification

The Node Descriptor is the cornerstone of network discovery in Fleetmesh.

2.3.1. 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.

2.3.2. Optional & Sidecar Tags

  • endpoint: Reachable connection addresses: - WebSocket: ws://... or wss://... - Iroh QUIC: iroh://<node_id>@<ip>:<port> - FIPS / DoD: fips://...

  • mint: URL of an accepted Cashu ecash mint (for PaidFetch settlements).

  • price: Default pricing structure (["price", "fetch", "<msat>", "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.

2.3.3. Example Node Descriptor Event

{
  "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..."
}