Struct tor_netdir::HsDirParams

pub struct HsDirParams { /* private fields */ }

Available on crate feature hs-common only.

Parameters for generating and using an HsDir ring.

These parameters are derived from the shared random values and time parameters in the consensus, and are used to determine the position of each HsDir within the ring.

Implementations

impl HsDirParams

pub fn time_period(&self) -> TimePeriod

Return the time period for which these parameters are valid.

The hs_blind_id for an onion service changes every time period: when uploading, callers should use this time period to determine which hs_blind_id’s descriptor should be sent to which directory.

pub fn start_of_shard_rand_period(&self) -> SystemTime

Return the starting time for the shared-random-value protocol that produced the SRV for this time period.

pub fn offset_within_srv_period( &self, when: SystemTime, ) -> Option<SrvPeriodOffset>

Available on crate feature hs-service only.

Return an opaque offset for when from the start of the shared-random-value protocol period corresponding to the SRV for this time period.

When uploading, callers should this offset to determine the revision counter for their descriptors.

Returns None if when is after the start of the SRV period.

Trait Implementations

impl Clone for HsDirParams

fn clone(&self) -> HsDirParams

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for HsDirParams

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

Formats the value using the given formatter.

impl PartialEq for HsDirParams

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for HsDirParams

impl StructuralPartialEq for HsDirParams