Struct PresetBuilder 

pub struct PresetBuilder { /* private fields */ }

Fluent builder for IrohServicesPreset. Construct one through preset or IrohServicesPreset::builder.

Implementations

impl PresetBuilder

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

Set the endpoint’s long-lived [SecretKey]. If left unset the endpoint will generate a fresh random key at bind time.

pub fn relays<I, S>(self, relays: I) -> Result<Self>

where I: IntoIterator<Item = S>, S: AsRef<str>,

Set relay URLs. This method accepts any iterator of &str, allowing the common pattern:

fn build() -> anyhow::Result<()> {
    let _preset = iroh_services::preset()
        .relays([
            "https://us-east1.project_username.iroh.link",
            "https://eu-west1.project_username.iroh.link",
            "https://eu-central1.project_username.iroh.link",
        ])?
        .api_secret_from_env()?
        .build()?;
    Ok(())
}

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

Pick relays via a [RelayMode] (e.g. RelayMode::Staging or a pre-built RelayMode::Custom(RelayMap)).

pub fn relay_map(self, map: RelayMap) -> Self

Pass in a [RelayMap] directly, bypassing URL parsing.

pub fn api_secret_from_env(self) -> Result<Self>

Check IROH_SERVICES_API_SECRET environment variable for a valid API secret

pub fn api_secret_from_str(self, secret_key: &str) -> Result<Self>

set client API secret from an encoded string

pub fn api_secret(self, api_secret: ApiSecret) -> Self

Stash an ApiSecret on the preset so callers can retrieve it later via IrohServicesPreset::api_secret when constructing a client.

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

Finalize the configuration into an IrohServicesPreset.

Trait Implementations

impl Clone for PresetBuilder

fn clone(&self) -> PresetBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PresetBuilder

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

Formats the value using the given formatter.