Struct RelayManager 

pub struct RelayManager { /* private fields */ }

Relay manager for promotion and demotion logic.

Implementations

impl RelayManager

pub fn new() -> Self

Creates a new relay manager with default configuration.

pub fn with_config(config: RelayConfig) -> Self

Creates a new relay manager with custom configuration.

pub fn should_promote_to_relay( &self, connection_count: usize, battery_level: u8, is_charging: bool, ) -> bool

Checks if this device should be promoted to relay role.

Arguments

• connection_count - Number of active connections
• battery_level - Current battery level (0-100)
• is_charging - Whether the device is charging

Returns

Returns true if the device should become a relay.

pub fn should_demote_from_relay( &self, connection_count: usize, battery_level: u8, is_charging: bool, ) -> bool

Checks if this device should be demoted from relay role.

Arguments

• connection_count - Number of active connections
• battery_level - Current battery level (0-100)
• is_charging - Whether the device is charging

Returns

Returns true if the device should stop being a relay.

pub fn evaluate_transition( &mut self, connection_count: usize, battery_level: u8, is_charging: bool, ) -> Option<RelayTransition>

Evaluates whether the relay role should change and, if so, applies the change and returns the transition that occurred.

This is the single entry point that mutates RelayRole: it compares the promote/demote decision against the current role and only returns Some when the role actually flips, so callers can emit a role-change event exactly once per transition. A stable role returns None.

pub fn calculate_relay_score(&self, relay: &RelayInfo) -> f32

Calculates a score for a potential relay.

Higher score = better relay candidate.

pub fn select_best_relays( &self, candidates: Vec<RelayInfo>, count: usize, max_congestion_level: f32, ) -> Vec<RelayInfo>

Selects the best relays from a list of candidates.

Arguments

• candidates - List of potential relays
• count - Number of relays to select
• max_congestion_level - Congestion level (0.0-1.0) at or above which a candidate is considered overloaded and excluded; pass the caller’s path policy (e.g. PathConfig::max_congestion_level)

Returns

Returns up to count relay candidates, sorted by score (best first).

pub fn current_role(&self) -> RelayRole

Gets the current relay role.

pub fn set_role(&mut self, role: RelayRole)

Sets the current relay role.

pub fn config(&self) -> &RelayConfig

Gets the relay configuration.

Trait Implementations

impl Default for RelayManager

fn default() -> Self

Returns the “default value” for a type.