Struct DnsDiscovery 

pub struct DnsDiscovery { /* private fields */ }

Available on non-wasm_browser only.

DNS endpoint discovery

When asked to resolve a EndpointId, this service performs a lookup in the Domain Name System (DNS).

It uses the Endpoint’s DNS resolver to query for TXT records under the domain _iroh.<z32-endpoint-id>.<origin-domain>:

• _iroh: is the record name
• <z32-endpoint-id> is the EndpointId encoded in z-base-32 format
• <origin-domain> is the endpoint origin domain as set in DnsDiscovery::builder.

Each TXT record returned from the query is expected to contain a string in the format <name>=<value>. If a TXT record contains multiple character strings, they are concatenated first. The supported attributes are:

• relay=<url>: The URL of the home relay server of the endpoint

The DNS resolver defaults to using the nameservers configured on the host system, but can be changed with crate::endpoint::Builder::dns_resolver.

Implementations

impl DnsDiscovery

pub fn builder(origin_domain: String) -> DnsDiscoveryBuilder

Creates a DnsDiscoveryBuilder that implements IntoDiscovery.

pub fn n0_dns() -> DnsDiscoveryBuilder

Creates a new DNS discovery using the iroh.link domain.

This uses the N0_DNS_ENDPOINT_ORIGIN_PROD domain.

Usage during tests

For testing it is possible to use the N0_DNS_ENDPOINT_ORIGIN_STAGING domain with DnsDiscovery::builder. This would then use a hosted staging discovery service for testing purposes.

Trait Implementations

impl Debug for DnsDiscovery

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

Formats the value using the given formatter.

impl Discovery for DnsDiscovery

fn resolve( &self, endpoint_id: EndpointId, ) -> Option<BoxStream<Result<DiscoveryItem, DiscoveryError>>>

Resolves the DiscoveryItem for the given EndpointId.

fn publish(&self, _data: &EndpointData)

Publishes the given EndpointData to the discovery mechanism.