Struct PartialTranscript 

pub struct PartialTranscript { /* private fields */ }

A partial transcript.

A partial transcript is a transcript which may not have all the data authenticated.

Only authenticated data is stored: the bytes, and the set of ranges they occupy. The total length of each direction is also carried, but when the transcript comes from a peer it is untrusted — it is only ever compared against a caller-provided length, never used to size an allocation.

Implementations

impl PartialTranscript

pub fn sent_authed(&self) -> &RangeSet<usize>

Returns the index of sent data which have been authenticated.

pub fn received_authed(&self) -> &RangeSet<usize>

Returns the index of received data which have been authenticated.

pub fn len_sent(&self) -> usize

Returns the total length of the sent data.

pub fn len_received(&self) -> usize

Returns the total length of the received data.

pub fn union_transcript(&mut self, other: &PartialTranscript)

Unions the authenticated data of another compressed transcript into this one.

Where both transcripts authenticate the same position, self takes precedence.

Panics

Panics if the transcripts are not the same length.

pub fn union_subsequence(&mut self, direction: Direction, seq: &Subsequence)

Unions an authenticated subsequence into this transcript.

Where the subsequence overlaps already authenticated data, the subsequence takes precedence.

Panics

Panics if the subsequence is out of bounds of the transcript.

pub fn sent_unsafe( &self, expected: usize, ) -> Result<Vec<u8>, InvalidTranscriptLength>

Returns the sent data, materialized to expected bytes.

Warning

Only the positions in sent_authed have been authenticated; every other position is 0.

The allocation is sized by expected, a length the caller trusts (for example the length recorded by the Verifier, or a signed TranscriptLength), never by the length carried by this transcript. Returns an error if expected does not match the length carried by this transcript.

pub fn received_unsafe( &self, expected: usize, ) -> Result<Vec<u8>, InvalidTranscriptLength>

Returns the received data, materialized to expected bytes.

Warning

Only the positions in received_authed have been authenticated; every other position is 0.

The allocation is sized by expected, a length the caller trusts, never by the length carried by this transcript. Returns an error if expected does not match the length carried by this transcript.

impl PartialTranscript

pub fn new(sent_len: usize, received_len: usize) -> Self

Creates a new partial transcript initialized to all 0s.

Arguments

• sent_len - The length of the sent data.
• received_len - The length of the received data.

pub fn is_complete(&self) -> bool

Returns whether the transcript is complete.

pub fn contains(&self, direction: Direction, idx: &RangeSet<usize>) -> bool

Returns whether the index is in bounds of the transcript.

pub fn sent_unauthed(&self) -> RangeSet<usize>

Returns the index of sent data which haven’t been authenticated.

pub fn received_unauthed(&self) -> RangeSet<usize>

Returns the index of received data which haven’t been authenticated.

pub fn iter(&self, direction: Direction) -> impl Iterator<Item = u8> + '_

Returns an iterator over the authenticated data in the transcript.

Trait Implementations

impl Clone for PartialTranscript

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 PartialTranscript

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PartialTranscript

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PartialTranscript

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

where __S: Serializer,

Serialize this value into the given Serde serializer.