Struct ReputationAttestation 

pub struct ReputationAttestation {
    pub id: EventId,
    pub issuer: PublicKey,
    pub destination: PublicKey,
    pub subject: String,
    pub reviews: u32,
    pub rating_hundredths: u16,
    pub since: u64,
    pub created_at: u64,
    pub expiration: u64,
}

A parsed, verified reputation attestation.

Fields

id: EventId

Event id, which identifies the attestation.

issuer: PublicKey

Key the issuer signed with.

destination: PublicKey

Identity the attestation is addressed to (p).

subject: String

The source account, opaque and stable within the issuer.

reviews: u32

Ratings received on the source.

rating_hundredths: u16

Average of those ratings, in hundredths (487 is 4.87).

since: u64

First completed trade on the source, a UTC day start.

created_at: u64

When the issuer signed it.

expiration: u64

When it stops being redeemable.

Implementations

impl ReputationAttestation

pub fn rating(&self) -> f64

Average rating as a number, 4.87 for rating_hundredths == 487.

The division is correctly rounded, so this is the same double as parsing the decimal string the event carries.

pub fn rating_text(&self) -> String

Average rating as the event writes it, with two decimals.

pub fn build( issuer: &Keys, destination: &PublicKey, subject: &str, reviews: u32, average: f64, since: u64, created_at: Timestamp, lifetime: u64, ) -> Result<Event, AttestationError>

Sign an attestation with the issuer’s dedicated key.

average is the issuer’s internal average; it is rounded and clamped as rating_hundredths does. The arguments are checked against the rules a destination applies, so a successful build always parses. lifetime is at most ATTESTATION_LIFETIME_SECS, the default cap.

pub fn parse( event: &Event, now: Timestamp, max_lifetime: u64, ) -> Result<Self, AttestationError>

Parse and verify an attestation event.

Applies every rule of the event: id and signature, kind, z, each tag exactly once and in range, created_at no later than now plus the skew, expiration no earlier than now minus the skew, and a lifetime of at most max_lifetime seconds. The trust list, the receiver’s own issuer key and the identity match are the caller’s.

pub fn parse_json( json: &str, now: Timestamp, max_lifetime: u64, ) -> Result<(Self, Event), AttestationError>

ReputationAttestation::parse on the JSON serialisation an attestation travels in. Returns the event too, so a caller can keep exactly what it received.

Trait Implementations

impl Clone for ReputationAttestation

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReputationAttestation

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

Formats the value using the given formatter.

impl Eq for ReputationAttestation

impl From<&ReputationAttestation> for ReputationImport

fn from(a: &ReputationAttestation) -> Self

Converts to this type from the input type.

impl PartialEq for ReputationAttestation

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ReputationAttestation