identity_iota_core/did_resolution/
did_resolution_handler.rs

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
// Copyright 2020-2023 IOTA Stiftung
// SPDX-License-Identifier: Apache-2.0

use crate::rebased::client::IdentityClientReadOnly;
use crate::Error;
use crate::IotaDID;
use crate::IotaDocument;
use crate::Result;

/// An extension trait that provides helper functions for publication
/// and resolution of DID documents in identities.
///
/// This trait is not intended to be implemented directly, a blanket implementation is
/// provided for [`IotaIdentityClient`] implementers.
#[cfg_attr(feature = "send-sync-client-ext", async_trait::async_trait)]
#[cfg_attr(not(feature = "send-sync-client-ext"), async_trait::async_trait(?Send))]
pub trait DidResolutionHandler {
  /// Resolve a [`IotaDocument`]. Returns an empty, deactivated document if the state metadata
  /// of the identity is empty.
  ///
  /// # Errors
  ///
  /// - [`DID resolution failed`](Error::DIDResolutionError) if the DID could not be resolved.
  async fn resolve_did(&self, did: &IotaDID) -> Result<IotaDocument>;
}

#[cfg_attr(feature = "send-sync-client-ext", async_trait::async_trait)]
#[cfg_attr(not(feature = "send-sync-client-ext"), async_trait::async_trait(?Send))]
impl DidResolutionHandler for IdentityClientReadOnly {
  async fn resolve_did(&self, did: &IotaDID) -> Result<IotaDocument> {
    self
      .resolve_did(did)
      .await
      .map_err(|err| Error::DIDResolutionError(err.to_string()))
  }
}