module_instance.hpp

Go to the documentation of this file.

#ifndef KAGOME_CORE_RUNTIME_MODULE_INSTANCE_HPP
#define KAGOME_CORE_RUNTIME_MODULE_INSTANCE_HPP

#include <string_view>

#include <boost/variant.hpp>
#include <optional>

#include "common/buffer.hpp"
#include "outcome/outcome.hpp"
#include "runtime/instance_environment.hpp"
#include "runtime/module_repository.hpp"
#include "runtime/ptr_size.hpp"

namespace kagome::runtime {

  static_assert(sizeof(float) == 4);
  static_assert(sizeof(double) == 8);
  using WasmValue = boost::variant<int32_t, int64_t, float, double>;

  class ModuleInstance {
   public:
    virtual ~ModuleInstance() = default;

    virtual const common::Hash256 &getCodeHash() const = 0;

    virtual outcome::result<PtrSize> callExportFunction(
        std::string_view name, common::BufferView encoded_args) const = 0;

    virtual outcome::result<std::optional<WasmValue>> getGlobal(
        std::string_view name) const = 0;

    using SegmentOffset = size_t;
    using SegmentData = gsl::span<const uint8_t>;
    using DataSegmentProcessor =
        std::function<void(SegmentOffset, SegmentData)>;
    virtual void forDataSegment(DataSegmentProcessor const &callback) const = 0;

    virtual InstanceEnvironment const &getEnvironment() const = 0;
    virtual outcome::result<void> resetEnvironment() = 0;
  };

}  // namespace kagome::runtime

#endif  // KAGOME_CORE_RUNTIME_MODULE_INSTANCE_HPP