Struct FipsEndpointBuilder 

pub struct FipsEndpointBuilder { /* private fields */ }

Builder for an embedded FIPS endpoint.

Implementations

impl FipsEndpointBuilder

pub fn config(self, config: Config) -> Self

Start from an explicit FIPS config.

pub fn identity_nsec(self, nsec: impl Into<String>) -> Self

Use an nsec or hex secret for the endpoint identity.

pub fn discovery_scope(self, scope: impl Into<String>) -> Self

Set an application-level discovery scope.

When the builder owns the default empty connectivity config, this also enables scoped Nostr discovery, open same-scope peer discovery, local LAN candidates, host-wide loopback rendezvous, and a UDP NAT advert. If an explicit transport or Nostr config was supplied, the explicit config is left in control and the scope is retained as endpoint metadata; call Self::local_rendezvous to opt that endpoint into same-host composition.

pub fn local_rendezvous(self) -> Self

Enable host-wide authenticated loopback composition.

pub fn local_role(self, name: impl Into<String>, priority: i16) -> Self

Advertise a portless same-host role, such as nostr.pubsub/1. Empty, oversized, and excess names are ignored.

pub fn without_system_tun(self) -> Self

Disable FIPS-owned TUN and DNS system integration.

pub fn packet_channel_capacity(self, capacity: usize) -> Self

Set the app packet/data channel capacity.

pub async fn bind(self) -> Result<FipsEndpoint, FipsEndpointError>

Bind and start the embedded endpoint.

pub async fn bind_with_direct_receiver( self, ) -> Result<(FipsEndpoint, FipsEndpointDirectReceiver), FipsEndpointError>

Bind with a bounded receiver for direct dataplane endpoint packet runs.

pub async fn bind_with_direct_sink<S>( self, sink: S, ) -> Result<FipsEndpoint, FipsEndpointError>

where S: FipsEndpointDirectSink,

Bind and start the endpoint with a direct dataplane endpoint-data sink.

Decrypted dataplane endpoint output is delivered to sink synchronously from the dataplane output path. Generic endpoint events, including loopback sends and non-dataplane delivery, continue to use the regular receive queue.

Trait Implementations

impl Clone for FipsEndpointBuilder

fn clone(&self) -> FipsEndpointBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FipsEndpointBuilder

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

Formats the value using the given formatter.

impl Default for FipsEndpointBuilder

fn default() -> Self

Returns the “default value” for a type.