Struct DhtConfig 

pub struct DhtConfig {
    pub k: usize,
    pub alpha: usize,
    pub provider_ttl: Duration,
    pub republish_interval: Duration,
    pub refresh_interval: Duration,
    pub rpc_timeout: Duration,
    pub provider_store_limits: ProviderStoreLimits,
}

Kademlia parameters for a DhtService.

The defaults follow the canonical Kademlia paper (k = 20, α = 3) and typical provider-record lifetimes; every field is documented so a node operator can tune replication vs. traffic.

Fields

k: usize

Replication parameter k — the bucket size and the number of closest peers a lookup converges on. A provider record is announced to (and a find_node returns) up to k peers. Larger k = more redundancy against churn, more traffic. Canonical default: 20.

alpha: usize

Lookup parallelism α — how many peers an iterative lookup queries concurrently per round. Larger α = faster convergence, more in-flight traffic. Canonical default: 3.

provider_ttl: Duration

Provider-record TTL — how long a PUT provider record is considered valid. A holder republishes before this elapses; a finder discards records older than this. Default: 2 hours.

This is also the clamp ceiling for inbound add_provider records (SPEC §6.2, §14): a responder never stores a third-party expires_at further in the future than now + provider_ttl, so a malicious record can never outlive local GC indefinitely.

republish_interval: Duration

Republish interval — how often the holder re-announces the content it still holds, so its provider records never expire while it is online. MUST be shorter than Self::provider_ttl. Default: 1 hour.

refresh_interval: Duration

Bucket-refresh interval — how often a bucket with no recent activity is refreshed by looking up a random key that falls in it, keeping the routing table populated. Default: 1 hour.

rpc_timeout: Duration

Per-RPC timeout — how long a single request to one peer may take before that peer is treated as unresponsive and the lookup moves on. Default: 5 seconds.

provider_store_limits: ProviderStoreLimits

Provider-store admission-control caps — the per-content-key and global record limits enforced on every inbound add_provider (SPEC §6.3, §14). Bounds worst-case memory growth from a single peer (or a small set of colluding peers) flooding announces. Default: ProviderStoreLimits::default.

Implementations

impl DhtConfig

pub fn provider_ttl_secs(&self) -> u64

The provider TTL in whole seconds (records store an absolute Unix-seconds expiry).

Trait Implementations

impl Clone for DhtConfig

fn clone(&self) -> DhtConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DhtConfig

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

Formats the value using the given formatter.

impl Default for DhtConfig

fn default() -> Self

Returns the “default value” for a type.