Struct PkarrResolver

pub struct PkarrResolver { /* private fields */ }

Resolver of node discovery information from a pkarr relay.

The resolver uses HTTP to query node discovery information from a pkarr relay server, see the module docs for details.

This implements the Discovery trait to be used as a node discovery service. Note that it only resolves node discovery information, for the corresponding publisher use the PkarrPublisher together with ConcurrentDiscovery.

Implementations

impl PkarrResolver

pub fn new(pkarr_relay: Url) -> Self

Creates a new publisher using the pkarr relay server at the URL.

pub fn n0_dns() -> Self

Creates a pkarr resolver which uses the number 0 pkarr relay server.

This uses the pkarr relay server operated by number 0 at N0_DNS_PKARR_RELAY_PROD.

When running with the environment variable IROH_FORCE_STAGING_RELAYS set to any non empty value N0_DNS_PKARR_RELAY_STAGING server is used instead.

Trait Implementations

impl Clone for PkarrResolver

fn clone(&self) -> PkarrResolver

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PkarrResolver

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

Formats the value using the given formatter.

impl Discovery for PkarrResolver

fn resolve( &self, _ep: Endpoint, node_id: NodeId, ) -> Option<BoxStream<'static, Result<DiscoveryItem>>>

Resolves the AddrInfo for the given NodeId.

fn publish(&self, _info: &AddrInfo)

Publishes the given AddrInfo to the discovery mechanism.

fn subscribe(&self) -> Option<BoxStream<DiscoveryItem>>

Subscribe to all addresses that get passively discovered.