Struct PeerPow 

pub struct PeerPow {
    pub sponsor_id: Id,
    pub timestamp: TimeMillis,
    pub content_hash: Hash,
    pub salt: Salt,
    pub pow: Pow,
}

A proof-of-work token sponsored by a specific peer and bound to a specific request body.

PeerPow is the standard “I did work, and I did it for this request” credential. It fixes four things into the PoW input: the sponsor’s peer Id, the time the work was performed, a content_hash over the request body, and a Salt that the worker varied to find a solution. Pinning the content hash is what prevents an attacker from replaying a valid PoW against a different request — re-using the same salt against a new body would produce a different hash and fail verification.

PeerPow is worn by Peer itself (three of them: the initial identity PoW plus rolling day/month “best-effort” PoWs) and by every authenticated RPC (see crate::protocol::rpc). Because its inputs are canonical and verification is cheap, receivers can re-derive and compare the PoW without keeping state.

Fields

sponsor_id: Id

timestamp: TimeMillis

content_hash: Hash

salt: Salt

pow: Pow

Implementations

impl PeerPow

pub fn new( sponsor_id: Id, verification_key: &VerificationKeyBytes, pq_commitment_bytes: &PQCommitmentBytes, timestamp: TimeMillis, content_hash: Hash, salt: Salt, ) -> Result<PeerPow>

pub fn zero() -> Self

pub fn random() -> Self

pub fn verify( &self, verification_key: &VerificationKeyBytes, pq_commitment_bytes: &PQCommitmentBytes, ) -> Result<()>

pub fn pow_decayed_day(&self, current_time_millis: TimeMillis) -> f64

pub fn pow_decayed_month(&self, current_time_millis: TimeMillis) -> f64

pub fn pow( sponsor_id: &Id, verification_key: &VerificationKeyBytes, pq_commitment_bytes: &PQCommitmentBytes, timestamp: &TimeMillisBytes, hash: &Hash, salt: &Salt, ) -> Result<(Pow, Hash)>

pub fn own_pow( &self, verification_key: &VerificationKeyBytes, pq_commitment_bytes: &PQCommitmentBytes, ) -> Result<(Pow, Hash)>

Trait Implementations

impl Clone for PeerPow

fn clone(&self) -> PeerPow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PeerPow

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PeerPow

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for PeerPow

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

Formats the value using the given formatter.

impl PartialEq for PeerPow

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PeerPow

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 PeerPow