API Reference mcl_om v#0.2.2

Public facade for mcl_om — the PQ-only over-mesh substrate.

OTP application entry point for hecate-om.

Advertises a service's capabilities on the mesh, and resolves other services' capabilities from the DHT.

Boot-time provider-authorization claim.

Put/get content on the mesh via macula's supervised macula_feeder/macula_download, blocking with a timeout — what an HTTP handler actually wants (bytes or an MCID back), instead of a pid it has nothing to do with.

macula_download callback implementation for mcl_om_content:get/1,2.

macula_feeder callback implementation for mcl_om_content:put/1,2.

Backs the synthetic <service-name>.describe_capabilities mesh capability mcl_om:boot/2 advertises for any service exporting describe_rpc_capabilities/0 and/or describe_pubsub_capabilities/0 (see mcl_om_service's own moduledoc for both callbacks).

Tracks a single service's health snapshot.

Cowboy handler — GET /health.

Identity, seed and realm resolution for the mesh pool mcl_om_sup supervises alongside this gen_server.

Verifies a caller actually holds the private half of the node key whose node id it asserts as its identity, inside an otherwise- open mesh payload. The 11.x identity is a pq_hybrid node key whose node id is a SHA-256 digest of its carried public key -- so, unlike the 10.x Ed25519 DID (where the id WAS the public key), possession can only be proved by signing {identity, timestamp, procedure} with the private half AND carrying the public key the signature verifies against. procedure is part of the signed message so a proof minted for one gated capability can't be replayed against another this or any other service adds later.

Publish onto the mesh via macula's supervised macula_publisher, instead of every service hand-rolling catch macula:publish(...).

Reconciles the desired subscription set against mcl_om_pubsub_sup's actual running children (piece D, PLAN_MCL_OM_MESH_WRAPPERS.md).

Dynamic supervisor for this service's macula_subscriber children (piece D, PLAN_MCL_OM_MESH_WRAPPERS.md).

Canonical barrel_docdb read-model wiring for hecate-services.

The behaviour every hecate-service implements.

Bridges macula's native {Module, Function} single-call handler convention into macula_response's per-request init/1 + handle_request/2 contract, for a handler that needs no per-request state — the common case for a hecate-service migrating a capability from bare macula:advertise/5 onto mcl_om_capabilities:register/1 (see plans/PLAN_UCAN_GATED_CAPABILITIES.md).

Canonical reckon-db + evoq wiring helper for hecate-services.

Top-level supervisor for hecate-om.

Tolerant field lookup on a decoded mesh payload map (RPC/stream args, or a pubsub event payload), instead of every provider desk re-solving the same two gotchas independently.