Struct Coverage 

pub struct Coverage { /* private fields */ }

A bitmap over discovery-block indices: bit i records whether block i (bytes [i * DISCOVERY_BLOCK_BYTES, (i + 1) * DISCOVERY_BLOCK_BYTES)) is covered.

Bit-packed as Vec<u8>: bit i lives at byte i / 8, bit position i % 8 (little-endian within the byte). Serializes over postcard as a length-prefixed byte vector — cheap on the wire and trivial to union/merge byte-wise if a future caller needs to.

Carries no num_blocks field. A Coverage built locally (via Self::from_block_indices / Self::full) leaves the trailing partial byte’s unused high bits zero. A Coverage deserialized from untrusted wire does not: the byte length only rounds the block count up to the next multiple of 8, and nothing on the wire pins the exact count, so a peer may set spurious high bits in that trailing byte. Self::covers and Self::covered_blocks report the raw bits as-is, so such a bit makes covers(i) true for an i past the blob’s real block count. Consumers MUST clamp interpretation to the blob’s own num_blocks(total_bytes) — query only i < num_blocks, and ignore any Self::covered_blocks index beyond it. The signed size, not the bitmap, is the authority on how many blocks exist.

Implementations

impl Coverage

pub fn empty() -> Self

No blocks covered.

pub fn full(num_blocks: u32) -> Self

Every block in 0..num_blocks covered.

pub fn from_block_indices( num_blocks: u32, set: impl Iterator<Item = u32>, ) -> Self

Builds a Coverage sized for num_blocks blocks with exactly the indices from set covered. Indices >= num_blocks in set are dropped rather than growing the bitmap past its declared size.

pub fn covers(&self, block: u32) -> bool

Is block covered?

pub fn is_empty(&self) -> bool

No block is covered — every byte of the bitmap is zero.

pub fn covered_blocks(&self) -> impl Iterator<Item = u32> + '_

Iterates the covered block indices in ascending order. Reports raw set bits: a Coverage from untrusted wire may yield indices past the blob’s real block count (see the type doc), so a consumer bounds these against its own num_blocks(total_bytes).

Trait Implementations

impl Clone for Coverage

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 Coverage

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

Formats the value using the given formatter.

impl Default for Coverage

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Coverage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Coverage

impl PartialEq for Coverage

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Coverage

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 Coverage