didcomm 0.4.1

DIDComm for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

//! DID Resolver (https://www.w3.org/TR/did-core/#dfn-did-resolvers) interfaces

use async_trait::async_trait;

use crate::{did::did_doc::DIDDoc, error::Result};

/// Represents DID Doc resolver (https://www.w3.org/TR/did-core/#did-resolution).
#[cfg(feature = "uniffi")]
#[async_trait]
pub trait DIDResolver: Sync {
    /// Resolves a DID document by the given DID.
    ///
    /// # Params
    /// - `did` a DID to be resolved.
    ///
    /// # Returns
    /// An instance of resolved DID DOC or None if DID is not found.
    ///
    /// # Errors
    /// - `IoError` IO error during resolving
    /// - `InvalidState` indicates a bug in resolver code
    async fn resolve(&self, did: &str) -> Result<Option<DIDDoc>>;
}

/// Represents DID Doc resolver (https://www.w3.org/TR/did-core/#did-resolution).
#[cfg(not(feature = "uniffi"))]
#[async_trait(?Send)]
pub trait DIDResolver {
    /// Resolves a DID document by the given DID.
    ///
    /// # Params
    /// - `did` a DID to be resolved.
    ///
    /// # Returns
    /// An instance of resolved DID DOC or None if DID is not found.
    ///
    /// # Errors
    /// - `IoError` IO error during resolving
    /// - `InvalidState` indicates a bug in resolver code
    async fn resolve(&self, did: &str) -> Result<Option<DIDDoc>>;
}