Struct RepairingBlob 

pub struct RepairingBlob { /* private fields */ }

Represents a blob that is in the process of being incrementally repaired or reconstructed from received ProofCarryingChunks.

Implementations

impl RepairingBlob

pub fn new(header: BlobHeader) -> Self

Creates a new RepairingBlob instance from a BlobHeader.

This initializes an empty RepairingChunkSet for each chunkset indicated in the header, ready to receive chunks for repair.

Arguments

• header - The BlobHeader of the blob to be repaired. This header provides the necessary metadata, including chunkset commitments, for the repair process.

Returns

A new RepairingBlob instance, prepared to accept chunks for reconstruction.

pub fn add_chunk( &mut self, chunk: &ProofCarryingChunk, ) -> Result<(), DecdsError>

Adds a ProofCarryingChunk to the appropriate RepairingChunkSet within the blob.

This method first validates the chunk’s inclusion using the blob header, then attempts to add it to the relevant chunkset’s decoder.

Arguments

• chunk - A reference to the ProofCarryingChunk to add.

Returns

Returns a Result which is:

• Ok(()) if the chunk is successfully added.
• Err(DecdsError::InvalidChunksetId) if the chunk’s chunkset_id does not exist in this blob.
• Err(DecdsError::ChunksetAlreadyRepaired) if the target chunkset has already been repaired.
• Err(DecdsError::InvalidProofInChunk) if the chunk’s proof of inclusion in the blob or chunkset is invalid.
• Err(DecdsError::ChunksetReadyToRepair) if the chunkset is already ready to repair (and thus cannot accept more chunks).
• Other DecdsError types may be returned from RepairingChunkSet::add_chunk_unvalidated.

pub fn is_chunkset_ready_to_repair( &self, chunkset_id: usize, ) -> Result<bool, DecdsError>

Checks if a specific chunkset within the blob is ready to be repaired (reconstructed).

Arguments

• chunkset_id - The ID of the chunkset to check.

Returns

Returns a Result which is:

• Ok(bool): true if the chunkset is ready for repair, false otherwise.
• Err(DecdsError::InvalidChunksetId) if chunkset_id is out of bounds.

pub fn is_chunkset_already_repaired( &self, chunkset_id: usize, ) -> Result<bool, DecdsError>

Checks if a specific chunkset within the blob has already been successfully repaired.

Arguments

• chunkset_id - The ID of the chunkset to check.

Returns

Returns a Result which is:

• Ok(bool): true if the chunkset has already been repaired, false otherwise.
• Err(DecdsError::InvalidChunksetId) if chunkset_id is out of bounds.

pub fn get_repaired_chunkset( &mut self, chunkset_id: usize, ) -> Result<Vec<u8>, DecdsError>

Retrieves the repaired (reconstructed) data for a specific chunkset. This method consumes the RepairingChunkSet for the given ID once successful, as the data is fully reconstructed.

Arguments

• chunkset_id - The ID of the chunkset to retrieve repaired data for.

Returns

Returns a Result which is:

• Ok(Vec<u8>) containing the repaired chunkset data if successful.
• Err(DecdsError::ChunksetAlreadyRepaired) if the chunkset has already been repaired and retrieved.
• Err(DecdsError::ChunksetNotYetReadyToRepair) if not enough chunks have been added to repair the chunkset.
• Err(DecdsError::InvalidChunksetId) if chunkset_id is out of bounds.
• Err(DecdsError::ChunksetRepairingFailed) if an error occurs during the underlying chunkset repair process.