Struct NostrClientTransportConfig 

#[non_exhaustive]
pub struct NostrClientTransportConfig {
    pub relay_urls: Vec<String>,
    pub server_pubkey: String,
    pub encryption_mode: EncryptionMode,
    pub gift_wrap_mode: GiftWrapMode,
    pub is_stateless: bool,
    pub timeout: Duration,
    pub discovery_relay_urls: Option<Vec<String>>,
    pub fallback_operational_relay_urls: Option<Vec<String>>,
    pub oversized_transfer: OversizedTransferConfig,
    pub open_stream: OpenStreamConfig,
}

Configuration for the client transport.

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.

relay_urls: Vec<String>

Relay URLs to connect to.

server_pubkey: String

The server’s public key (hex, npub, or nprofile).

When an nprofile is provided, embedded relay hints are extracted and used during CEP-17 relay resolution.

encryption_mode: EncryptionMode

Encryption mode.

gift_wrap_mode: GiftWrapMode

Gift-wrap policy for encrypted messages.

is_stateless: bool

Stateless mode: emulate initialize response locally.

timeout: Duration

Correlation-retention TTL for pending client requests (default: 30s).

Stale pending entries older than this are swept from the correlation store. This prevents leaks – rmcp owns actual request timeout and cancellation. Keep this value above your rmcp request timeout to avoid premature cleanup.

discovery_relay_urls: Option<Vec<String>>

Relay URLs used for CEP-17 relay-list discovery when operational relays are not configured. Overrides DEFAULT_BOOTSTRAP_RELAY_URLS when provided.

fallback_operational_relay_urls: Option<Vec<String>>

Non-authoritative operational relays probed in parallel with CEP-17 discovery.

oversized_transfer: OversizedTransferConfig

CEP-22 oversized payload transfer configuration. Enabled by default.

open_stream: OpenStreamConfig

CEP-41 open-stream configuration. Disabled by default (opt-in).

When enabled, drives capability advertisement/learning, the inbound reader engine, the keepalive sweep, and call_tool_stream. Opt in with OpenStreamConfig::enabled() / with_enabled(true).

Implementations

impl NostrClientTransportConfig

pub fn with_server_pubkey(self, pubkey: impl Into<String>) -> Self

Set the server’s public key (hex, npub, or nprofile).

pub fn with_encryption_mode(self, mode: EncryptionMode) -> Self

Set the encryption mode.

pub fn with_gift_wrap_mode(self, mode: GiftWrapMode) -> Self

Set the gift-wrap mode (CEP-19).

pub fn with_stateless(self, stateless: bool) -> Self

Enable or disable stateless mode.

pub fn with_relay_urls(self, urls: Vec<String>) -> Self

Set the relay URLs to connect to.

pub fn with_timeout(self, timeout: Duration) -> Self

Set the correlation-retention TTL.

pub fn with_discovery_relay_urls(self, urls: Vec<String>) -> Self

Set relay URLs for CEP-17 relay-list discovery.

pub fn with_fallback_operational_relay_urls(self, urls: Vec<String>) -> Self

Set fallback operational relay URLs probed in parallel with discovery.

pub fn with_oversized_transfer(self, config: OversizedTransferConfig) -> Self

Set the full CEP-22 oversized payload transfer configuration.

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

Enable or disable CEP-22 oversized payload transfer, leaving other knobs at default.

pub fn with_open_stream(self, config: OpenStreamConfig) -> Self

Set the full CEP-41 open-stream configuration (disabled by default; opt in with OpenStreamConfig::enabled()).

Trait Implementations

impl Clone for NostrClientTransportConfig

fn clone(&self) -> NostrClientTransportConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NostrClientTransportConfig

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

Formats the value using the given formatter.

impl Default for NostrClientTransportConfig

fn default() -> Self

Returns the “default value” for a type.