Struct SierraCasmRunner 

pub struct SierraCasmRunner { /* private fields */ }

Runner enabling running a Sierra program on the VM.

Implementations

impl SierraCasmRunner

pub fn new( sierra_program: Program, metadata_config: Option<MetadataComputationConfig>, starknet_contracts_info: OrderedHashMap<Felt252, ContractInfo>, run_profiler: Option<ProfilingInfoCollectionConfig>, ) -> Result<Self, RunnerError>

pub fn run_function_with_starknet_context( &self, func: &Function, args: Vec<Arg>, available_gas: Option<usize>, starknet_state: StarknetState, ) -> Result<RunResultStarknet, RunnerError>

Runs the VM starting from a function in the context of a given Starknet state.

pub fn run_function_with_prepared_starknet_context( &self, func: &Function, hint_processor: &mut dyn StarknetHintProcessor, _: PreparedStarknetContext, ) -> Result<RunResultStarknet, RunnerError>

Runs the VM starting from a function in the context of a given Starknet state and a (possibly) amended hint processor.

pub fn run_function<'a, Bytecode>( &self, func: &Function, hint_processor: &mut dyn HintProcessor, hints_dict: HashMap<usize, Vec<HintParams>>, bytecode: Bytecode, builtins: Vec<BuiltinName>, ) -> Result<RunResult, RunnerError>

where Bytecode: ExactSizeIterator<Item = &'a BigInt> + Clone,

Runs the VM starting from a function with a custom hint processor. The function may have implicits, but no other ref params. The cost of the function is deducted from available_gas before the execution begins.

pub fn prepare_starknet_context( &self, func: &Function, args: Vec<Arg>, available_gas: Option<usize>, starknet_state: StarknetState, ) -> Result<(CairoHintProcessor<'_>, PreparedStarknetContext), RunnerError>

Prepares context for running a function in the context of a given Starknet state.

The returned hint processor instance is set up for interpreting and executing the hints provided during the Cairo program’s execution. Can be customised by wrapping into a custom hint processor implementation and passing that to the run_function method.

pub fn handle_main_return_value( inner_type_size: Option<i16>, values: Vec<Felt252>, cells: &[Option<Felt252>], ) -> RunResultValue

Handling the main return value to create a RunResultValue.

pub fn get_results_data( &self, return_types: &[(GenericTypeId, i16)], cells: &[Option<Felt252>], ap: usize, ) -> (Vec<(GenericTypeId, Vec<Felt252>)>, Option<Felt252>)

Returns the final values and type of all funcs returning variables.

pub fn find_function(&self, name_suffix: &str) -> Result<&Function, RunnerError>

Finds first function ending with name_suffix.

pub fn get_initial_available_gas( &self, func: &Function, available_gas: Option<usize>, ) -> Result<usize, RunnerError>

Returns the initial value for the gas counter. If available_gas is None returns 0.

pub fn initial_required_gas(&self, func: &Function) -> Option<usize>