Struct BlockIndex 

pub struct BlockIndex {
    pub version: String,
    pub algorithm: HashAlgorithm,
    pub root: DocumentId,
    pub blocks: Vec<BlockHashEntry>,
}

Index of content blocks with their hashes.

This structure is stored at content/block-index.json and enables:

• Merkle proof generation for individual blocks
• Efficient verification of specific content sections
• Selective disclosure without revealing full content

Fields

version: String

Version of the block index format.

algorithm: HashAlgorithm

Hash algorithm used for all hashes.

root: DocumentId

Merkle root hash of all blocks.

blocks: Vec<BlockHashEntry>

Individual block entries with their hashes.

Implementations

impl BlockIndex

pub const VERSION: &'static str = "0.1"

Current version of the block index format.

pub fn from_content(content: &Content, algorithm: HashAlgorithm) -> Result<Self>

Create a block index from document content.

This computes hashes for each block and builds a Merkle tree to derive the root hash.

Errors

Returns an error if the content has no blocks.

pub fn merkle_root(&self) -> &DocumentId

Get the Merkle root hash.

pub fn block_count(&self) -> usize

Get the number of blocks.

pub fn find_block(&self, id: &str) -> Option<&BlockHashEntry>

Find a block entry by ID.

pub fn get_block(&self, index: usize) -> Option<&BlockHashEntry>

Find a block entry by index.

pub fn hashes(&self) -> Vec<&DocumentId>

Get all block hashes in order.

pub fn to_json(&self) -> Result<String>

Serialize to JSON.

Errors

Returns an error if serialization fails.

pub fn from_json(json: &str) -> Result<Self>

Deserialize from JSON.

Errors

Returns an error if deserialization fails.

Trait Implementations

impl Clone for BlockIndex

fn clone(&self) -> BlockIndex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BlockIndex

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BlockIndex

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for BlockIndex

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for BlockIndex

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for BlockIndex

impl StructuralPartialEq for BlockIndex