Struct VanguardsConfig 

pub struct VanguardsConfig {
    pub num_layer1_guards: u8,
    pub num_layer2_guards: u8,
    pub num_layer3_guards: u8,
    pub layer1_lifetime_days: u16,
    pub min_layer2_lifetime_hours: u32,
    pub max_layer2_lifetime_hours: u32,
    pub min_layer3_lifetime_hours: u32,
    pub max_layer3_lifetime_hours: u32,
}

Vanguard-specific configuration options.

Controls the number of guards at each layer and their rotation lifetimes. These settings directly affect the security/performance tradeoff of vanguard protection.

Guard Layers

┌─────────────────────────────────────────────────────────────────┐
│                    Vanguard Guard Layers                        │
└─────────────────────────────────────────────────────────────────┘

  Client ──▶ Layer1 ──▶ Layer2 ──▶ Layer3 ──▶ Rendezvous Point
             (Entry)    (Middle)   (Middle)

  Layer1: Entry guards (managed by Tor, configurable count)
  Layer2: First vanguard layer (longer lifetime: 1-45 days)
  Layer3: Second vanguard layer (shorter lifetime: 1-48 hours)

Fields

Field	Default	Description
num_layer1_guards	2	Entry guards (0 = Tor default)
num_layer2_guards	4	Layer2 vanguard count
num_layer3_guards	8	Layer3 vanguard count
layer1_lifetime_days	0	Entry guard lifetime (0 = Tor default)
min_layer2_lifetime_hours	24	Minimum layer2 lifetime
max_layer2_lifetime_hours	1080	Maximum layer2 lifetime (45 days)
min_layer3_lifetime_hours	1	Minimum layer3 lifetime
max_layer3_lifetime_hours	48	Maximum layer3 lifetime

Security Considerations

• More guards = Better anonymity but more exposure to malicious relays
• Longer lifetimes = Better protection against guard discovery but slower recovery from compromise
• Shorter lifetimes = Faster recovery but more vulnerable to timing attacks

Example

use vanguards_rs::VanguardsConfig;

let mut config = VanguardsConfig::default();

// Increase guard counts for higher security
config.num_layer2_guards = 6;
config.num_layer3_guards = 12;

// Extend layer2 lifetime for better protection
config.max_layer2_lifetime_hours = 2160; // 90 days

See Also

• Config - Main configuration struct
• VanguardState - Runtime guard state

Fields

num_layer1_guards: u8

Number of layer1 (entry) guards. 0 means use Tor default.

num_layer2_guards: u8

Number of layer2 guards.

num_layer3_guards: u8

Number of layer3 guards.

layer1_lifetime_days: u16

Layer1 guard lifetime in days. 0 means use Tor default.

min_layer2_lifetime_hours: u32

Minimum layer2 guard lifetime in hours.

max_layer2_lifetime_hours: u32

Maximum layer2 guard lifetime in hours.

min_layer3_lifetime_hours: u32

Minimum layer3 guard lifetime in hours.

max_layer3_lifetime_hours: u32

Maximum layer3 guard lifetime in hours.

Trait Implementations

impl Clone for VanguardsConfig

fn clone(&self) -> VanguardsConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VanguardsConfig

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

Formats the value using the given formatter.

impl Default for VanguardsConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for VanguardsConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for VanguardsConfig

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

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 VanguardsConfig