Struct LinkResolver 

pub struct LinkResolver { /* private fields */ }

In-memory resolver and mirror registry.

Implementations

impl LinkResolver

pub fn new() -> Self

Create an empty resolver.

pub fn register_mirror(&self, ticket: BlobTicket) -> Result<()>

Register a direct mirror ticket for a hash.

Errors

Returns an error if the ticket is malformed.

pub fn add_mirror(&self, ticket: BlobTicket) -> Result<()>

Alias for Self::register_mirror.

Errors

Returns an error if the ticket is malformed.

pub fn register_provider_ticket(&self, ticket: BlobTicket) -> Result<()>

Register a provider ticket as a mirror.

Errors

Returns an error if the ticket is malformed.

pub fn register_provider_lease(&self, lease: ProviderLease) -> Result<()>

Register a signed provider lease for a hash.

Errors

Returns an error if the lease signature, expiry, or ticket is invalid.

pub fn mirrors(&self, hash: Hash) -> Result<Vec<BlobTicket>>

Return registered direct mirror tickets in registration order.

Errors

Returns an error if the resolver state lock is poisoned.

pub fn publish(&self, pointer: MutablePointer) -> Result<()>

Accept a signed mutable pointer, enforcing monotonic sequence.

Errors

Returns an error if the pointer is unsigned, invalid, or older than the current pointer.

pub fn register_pointer(&self, pointer: MutablePointer) -> Result<()>

Alias for Self::publish.

Errors

Returns an error if the pointer is invalid or not monotonic.

pub fn update(&self, pointer: MutablePointer) -> Result<()>

Alias for Self::publish.

Errors

Returns an error if the pointer is invalid or not monotonic.

pub fn current_pointer(&self, link: &NameLink) -> Result<Option<MutablePointer>>

Return the current pointer for a mutable name.

Errors

Returns an error if the link is invalid or the resolver state lock is poisoned.

pub fn revoke(&self, link: &PrivateLink) -> Result<()>

Revoke a private capability.

Errors

Returns an error if the link is invalid or the resolver state lock is poisoned.

pub fn revoke_private(&self, link: &PrivateLink) -> Result<()>

Alias for Self::revoke.

Errors

Returns an error if the link is invalid or the resolver state lock is poisoned.

pub fn is_revoked(&self, link: &PrivateLink) -> Result<bool>

Return whether a private capability has been revoked.

Errors

Returns an error if the link is invalid or the resolver state lock is poisoned.

pub fn resolve(&self, link: &Link) -> Result<LinkResolution>

Resolve a link using the current time.

Errors

Returns an error if the link is invalid, unavailable, expired, revoked, or has an invalid provider.

pub fn resolve_at(&self, link: &Link, now: u64) -> Result<LinkResolution>

Resolve a link at an explicit timestamp.

Errors

Returns an error if the link is invalid, unavailable, expired, revoked, or has an invalid provider.

pub fn resolve_version( &self, link: &NameLink, version: &str, ) -> Result<LinkResolution>

Resolve a mutable link to an exact semantic version.

Errors

Returns an error if the link or requested version is unavailable.

pub fn resolve_with_options( &self, link: &Link, options: &ResolveOptions, ) -> Result<LinkResolution>

Resolve a link using explicit version and expiry options.

Errors

Returns an error if the link is invalid, unavailable, expired, revoked, or has an invalid provider.

pub fn resolve_uri(&self, uri: &str) -> Result<LinkResolution>

Parse and resolve a link URI.

Errors

Returns an error if the URI cannot be parsed or the link cannot be resolved.

pub fn fetch_with_mirrors<T, Fetch>( &self, link: &Link, fetch: Fetch, ) -> Result<T>

where Fetch: FnMut(&BlobTicket) -> Result<T>,

Resolve and fetch a link, trying each provider and mirror in order.

Errors

Returns the first successful fetch result, or an error if resolution fails or every provider fails.

Trait Implementations

impl Clone for LinkResolver

fn clone(&self) -> LinkResolver

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LinkResolver

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

Formats the value using the given formatter.

impl Default for LinkResolver

fn default() -> LinkResolver

Returns the “default value” for a type.