Struct HiveMeshConfig 

pub struct HiveMeshConfig {

    pub node_id: NodeId,
    pub callsign: String,
    pub mesh_id: String,
    pub peripheral_type: PeripheralType,
    pub peer_config: PeerManagerConfig,
    pub sync_interval_ms: u64,
    pub auto_broadcast_events: bool,
    pub encryption_secret: Option<[u8; 32]>,
    pub strict_encryption: bool,
    pub enable_relay: bool,
    pub max_relay_hops: u8,
    pub relay_fanout: usize,
    pub seen_cache_ttl_ms: u64,
}

Configuration for HiveMesh

Fields

node_id: NodeId

Our node ID

callsign: String

Our callsign (e.g., “ALPHA-1”)

mesh_id: String

Mesh ID to filter peers (e.g., “DEMO”)

peripheral_type: PeripheralType

Peripheral type for this device

peer_config: PeerManagerConfig

Peer management configuration

sync_interval_ms: u64

Sync interval in milliseconds (how often to broadcast state)

auto_broadcast_events: bool

Whether to auto-broadcast on emergency/ack

encryption_secret: Option<[u8; 32]>

Optional shared secret for mesh-wide encryption (32 bytes)

When set, all documents are encrypted using ChaCha20-Poly1305 before transmission and decrypted upon receipt. All nodes in the mesh must share the same secret to communicate.

strict_encryption: bool

Strict encryption mode - reject unencrypted documents when encryption is enabled

When true and encryption is enabled, any unencrypted documents received will be rejected and trigger a SecurityViolation event. This prevents downgrade attacks where an adversary sends unencrypted malicious documents.

Default: false (backward compatible - accepts unencrypted for gradual rollout)

enable_relay: bool

Enable multi-hop relay

When enabled, received messages will be forwarded to other peers based on the gossip strategy. Requires message deduplication to prevent loops.

Default: false

max_relay_hops: u8

Maximum hops for relay messages (TTL)

Messages will not be relayed beyond this many hops from the origin. Default: 7

relay_fanout: usize

Gossip fanout for relay

Number of peers to forward each message to. Higher values increase convergence speed but also bandwidth usage. Default: 2

seen_cache_ttl_ms: u64

TTL for seen message cache (milliseconds)

How long to remember message IDs for deduplication. Default: 300_000 (5 minutes)

Implementations

impl HiveMeshConfig

pub fn new(node_id: NodeId, callsign: &str, mesh_id: &str) -> Self

Create a new configuration with required fields

pub fn with_encryption(self, secret: [u8; 32]) -> Self

Enable mesh-wide encryption with a shared secret

All documents will be encrypted using ChaCha20-Poly1305 before transmission. All mesh participants must use the same secret.

pub fn with_peripheral_type(self, ptype: PeripheralType) -> Self

Set peripheral type

pub fn with_sync_interval(self, interval_ms: u64) -> Self

Set sync interval

pub fn with_peer_timeout(self, timeout_ms: u64) -> Self

Set peer timeout

pub fn with_max_peers(self, max: usize) -> Self

Set max peers (for embedded systems)

pub fn with_strict_encryption(self) -> Self

Enable strict encryption mode

When enabled (and encryption is also enabled), any unencrypted documents received will be rejected and trigger a SecurityViolation event. This prevents downgrade attacks.

Note: This only has effect when encryption is enabled via with_encryption().

pub fn with_relay(self) -> Self

Enable multi-hop relay

When enabled, received messages will be forwarded to other connected peers based on the gossip strategy. This enables mesh-wide message propagation.

pub fn with_max_relay_hops(self, max_hops: u8) -> Self

Set maximum relay hops (TTL)

Messages will not be relayed beyond this many hops from the origin.

pub fn with_relay_fanout(self, fanout: usize) -> Self

Set gossip fanout for relay

Number of peers to forward each message to.

pub fn with_seen_cache_ttl(self, ttl_ms: u64) -> Self

Set TTL for seen message cache

How long to remember message IDs for deduplication (milliseconds).

Trait Implementations

impl Clone for HiveMeshConfig

fn clone(&self) -> HiveMeshConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HiveMeshConfig

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

Formats the value using the given formatter.