idiolect-identity

API reference: docs.rs/idiolect-identity · Source: crates/idiolect-identity/ · Crate: crates.io/idiolect-identity

This page is an editorial overview. The per-symbol surface (every public type, trait, function, and feature flag) is the docs.rs link above; that is the authoritative reference.

DID resolution. Maps a did to a structured DidDocument carrying the also-known-as set, service entries, verification methods, and any additional fields the source document carries.

[dependencies]
idiolect-identity = { version = "0.8", features = ["resolver-reqwest"] }

Public surface

IdentityResolver is the trait every resolver implements; the crate ships three implementations.

Type	Feature	Backing
`InMemoryIdentityResolver`	(always)	`HashMap<Did, DidDocument>`. Tests and fixtures.
`ReqwestIdentityResolver`	`resolver-reqwest`	Reqwest-backed; resolves `did:plc` via plc.directory and `did:web` via `.well-known/did.json`.
`CachingIdentityResolver<R>`	(always)	TTL'd cache wrapping any inner resolver.

DidDocument carries the resolved data. The shipped accessors include handle(), pds_url(), and the underlying also_known_as field; see docs.rs for the full surface.

Errors

IdentityError is the single error type the crate exposes. Variants distinguish transport failures, parse failures, and unsupported DID methods.

Feature flags

Feature	Adds
`resolver-reqwest`	The `ReqwestIdentityResolver` implementation.

The shipped CachingIdentityResolver wraps any inner resolver with a TTL'd cache. Default TTL and overrides are documented on docs.rs. Cache hits skip the HTTP request entirely; cache misses fall through to the inner resolver. Errors are not cached.