Struct HostMap 

pub struct HostMap { /* private fields */ }

Bidirectional hostname ↔ npub mapping table.

Implementations

impl HostMap

pub fn new() -> Self

Create an empty host map.

pub fn insert(&mut self, hostname: &str, npub: &str) -> Result<(), HostMapError>

Insert a hostname → npub mapping.

Validates the hostname and npub before inserting. The hostname is stored in lowercase for case-insensitive matching.

pub fn lookup_npub(&self, hostname: &str) -> Option<&str>

Look up the npub for a hostname (case-insensitive).

pub fn lookup_hostname(&self, node_addr: &NodeAddr) -> Option<&str>

Look up the hostname for a NodeAddr (reverse lookup for display).

pub fn len(&self) -> usize

Number of entries in the map.

pub fn is_empty(&self) -> bool

Whether the map is empty.

pub fn from_peer_configs(peers: &[PeerConfig]) -> Self

Build a host map from configured peer aliases.

Peers with a valid alias field are inserted. Invalid hostnames or npubs are logged as warnings and skipped.

pub fn load_hosts_file(path: &Path) -> Self

Load a host map from a hosts file.

If the file does not exist, returns an empty map (not an error). Parse errors on individual lines are logged as warnings and skipped.

pub fn merge(&mut self, other: HostMap)

Merge another host map into this one. The other map wins on conflicts.

Trait Implementations

impl Clone for HostMap

fn clone(&self) -> HostMap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HostMap

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

Formats the value using the given formatter.

impl Default for HostMap

fn default() -> HostMap

Returns the “default value” for a type.