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.