Trait StatusCheck 

pub trait StatusCheck: Send + Sync {
    // Required method
    fn check<'life0, 'life1, 'async_trait>(
        &'life0 self,
        status: CredentialStatus<'life1>,
        now: DateTime<Utc>,
    ) -> Pin<Box<dyn Future<Output = Result<(), StatusError>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait,
             'life1: 'async_trait;
}

Available on crate feature vc only.

Checks the status of a credential: fetches the status list, bitmap or registry an entry points to and reports whether the credential is still good.

One check serves both credential formats: the validators hand it every credentialStatus entry of a VCDM credential as CredentialStatus::Vcdm and the status claim of an SD-JWT credential, or of a JWT credential, as CredentialStatus::SdJwt (feature sd-jwt), so an application implements status checking once. A check that does not understand an entry reports StatusError::Unsupported, which the StatusPolicy decides about. StatusListCheck of sd_jwt_vc::validation (features sd-jwt and did-web) checks the Token Status List and reports every VCDM entry as unsupported.

Examples

A check that knows only the Token Status List, and only the list it was given:

use chrono::{DateTime, Utc};
use identity_kit::vc::validation::{CredentialStatus, StatusCheck, StatusError};

struct Revoked;

#[async_trait::async_trait]
impl StatusCheck for Revoked {
    async fn check(&self, status: CredentialStatus<'_>, _: DateTime<Utc>) -> Result<(), StatusError> {
        match status {
            #[cfg(feature = "sd-jwt")]
            CredentialStatus::SdJwt(status) if status.status_list.is_some() => {
                Err(StatusError::Invalid("revoked".to_owned()))
            }
            other => Err(StatusError::Unsupported(other.mechanism())),
        }
    }
}

Required Methods

fn check<'life0, 'life1, 'async_trait>( &'life0 self, status: CredentialStatus<'life1>, now: DateTime<Utc>, ) -> Pin<Box<dyn Future<Output = Result<(), StatusError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Checks status at the validation time now, against which a check judges what it fetched (the expiry of a status list token, for instance).

Errors

A StatusError: Unsupported for an entry or mechanism the check does not know, Unavailable when the status could not be obtained, Invalid when the credential is revoked or suspended.

Dyn Compatibility

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

impl<T: StatusCheck + ?Sized> StatusCheck for &T

fn check<'life0, 'life1, 'async_trait>( &'life0 self, status: CredentialStatus<'life1>, now: DateTime<Utc>, ) -> Pin<Box<dyn Future<Output = Result<(), StatusError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

impl<T: StatusCheck + ?Sized> StatusCheck for Arc<T>

fn check<'life0, 'life1, 'async_trait>( &'life0 self, status: CredentialStatus<'life1>, now: DateTime<Utc>, ) -> Pin<Box<dyn Future<Output = Result<(), StatusError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

impl<T: StatusCheck + ?Sized> StatusCheck for Box<T>

fn check<'life0, 'life1, 'async_trait>( &'life0 self, status: CredentialStatus<'life1>, now: DateTime<Utc>, ) -> Pin<Box<dyn Future<Output = Result<(), StatusError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Implementors

impl<C: HttpClient, R: KeyResolver, V: JwsVerifier> StatusCheck for StatusListCheck<C, R, V>

Available on crate feature sd-jwt only.