1.11. Protocol Interoperability & External Standards

1.11.1. Interoperability: what a fleetmesh node speaks that it did not invent

A fleetmesh node is reachable by programs that have never heard of fleetmesh: a Nostr client sees a relay, a Blossom client sees a blob server, a Cashu wallet sees a payee, a DIDComm agent sees a mediator, an ATProto PDS sees a repository sync peer, a Mastodon instance sees an ActivityPub actor, an SSB peer sees a Scuttlebutt feed replica, a p2panda peer sees a CBOR operation log host, and a Rhio cluster node sees a NATS JetStream / Bao CAS sync peer. This page states the policy for that surface and holds the inventory of it to the code.

1.11.1.1. Policy

  1. Reuse before invent. Where an open protocol already carries the fact, the node speaks it unchanged and the fleetmesh protocol says only what is left over. Peering, budgets and grants are ours; relaying, blob transfer, payment, federation, and encrypted transport are not.

  2. Adopt a protocol by its own test. A row below is “proved” when a test file in this repo names the identifier and exercises the behaviour against a fixture or vector from that protocol, not a paraphrase of it. A row with no test is a stated gap, and the census lists it as one rather than hiding it.

  3. One package per protocol suite, conforming to ProtocolPackage. Protocols are packaged into decoupled suites mounted dynamically: Nostr in fleetmesh_node/protocols/nostr/, Blossom in fleetmesh_node/protocols/nostr/blossom.py and fleetmesh_node/planes/store/blob_wire/, Cashu in fleetmesh_core/accounting/cashu.py and fleetmesh_node/planes/services/settle/, DIDComm in fleetmesh_node/transport/ and fleetmesh_node/planes/transport/mediation/, AT Protocol in fleetmesh_node/protocols/atproto/, ActivityPub in fleetmesh_node/protocols/activitypub/, Secure Scuttlebutt in fleetmesh_node/protocols/ssb/ and fleetmesh_node/sidecar/fleetmesh_ssb.py, p2panda in fleetmesh_node/protocols/p2panda/ and fleetmesh_core/wire/p2panda.py, and Rhio in fleetmesh_node/protocols/rhio/ and fleetmesh_node/sidecar/fleetmesh_rhio.py.

  4. Foreign protocols are dialects, not forks. Anything another party mints under its own origin is spoken as a dialect (docs/extending.md): it is declared with a c tag, never under https://fleetmesh.org/, and needs no registry entry here. The census below is of the standards families; dialects are per-deployment and belong in a node’s descriptor.

  5. The schema is not a union. schema/messages.json reused_protocols names DIDComm protocols by their identifiers and nothing else; fleetmesh does not re-specify them and the digest does not cover them.

1.11.1.2. Census

Generated by scripts/check-interop.py from every NIP-xx, BUD-xx, NUT-xx, RFC-xxxx, com.atproto.*, SSB-*, and https://didcomm.org/... identifier in fleetmesh_node/ and fleetmesh_core/ (the demo is skipped). “Named in” is the shipped code; “proved by” the test files that name the same identifier. The check fails when this table is stale; --write regenerates it.

Identifier

Family

Named in

Proved by

NIP-01

nostr

fleetmesh_core/commerce/messages.py, fleetmesh_core/conformance/conformance_ops.py, fleetmesh_core/crypto/giftwrap.py, fleetmesh_core/identity/identity.py, fleetmesh_core/identity/relaylist.py, fleetmesh_core/network/brand.py, fleetmesh_core/network/definition.py, fleetmesh_core/network/grant.py, fleetmesh_core/network/join_request.py, fleetmesh_core/peering/projection.py, fleetmesh_core/storage/projection.py, fleetmesh_core/storage/store.py, fleetmesh_core/storage/store_postgres.py, fleetmesh_core/textile/strand_event.py, fleetmesh_core/wire/wire_types.py, fleetmesh_node/app/control.py, fleetmesh_node/app/core.py, fleetmesh_node/app/groups.py, fleetmesh_node/examples/demo.py, fleetmesh_node/planes/identity/discovery/compartment.py, fleetmesh_node/planes/operations/updates/core.py, fleetmesh_node/planes/peering/peering/core.py, fleetmesh_node/planes/peering/peering/envelope.py, fleetmesh_node/planes/services/gateway/translate.py, fleetmesh_node/planes/services/gossip/core.py, fleetmesh_node/protocols/nostr/__init__.py, fleetmesh_node/protocols/nostr/eventstore.py, fleetmesh_node/protocols/nostr/package.py, fleetmesh_node/protocols/nostr/relayserver.py, fleetmesh_node/storage/grants.py, fleetmesh_node/storage/projected.py, fleetmesh_node/transport/relay_rung/cooldown.py

test_brands.py, test_nostr_package.py, test_peering_wire.py, test_projected_store.py, test_sync_wire.py, test_transport.py

NIP-04

nostr

fleetmesh_node/planes/services/settle/gateways.py

test_gateways.py

NIP-09

nostr

fleetmesh_core/network/brand.py, fleetmesh_core/storage/projection.py, fleetmesh_core/storage/store.py, fleetmesh_core/textile/privacy_ladder.py, fleetmesh_node/app/control.py, fleetmesh_node/app/core.py, fleetmesh_node/planes/identity/network/compartment.py, fleetmesh_node/planes/services/compute/executors/harness.py, fleetmesh_node/protocols/nostr/eventstore.py, fleetmesh_node/storage/projected.py

test_projected_store.py, test_retention.py, test_visibility_wire.py

NIP-11

nostr

fleetmesh_core/conformance/conformance_ops.py, fleetmesh_core/services/discovery.py, fleetmesh_node/planes/identity/discovery/compartment.py, fleetmesh_node/planes/services/nsite/compartment.py, fleetmesh_node/protocols/nostr/package.py, fleetmesh_node/protocols/nostr/relayserver.py, fleetmesh_node/transport/ws.py

test_auth.py, test_blossom.py, test_cli.py, test_discovery_wire.py, test_hardening.py, test_multiprotocol_concurrency.py, test_nostr_package.py, test_nostr_toggle.py, test_nsite.py, test_sync_wire.py, test_visibility_wire.py

NIP-13

nostr

fleetmesh_core/identity/identity.py, fleetmesh_node/app/core.py, fleetmesh_node/protocols/nostr/descriptor.py, fleetmesh_node/sidecar/fleetmesh_announce.py

none - a gap

NIP-17

nostr

fleetmesh_core/commerce/__init__.py, fleetmesh_core/commerce/messages.py, fleetmesh_core/commerce/payment.py, fleetmesh_core/commerce/sealed.py, fleetmesh_core/conformance/conformance_ops.py, fleetmesh_core/identity/relaylist.py, fleetmesh_node/planes/identity/presence/compartment.py, fleetmesh_node/transport/const.py, fleetmesh_node/transport/relay_rung/outbound.py

test_presence.py

NIP-19

nostr

fleetmesh_core/crypto/bech32.py

test_cli.py

NIP-23

nostr

fleetmesh_core/textile/types.py

none - a gap

NIP-32

nostr

fleetmesh_core/conformance/conformance_ops.py, fleetmesh_core/network/__init__.py, fleetmesh_core/network/brand.py, fleetmesh_core/peering/projection.py, fleetmesh_core/textile/strand.py, fleetmesh_node/app/core.py, fleetmesh_node/planes/peering/reporter/core.py

test_brands.py, test_multinode_integration.py

NIP-34

nostr

fleetmesh_core/textile/code_repo.py, fleetmesh_protocols/grasp/git_http.py, fleetmesh_protocols/grasp/git_store.py

none - a gap

NIP-40

nostr

fleetmesh_core/conformance/conformance_ops.py, fleetmesh_core/network/brand.py, fleetmesh_core/network/fleet.py, fleetmesh_core/peering/coverage.py, fleetmesh_core/storage/projection.py, fleetmesh_core/storage/store.py, fleetmesh_node/planes/services/gossip/core.py, fleetmesh_node/planes/store/retention/compartment.py, fleetmesh_node/planes/transport/bridge/compartment.py, fleetmesh_node/protocols/nostr/package.py, fleetmesh_node/protocols/nostr/relayserver.py, fleetmesh_node/storage/projected.py

test_bridge.py, test_projected_store.py, test_retention.py

NIP-42

nostr

fleetmesh_core/identity/web_auth.py, fleetmesh_core/network/relay_allow.py, fleetmesh_node/planes/transport/bridge/compartment.py, fleetmesh_node/protocols/nostr/client.py, fleetmesh_node/protocols/nostr/package.py, fleetmesh_node/protocols/nostr/relayserver.py, fleetmesh_node/transport/relay_rung/core.py, fleetmesh_node/transport/relay_rung/wire.py

test_auth.py, test_visibility_wire.py

NIP-44

nostr

fleetmesh_core/conformance/conformance_ops.py, fleetmesh_core/crypto/giftwrap.py, fleetmesh_core/crypto/nip44.py, fleetmesh_core/network/control.py, fleetmesh_core/network/join_request.py, fleetmesh_core/network/roster.py, fleetmesh_core/textile/leaf_crypto.py, fleetmesh_node/examples/demo.py, fleetmesh_node/planes/services/compute/__init__.py, fleetmesh_node/planes/services/compute/jobs.py, fleetmesh_node/planes/services/compute_wire/__init__.py, fleetmesh_node/planes/services/compute_wire/sealing.py, fleetmesh_node/planes/services/settle/gateways.py, fleetmesh_node/protocols/nostr/package.py, fleetmesh_node/transport/const.py, fleetmesh_protocols/dm/mailbox.py

test_crypto.py, test_gateways.py, test_transport.py

NIP-47

nostr

fleetmesh_node/planes/services/settle/gateways.py

test_gateways.py

NIP-59

nostr

fleetmesh_core/commerce/messages.py, fleetmesh_core/commerce/sealed.py, fleetmesh_core/crypto/giftwrap.py, fleetmesh_core/crypto/nip44.py, fleetmesh_core/network/control.py, fleetmesh_core/network/grant.py, fleetmesh_core/textile/leaf_crypto.py, fleetmesh_core/wire/wire_types.py, fleetmesh_node/app/authority.py, fleetmesh_node/planes/operations/remote/compartment.py, fleetmesh_node/planes/services/gossip/core.py, fleetmesh_node/planes/services/gossip/envelope.py, fleetmesh_node/planes/store/retention/compartment.py, fleetmesh_node/protocols/nostr/package.py, fleetmesh_node/protocols/nostr/relayserver.py, fleetmesh_node/transport/__init__.py, fleetmesh_node/transport/relay_rung/__init__.py, fleetmesh_node/transport/relay_rung/inbound.py, fleetmesh_node/transport/router.py

test_crypto.py, test_hardening.py, test_multinode_integration.py, test_retention.py, test_transport.py

NIP-60

nostr

fleetmesh_node/planes/services/settle/__init__.py, fleetmesh_node/planes/services/settle/payment.py

test_settlement.py

NIP-61

nostr

fleetmesh_core/accounting/cashu.py, fleetmesh_node/planes/services/settle/__init__.py, fleetmesh_node/planes/services/settle/compartment.py, fleetmesh_node/planes/services/settle/engine.py, fleetmesh_node/planes/services/settle/payment.py

test_settlement.py

NIP-66

nostr

fleetmesh_core/conformance/conformance_ops.py, fleetmesh_core/services/discovery.py, fleetmesh_node/planes/identity/discovery/compartment.py, fleetmesh_node/planes/transport/mediation/__init__.py, fleetmesh_node/planes/transport/mediation/leaf.py, fleetmesh_node/protocols/nostr/relayserver.py

test_cli.py, test_mediation.py, test_multinode_integration.py, test_visibility_wire.py

NIP-73

nostr

fleetmesh_core/peering/projection.py

none - a gap

NIP-77

nostr

fleetmesh_core/peering/coverage.py, fleetmesh_core/storage/negentropy.py, fleetmesh_core/storage/projection.py, fleetmesh_core/storage/replication.py, fleetmesh_core/storage/store.py, fleetmesh_core/storage/sync.py, fleetmesh_core/textile/__init__.py, fleetmesh_core/textile/leaf_envelope.py, fleetmesh_core/wire/validate.py, fleetmesh_node/protocols/nostr/__init__.py, fleetmesh_node/protocols/nostr/package.py, fleetmesh_node/protocols/nostr/relayserver.py, fleetmesh_node/storage/projected.py, fleetmesh_node/storage/sharding.py, fleetmesh_node/storage/standing.py

test_discovery_wire.py, test_node.py, test_projected_store.py, test_sync_wire.py

NIP-85

nostr

fleetmesh_core/conformance/conformance_ops.py, fleetmesh_core/peering/projection.py, fleetmesh_node/planes/peering/reporter/publish.py

test_multinode_integration.py

NIP-90

nostr

fleetmesh_core/services/dvm.py, fleetmesh_node/commands/compute_cmds.py, fleetmesh_node/config/compartments.py, fleetmesh_node/meshnode.py, fleetmesh_node/planes/services/__init__.py, fleetmesh_node/planes/services/compute/executors/media.py, fleetmesh_node/planes/services/dvm/__init__.py, fleetmesh_node/planes/services/dvm/gateway.py, fleetmesh_node/planes/services/dvm/protocol.py, fleetmesh_node/planes/services/dvm/translate.py, fleetmesh_node/planes/services/video/barter.py

test_compute_nondet.py, test_dvm.py, test_multinode_integration.py

NIP-98

nostr

fleetmesh_core/identity/web_auth.py

none - a gap

NIP-99

nostr

fleetmesh_core/commerce/__init__.py, fleetmesh_core/commerce/messages.py, fleetmesh_core/commerce/payment.py, fleetmesh_core/conformance/conformance_ops.py, fleetmesh_core/products/__init__.py, fleetmesh_core/products/listing.py, fleetmesh_core/products/refusals.py

none - a gap

BUD-01

blossom

fleetmesh_core/conformance/conformance_ops.py, fleetmesh_core/storage/blossom_auth.py, fleetmesh_node/planes/services/compute/common.py, fleetmesh_node/protocols/nostr/__init__.py, fleetmesh_node/protocols/nostr/blossom.py, fleetmesh_node/protocols/nostr/package.py

test_blossom.py, test_nostr_package.py

BUD-02

blossom

fleetmesh_core/storage/linked_data.py, fleetmesh_node/protocols/nostr/blossom.py, fleetmesh_node/protocols/nostr/package.py

test_blossom.py, test_visibility_wire.py

BUD-03

blossom

fleetmesh_core/services/nsite.py

none - a gap

BUD-04

blossom

fleetmesh_core/conformance/conformance_ops.py, fleetmesh_core/storage/blossom_auth.py, fleetmesh_node/planes/store/blob_replication/compartment.py, fleetmesh_node/protocols/nostr/__init__.py, fleetmesh_node/protocols/nostr/blossom.py, fleetmesh_node/protocols/nostr/package.py

test_blob_replication.py, test_blossom.py

NUT-00

cashu

fleetmesh_core/accounting/cashu.py, fleetmesh_node/planes/services/settle/gateways.py, fleetmesh_node/planes/services/settle/payment.py

test_cashu_live.py, test_cashu_wire.py, test_gateways.py, test_settlement.py

NUT-02

cashu

fleetmesh_node/planes/services/paidfetch/compartment.py

test_paid_fetch.py

NUT-03

cashu

fleetmesh_core/accounting/cashu.py, fleetmesh_node/planes/services/paidfetch/compartment.py, fleetmesh_node/planes/services/settle/gateways.py, fleetmesh_node/planes/services/video/packager.py, fleetmesh_node/planes/services/video/player.py

test_gateways.py

NUT-04

cashu

fleetmesh_node/planes/services/settle/gateways.py

test_gateways.py

NUT-05

cashu

fleetmesh_node/planes/services/paidfetch/compartment.py, fleetmesh_node/planes/services/settle/gateways.py

test_gateways.py, test_paid_fetch.py

NUT-07

cashu

fleetmesh_core/accounting/cashu.py, fleetmesh_node/planes/services/settle/engine.py, fleetmesh_node/planes/services/settle/gateways.py

test_cashu_live.py, test_gateways.py

NUT-10

cashu

fleetmesh_core/accounting/cashu.py

test_cashu_wire.py

NUT-11

cashu

fleetmesh_core/accounting/cashu.py, fleetmesh_node/planes/services/video/packager.py, fleetmesh_node/planes/services/video/player.py

test_cashu_live.py

NUT-12

cashu

fleetmesh_core/accounting/cashu.py

test_cashu_wire.py

NUT-18

cashu

fleetmesh_core/accounting/cashu.py, fleetmesh_core/wire/cbor.py, fleetmesh_node/planes/services/compute/executors/harness.py, fleetmesh_node/planes/services/gateway/settle.py, fleetmesh_node/protocols/atproto/metering.py

test_cashu_live.py, test_cashu_wire.py, test_paid_fetch.py

NUT-24

cashu

fleetmesh_core/accounting/cashu.py, fleetmesh_core/accounting/paidfetch.py, fleetmesh_node/planes/services/gateway/settle.py, fleetmesh_node/protocols/atproto/metering.py, fleetmesh_node/protocols/nostr/blossom.py

test_cashu_live.py, test_cashu_wire.py

RFC-7033

activitypub

fleetmesh_node/protocols/activitypub/package.py

test_activitypub_actor.py

RFC-9421

activitypub

fleetmesh_node/protocols/activitypub/package.py

test_activitypub_signatures.py

com.atproto.repo

atproto

fleetmesh_node/protocols/atproto/package.py, fleetmesh_node/protocols/atproto/xrpc.py

test_atproto_metering.py, test_atproto_xrpc.py, test_multiprotocol_concurrency.py, test_protocol_hardening.py

com.atproto.server

atproto

fleetmesh_node/protocols/atproto/package.py, fleetmesh_node/protocols/atproto/xrpc.py

test_atproto_metering.py, test_atproto_xrpc.py, test_multiprotocol_concurrency.py

com.atproto.sync

atproto

fleetmesh_core/wire/interfaces.py, fleetmesh_node/protocols/atproto/firehose.py, fleetmesh_node/protocols/atproto/metering.py, fleetmesh_node/protocols/atproto/package.py, fleetmesh_node/protocols/atproto/xrpc.py

test_atproto_metering.py, test_atproto_xrpc.py

SSB-BoxStream

ssb

fleetmesh_core/crypto/ssb.py, fleetmesh_node/protocols/ssb/package.py

test_ssb_crypto.py

SSB-MuxRPC

ssb

fleetmesh_node/protocols/ssb/muxrpc.py, fleetmesh_node/protocols/ssb/package.py

test_ssb_muxrpc.py

SSB-SHS

ssb

fleetmesh_core/crypto/ssb.py, fleetmesh_node/protocols/ssb/package.py

test_ssb_crypto.py

https://didcomm.org/coordinate-mediation/2.0

didcomm

fleetmesh_node/planes/transport/mediation/messages.py, fleetmesh_protocols/textile/hosted_relay.py

test_mediation.py

https://didcomm.org/discover-features/2.0

didcomm

fleetmesh_core/services/discover.py, fleetmesh_node/transport/const.py

test_blob_wire.py, test_durability_boundary.py, test_extensions.py, test_hardening.py, test_mediation.py, test_meter_durability.py, test_peering_wire.py, test_reporter.py, test_router.py, test_wire_protocol.py

https://didcomm.org/empty/1.0

didcomm

fleetmesh_node/transport/const.py

test_transport.py

https://didcomm.org/messagepickup/2.0

didcomm

fleetmesh_node/planes/transport/mediation/messages.py

test_mediation.py

https://didcomm.org/routing/2.0

didcomm

fleetmesh_node/planes/transport/mediation/messages.py, fleetmesh_node/transport/const.py

test_mediation.py

https://didcomm.org/trust-ping/2.0

didcomm

fleetmesh_node/transport/const.py

test_didcomm_inbound.py, test_p2panda_package.py, test_rhio_sidecar.py, test_transport.py

53 identifiers named by shipped code; 7 with no test naming them.

1.11.1.3. Finding: the schema’s reused list and the code disagree

schema/messages.json reused_protocols is the set of registered protocols the spec lets a node reuse unmodified - the spec’s own table (“Required of”) is the normative statement and the list is its machine-readable form. It is not a statement of what this implementation speaks today; the census above is. When the first census ran the two disagreed in both directions: the list omitted coordinate-mediation/2.0 and messagepickup/2.0, which the mediation module speaks and the spec table already named (check-spec.py had been patched to tolerate the first), and it named four - out-of-band, discover-features, trust-ping, report-problem - that the node does not yet speak (trust-ping appears in the demo only). The omission was a schema error and is fixed, under the digest. The four unspoken ones are spec requirements the node has not met, and they stay on the list: removing them would make the schema describe the implementation instead of the protocol. They are the honest gap on the DIDComm side, the way the census rows were on the Nostr and Cashu side.

1.11.1.4. Reading the gaps

A gap row means the code names the standard and no test does. There are none at the moment; the seven the first census found were closed with a vector each from the upstream spec, added to the test file that already covered the module rather than a new harness - NIP-13’s own 36-bit id, NIP-19’s npub pair both ways plus a checksum refusal, NIP-73’s fragment rule, BUD-02’s HEAD contract on the raw wire, NUT-02’s input fee against a mint that refuses a swap short of it, NUT-10’s printed example secret, and for NUT-12 the negative: a forged on-curve C that the structural check cannot catch and only the key check does, which is exactly why verify_proof says it is not a signature check. A new gap appears here the moment code names a standard that no test does; close it the same way.