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.