feat: Wasm module implementation

.config/dictionaries/project.dic

@@ -88,5 +88,6 @@ vitss
 voteplan
 voteplans
 WASI
+wasmtime
 webasm
 yoroi

hermes/Cargo.toml

@@ -11,7 +11,6 @@ version = "0.0.1"
 authors = [
     "Steven Johnson <steven.johnson@iohk.io>"
 ]
-rust-version = "1.73"
 homepage = "https://input-output-hk.github.io/hermes"
 repository = "https://github.com/input-output-hk/hermes"
 license = "MIT OR Apache-2.0"
@@ -55,3 +54,6 @@ missing_docs_in_private_items = "deny"
 # issue: https://github.com/input-output-hk/hermes/issues/63
 pallas = { version = "0.21.0", git = "https://github.com/input-output-hk/catalyst-pallas.git", branch = "feat/hardano-read-blocks-iter-send" }
 pallas-hardano = { version = "0.21.0", git = "https://github.com/input-output-hk/catalyst-pallas.git", branch = "feat/hardano-read-blocks-iter-send" }
+
+wasmtime = "16.0.0"
+thiserror = "1.0"

hermes/bin/Cargo.toml

@@ -11,3 +11,7 @@ repository.workspace = true
 
 [lints]
 workspace = true
+
+[dependencies]
+thiserror = { workspace = true }
+wasmtime = { workspace = true, features = ["component-model"] }

hermes/bin/src/lib.rs

@@ -1,2 +1,4 @@
 //! Intentionally empty
 //! This file exists, so that doc tests can be used inside binary crates.
+
+mod wasm;

hermes/bin/src/wasm/engine.rs

@@ -0,0 +1,43 @@
+//! WASM engine implementation
+//! Wrapper over the `wasmtime::Engine` struct with some specific configuration setup.
+
+use std::ops::{Deref, DerefMut};
+
+use wasmtime::{Config as WasmConfig, Engine as WasmEngine};
+
+use super::Error;
+
+/// WASM Engine struct
+pub(crate) struct Engine(WasmEngine);
+
+impl Deref for Engine {
+    type Target = WasmEngine;
+
+    fn deref(&self) -> &Self::Target {
+        &self.0
+    }
+}
+
+impl DerefMut for Engine {
+    fn deref_mut(&mut self) -> &mut Self::Target {
+        &mut self.0
+    }
+}
+
+impl Engine {
+    /// Creates a new instance of the `Engine`.
+    ///
+    /// # Errors
+    ///
+    /// - `Error::Wasm`. Returns an error if the `WasmEngine` fails to initialize.
+    #[allow(dead_code)]
+    pub(crate) fn new() -> Result<Self, Error> {
+        let mut config = WasmConfig::new();
+        config.wasm_component_model(true);
+        config.consume_fuel(false);
+
+        let engine = WasmEngine::new(&config)?;
+
+        Ok(Self(engine))
+    }
+}

hermes/bin/src/wasm/mod.rs

@@ -0,0 +1,29 @@
+//! WASM related structures and functions.
+//! All implementation based on [wasmtime](https://crates.io/crates/wasmtime) crate dependency.
+
+mod engine;
+mod module;
+
+/// WASM module errors.
+#[derive(thiserror::Error, Debug)]
+enum Error {
+    /// Exports mismatch
+    #[error("Exports mismatch")]
+    ExportsMismatch,
+
+    /// Imports mismatch
+    #[error("Imports mismatch")]
+    ImportsMismatch,
+
+    /// Export module entity is not a function
+    #[error("Export module entity is not a function, name: {0}")]
+    ExportNotAFunc(String),
+
+    /// Import module entity is not a function
+    #[error("Import module entity is not a function, module: {0}, name: {1}")]
+    ImportNotAFunc(String, String),
+
+    /// Internal wasmtime errors
+    #[error(transparent)]
+    Wasm(#[from] wasmtime::Error),
+}