Skip to main content

DidPlcResolver

Struct DidPlcResolver 

Source
pub struct DidPlcResolver<F: PlcAuditFetcher> { /* private fields */ }
Expand description

Resolves a did:plc identifier to its validated DID document.

Generic over a PlcAuditFetcher so the parse/validate/verify path is testable with an injected fixture (no live network); the native implementation is HttpPlcFetcher. This is the federation-intake artifact E2 (#1174, foreign handle resolution) and E3 (#1175, exchange audience) build on.

Read-only forever: there is no write path. See the module docs.

Implementations§

Source§

impl<F: PlcAuditFetcher> DidPlcResolver<F>

Source

pub fn with_fetcher(fetcher: F, config: PlcResolverConfig) -> Self

Construct a resolver over an injected document+audit fetcher. This is for fixtures and alternate transports; native callers should use DidPlcResolver::<HttpPlcFetcher>::new, which couples its cache TTL to this resolver’s one configuration object.

Source

pub fn config(&self) -> &PlcResolverConfig

The resolver’s directory configuration (base URL, TTL).

Source

pub async fn resolve_document(&self, did: &str) -> Result<Value>

Resolve did to its DID document, validated.

Derives the pinned URL beneath the configured base URL, fetches it, and enforces the subject binding (validate_plc_document). Every failure — malformed DID, fetch error, malformed document, doc.id mismatch — is Err (fail-closed).

Source§

impl DidPlcResolver<HttpPlcFetcher>

Source

pub fn new(config: PlcResolverConfig) -> Result<Self>

Construct the native HTTPS resolver from one configuration object.

The fetcher is created here rather than accepted from the caller, so the cache enforcing the TTL and the resolver advertising it cannot diverge.

Trait Implementations§

Source§

impl<F: PlcAuditFetcher> DidDocResolve for DidPlcResolver<F>

A configured did:plc resolver can serve the existing federation admission boundary. Its URL derivation, egress allowlist, cache, and doc.id binding are all enforced before this gate inspects verification methods.

Source§

fn resolve_doc<'life0, 'life1, 'async_trait>( &'life0 self, did: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Value>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetch and parse the DID document for did.

Auto Trait Implementations§

§

impl<F> Freeze for DidPlcResolver<F>
where F: Freeze,

§

impl<F> RefUnwindSafe for DidPlcResolver<F>
where F: RefUnwindSafe,

§

impl<F> Send for DidPlcResolver<F>

§

impl<F> Sync for DidPlcResolver<F>

§

impl<F> Unpin for DidPlcResolver<F>
where F: Unpin,

§

impl<F> UnsafeUnpin for DidPlcResolver<F>
where F: UnsafeUnpin,

§

impl<F> UnwindSafe for DidPlcResolver<F>
where F: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
§

impl<T> ServiceExt for T

§

fn map_response_body<F>(self, f: F) -> MapResponseBody<Self, F>
where Self: Sized,

Apply a transformation to the response body. Read more
§

fn trace_for_http(self) -> Trace<Self, SharedClassifier<ServerErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using HTTP status codes. Read more
§

fn trace_for_grpc(self) -> Trace<Self, SharedClassifier<GrpcErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using gRPC headers. Read more
§

fn follow_redirects(self) -> FollowRedirect<Self>
where Self: Sized,

Follow redirect resposes using the Standard policy. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<T> ErasedDestructor for T
where T: 'static,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSync for T
where T: Sync,

§

impl<T> MaybeSync for T
where T: Sync,