Expand description
Lazy-connecting UDS RPC transport (same-host ipc plane).
Mirrors LazyQuinnTransport and
LazyIrohTransport: the
dial factory is synchronous, so this holds the socket
path and connects on the first send(), caching the session — preserving
sync, zero-I/O construction.
The connection is a UdsSession on the RPC
plane (PLANE_RPC), wrapped as a SessionRpcTransport — the same generic
client used by the quinn and iroh backends, so the ipc plane carries the
identical Cap’n Proto bidi wire protocol with no transport-specific RPC code.
This is the post-ZMQ ipc transport: same-host processes keep ipc,
re-platformed off ZMQ framing onto SignedEnvelope-over-UDS.
§Identity
UDS has no transport-level peer identity; same-host trust + the app-layer
SignedEnvelope (verified against the response key) are the authentication.
Socket-file permissions + SO_PEERCRED are defense-in-depth owned by the
daemon that binds the listener (see #207). A None server_verifying_key
leaves the response identity unpinned (the envelope sig is still verified),
matching the quinn arm.
Re-dial/self-heal semantics match the other lazy transports: a per-request timeout keeps the session; a transport-fatal error drops it so the next call re-dials.
Structs§
- Lazy
UdsTransport - A UDS RPC transport that connects on first use and caches the session.