Struct ProviderTrustRecord 

#[non_exhaustive]
pub struct ProviderTrustRecord {
    pub provider: PublicKey,
    pub action: ProviderTrustAction,
    pub scope: Option<Hash>,
    pub issuer: String,
    pub sequence: u64,
    pub issued_at: u64,
    pub expires_at: Option<u64>,
    pub reason: String,
    pub signature: Option<String>,
}

A signed provider reliability record in the local Web-of-Trust.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

provider: PublicKey

action: ProviderTrustAction

scope: Option<Hash>

issuer: String

sequence: u64

issued_at: u64

expires_at: Option<u64>

reason: String

signature: Option<String>

Implementations

impl ProviderTrustRecord

pub fn new( provider: PublicKey, action: ProviderTrustAction, scope: Option<Hash>, sequence: u64, expires_at: Option<u64>, reason: impl Into<String>, signing_key: &SigningKey, ) -> Result<Self>

Create and sign a provider trust record using the current time.

Errors

Returns an error if the record is invalid or signing fails.

pub fn new_with_time( provider: PublicKey, action: ProviderTrustAction, scope: Option<Hash>, sequence: u64, issued_at: u64, reason: impl Into<String>, signing_key: &SigningKey, ) -> Result<Self>

Create and sign a provider trust record with an explicit issue time.

Errors

Returns an error if the record is invalid or signing fails.

pub fn with_expiration( self, expires_at: Option<u64>, signing_key: &SigningKey, ) -> Result<Self>

Add or replace an expiration time and re-sign the record.

Errors

Returns an error when the expiration is invalid or signing fails.

pub fn sign(&mut self, signing_key: &SigningKey) -> Result<()>

Sign the record with its declared issuer.

Errors

Returns an error when the signing key does not match the issuer.

pub fn verify_signature(&self) -> Result<()>

Verify the cryptographic signature.

Errors

Returns an error when the record is malformed or unsigned.

pub fn verify(&self) -> Result<()>

Verify the signature and require the record to be active now.

Errors

Returns an error when the record is malformed, unsigned, or expired.

pub fn verify_at(&self, now: u64) -> Result<()>

Verify the signature and reject expired records.

Errors

Returns an error when the record is malformed, unsigned, or expired.

pub fn validate(&self) -> Result<()>

Validate non-cryptographic record fields.

Errors

Returns an error when an identity, sequence, reason, or timestamp is invalid.

pub fn to_bytes(&self) -> Result<Vec<u8>>

Encode the record as JSON.

Errors

Returns an error when the record is invalid or cannot be serialized.

pub fn from_bytes(bytes: impl AsRef<[u8]>) -> Result<Self>

Decode a record from JSON.

Errors

Returns an error when the bytes do not contain a valid record.

Trait Implementations

impl Clone for ProviderTrustRecord

fn clone(&self) -> ProviderTrustRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderTrustRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProviderTrustRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ProviderTrustRecord

impl PartialEq for ProviderTrustRecord

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ProviderTrustRecord

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ProviderTrustRecord