Struct StreamCandidate 

#[non_exhaustive]
pub struct StreamCandidate<S> {
    pub source: S,
    pub ctx: Arc<Mutex<PoolContext>>,
    pub ledger: Arc<PoolLedger>,
    pub coverage: Option<Coverage>,
    /* private fields */
}

One provider’s paid lane: the paid source plus the (ctx, ledger) that pays it. A [SourceProvider] builds one per holder, and both faces fetch across them.

A lane that faults mid-fetch cools and returns; its remainder continues from another lane meanwhile, resuming from the store’s verified frontier so no delivered byte is re-pulled or re-paid. Every lane names a distinct on-chain provider (one voucher stream per (signer, provider) lane).

Build one with Self::new, and set Self::coverage for a partial holder.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

source: S

The paid source — one provider’s cdn/client/v1 requester.

ctx: Arc<Mutex<PoolContext>>

The buyer context paying this candidate’s provider (shared behind interior mutability so a funding recovery step’s deposit is visible to its next open).

ledger: Arc<PoolLedger>

This candidate’s per-(signer, provider) voucher ledger.

coverage: Option<Coverage>

This candidate’s measured block coverage for the blob being fetched (#1506), or None to treat it as a full holder. A partial holder MUST set this so the scheduler never assigns it — and it never steals — a range it does not hold; None maps to Coverage::full sized to the blob, the right default for the common case that discovery yields whole- blob holders. The bitmap is sized to ONE blob, so a crate::Downloader given several targets applies it to each of them: set it only on a single-target fetch.

Implementations

impl<S> StreamCandidate<S>

pub fn new( source: S, ctx: Arc<Mutex<PoolContext>>, ledger: Arc<PoolLedger>, ) -> Self

A whole-blob holder’s lane: source paid from ctx through ledger, holding no lease and staying at one stream.

Trait Implementations

impl<S> Debug for StreamCandidate<S>

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

Formats the value using the given formatter.