Struct BlobProbePrefix 

pub struct BlobProbePrefix(/* private fields */);

A *-origin @blob prefix, for probing only (RFC 07 §2.5).

Deliberately a distinct type from Key, and deliberately not convertible into one: a fleet prefix and a concrete prefix are interchangeable as strings, which is exactly how a probe turns into a wildcard-origin bulk fetch — every holder ships the full payload and Zenoh cannot cancel remote replies in flight, so N holders cost N× the bytes (RFC 07 §2.5, §3). Keeping the types apart makes that mistake fail to compile rather than fail on a link.

The sanctioned shape is: probe across origins with a tiny reply (have availability, or a manifest), pick one origin, then fetch from that origin’s concrete V1Context::blob_prefix.

Implementations

impl BlobProbePrefix

pub fn new(tier: BlobTier) -> Self

The *-origin prefix for tier: v1/*/@blob/<tier>.

pub fn store_have(algo: impl AsRef<str>) -> Self

The Tier-2 store probe: v1/*/@blob/store/<algo>/have (RFC 07 §2.4/§2.5, v1.17).

The request carries a list of content addresses; each holder answers a bitfield over exactly that list, so the reply is O(request) and §3’s cost gate is satisfied by construction — which is what makes the wildcard origin legitimate here. have is a reserved Tier-2 token and never a valid content address (§2.4). algo is slugged at the boundary like every generated variable.

pub fn tree_have(root: &ContentHash) -> Self

The Tier-2 tree probe: v1/*/@blob/tree/<root>/have (RFC 07 §2.4/§2.5, v1.17).

Each holder answers has-index plus chunks present / total — a flag and two counters, O(request) whatever the tree’s size. The <root> is a validated grammar::ContentHash, so the revoked caller-chosen name (§2.3) has no spelling here either.

pub fn as_str(&self) -> &str

The prefix as a selector string, for handing to a probing client.

Trait Implementations

impl Clone for BlobProbePrefix

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BlobProbePrefix

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

Formats the value using the given formatter.

impl Display for BlobProbePrefix

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

Formats the value using the given formatter.

impl Eq for BlobProbePrefix

impl Hash for BlobProbePrefix

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for BlobProbePrefix

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for BlobProbePrefix