Struct HickoryDnsResolver 

pub struct HickoryDnsResolver { /* private fields */ }

DNS resolver implementation using hickory-resolver.

Implementations

impl HickoryDnsResolver

pub async fn new() -> Result<Self, DnsError>

Create a new resolver with system configuration.

Regular queries use the default resolver. TLSA queries use a DNSSEC-validating resolver for security.

pub async fn with_preset(preset: DnsResolverConfig) -> Result<Self, DnsError>

Create a resolver with a preset configuration (Cloudflare, Google, etc.).

For System, reads the OS DNS configuration. This uses the actual nameservers configured on the machine (not hardcoded Google DNS).

pub async fn with_nameservers( nameservers: &[Ipv4Addr], ) -> Result<Self, DnsError>

Create a resolver with custom nameserver IP addresses.

Example

use ans_verify::HickoryDnsResolver;
use std::net::Ipv4Addr;

// Use custom nameservers
let resolver = HickoryDnsResolver::with_nameservers(&[
    Ipv4Addr::new(1, 1, 1, 1),
    Ipv4Addr::new(8, 8, 8, 8),
]).await?;

pub async fn with_config( config: ResolverConfig, opts: ResolverOpts, ) -> Result<Self, DnsError>

Create a new resolver with custom configuration.

pub async fn with_dnssec() -> Result<Self, DnsError>

Create a resolver with DNSSEC validation enabled for all queries.

Trait Implementations

impl Debug for HickoryDnsResolver

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

Formats the value using the given formatter.

impl DnsResolver for HickoryDnsResolver

fn lookup_badge<'life0, 'life1, 'async_trait>( &'life0 self, fqdn: &'life1 Fqdn, ) -> Pin<Box<dyn Future<Output = Result<DnsLookupResult<BadgeRecord>, DnsError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Query badge TXT records for an FQDN.

fn lookup_tlsa<'life0, 'life1, 'async_trait>( &'life0 self, fqdn: &'life1 Fqdn, port: u16, ) -> Pin<Box<dyn Future<Output = Result<DnsLookupResult<TlsaRecord>, DnsError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Query TLSA records for an FQDN and port.

fn get_badge_records<'life0, 'life1, 'async_trait>( &'life0 self, fqdn: &'life1 Fqdn, ) -> Pin<Box<dyn Future<Output = Result<Vec<BadgeRecord>, DnsError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Query all badge records and return them. Convenience method that unwraps the result.

fn get_tlsa_records<'life0, 'life1, 'async_trait>( &'life0 self, fqdn: &'life1 Fqdn, port: u16, ) -> Pin<Box<dyn Future<Output = Result<Vec<TlsaRecord>, DaneError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get TLSA records, returning empty vec if not found.

fn find_badge_for_version<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, fqdn: &'life1 Fqdn, version: &'life2 Version, ) -> Pin<Box<dyn Future<Output = Result<Option<BadgeRecord>, DnsError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Find the badge record matching a specific version.

fn find_preferred_badge<'life0, 'life1, 'async_trait>( &'life0 self, fqdn: &'life1 Fqdn, ) -> Pin<Box<dyn Future<Output = Result<Option<BadgeRecord>, DnsError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Find the first ACTIVE badge (or any if none specified as active). During version changes, prefer newer versions.