Struct IrohTransportBuilder 

pub struct IrohTransportBuilder { /* private fields */ }

Builder for configuring IrohTransport with different relay modes and options.

Examples

Production deployment (default)

use eidetica::sync::transports::iroh::IrohTransport;

let transport = IrohTransport::builder()
    .build()?;
// Uses n0's production relay servers by default

Local testing without internet

use eidetica::sync::transports::iroh::IrohTransport;
use iroh::RelayMode;

let transport = IrohTransport::builder()
    .relay_mode(RelayMode::Disabled)
    .build()?;
// Direct P2P only, no relay servers

Enterprise deployment with custom relay

use eidetica::sync::transports::iroh::IrohTransport;
use iroh::{RelayConfig, RelayMode, RelayMap, RelayUrl};

let relay_url: RelayUrl = "https://relay.example.com".parse()?;
let relay_config: RelayConfig = relay_url.into();
let transport = IrohTransport::builder()
    .relay_mode(RelayMode::Custom(RelayMap::from_iter([relay_config])))
    .build()?;

Implementations

impl IrohTransportBuilder

pub fn new() -> Self

Create a new builder with production defaults.

By default, uses RelayMode::Default which connects to n0’s production relay infrastructure for NAT traversal.

pub fn relay_mode(self, mode: RelayMode) -> Self

Set the relay mode for the transport.

Relay Modes

• RelayMode::Default - Use n0’s production relay servers (recommended)
• RelayMode::Staging - Use n0’s staging infrastructure for testing
• RelayMode::Disabled - No relay servers, direct P2P only (local testing)
• RelayMode::Custom(RelayMap) - Use custom relay servers (enterprise deployments)

Example

use eidetica::sync::transports::iroh::IrohTransport;
use iroh::RelayMode;

let transport = IrohTransport::builder()
    .relay_mode(RelayMode::Disabled)
    .build()?;

pub fn secret_key(self, key: SecretKey) -> Self

Set the secret key for persistent node identity.

When a secret key is provided, the node will have the same cryptographic identity (and thus the same address) across restarts. This is essential for maintaining stable peer connections.

If not set, a random secret key will be generated on each startup, resulting in a different node address each time.

Example

use eidetica::sync::transports::iroh::IrohTransport;
use iroh::SecretKey;
use rand::RngCore;

// Generate or load secret key from storage
let mut secret_bytes = [0u8; 32];
rand::rngs::OsRng.fill_bytes(&mut secret_bytes);
let secret_key = SecretKey::from_bytes(&secret_bytes);

let transport = IrohTransport::builder()
    .secret_key(secret_key)
    .build()?;

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

Build the IrohTransport with the configured options.

Returns a configured IrohTransport ready to be used with SyncEngine::enable_iroh_transport_with_config().

Trait Implementations

impl Clone for IrohTransportBuilder

fn clone(&self) -> IrohTransportBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IrohTransportBuilder

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

Formats the value using the given formatter.

impl Default for IrohTransportBuilder

fn default() -> Self

Returns the “default value” for a type.

impl TransportBuilder for IrohTransportBuilder

fn build<'async_trait>( self, persisted: Doc, ) -> Pin<Box<dyn Future<Output = Result<(Self::Transport, Option<Doc>)>> + Send + 'async_trait>>

where Self: 'async_trait,

Build the transport using persisted state for identity.

The secret key (node identity) is loaded from the persisted Doc. If no secret key exists, a new one is generated and the Doc is returned for persistence. Any secret_key set via the builder is ignored - persisted state takes precedence.

type Transport = IrohTransport

The transport type this builder creates.