federation_node_report_in

io.github.ronrey/federation · Verify this server

The mothership link (CO 486): a self-hosted node reports in to the hub on its own initiative (poll-shaped, node-initiated — the hub never calls the node). NODE-SIGNED, not operator-token'd: the node's identity IS its signature over the canonical envelope { node_id, nonce, timestamp, route }, verified against its bound key (federation_node_key_bind). Carries version, catalog digest, and journal head - and optionally the node's unreported metered tab (meter_seq + meter_coms, CO 500), charged hub-side to the node's billing tenant at most once per meter_seq (no billing tenant = tab deferred honestly, never dropped); advances the node's liveness clock (minutes), which is separate from the operator's manager standing (days) — a dark node never accelerates its operator's decay. Fails closed on a bad/absent/replayed signature or a stale timestamp. No operator token required; the signature is the auth. Returns: { ok: true, last_report_in, report_in_count } or { error, code }. Example: call federation_node_report_in with arguments {}.