···

       
1
       
1
       
-
       
# Identity Resolution

     

       
2
       
2
       
-
       


     

       
3
       
3
       
-
       
This module provides helpers for resolving AT Protocol identifiers (handles and DIDs) and fetching DID documents.

     

       
4
       
4
       
-
       


     

       
5
       
5
       
-
       
Highlights:

     

       
6
       
6
       
-
       


     

       
7
       
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
       
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
       
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
       
10
       
-
       
- Slingshot: supports unauthenticated `resolveHandle` and a minimal-document endpoint (`com.bad-example.identity.resolveMiniDoc`).

     

       
11
       
11
       
-
       
- Auth-aware fallbacks: PDS `resolveHandle` / `resolveDid` available via helpers that accept an `XrpcClient`.

     

       
12
       
12
       
-
       


     

       
13
       
13
       
-
       
See `jacquard::identity::resolver` rustdoc for examples.

     

       
14
       
14
       
-