Struct DTGCommon 

pub struct DTGCommon {
    pub context: Vec<String>,
    pub type_: Vec<String>,
    pub id: Option<String>,
    pub issuer: String,
    pub valid_from: DateTime<Utc>,
    pub valid_until: Option<DateTime<Utc>>,
    pub task_context: Option<String>,
    pub credential_subject: CredentialSubject,
    pub proof: Option<DataIntegrityProof>,
}

All DTG Credentials follow a common structure.

Fields

context: Vec<String>

JSON-LD links to contexts Must contain at least:

• https://www.w3.org/ns/credentials/v2
• https://firstperson.network/credentials/dtg/v1

type_: Vec<String>

Credential type identifiers Must contain at least: DTGCredential VerifiableCredential

id: Option<String>

OPTIONAL identifier for this specific credential, per the W3C VC Data Model.

When present it MUST be a single URL. A urn:uuid: URN is the usual choice for a credential with no dereferenceable home.

This is the handle a holder or verifier stores the credential under, so it is what makes re-delivery of the same credential idempotent and re-issuance of a different one recognisable as a renewal rather than a duplicate. A counterparty that keys credentials by id cannot accept one that has none — so issue with an id unless you know nobody on the other side needs it.

Set it before signing

A Data Integrity proof covers the credential minus its proof, which includes this property. Set it while building — DTGCredential::with_id — never after DTGCredential::sign, which would leave a document whose proof no longer verifies.

issuer: String

DID of the entity issuing this credential

valid_from: DateTime<Utc>

ISO 8601 format of when this credentials become valid from

valid_until: Option<DateTime<Utc>>

ISO 8601 format of when these credentials are valid to

task_context: Option<String>

Identifier (threadId) of the trust task exchange in which this credential was issued.

REQUIRED for DTGCredentialType::Witness credentials, OPTIONAL for all other DTG credential types. A DTG credential without a taskContext MUST be interpretable standing alone, independent of any exchange.

NOTE: A verifier MUST NOT interpret a taskContext-bearing credential as proof that the associated trust task completed unless the matching trust task outcome evidence is also present and verified.

credential_subject: CredentialSubject

The assertion between the entities involved

proof: Option<DataIntegrityProof>

Cryptographic proof of credential authenticity

Implementations

impl DTGCommon

pub fn signed(&self) -> bool

Has this credential been signed? Returns true if a proof exists NOTE: This does NOT validate the proof itself

pub fn id(&self) -> Option<&str>

This credential’s own identifier, if it has one. See DTGCommon::id.

pub fn issuer(&self) -> &str

Returns the issuer DID

pub fn subject(&self) -> &str

Returns the subject DID

pub fn valid_from(&self) -> DateTime<Utc>

The credential is valid from this timestamp

pub fn valid_until(&self) -> Option<DateTime<Utc>>

The credential is valid until this timestamp, if set

pub fn task_context(&self) -> Option<&str>

The threadId of the trust task exchange this credential was issued in, if set

Trait Implementations

impl Clone for DTGCommon

fn clone(&self) -> DTGCommon

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DTGCommon

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

Formats the value using the given formatter.

impl Default for DTGCommon

Helps ensure default starting point is correct

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DTGCommon

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DTGCommon

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<DTGCommon> for DTGCredential

Post deserialize setup of a CredentialSubject and CredntialType

type Error = DTGCredentialError

The type returned in the event of a conversion error.

fn try_from(value: DTGCommon) -> Result<Self, Self::Error>

Performs the conversion.