Struct ProtocolConfigBuilder 

pub struct ProtocolConfigBuilder { /* private fields */ }

Builder for ProtocolConfig with a fluent API.

Implementations

impl ProtocolConfigBuilder

pub fn new(app_id: impl Into<String>, profile: impl Into<String>) -> Self

Creates a new builder.

pub fn transport(self, config: TransportConfig) -> Self

Configures transports.

pub fn ble_enabled(self, enabled: bool) -> Self

Enables or disables BLE transport.

pub fn wifi_direct_enabled(self, enabled: bool) -> Self

Enables or disables Wi-Fi Direct transport.

pub fn internet_enabled(self, enabled: bool) -> Self

Enables or disables Internet transport.

pub fn nostr_enabled(self, enabled: bool) -> Self

Enables or disables Nostr relay transport.

pub fn nostr_sealing_enabled(self, enabled: bool) -> Self

Enables or disables sealing of outgoing Nostr frames (default on).

pub fn nostr_cold_contact_enabled(self, enabled: bool) -> Self

Enables or disables Nostr key-package publication and peer resolution (default on; see TransportConfig::nostr_cold_contact_enabled).

pub fn dors(self, config: DorsConfig) -> Self

Configures DORS (Dynamic Offline Relay Switch).

pub fn online_first(self, enabled: bool) -> Self

Enables online-first mode (prefer Internet when available).

pub fn relay(self, config: RelayConfig) -> Self

Configures relay management.

pub fn mesh_relay(self, config: MeshRelayConfig) -> Self

Configures how traffic is carried for other people.

pub fn path(self, config: PathConfig) -> Self

Configures path selection.

pub fn reliability(self, config: ReliabilityConfig) -> Self

Configures reliability layer.

pub fn initial_ttl(self, ttl: u8) -> Self

Sets the initial TTL for messages.

pub fn encryption(self, config: EncryptionConfig) -> Self

Configures encryption settings.

pub fn encryption_enabled(self, enabled: bool) -> Self

Enables or disables automatic encryption.

pub fn auto_key_exchange(self, enabled: bool) -> Self

Enables or disables automatic key exchange on peer discovery.

pub fn store_pending_messages(self, enabled: bool) -> Self

Enables or disables storing pending messages for later encryption.

pub fn require_encryption(self, required: bool) -> Self

Enables or disables strict encryption requirement.

pub fn pending_queue(self, config: PendingQueueConfig) -> Self

Configures pending encrypted message queue bounds and overflow behavior.

pub fn group(self, config: GroupConfig) -> Self

Configures group messaging settings.

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

Sets the maximum number of members allowed in a single group.

pub fn group_relay_enabled(self, enabled: bool) -> Self

Sets whether groups should attempt relay server registration.

pub fn group_relay_broadcast_enabled(self, enabled: bool) -> Self

Sets whether relay-synced groups may send via a single relay broadcast instead of per-member fan-out. See GroupConfig::relay_broadcast_enabled — on by default, but only ever taken against a relay that advertised the group_delivery_v3 capability, whose settled, address-space delivery report gives the broadcast a per-recipient delivery contract.

pub fn group_enforce_admin_commits(self, enabled: bool) -> Self

Sets whether unauthorized MLS membership commits are refused rather than applied-and-reported. See GroupConfig::enforce_admin_commits — off by default, and enabling it risks permanently forking members whose admin overlay disagrees.

pub fn security(self, config: SecurityConfig) -> Self

Configures security settings.

pub fn require_transport_identity(self, required: bool) -> Self

Sets whether transport identity is required for control messages.

pub fn build(self) -> Result<ProtocolConfig>

Builds and validates the configuration.

Returns

Returns Ok(ProtocolConfig) if valid, Err otherwise.