sysio::chain::wasm_interface Class Reference

#include <wasm_interface.hpp>

Public Types
enum class	vm_type { eos_vm , eos_vm_jit , eos_vm_oc }

Public Member Functions
	wasm_interface (vm_type vm, bool eosvmoc_tierup, const chainbase::database &d, const boost::filesystem::path data_dir, const eosvmoc::config &eosvmoc_config, bool profile)
	~wasm_interface ()
void	indicate_shutting_down ()
void	code_block_num_last_used (const digest_type &code_hash, const uint8_t &vm_type, const uint8_t &vm_version, const uint32_t &block_num)
void	current_lib (const uint32_t lib)
void	apply (const digest_type &code_hash, const uint8_t &vm_type, const uint8_t &vm_version, apply_context &context)
void	exit ()

Static Public Member Functions
static std::string	vm_type_string (vm_type vmtype)
static void	validate (const controller &control, const bytes &code)

Public Attributes
std::function< bool(const digest_type &code_hash, uint8_t vm_type, uint8_t vm_version, apply_context &context)>	substitute_apply

Detailed Description

Definition at line 25 of file wasm_interface.hpp.

Member Enumeration Documentation

vm_type

enum class sysio::chain::wasm_interface::vm_type

strong

Enumerator
eos_vm
eos_vm_jit
eos_vm_oc

Definition at line 27 of file wasm_interface.hpp.

                            {
            eos_vm,
            eos_vm_jit,
            eos_vm_oc
         };

Constructor & Destructor Documentation

wasm_interface()

sysio::chain::wasm_interface::wasm_interface	(	vm_type	vm,
		bool	eosvmoc_tierup,
		const chainbase::database &	d,
		const boost::filesystem::path	data_dir,
		const eosvmoc::config &	eosvmoc_config,
		bool	profile )

Definition at line 36 of file wasm_interface.cpp.

     : my( new wasm_interface_impl(vm, eosvmoc_tierup, d, data_dir, eosvmoc_config, profile) ) {}

~wasm_interface()

sysio::chain::wasm_interface::~wasm_interface

(

)

Definition at line 39 of file wasm_interface.cpp.

{}

Member Function Documentation

apply()

void sysio::chain::wasm_interface::apply	(	const digest_type &	code_hash,
		const uint8_t &	vm_type,
		const uint8_t &	vm_version,
		apply_context &	context )

Definition at line 81 of file wasm_interface.cpp.

                                                                                                                                       {
      if(substitute_apply && substitute_apply(code_hash, vm_type, vm_version, context))
         return;
#ifdef SYSIO_SYS_VM_OC_RUNTIME_ENABLED
      if(my->eosvmoc) {
         const chain::eosvmoc::code_descriptor* cd = nullptr;
         try {
            cd = my->eosvmoc->cc.get_descriptor_for_code(code_hash, vm_version);
         }
         catch(...) {
            //swallow errors here, if SYS VM OC has gone in to the weeds we shouldn't bail: continue to try and run baseline
            //In the future, consider moving bits of SYS VM that can fire exceptions and such out of this call path
            static bool once_is_enough;
            if(!once_is_enough)
               elog("SYS VM OC has encountered an unexpected failure");
            once_is_enough = true;
         }
         if(cd) {
            my->eosvmoc->exec.execute(*cd, my->eosvmoc->mem, context);
            return;
         }
      }
#endif
      my->get_instantiated_module(code_hash, vm_type, vm_version, context.trx_context)->apply(context);
   }

Here is the caller graph for this function:

code_block_num_last_used()

void sysio::chain::wasm_interface::code_block_num_last_used	(	const digest_type &	code_hash,
		const uint8_t &	vm_type,
		const uint8_t &	vm_version,
		const uint32_t &	block_num )

Definition at line 73 of file wasm_interface.cpp.

                                                                                                                                                           {
      my->code_block_num_last_used(code_hash, vm_type, vm_version, block_num);
   }

current_lib()

void sysio::chain::wasm_interface::current_lib

(

const uint32_t

lib

)

Definition at line 77 of file wasm_interface.cpp.

                                                      {
      my->current_lib(lib);
   }

exit()

void sysio::chain::wasm_interface::exit

(

)

Definition at line 107 of file wasm_interface.cpp.

                             {
      my->runtime_interface->immediately_exit_currently_running_module();
   }

indicate_shutting_down()

void sysio::chain::wasm_interface::indicate_shutting_down

(

)

Definition at line 69 of file wasm_interface.cpp.

                                               {
      my->is_shutting_down = true;
   }

validate()

void sysio::chain::wasm_interface::validate ( const controller & control, const bytes & code )

static

Definition at line 41 of file wasm_interface.cpp.

                                                                             {
      const auto& pso = control.db().get<protocol_state_object>();
 
      if (control.is_builtin_activated(builtin_protocol_feature_t::configurable_wasm_limits)) {
         const auto& gpo = control.get_global_properties();
         webassembly::eos_vm_runtime::validate( code, gpo.wasm_configuration, pso.whitelisted_intrinsics );
         return;
      }
      Module module;
      try {
         Serialization::MemoryInputStream stream((U8*)code.data(), code.size());
         WASM::serialize(stream, module);
      } catch(const Serialization::FatalSerializationException& e) {
         SYS_ASSERT(false, wasm_serialization_error, e.message.c_str());
      } catch(const IR::ValidationException& e) {
         SYS_ASSERT(false, wasm_serialization_error, e.message.c_str());
      }
 
      wasm_validations::wasm_binary_validation validator(control, module);
      validator.validate();
 
      webassembly::eos_vm_runtime::validate( code, pso.whitelisted_intrinsics );
 
      //there are a couple opportunties for improvement here--
      //Easy: Cache the Module created here so it can be reused for instantiaion
      //Hard: Kick off instantiation in a separate thread at this location
     }

Here is the call graph for this function:

Here is the caller graph for this function:

vm_type_string()

static std::string sysio::chain::wasm_interface::vm_type_string ( vm_type vmtype )

inlinestatic

Definition at line 34 of file wasm_interface.hpp.

                                                         {
             switch (vmtype) {
             case vm_type::eos_vm:
                return "sys-vm";
             case vm_type::eos_vm_oc:
                return "sys-vm-oc";
             default:
                 return "sys-vm-jit";
             }
         }

Here is the caller graph for this function:

Member Data Documentation

substitute_apply

std::function<bool( const digest_type& code_hash, uint8_t vm_type, uint8_t vm_version, apply_context& context)> sysio::chain::wasm_interface::substitute_apply

Definition at line 69 of file wasm_interface.hpp.

---

The documentation for this class was generated from the following files:

• libraries/chain/include/sysio/chain/wasm_interface.hpp
• libraries/chain/wasm_interface.cpp