Struct libp2p::identify::Config

#[non_exhaustive]
pub struct Config {
    pub protocol_version: String,
    pub local_public_key: PublicKey,
    pub agent_version: String,
    pub initial_delay: Duration,
    pub interval: Duration,
    pub push_listen_addr_updates: bool,
    pub cache_size: usize,
}

Configuration for the identify::Behaviour.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

protocol_version: String

Application-specific version of the protocol family used by the peer, e.g. ipfs/1.0.0 or polkadot/1.0.0.

local_public_key: PublicKey

The public key of the local node. To report on the wire.

agent_version: String

Name and version of the local peer implementation, similar to the User-Agent header in the HTTP protocol.

Defaults to rust-libp2p/<libp2p-identify-version>.

initial_delay: Duration

👎Deprecated: The initial_delay is no longer necessary and will be completely removed since a remote should be able to instantly answer to an identify request

The initial delay before the first identification request is sent to a remote on a newly established connection.

Defaults to 0ms.

interval: Duration

The interval at which identification requests are sent to the remote on established connections after the first request, i.e. the delay between identification requests.

Defaults to 5 minutes.

push_listen_addr_updates: bool

Whether new or expired listen addresses of the local node should trigger an active push of an identify message to all connected peers.

Enabling this option can result in connected peers being informed earlier about new or expired listen addresses of the local node, i.e. before the next periodic identify request with each peer.

Disabled by default.

cache_size: usize

How many entries of discovered peers to keep before we discard the least-recently used one.

Disabled by default.

Implementations

impl Config

pub fn new(protocol_version: String, local_public_key: PublicKey) -> Config

Creates a new configuration for the identify Behaviour that advertises the given protocol version and public key.

pub fn with_agent_version(self, v: String) -> Config

Configures the agent version sent to peers.

pub fn with_initial_delay(self, d: Duration) -> Config

👎Deprecated: The initial_delay is no longer necessary and will be completely removed since a remote should be able to instantly answer to an identify request thus also this setter will be removed

Configures the initial delay before the first identification request is sent on a newly established connection to a peer.

pub fn with_interval(self, d: Duration) -> Config

Configures the interval at which identification requests are sent to peers after the initial request.

pub fn with_push_listen_addr_updates(self, b: bool) -> Config

Configures whether new or expired listen addresses of the local node should trigger an active push of an identify message to all connected peers.

pub fn with_cache_size(self, cache_size: usize) -> Config

Configures the size of the LRU cache, caching addresses of discovered peers.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.