Struct CoreDocument

pub struct CoreDocument { /* private fields */ }

A DID Document.

Specification

Implementations

impl CoreDocument

pub fn builder(properties: Object) -> DocumentBuilder

Creates a DocumentBuilder to configure a new CoreDocument.

This is the same as DocumentBuilder::new.

pub fn from_builder(builder: DocumentBuilder) -> Result<Self>

Returns a new CoreDocument based on the DocumentBuilder configuration.

pub fn id(&self) -> &CoreDID

Returns a reference to the CoreDocument id.

pub fn id_mut_unchecked(&mut self) -> &mut CoreDID

Returns a mutable reference to the CoreDocument id.

Warning

Changes to the identifier can drastically alter the results of Self::resolve_method, Self::resolve_service and the related DID URL dereferencing algorithm.

pub fn controller(&self) -> Option<&OneOrSet<CoreDID>>

Returns a reference to the CoreDocument controller.

pub fn controller_mut(&mut self) -> &mut Option<OneOrSet<CoreDID>>

Returns a mutable reference to the CoreDocument controller.

pub fn also_known_as(&self) -> &OrderedSet<Url>

Returns a reference to the CoreDocument alsoKnownAs set.

pub fn also_known_as_mut(&mut self) -> &mut OrderedSet<Url>

Returns a mutable reference to the CoreDocument alsoKnownAs set.

pub fn verification_method(&self) -> &OrderedSet<VerificationMethod>

Returns a reference to the CoreDocument verificationMethod set.

pub fn authentication(&self) -> &OrderedSet<MethodRef>

Returns a reference to the CoreDocument authentication set.

pub fn assertion_method(&self) -> &OrderedSet<MethodRef>

Returns a reference to the CoreDocument assertionMethod set.

pub fn key_agreement(&self) -> &OrderedSet<MethodRef>

Returns a reference to the CoreDocument keyAgreement set.

pub fn capability_delegation(&self) -> &OrderedSet<MethodRef>

Returns a reference to the CoreDocument capabilityDelegation set.

pub fn capability_invocation(&self) -> &OrderedSet<MethodRef>

Returns a reference to the CoreDocument capabilityInvocation set.

pub fn service(&self) -> &OrderedSet<Service>

Returns a reference to the CoreDocument service set.

pub fn service_mut_unchecked(&mut self) -> &mut OrderedSet<Service>

Warning

Changing a service’s identifier can drastically alter the results of Self::resolve_service and the related DID URL dereferencing algorithm.

pub fn properties(&self) -> &Object

Returns a reference to the custom CoreDocument properties.

pub fn properties_mut_unchecked(&mut self) -> &mut Object

Returns a mutable reference to the custom CoreDocument properties.

Warning

The properties returned are not checked against the standard fields in a CoreDocument. Incautious use can have undesired consequences such as key collision when attempting to serialize the document or distinct resources (such as services and methods) being identified by the same DID URL.

pub fn insert_method( &mut self, method: VerificationMethod, scope: MethodScope, ) -> Result<()>

Adds a new [VerificationMethod] to the document in the given [MethodScope].

Errors

Returns an error if a method or service with the same fragment already exists.

pub fn remove_method(&mut self, did_url: &DIDUrl) -> Option<VerificationMethod>

Removes and returns the [VerificationMethod] identified by did_url from the document.

Note

All references to the method found in the document will be removed. This includes cases where the reference is to a method contained in another DID document.

pub fn remove_method_and_scope( &mut self, did_url: &DIDUrl, ) -> Option<(VerificationMethod, MethodScope)>

Removes and returns the [VerificationMethod] from the document. The [MethodScope] under which the method was found is appended to the second position of the returned tuple.

Note

All references to the method found in the document will be removed. This includes cases where the reference is to a method contained in another DID document.

pub fn insert_service(&mut self, service: Service) -> Result<()>

Adds a new Service to the document.

Errors

Returns an error if there already exists a service or verification method with the same identifier.

pub fn remove_service(&mut self, id: &DIDUrl) -> Option<Service>

Removes and returns a Service from the document if it exists.

pub fn attach_method_relationship<'query, Q>( &mut self, method_query: Q, relationship: MethodRelationship, ) -> Result<bool>

where Q: Into<DIDUrlQuery<'query>>,

Attaches the relationship to the method resolved by method_query.

Errors

Returns an error if the method does not exist or if it is embedded. To convert an embedded method into a generic verification method, remove it first and insert it with [MethodScope::VerificationMethod].

pub fn detach_method_relationship<'query, Q>( &mut self, method_query: Q, relationship: MethodRelationship, ) -> Result<bool>

where Q: Into<DIDUrlQuery<'query>>,

Detaches the relationship from the method resolved by method_query. Returns true if the relationship was found and removed, false otherwise.

Errors

Returns an error if the method does not exist or is embedded. To remove an embedded method, use Self::remove_method.

Note

If the method is referenced in the given scope, but the document does not contain the referenced verification method, then the reference will persist in the document (i.e. it is not removed).

pub fn methods(&self, scope: Option<MethodScope>) -> Vec<&VerificationMethod>

Returns a Vec of verification method references whose verification relationship matches scope.

If scope is None, an iterator over all embedded methods is returned.

pub fn verification_relationships(&self) -> impl Iterator<Item = &MethodRef>

Returns an iterator over all verification relationships.

This includes embedded and referenced VerificationMethods.

pub fn resolve_method<'query, 'me, Q>( &'me self, method_query: Q, scope: Option<MethodScope>, ) -> Option<&'me VerificationMethod>

where Q: Into<DIDUrlQuery<'query>>,

Returns the first [VerificationMethod] with an id property matching the provided method_query and the verification relationship specified by scope if present.

pub fn resolve_method_mut<'query, 'me, Q>( &'me mut self, method_query: Q, scope: Option<MethodScope>, ) -> Option<&'me mut VerificationMethod>

where Q: Into<DIDUrlQuery<'query>>,

Returns a mutable reference to the first [VerificationMethod] with an id property matching the provided method_query.

Warning

Incorrect use of this method can lead to distinct document resources being identified by the same DID URL.

pub fn resolve_service<'query, 'me, Q>( &'me self, service_query: Q, ) -> Option<&'me Service>

where Q: Into<DIDUrlQuery<'query>>,

Returns the first Service with an id property matching the provided service_query, if present.

pub fn try_map<F, G, H, L, M, E>( self, id_update: F, controller_update: G, methods_update: H, service_update: L, error_cast: M, ) -> Result<Self, E>

where F: FnOnce(CoreDID) -> Result<CoreDID, E>, G: FnMut(CoreDID) -> Result<CoreDID, E>, H: FnMut(CoreDID) -> Result<CoreDID, E>, L: FnMut(CoreDID) -> Result<CoreDID, E>, M: FnOnce(Error) -> E,

Update the DID components of the document’s id, controllers, methods and services by applying the provided fallible maps.

This is an advanced method that can be useful for DID methods that do not know the document’s identifier prior to publishing, but should preferably be avoided otherwise.

Errors

Any error is returned if any of the functions fail or the updates cause scoped method references to embedded methods, or methods and services with identical identifiers in the document. In the case where illegal identifiers are detected the supplied the error_cast function gets called in order to convert Error to E.

pub fn map_unchecked<F, G, H, L>( self, id_update: F, controller_update: G, methods_update: H, service_update: L, ) -> Self

where F: FnOnce(CoreDID) -> CoreDID, G: FnMut(CoreDID) -> CoreDID, H: FnMut(CoreDID) -> CoreDID, L: FnMut(CoreDID) -> CoreDID,

Unchecked version of Self::try_map.

impl CoreDocument

pub fn verify_jws<'jws, T: JwsVerifier>( &self, jws: &'jws str, detached_payload: Option<&'jws [u8]>, signature_verifier: &T, options: &JwsVerificationOptions, ) -> Result<DecodedJws<'jws>>

Decodes and verifies the provided JWS according to the passed JwsVerificationOptions and [JwsVerifier].

Regardless of which options are passed the following conditions must be met in order for a verification attempt to take place.

• The JWS must be encoded according to the JWS compact serialization.
• The kid value in the protected header must be an identifier of a verification method in this DID document, or set explicitly in the options.

pub fn verify_jws_hybrid<'jws, TRV: JwsVerifier, PQV: JwsVerifier>( &self, jws: &'jws str, detached_payload: Option<&'jws [u8]>, traditional_verifier: &TRV, pq_verifier: &PQV, options: &JwsVerificationOptions, ) -> Result<DecodedJws<'jws>>

Decodes and verifies the provided PQ/T JWS according to the passed JwsVerificationOptions with a traditional [JwsVerifier] and PQ [JwsVerifier].

Regardless of which options are passed the following conditions must be met in order for a verification attempt to take place.

• The JWS must be encoded according to the JWS compact serialization.
• The kid value in the protected header must be an identifier of a verification method in this DID document, or set explicitly in the options.

impl CoreDocument

pub fn expand_did_jwk(did_jwk: DIDJwk) -> Result<Self, Error>

Creates a CoreDocument from a did:jwk DID.

impl CoreDocument

pub fn expand_did_compositejwk( did_compositejwk: DIDCompositeJwk, ) -> Result<Self, Error>

Creates a CoreDocument from a did:compositejwk DID.

Trait Implementations

impl AsRef<CoreDocument> for CoreDocument

fn as_ref(&self) -> &CoreDocument

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for CoreDocument

fn clone(&self) -> CoreDocument

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CoreDocument

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CoreDocument

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for CoreDocument

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for CoreDocument

fn eq(&self, other: &CoreDocument) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CoreDocument

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for CoreDocument

impl StructuralPartialEq for CoreDocument