Struct miden_objects::vm::Program

pub struct Program { /* private fields */ }

Implementations

impl Program

Constructors

pub fn new(mast_forest: 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 have an entrypoint

pub fn with_kernel( mast_forest: MastForest, entrypoint: MastNodeId, kernel: Kernel, ) -> Program

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

Panics:

• if mast_forest doesn’t have an entrypoint

impl Program

Public accessors

pub fn mast_forest(&self) -> &MastForest

Returns the underlying MastForest.

pub fn kernel(&self) -> &Kernel

Returns the kernel associated with this program.

pub fn entrypoint(&self) -> MastNodeId

Returns the entrypoint associated with this program.

pub fn hash(&self) -> RpoDigest

Returns the hash of the program’s entrypoint.

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

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 faillible version of indexing (e.g. program[node_id]).

pub fn find_procedure_root(&self, digest: RpoDigest) -> 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.

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 copy 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 read_from_bytes(bytes: &[u8]) -> Result<Self, DeserializationError>

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

impl Display for Program

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

Formats the value using the given formatter.

impl From<Program> for MastForest

fn from(program: Program) -> MastForest

Converts to this type from the input type.

impl From<Program> for ProgramInfo

fn from(program: Program) -> ProgramInfo

Converts to this type from the input type.

impl Index<MastNodeId> for Program

type Output = MastNode

The returned type after indexing.

fn index(&self, node_id: MastNodeId) -> &<Program as Index<MastNodeId>>::Output

Performs the indexing (container[index]) operation.

impl PartialEq for Program

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

impl StructuralPartialEq for Program