Struct ProviderRecord 

pub struct ProviderRecord {
    pub content_key: String,
    pub provider_peer_id: String,
    pub addresses: Vec<CandidateAddr>,
    pub expires_at: u64,
}

The DHT’s stored value: peer provider_peer_id holds the content whose key is content_key, reachable at addresses, until expires_at.

• content_key is the 64-hex Key the content id hashed to — the DHT stores by key, not by the (larger, granularity-tagged) content id, so a record is compact and the store is a pure key→providers map.
• provider_peer_id is the 64-hex peer_id of the holder; a finder builds a PeerTarget from it plus addresses and connects via dig-nat.
• expires_at is absolute Unix seconds; a record past its expiry is treated as absent and GC’d. The holder republishes (a fresh record with a new expires_at) before expiry to stay findable.

Fields

content_key: String

The content key (64-hex) this record provides for — the Key a content id hashed to.

provider_peer_id: String

The holder’s peer_id (64-hex).

addresses: Vec<CandidateAddr>

Candidate addresses to reach the holder. Ordered IPv6-first, then most-direct-first by AddressKind::rank when built via ProviderRecord::new; a record deserialized directly from the wire (bypassing new) is not guaranteed sorted, so a consumer that cannot assume a conforming producer should still sort defensively.

expires_at: u64

Absolute expiry (Unix seconds). A record at/after this time is stale.

Implementations

impl ProviderRecord

pub fn new( content_key: &Key, provider: &PeerId, addresses: Vec<CandidateAddr>, expires_at: u64, ) -> Self

Build a record: peer provider holds content_key, reachable at addresses, until expires_at (absolute Unix seconds).

pub fn provider_peer_id(&self) -> Option<PeerId>

The provider’s peer_id decoded from the 64-hex field, or None if malformed.

pub fn is_expired(&self, now: u64) -> bool

Whether this record is expired at now (Unix seconds) — stale records are dropped on read.

pub fn best_address(&self) -> Option<&CandidateAddr>

The IPv6-preferred, most-direct dialable candidate address, if any — the address a finder dials first. addresses is already IPv6-first-then-rank sorted (sort_addresses_ipv6_first), so this is simply the first dialable entry.

Trait Implementations

impl Clone for ProviderRecord

fn clone(&self) -> ProviderRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProviderRecord

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ProviderRecord

impl PartialEq for ProviderRecord

fn eq(&self, other: &ProviderRecord) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ProviderRecord

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ProviderRecord