Struct Target 

pub struct Target<F: Family, D: Digest> {
    pub root: D,
    pub range: NonEmptyRange<Location<F>>,
}

Target state to sync to.

PartialEq, Eq, and Clone are implemented manually to avoid requiring F to implement them.

Fields

root: D

The ops root the sync engine verifies streaming batches against.

range: NonEmptyRange<Location<F>>

Operations to sync, from the inclusive lower bound to the exclusive target size.

The target’s inactivity floor is declared by its final commit and may differ from the lower bound.

Implementations

impl<F: Family, D: Digest> Target<F, D>

pub const fn new(root: D, range: NonEmptyRange<Location<F>>) -> Self

Create a sync target.

pub fn advances(&self, from: &Self) -> bool

Whether this target advances relative to from.

Both targets are assumed to describe valid states of the same append-only QMDB. Because the root commits to the database size, valid targets at different sizes have distinct roots.

Trait Implementations

impl<F: Family, D: Digest> Clone for Target<F, D>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<F: Debug + Family, D: Debug + Digest> Debug for Target<F, D>

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

Formats the value using the given formatter.

impl<F: Family, D: Digest> EncodeSize for Target<F, D>

fn encode_size(&self) -> usize

Returns the encoded size of this value (in bytes).

fn encode_inline_size(&self) -> usize

Returns the encoded size excluding bytes passed to BufsMut::push during Write::write_bufs. Used to size the fixed working buffer for inline writes, so it must not be less than the bytes written inline. Override alongside Write::write_bufs for types where large byte fields go via push, or the working buffer will over-allocate.

impl<F: Family, D: Digest> Eq for Target<F, D>

impl<F: Family, D: Digest> PartialEq for Target<F, D>

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

Equality operator ==.

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

Inequality operator !=.

impl<F: Family, D: Digest> Read for Target<F, D>

type Cfg = ()

The Cfg type parameter allows passing configuration during the read process. This is crucial for safely decoding untrusted data, for example, by providing size limits for collections or strings.

fn read_cfg(buf: &mut impl Buf, _: &()) -> Result<Self, CodecError>

Reads a value from the buffer using the provided configuration cfg.

impl<F: Family, D: Digest> TryFrom<&CompactTarget<F, D>> for Target<F, D>

type Error = EngineError<F, D>

The type returned in the event of a conversion error.

fn try_from(target: &CompactTarget<F, D>) -> Result<Self, Self::Error>

Performs the conversion.

impl<F: Family, D: Digest> Write for Target<F, D>

fn write(&self, buf: &mut impl BufMut)

Writes the binary representation of self to the provided buffer buf.

fn write_bufs(&self, buf: &mut impl BufsMut)

Writes to a BufsMut, allowing existing byte chunks to be appended via BufsMut::push instead of written inline. Must encode to the same format as Write::write. Defaults to Write::write.