Struct Resolver 

struct Resolver {
    inner: JacquardResolver<Client>,
}

The identity resolution behind OperatorAuth.

jacquard-identity builds a did:web document URL by pasting the method-specific identifier after https://, so did:web:localhost%3A3415 becomes a request to a host literally named localhost%3A3415. atproto permits exactly that shape — a port, with its colon percent-encoded — for localhost and nowhere else, “only in testing and development”, and didbot_identity::did::AccountDid decodes it. This puts that answer in front of the library’s.

Only a DID that carries a port takes this path, and only a bare loopback hostname may carry one, so a deployment on a public zone never reaches it. Every such fetch is https:// like any other.

Fields

inner: JacquardResolver<Client>

Implementations

impl Resolver

fn new(http: Client) -> Self

fn ported_document_url(&self, did: &str) -> Option<String>

Where did’s document is served, for a did:web this resolver reads itself rather than handing to the library.

Trait Implementations

impl DpopExt for Resolver

fn dpop_server_call<'r, D>( &'r self, data_source: &'r mut D, ) -> DpopCall<'r, Self, D>

where Self: Sized, D: DpopDataSource,

Begin building a DPoP-protected request targeting an authorization server.

fn dpop_call<'r, N>(&'r self, data_source: &'r mut N) -> DpopCall<'r, Self, N>

where Self: Sized, N: DpopDataSource,

Begin building a DPoP-protected request targeting a resource server.

impl HttpClient for Resolver

type Error = IdentityError

Error type returned by the HTTP client

async fn send_http( &self, request: Request<Vec<u8>>, ) -> Result<Response<Vec<u8>>, Self::Error>

Send an HTTP request and return the response.

impl IdentityResolver for Resolver

fn options(&self) -> &ResolverOptions

Access options for validation decisions in default methods

async fn resolve_handle<S: BosStr + Sync>( &self, handle: &Handle<S>, ) -> Result<Did>

Resolve handle

async fn resolve_did_doc<S: BosStr + Sync>( &self, did: &Did<S>, ) -> Result<DidDocResponse>

Resolve DID document

fn resolve_ident<S>( &self, actor: &AtIdentifier<S>, ) -> impl Future<Output = Result<DidDocResponse, IdentityError>> + Send

where S: BosStr + Sync, Self: Sync,

Resolve DID doc from an identifier

fn resolve_ident_owned<S>( &self, actor: &AtIdentifier<S>, ) -> impl Future<Output = Result<DidDocument, IdentityError>> + Send

where S: BosStr + Sync, Self: Sync,

Resolve DID doc from an identifier

fn resolve_did_doc_owned<S>( &self, did: &Did<S>, ) -> impl Future<Output = Result<DidDocument, IdentityError>> + Send

where S: BosStr + Sync, Self: Sync,

Resolve the DID document and return an owned version

fn pds_for_did<S>( &self, did: &Did<S>, ) -> impl Future<Output = Result<Uri<String>, IdentityError>> + Send

where S: BosStr + Sync, Self: Sync,

Return the PDS url for a DID

fn pds_for_handle<S>( &self, handle: &Handle<S>, ) -> impl Future<Output = Result<(Did, Uri<String>), IdentityError>> + Send

where S: BosStr + Sync, Self: Sync,

Return the DID and PDS url for a handle

impl OAuthResolver for Resolver

fn verify_issuer<S>( &self, server_metadata: &OAuthAuthorizationServerMetadata, sub: &Did<S>, ) -> impl Future<Output = Result<Uri<String>, ResolverError>> + Send

where S: BosStr + Sync, Self: Sync,

Verify that the authorization server in server_metadata is the correct issuer for sub.

fn resolve_oauth( &self, input: &str, ) -> impl Future<Output = Result<(OAuthAuthorizationServerMetadata, Option<DidDocument>), ResolverError>> + Send

where Self: Sync,

Resolve input (a handle, DID, PDS URL, or entryway URL) to OAuth metadata.

fn resolve_from_service( &self, input: &str, ) -> impl Future<Output = Result<OAuthAuthorizationServerMetadata, ResolverError>> + Send

where Self: Sync,

Resolve a service URL (PDS or entryway) to its authorization server metadata.

fn resolve_from_identity( &self, input: &str, ) -> impl Future<Output = Result<(OAuthAuthorizationServerMetadata, DidDocument), ResolverError>> + Send

where Self: Sync,

Resolve an AT identifier (handle or DID) to its authorization server metadata and DID document.

fn get_authorization_server_metadata( &self, issuer: &str, ) -> impl Future<Output = Result<OAuthAuthorizationServerMetadata, ResolverError>> + Send

where Self: Sync,

Fetch and validate the authorization server metadata for the given issuer URL.

fn get_resource_server_metadata( &self, pds: &str, ) -> impl Future<Output = Result<OAuthAuthorizationServerMetadata, ResolverError>> + Send

where Self: Sync,

Resolve a PDS base URL to its authorization server metadata.