Struct miden_objects::notes::NoteAssets

pub struct NoteAssets { /* private fields */ }

An asset container for a note.

A note must contain at least 1 asset and can contain up to 256 assets. No duplicates are allowed, but the order of assets is unspecified.

All the assets in a note can be reduced to a single commitment which is computed by sequentially hashing the assets. Note that the same list of assets can result in two different commitments if the asset ordering is different.

Implementations

impl NoteAssets

pub const MAX_NUM_ASSETS: usize = 256usize

The maximum number of assets which can be carried by a single note.

pub fn new(assets: &[Asset]) -> Result<Self, NoteError>

Returns new NoteAssets constructed from the provided list of assets.

Errors

Returns an error if:

• The asset list is empty.
• The list contains more than 256 assets.
• There are duplicate assets in the list.

pub fn commitment(&self) -> Digest

Returns a commitment to the note’s assets.

pub fn num_assets(&self) -> usize

Returns the number of assets.

pub fn iter(&self) -> Iter<'_, Asset>

Returns an iterator over all assets.

pub fn to_padded_assets(&self) -> Vec<Felt>

Returns all assets represented as a vector of field elements.

The vector is padded with ZEROs so that its length is a multiple of 8. This is useful because hashing the returned elements results in the note asset commitment.

Trait Implementations

impl Clone for NoteAssets

fn clone(&self) -> NoteAssets

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NoteAssets

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

Formats the value using the given formatter.

impl Deserializable for NoteAssets

fn read_from<R: ByteReader>( source: &mut R ) -> Result<Self, DeserializationError>

Reads a sequence of bytes from the provided source, attempts to deserialize these bytes into Self, and returns the result.

fn read_from_bytes(bytes: &[u8]) -> Result<Self, DeserializationError>

Attempts to deserialize the provided bytes into Self and returns the result.

impl PartialEq for NoteAssets

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Serializable for NoteAssets

fn write_into<W: ByteWriter>(&self, target: &mut W)

Serializes self into bytes and writes these bytes into the target.

fn to_bytes(&self) -> Vec<u8>

Serializes self into a vector of bytes.

fn get_size_hint(&self) -> usize

Returns an estimate of how many bytes are needed to represent self.

impl Eq for NoteAssets