Skip to main content

Module at9p_resolver

Module at9p_resolver 

Source
Expand description

#893 (at9p D1) — did:at9p capsule resolver: turns a GATE-verified capsule into a dialable TransportConfig::iroh (sibling to hyprstream_rpc::service_entry::decode_iroh). Injectable at the Resolver::set_global / network-profile resolver seam (#873). did:at9p capsule resolver — GATE-verified reach as a TransportConfig (#893, design #879 §9; epic #880 Track D / D1).

This is the D1 sibling to hyprstream_rpc::service_entry::decode_iroh: where decode_iroh turns a DID-document IrohTransport service entry into a dialable [TransportConfig], this module turns a GATE-verified did:at9p capsule into the same shape. It is explicitly not a RecordResolver impl — a RecordResolver returns an atproto CAR (the wrong output shape for “how do I dial this peer”). The capsule→reach path is a separate resolution arm, injected at the network-profile resolver seam (Resolver::set_global, the future NetworkDiscoveryResolver of #873).

§Why a genesis capsule cannot mint a dial target

GATE makes genesis fields content-bound claims; it does not prove current state, liveness, or possession. The schema carries a relay claim but no independent carrier EndpointId, so this resolver fails closed rather than deriving reach from the subject Ed25519 key (#1031).

§Service selection (#893 update; design #905 §4, #879 §5.1a)

A capsule carries a map of named services (the #882 services field), each typed (NinePExport, AtprotoPds). The resolver takes an optional service selector (default [DEFAULT_AT9P_SERVICE] = #ns, the 9P export a client attaches to) and validates that selected NinePExport service entry only. A missing id, a wrong-type entry, a non-iroh transport, or the absence of an independent carrier EndpointId fails closed — never an unrequested, wrong-shape, or identity-derived endpoint. This is the seam #906 (the DID-URL dereferencer, G1) pins against, and the one #877’s attach profile consumes.

Structs§

At9pResolver
did:at9p capsule resolver — turns a did:at9p:<cid> into a dialable TransportConfig over a CapsuleSource + the GATE pipeline.

Constants§

DEFAULT_AT9P_SERVICE
Default at9p service selector — the NinePExport entry a client attaches to.

Traits§

CapsuleSource
Untrusted source of capsule bytes for a did:at9p:<cid> identifier.

Functions§

capsule_to_iroh_reach
Map a GATE-verified did:at9p capsule to a dialable iroh TransportConfig, selecting the NinePExport service entry named service (default DEFAULT_AT9P_SERVICE).