Struct libp2p_gossipsub::GossipsubConfig

pub struct GossipsubConfig {
    pub protocol_id: Cow<'static, [u8]>,
    pub history_length: usize,
    pub history_gossip: usize,
    pub mesh_n: usize,
    pub mesh_n_low: usize,
    pub mesh_n_high: usize,
    pub gossip_lazy: usize,
    pub heartbeat_initial_delay: Duration,
    pub heartbeat_interval: Duration,
    pub fanout_ttl: Duration,
    pub max_transmit_size: usize,
    pub hash_topics: bool,
    pub no_source_id: bool,
    pub manual_propagation: bool,
    pub message_id_fn: fn(_: &GossipsubMessage) -> MessageId,
}

Configuration parameters that define the performance of the gossipsub network.

Fields

protocol_id: Cow<'static, [u8]>

The protocol id to negotiate this protocol (default is /meshsub/1.0.0).

history_length: usize

Number of heartbeats to keep in the memcache (default is 5).

history_gossip: usize

Number of past heartbeats to gossip about (default is 3).

mesh_n: usize

Target number of peers for the mesh network (D in the spec, default is 6).

mesh_n_low: usize

Minimum number of peers in mesh network before adding more (D_lo in the spec, default is 4).

mesh_n_high: usize

Maximum number of peers in mesh network before removing some (D_high in the spec, default is 12).

gossip_lazy: usize

Number of peers to emit gossip to during a heartbeat (D_lazy in the spec, default is 6).

heartbeat_initial_delay: Duration

Initial delay in each heartbeat (default is 5 seconds).

heartbeat_interval: Duration

Time between each heartbeat (default is 1 second).

fanout_ttl: Duration

Time to live for fanout peers (default is 60 seconds).

max_transmit_size: usize

The maximum byte size for each gossip (default is 2048 bytes).

hash_topics: bool

Flag determining if gossipsub topics are hashed or sent as plain strings (default is false).

no_source_id: bool

When set, all published messages will have a 0 source PeerId (default is false).

manual_propagation: bool

When set to true, prevents automatic forwarding of all received messages. This setting allows a user to validate the messages before propagating them to their peers. If set to true, the user must manually call propagate_message() on the behaviour to forward message once validated (default is false).

message_id_fn: fn(_: &GossipsubMessage) -> MessageId

A user-defined function allowing the user to specify the message id of a gossipsub message. The default value is to concatenate the source peer id with a sequence number. Setting this parameter allows the user to address packets arbitrarily. One example is content based addressing, where this function may be set to hash(message). This would prevent messages of the same content from being duplicated.

The function takes a GossipsubMessage as input and outputs a String to be interpreted as the message id.

Trait Implementations

impl Clone for GossipsubConfig

fn clone(&self) -> GossipsubConfig

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for GossipsubConfig

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

Formats the value using the given formatter.

impl Default for GossipsubConfig

fn default() -> GossipsubConfig

Returns the "default value" for a type.