Struct IPDiversityConfig 

pub struct IPDiversityConfig {
    pub max_per_ip: Option<usize>,
    pub max_per_subnet: Option<usize>,
}

Configuration for IP diversity enforcement at two tiers: exact IP and subnet.

Limits are applied per-bucket and per-close-group (the K closest nodes to self), matching how geographic diversity is enforced. When a candidate would exceed a limit, it may still be admitted via swap-closer logic: if the candidate is closer (XOR distance) to self than the farthest same-subnet peer in the scope, that farther peer is evicted.

By default every limit is None, meaning the K-based defaults from DhtCoreEngine apply (fractions of the bucket size K). Setting an explicit Some(n) overrides the K-based default for that tier.

Fields

max_per_ip: Option<usize>

Override for max nodes sharing an exact IP address per bucket/close-group. When None, uses the default of 2.

max_per_subnet: Option<usize>

Override for max nodes in the same subnet (/24 IPv4, /48 IPv6). When None, uses the K-based default (~25% of bucket size).

Implementations

impl IPDiversityConfig

pub fn testnet() -> IPDiversityConfig

Create a testnet configuration with relaxed diversity requirements.

This is useful for testing environments like Digital Ocean where all nodes share the same ASN (AS14061). The relaxed limits allow many nodes from the same provider while still maintaining some diversity tracking.

Currently identical to permissive but kept as a separate constructor so testnet limits can diverge independently (e.g. allowing same-subnet but limiting per-IP) without changing local-dev callers.

Warning

This configuration should NEVER be used in production as it significantly weakens Sybil attack protection.

pub fn permissive() -> IPDiversityConfig

Create a permissive configuration that effectively disables diversity checks.

This is useful for local development and unit testing where all nodes run on localhost or the same machine.

pub fn validate(&self) -> Result<(), Error>

Validate IP diversity parameter safety constraints (Section 4 points 1-2).

Returns Err if any explicit limit is less than 1.

Trait Implementations

impl Clone for IPDiversityConfig

fn clone(&self) -> IPDiversityConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IPDiversityConfig

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

Formats the value using the given formatter.

impl Default for IPDiversityConfig

fn default() -> IPDiversityConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for IPDiversityConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<IPDiversityConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for IPDiversityConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.