Struct IpfsGatewayResolver 

pub struct IpfsGatewayResolver { /* private fields */ }

Resolves DID documents via an IPFS/IPNS HTTP gateway.

The gateway must serve DID documents at /ipns/<key-id>. Cached document bytes and negative outcomes expire on independent TTLs.

Implementations

impl IpfsGatewayResolver

pub fn public_default() -> Self

Build a public-gateway resolver with no localhost probing.

pub fn new(gateway_url: impl Into<String>) -> Self

Build a resolver using the caller-provided primary gateway followed by the standard public fallbacks. Localhost is used only if gateway_url itself points at localhost.

pub fn local_first(gateway_url: impl Into<String>) -> Self

Build a local-first resolver: localhost, then the caller-provided primary gateway, then the standard public fallbacks.

pub fn pool(&self) -> &GatewayPool

The underlying gateway pool, for generic content fetches.

pub fn with_cache_ttls( self, positive_ttl: Duration, negative_ttl: Duration, ) -> Self

pub fn with_base_cooldown(self, cooldown: Duration) -> Self

Override the base per-gateway failure cooldown. The cooldown escalates Fibonacci-style per consecutive failure and resets on success. Duration::ZERO disables cooldowns entirely.

pub fn with_request_timeout(self, timeout: Duration) -> Self

Override the per-request timeout (default 6 seconds). Covers the whole request, connection through body transfer.

pub fn set_request_timeout(&self, timeout: Option<Duration>)

Update the per-request timeout at runtime. Pass None to revert to the 6-second built-in default.

pub async fn resolve_ipns_path(&self, path: &str) -> Result<String>

Resolve an /ipns/<name> reference to its current /ipfs/<cid> path.

Trait Implementations

impl Default for IpfsGatewayResolver

fn default() -> Self

Build a local-first resolver for development and native runtimes.

impl DidDocumentResolver for IpfsGatewayResolver

fn resolve<'life0, 'life1, 'async_trait>( &'life0 self, did: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Document>> + Send + 'async_trait>>

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

fn set_cache_ttls(&self, positive_ttl: Duration, negative_ttl: Duration)

Update resolver cache TTLs at runtime.

fn cache_ttls(&self) -> Option<(Duration, Duration)>

Return current resolver cache TTLs when supported.

impl From<GatewayPool> for IpfsGatewayResolver

fn from(pool: GatewayPool) -> Self

Converts to this type from the input type.

impl IpnsPathResolver for IpfsGatewayResolver

fn resolve_ipns_path<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

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