Struct ethereumvm::TransactionVM

pub struct TransactionVM<'a, M, P: Patch>(_);

A VM that executes using a transaction and block information.

Methods

impl<'a, M: Memory, P: Patch> TransactionVM<'a, M, P>

pub fn new_untrusted(
    patch: &'a P,
    transaction: UntrustedTransaction,
    block: HeaderParams
) -> Result<Self, PreExecutionError>

Create a VM from an untrusted transaction. It can be any transaction and the VM will return an error if it has errors.

pub fn new(
    patch: &'a P,
    transaction: ValidTransaction,
    block: HeaderParams
) -> Self

Create a new VM using the given transaction, block header and patch. This VM runs at the transaction level.

pub fn current_state(&self) -> Option<&State<M, P>>

Returns the current state of the VM.

pub fn current_machine(&self) -> Option<&Machine<M, P>>

Returns the current runtime machine.

pub fn with_previous(
    transaction: ValidTransaction,
    block: HeaderParams,
    vm: &TransactionVM<'a, M, P>
) -> Self

Create a new VM with the result of the previous VM. This is usually used by transaction for chaining them.

pub fn with_states(
    patch: &'a P,
    transaction: ValidTransaction,
    block: HeaderParams,
    account_state: AccountState<'a, P::Account>,
    blockhash_state: BlockhashState
) -> Self

Create a new VM with the provided account and blockchain states

Trait Implementations

impl<'a, M: Memory, P: Patch> VM for TransactionVM<'a, M, P>

fn commit_account(
    &mut self,
    commitment: AccountCommitment
) -> Result<(), CommitError>

Commit an account information to this VM. This should only be used when receiving RequireError.

fn commit_blockhash(
    &mut self,
    number: U256,
    hash: H256
) -> Result<(), CommitError>

Commit a block hash to this VM. This should only be used when receiving RequireError.

fn status(&self) -> VMStatus

Returns the current status of the VM.

fn peek(&self) -> Option<Instruction>

Read the next instruction to be executed.

fn peek_opcode(&self) -> Option<Opcode>

Read the next opcode to be executed.

fn step(&mut self) -> Result<(), RequireError>

Run one instruction and return. If it succeeds, VM status can still be Running. If the call stack has more than one items, this will only executes the last items' one single instruction.

fn accounts(&self) -> Values<Address, AccountChange>

Returns the changed or committed accounts information up to current execution status.

fn used_addresses(&self) -> Set<Address>

Returns all fetched or modified addresses.

fn out(&self) -> &[u8]

Returns the out value, if any.

fn available_gas(&self) -> Gas

Returns the available gas of this VM.

fn refunded_gas(&self) -> Gas

Returns the refunded gas of this VM.

fn logs(&self) -> &[Log]

Returns logs to be appended to the current block if the user decided to accept the running status of this VM.

fn removed(&self) -> &[Address]

Returns all removed account addresses as for current VM execution.

fn used_gas(&self) -> Gas

Returns the real used gas by the transaction or the VM context. Only available when the status of the VM is exited. Otherwise returns zero.

fn fire(&mut self) -> Result<(), RequireError>

Run instructions until it reaches a RequireError or exits. If this function succeeds, the VM status can only be either ExitedOk or ExitedErr.