Struct Rating 

pub struct Rating {
    pub total_reviews: u64,
    pub total_rating: f64,
    pub last_rating: u8,
    pub max_rate: u8,
    pub min_rate: u8,
    pub since: Option<u64>,
}

User reputation snapshot, suitable for publishing as Nostr tags.

The fields are the same aggregates stored on crate::user::User, but typed for transport (unsigned integers for counts, u8 for rating values).

Fields

total_reviews: u64

Total number of ratings received.

total_rating: f64

Weighted rating average across all reviews.

last_rating: u8

Most recent rating, in the MIN_RATING..=MAX_RATING range.

max_rate: u8

Highest rating ever received.

min_rate: u8

Lowest rating ever received.

since: Option<u64>

Unix timestamp of the user’s first trade, truncated to the start of its UTC day, or None from a peer that does not publish it yet.

Supersedes the days count the daemon publishes alongside it. A day count is derived when the event is written, so it is stale on any event that sits on relays for a while, and it cannot be merged when reputation is imported from another venue; a date can be.

Day precision is deliberate rather than incidental. This value travels on every order of the same user, so a second-precision timestamp would be a fingerprint linking their trade pubkeys together.

Skipped when absent, so a Rating that never sets it serializes exactly as it did before this field existed. Always published truncated to its UTC day, in JSON and in tags, however it was set.

Implementations

impl Rating

pub fn new( total_reviews: u64, total_rating: f64, last_rating: u8, min_rate: u8, max_rate: u8, ) -> Self

Construct a new Rating from its individual components.

Leaves Rating::since unset; add it with Rating::with_since. The signature is deliberately unchanged so no caller has to move.

pub fn with_since(self, since: u64) -> Self

Attach the date of the user’s first trade.

since is truncated to the start of its UTC day with the same rule as day_truncate, so a caller that passes a raw timestamp cannot leak second precision.

pub fn from_json(json: &str) -> Result<Self, ServiceError>

Parse a Rating from its JSON representation.

Returns ServiceError::MessageSerializationError if json is not a valid serialization of this type.

pub fn as_json(&self) -> Result<String, ServiceError>

Serialize the rating to a JSON string.

pub fn to_tags(&self) -> Tags

Encode the rating as a set of Nostr tags, ready to attach to an event.

Returns a Tags value with one entry per numeric field plus a z marker tag identifying the payload as a rating. Encoding is infallible (nostr 0.45 Tag::custom takes string kind keys directly).

pub fn from_tags(tags: Tags) -> Result<Self, ServiceError>

Rebuild a Rating from a set of Nostr tags previously produced by Rating::to_tags.

Unknown tag keys are ignored so that the function keeps working if the server adds new metadata fields. Returns a ServiceError if a required key carries a non-parseable value.

Trait Implementations

impl Clone for Rating

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 Rating

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Rating

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Rating

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

where __S: Serializer,

Serialize this value into the given Serde serializer.