Struct Tile 

pub struct Tile { /* private fields */ }

A C2SP tlog-tiles tile coordinate.

Identifies a tile by its level, its index within that level, and its width in hashes. A width of TILE_WIDTH (256) is a full tile; a width in 1..=255 is a partial tile (the rightmost tile of a tree whose size is not a multiple of the tile span).

Implementations

impl Tile

pub fn new(level: u8, index: u64, width: u16) -> Result<Self>

Construct a tile coordinate, validating the level and width.

Errors

Returns Error::MalformedTile if level > 63 or width is not in 1..=256.

pub fn level(&self) -> u8

The tile level (0 = leaf-hash tiles).

pub fn index(&self) -> u64

The tile index within its level.

pub fn width(&self) -> u16

The tile width in hashes (256 for a full tile).

pub fn is_partial(&self) -> bool

Whether this is a partial tile (width < 256).

pub fn byte_len(&self) -> usize

The number of serialized bytes a tile of this width occupies (width * 32).

pub fn path(&self) -> String

The Merkle tile path tile/<L>/<N>[.p/<W>].

<N> is encoded as zero-padded 3-digit path elements, all but the last prefixed with x (e.g. index 1234067 → x001/x234/067). The .p/<W> suffix is present only for partial tiles.

pub fn entries_path(&self) -> String

The entry-bundle path tile/entries/<N>[.p/<W>] for this tile’s index and width. Only meaningful for level-0 coordinates, but defined purely in terms of (index, width).

pub fn parse_path(path: &str) -> Result<Self>

Parse a Merkle tile path tile/<L>/<N>[.p/<W>].

Errors

Returns Error::MalformedTile if the path does not match the grammar, including leading-zero levels/widths, malformed index path elements, or an out-of-range level/width.

pub fn hashes(&self, bytes: &[u8]) -> Result<Vec<Hash>>

Interpret raw tile bytes as the tile’s sequence of 32-byte hashes, validating that the byte length matches the declared width.

Errors

Returns Error::MalformedTile if bytes.len() != width * 32.

Trait Implementations

impl Clone for Tile

fn clone(&self) -> Tile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Tile

impl Debug for Tile

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

Formats the value using the given formatter.

impl Eq for Tile

impl Hash for Tile

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 Tile

fn eq(&self, other: &Tile) -> 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 StructuralPartialEq for Tile