Struct JoinRateLimiter 

pub struct JoinRateLimiter { /* private fields */ }

Join rate limiter for Sybil attack protection

Implements multi-level rate limiting to prevent attackers from flooding the network with Sybil identities:

• Global limit: Protects against network-wide flooding attacks
• Per-subnet /64 limit: Prevents single residential/small org Sybil attacks
• Per-subnet /48 limit: Prevents coordinated attacks from larger organizations
• Per-subnet /24 limit: IPv4-specific protection

Example

use saorsa_core::rate_limit::{JoinRateLimiter, JoinRateLimiterConfig};
use std::net::IpAddr;

let limiter = JoinRateLimiter::new(JoinRateLimiterConfig::default());

let ip: IpAddr = "2001:db8::1".parse().unwrap();
match limiter.check_join_allowed(&ip) {
    Ok(()) => println!("Join allowed"),
    Err(e) => println!("Join denied: {}", e),
}

Implementations

impl JoinRateLimiter

pub fn new(config: JoinRateLimiterConfig) -> Self

Create a new join rate limiter with the given configuration

pub fn check_join_allowed(&self, ip: &IpAddr) -> Result<(), JoinRateLimitError>

Check if a join request from the given IP is allowed

Returns Ok(()) if the join is allowed, or Err(JoinRateLimitError) if any rate limit is exceeded.

Rate Limit Checks (in order)

1. Global rate limit (protects against network flooding)
2. Per-subnet limits based on IP version:
   • IPv6: /64 and /48 subnet limits
   • IPv4: /24 subnet limit

pub fn config(&self) -> &JoinRateLimiterConfig

Get the current configuration

Trait Implementations

impl Debug for JoinRateLimiter

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

Formats the value using the given formatter.