Struct identity_iota::client::PresentationValidator

#[non_exhaustive]
pub struct PresentationValidator;

A struct for validating Presentations.

Implementations

impl PresentationValidator

pub fn validate<U, V, D>(
    presentation: &Presentation<U, V>,
    holder: &D,
    issuers: &[D],
    options: &PresentationValidationOptions,
    fail_fast: FailFast
) -> Result<(), CompoundPresentationValidationError> where
    U: Serialize,
    V: Serialize,
    D: AsRef<IotaDocument>, 

Validate a Presentation.

The following properties are validated according to options:

• the semantic structure of the presentation,
• the holder’s signature,
• the relationship between the holder and the credential subjects,
• the signatures and some properties of the constituent credentials (see CredentialValidator::validate).

Warning

The lack of an error returned from this method is in of itself not enough to conclude that the presentation can be trusted. This section contains more information on additional checks that should be carried out before and after calling this method.

The state of the supplied DID Documents.

The caller must ensure that the DID Documents in holder and issuers are up-to-date. The convenience methods Resolver::resolve_presentation_holder and Resolver::resolve_presentation_issuers can help extract the latest available states of these DID Documents.

Properties that are not validated

There are many properties defined in The Verifiable Credentials Data Model that are not validated, such as: credentialStatus, type, credentialSchema, refreshService, and more. These should be manually checked after validation, according to your requirements.

Errors

An error is returned whenever a validated condition is not satisfied.

pub fn verify_presentation_signature<U, V, D>(
    presentation: &Presentation<U, V>,
    holder: &D,
    options: &VerifierOptions
) -> Result<(), ValidationError> where
    U: Serialize,
    V: Serialize,
    D: AsRef<IotaDocument>, 

Verify the presentation’s signature using the resolved document of the holder.

Warning

The caller must ensure that the DID Document of the holder is up-to-date.

Errors

Fails if the holder does not match the presentation’s holder property. Fails if signature verification against the holder document fails.

pub fn check_structure<U, V>(
    presentation: &Presentation<U, V>
) -> Result<(), ValidationError>

Validates the semantic structure of the Presentation.

Trait Implementations

impl Clone for PresentationValidator

fn clone(&self) -> PresentationValidator

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PresentationValidator

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

Formats the value using the given formatter.