blooym.dev
forked from
nonbinary.computer/jacquard
A better Rust ATProto crate
removed extraneous file
-14
docs/identity.md
-14
docs/identity.md
···
1
-
# Identity Resolution
2
-
3
-
This module provides helpers for resolving AT Protocol identifiers (handles and DIDs) and fetching DID documents.
4
-
5
-
Highlights:
6
-
7
-
- DNS TXT (`_atproto.<handle>`) first when compiled with the `dns` feature, then HTTPS well-known, then Slingshot `resolveHandle` when configured as PLC source.
8
-
- DID resolution via did:web well-known or PLC base (PLC Directory or Slingshot), returning a `DidDocResponse` that supports borrowed parsing and validation.
9
-
- Validation: convenience helpers validate that the fetched DID document `id` matches the requested DID (default on). On mismatch, a `DocIdMismatch` error includes the fetched document for callers to inspect.
10
-
- Slingshot: supports unauthenticated `resolveHandle` and a minimal-document endpoint (`com.bad-example.identity.resolveMiniDoc`).
11
-
- Auth-aware fallbacks: PDS `resolveHandle` / `resolveDid` available via helpers that accept an `XrpcClient`.
12
-
13
-
See `jacquard::identity::resolver` rustdoc for examples.
14
-
···