Struct RendGuard 

pub struct RendGuard {
    pub use_counts: HashMap<String, RendUseCount>,
    pub total_use_counts: f64,
    pub pickle_revision: f64,
}

Rendezvous point usage tracking for detecting statistical attacks.

Tracks usage counts for all relays used as rendezvous points and detects when a relay is being used more than expected based on its bandwidth weight.

Fields

use_counts: HashMap<String, RendUseCount>

Usage counts per relay fingerprint.

total_use_counts: f64

Total usage count across all relays.

pickle_revision: f64

Version number for pickle compatibility.

Implementations

impl RendGuard

pub fn new() -> Self

Creates a new empty RendGuard.

pub fn scale_counts(&mut self)

Scales all usage counts by half.

Called when total_use_counts reaches the scale threshold to prevent unbounded growth and to avoid over-counting high-uptime relays.

pub fn valid_rend_use( &mut self, fingerprint: &str, config: &RendguardConfig, ) -> bool

Records a rendezvous point usage and checks for overuse.

This method should be called each time a relay is used as a rendezvous point for a hidden service circuit.

Arguments

• fingerprint - The relay’s fingerprint (40 hex characters)
• config - Rendguard configuration

Returns

true if the usage is valid (not overused), false if overused.

pub fn xfer_use_counts( &mut self, generator: &BwWeightedGenerator, config: &RendguardConfig, )

Transfers and updates use counts on consensus change.

This method should be called when a new consensus is received.

pub fn usage_rate(&self, fingerprint: &str) -> f64

Returns the usage rate for a relay as a percentage.

pub fn expected_weight(&self, fingerprint: &str) -> f64

Returns the expected weight for a relay as a percentage.

pub fn is_overused(&self, fingerprint: &str, config: &RendguardConfig) -> bool

Checks if a relay is currently overused.

Trait Implementations

impl Clone for RendGuard

fn clone(&self) -> RendGuard

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RendGuard

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

Formats the value using the given formatter.

impl Default for RendGuard

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RendGuard

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RendGuard

fn eq(&self, other: &RendGuard) -> 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 RendGuard

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 RendGuard