Struct TransactionExecutorHost 

pub struct TransactionExecutorHost<'store, 'auth, STORE, AUTH>
where
    STORE: DataStore,
    AUTH: TransactionAuthenticator,
{ /* private fields */ }

The transaction executor host is responsible for handling FutureMaybeSend requests made by the transaction kernel during execution. In particular, it responds to signature generation requests by forwarding the request to the contained TransactionAuthenticator.

Transaction hosts are created on a per-transaction basis. That is, a transaction host is meant to support execution of a single transaction and is discarded after the transaction finishes execution.

Implementations

impl<'store, 'auth, STORE, AUTH> TransactionExecutorHost<'store, 'auth, STORE, AUTH>

where STORE: DataStore + Sync, AUTH: TransactionAuthenticator + Sync,

pub fn new( account: &PartialAccount, input_notes: InputNotes<InputNote>, mast_store: &'store STORE, scripts_mast_store: ScriptMastForestStore, acct_procedure_index_map: AccountProcedureIndexMap, authenticator: Option<&'auth AUTH>, ref_block: BlockNumber, source_manager: Arc<dyn SourceManagerSync>, ) -> Self

Creates a new TransactionExecutorHost instance from the provided inputs.

pub fn tx_progress(&self) -> &TransactionProgress

Returns a reference to the tx_progress field of this transaction host.

pub async fn on_auth_requested( &mut self, pub_key_hash: Word, signing_inputs: SigningInputs, ) -> Result<Vec<AdviceMutation>, TransactionKernelError>

Pushes a signature to the advice stack as a response to the AuthRequest event.

The signature is requested from the host’s authenticator.

pub fn into_parts( self, ) -> (AccountDelta, InputNotes<InputNote>, Vec<OutputNote>, Vec<AccountCode>, BTreeMap<Word, Vec<Felt>>, TransactionProgress)

Consumes self and returns the account delta, output notes, generated signatures and transaction progress.

Trait Implementations

impl<STORE, AUTH> AsyncHost for TransactionExecutorHost<'_, '_, STORE, AUTH>

where STORE: DataStore + Sync, AUTH: TransactionAuthenticator + Sync,

fn get_mast_forest( &self, node_digest: &Word, ) -> impl FutureMaybeSend<Option<Arc<MastForest>>>

Returns MAST forest corresponding to the specified digest, or None if the MAST forest for this digest could not be found in this host.

fn on_event( &mut self, process: &ProcessState<'_>, ) -> impl FutureMaybeSend<Result<Vec<AdviceMutation>, EventError>>

Handles the event emitted from the VM and provides advice mutations to be applied to the advice provider.

impl<STORE, AUTH> BaseHost for TransactionExecutorHost<'_, '_, STORE, AUTH>

where STORE: DataStore, AUTH: TransactionAuthenticator,

fn get_label_and_source_file( &self, location: &Location, ) -> (SourceSpan, Option<Arc<SourceFile>>)

Returns the SourceSpan and optional SourceFile for the provided location.

fn on_debug( &mut self, process: &mut ProcessState<'_>, options: &DebugOptions, ) -> Result<(), ExecutionError>

Handles the debug request from the VM.

fn on_trace( &mut self, process: &mut ProcessState<'_>, trace_id: u32, ) -> Result<(), ExecutionError>

Handles the trace emitted from the VM.

fn on_assert_failed( &mut self, _process: &ProcessState<'_>, _err_code: BaseElement, )

Handles the failure of the assertion instruction.

fn resolve_event(&self, _event_id: EventId) -> Option<&EventName>

Returns the EventName registered for the provided EventId, if any.