Struct DonationPermit 

pub struct DonationPermit { /* private fields */ }

A single redeemable donation permit.

This is the value sent, over an unauthenticated connection, to a donation endpoint. It is a bearer token: it does not bind to any particular request, so it must be transmitted over a confidential channel (e.g. TLS).

Implementations

impl DonationPermit

pub fn expiration(&self) -> Timestamp

The expiration after which this permit can no longer be redeemed.

pub fn spend_id(&self) -> &[u8]

The key a redeeming server should use to detect double-spends: the permit’s nonce.

The nonce uniquely identifies the permit and cannot be altered without invalidating the token (verification recomputes the attribute point from it), so a replayed permit produces the same key. The redeeming server must record this (scoped to expiration) and reject any permit whose key it has already seen.

pub fn verify( &self, now: Timestamp, key_pair: &DonationPermitDerivedKeyPair, ) -> Result<(), ZkGroupVerificationFailure>

Verifies that this permit was honestly issued for the current day under key_pair.

This does not enforce single use. The caller must additionally check spend_id against its spent set and record it on success.

Trait Implementations

impl Clone for DonationPermit

fn clone(&self) -> DonationPermit

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DonationPermit

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DonationPermit

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialDefault for DonationPermit

fn partial_default() -> Self

Returns a value that can be safely dropped or assigned over.

impl Serialize for DonationPermit

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

where __S: Serializer,

Serialize this value into the given Serde serializer.