Struct Program 

pub struct Program { /* private fields */ }

An executable program for Miden VM.

A program consists of a MAST forest, an entrypoint defining the MAST node at which the program execution begins, and a definition of the kernel against which the program must be executed (the kernel can be an empty kernel).

Implementations

impl Program

Constructors

pub fn new(mast_forest: Arc<MastForest>, entrypoint: MastNodeId) -> Program

Construct a new Program from the given MAST forest and entrypoint. The kernel is assumed to be empty.

Panics:

• if mast_forest doesn’t contain the specified entrypoint.
• if the specified entrypoint is not a procedure root in the mast_forest.

pub fn with_kernel( mast_forest: Arc<MastForest>, entrypoint: MastNodeId, kernel: KernelDescriptor, ) -> Program

Construct a new Program from the given MAST forest, entrypoint, and kernel.

Panics:

• if mast_forest doesn’t contain the specified entrypoint.
• if the specified entrypoint is not a procedure root in the mast_forest.

pub fn with_advice_map(self, advice_map: AdviceMap) -> Program

Produces a new program with the existing MastForest and where all key/values in the provided advice map are added to the internal advice map.

impl Program

Public accessors

pub fn hash(&self) -> Word

Returns the hash of the program’s entrypoint.

Equivalently, returns the hash of the root of the entrypoint procedure.

pub fn entrypoint(&self) -> MastNodeId

Returns the entrypoint associated with this program.

pub fn mast_forest(&self) -> &Arc<MastForest>

Returns a reference to the underlying MastForest.

pub fn kernel(&self) -> &KernelDescriptor

Returns the kernel associated with this program.

pub fn get_node_by_id(&self, node_id: MastNodeId) -> Option<&MastNode>

Returns the MastNode associated with the provided MastNodeId if valid, or else None.

This is the fallible version of indexing (e.g. program[node_id]).

pub fn find_procedure_root(&self, digest: Word) -> Option<MastNodeId>

Returns the MastNodeId of the procedure root associated with a given digest, if any.

pub fn num_procedures(&self) -> u32

Returns the number of procedures in this program.

pub fn to_info(&self) -> ProgramInfo

Returns basic information about this program (i.e., program hash and kernel).

impl Program

Serialization

pub fn write_to_file<P>(&self, path: P) -> Result<(), Error>

where P: AsRef<Path>,

Writes this Program to the provided file path.

Trait Implementations

impl Clone for Program

fn clone(&self) -> Program

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Program

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

Formats the value using the given formatter.

impl Deserializable for Program

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

where R: ByteReader,

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

fn min_serialized_size() -> usize

Returns the minimum serialized size for one instance of this type.

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

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

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

Deserializes Self from bytes with a byte budget limit.

impl<'de> Deserialize<'de> for Program

fn deserialize<__D>( __deserializer: __D, ) -> Result<Program, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Program

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

Formats the value using the given formatter.

impl Eq for Program

impl From<Program> for ProgramInfo

fn from(program: Program) -> ProgramInfo

Converts to this type from the input type.

impl PartialEq for Program

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

Equality operator ==.

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

Inequality operator !=.

impl PrettyPrint for Program

fn render(&self) -> Document

The core of the PrettyPrint functionality.

fn to_pretty_string(&self) -> String

Produce a String containing the results of pretty-printing this object.

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

Pretty-print this object to the given core::fmt::Formatter.

impl Serializable for Program

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

where W: ByteWriter,

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 Serialize for Program

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Program