Struct DefaultHost 

pub struct DefaultHost<D = DefaultDebugHandler, S = DefaultSourceManager>
where
    D: DebugHandler,
    S: SourceManager,
{ /* private fields */ }

A default SyncHost implementation that provides the essential functionality required by the VM.

Implementations

impl<D, S> DefaultHost<D, S>

where D: DebugHandler, S: SourceManager,

pub fn with_source_manager<O>(self, source_manager: Arc<O>) -> DefaultHost<D, O>

where O: SourceManager,

Use the given source manager implementation instead of the default one [DefaultSourceManager].

pub fn load_library( &mut self, library: impl Into<HostLibrary>, ) -> Result<(), ExecutionError>

Loads a HostLibrary containing a [MastForest] with its list of event handlers.

pub fn with_library( self, library: impl Into<HostLibrary>, ) -> Result<DefaultHost<D, S>, ExecutionError>

Adds a HostLibrary containing a [MastForest] with its list of event handlers. to the host.

pub fn register_handler( &mut self, event: EventName, handler: Arc<dyn EventHandler>, ) -> Result<(), ExecutionError>

Registers a single EventHandler into this host.

The handler can be either a closure or a free function with signature fn(&mut ProcessorState) -> Result<(), EventHandler>

pub fn unregister_handler(&mut self, id: EventId) -> bool

Un-registers a handler with the given id, returning a flag indicating whether a handler was previously registered with this id.

pub fn replace_handler( &mut self, event: EventName, handler: Arc<dyn EventHandler>, ) -> bool

Replaces a handler with the given event, returning a flag indicating whether a handler was previously registered with this event ID.

pub fn with_debug_handler<H>(self, handler: H) -> DefaultHost<H, S>

where H: DebugHandler,

Replace the current DebugHandler with a custom one.

pub fn debug_handler(&self) -> &D

Returns a reference to the DebugHandler, useful for recovering debug information emitted during a program execution.

Trait Implementations

impl<D, S> BaseHost for DefaultHost<D, S>

where D: DebugHandler, S: SourceManager,

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: &ProcessorState<'_>, options: &DebugOptions, ) -> Result<(), Box<dyn Error + Sync + Send>>

Handles the debug request from the VM.

fn on_trace( &mut self, process: &ProcessorState<'_>, trace_id: u32, ) -> Result<(), Box<dyn Error + Sync + Send>>

Handles the trace emitted from the VM.

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

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

impl<D, S> Debug for DefaultHost<D, S>

where D: Debug + DebugHandler, S: Debug + SourceManager,

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

Formats the value using the given formatter.

impl Default for DefaultHost

fn default() -> DefaultHost

Returns the “default value” for a type.

impl<D, S> SyncHost for DefaultHost<D, S>

where D: DebugHandler, S: SourceManager,

fn get_mast_forest(&self, node_digest: &Word) -> 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: &ProcessorState<'_>, ) -> Result<Vec<AdviceMutation>, Box<dyn Error + Sync + Send>>

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