child_storage_extension.hpp

Go to the documentation of this file.

#ifndef KAGOME_HOST_API_CHILD_STORAGE_EXTENSION_HPP
#define KAGOME_HOST_API_CHILD_STORAGE_EXTENSION_HPP

#include <cstdint>

#include "common/buffer.hpp"
#include "log/logger.hpp"
#include "runtime/types.hpp"

namespace kagome::runtime {
  class MemoryProvider;
  class TrieStorageProvider;
  class Memory;
}  // namespace kagome::runtime

namespace kagome::host_api {
  class ChildStorageExtension {
   public:
    ChildStorageExtension(
        std::shared_ptr<runtime::TrieStorageProvider> storage_provider,
        std::shared_ptr<const runtime::MemoryProvider> memory_provider);

    // ---------------------------- Child Storage ----------------------------

    void ext_default_child_storage_set_version_1(
        runtime::WasmSpan child_storage_key,
        runtime::WasmSpan key,
        runtime::WasmSpan value);

    runtime::WasmSpan ext_default_child_storage_get_version_1(
        runtime::WasmSpan child_storage_key, runtime::WasmSpan key) const;

    void ext_default_child_storage_clear_version_1(
        runtime::WasmSpan child_storage_key, runtime::WasmSpan key);

    runtime::WasmSpan ext_default_child_storage_next_key_version_1(
        runtime::WasmSpan child_storage_key, runtime::WasmSpan key) const;

    runtime::WasmSpan ext_default_child_storage_root_version_1(
        runtime::WasmSpan child_storage_key) const;

    void ext_default_child_storage_clear_prefix_version_1(
        runtime::WasmSpan child_storage_key, runtime::WasmSpan prefix);

    runtime::WasmSpan ext_default_child_storage_read_version_1(
        runtime::WasmSpan child_storage_key,
        runtime::WasmSpan key,
        runtime::WasmSpan value_out,
        runtime::WasmOffset offset) const;

    uint32_t ext_default_child_storage_exists_version_1(
        runtime::WasmSpan child_storage_key, runtime::WasmSpan key) const;

    void ext_default_child_storage_storage_kill_version_1(
        runtime::WasmSpan child_storage_key);

   private:
    std::shared_ptr<runtime::TrieStorageProvider> storage_provider_;
    std::shared_ptr<const runtime::MemoryProvider> memory_provider_;
    log::Logger logger_;

    constexpr static auto kDefaultLoggerTag =
        "WASM Runtime [ChildStorageExtension]";

    template <typename R, typename F, typename... Args>
    outcome::result<R> executeOnChildStorage(
        const common::Buffer &child_storage_key, F func, Args &&...args) const;
  };

}  // namespace kagome::host_api

#endif  // KAGOME_CHILD_STORAGE_HostApiS_HostApi_HPP