Skip to main content

Module registry_readback

Module registry_readback 

Source
Expand description

One bounded, read-only Registry canary lookup under the enrolled Registry identity. The Policy preflight authenticates as that same service before the Registry request, so an authorization denial cannot be mistaken for a missing canary.

The internal timeouts bound only the Policy and Registry RPC futures. They do not bound resolver/bootstrap work, local filesystem access, or process shutdown; staging diagnostics must also use an external deadline that kills the complete diagnostic process group.

Functions§

error_category
Return only a fixed category suitable for CLI output. Never propagate RPC error text, which may include private transport or authorization details.
readback_local_canary
Authenticate a read-only PolicyCheck using the same Registry key and delegated service JWT that the subsequent Registry request uses. Policy’s request subject/domain fields are compatibility fields; PolicyService derives identity and domain from this verified envelope instead.
register_local_canary
Preflight both exact grants before constructing the sole Register request. The Registry signing key and JWT still authenticate both Policy and Registry RPCs; only the caller’s outbound Iroh carrier is ephemeral.
registration_error_category
A write or its readback may have completed after a lost response. Every such outcome requires durable-state reconciliation, never an automatic retry.
require_registry_service_subject
Reject a credential selected from a flat per-service credential directory unless its decoded subject names Registry. This is only an invocation-side selector: the subsequent signed Policy request remains the authority that verifies the credential and binds it to the signing key.