first working implementation

Author: mihaicalinluca

framework/base/Cargo.toml

@@ -4,15 +4,23 @@ version = "0.56.0"
 edition = "2021"
 rust-version = "1.78"
 
-authors = ["Andrei Marinica <andrei.marinica@multiversx.com>", "MultiversX <contact@multiversx.com>"]
+authors = [
+    "Andrei Marinica <andrei.marinica@multiversx.com>",
+    "MultiversX <contact@multiversx.com>",
+]
 license = "GPL-3.0-only"
 readme = "README.md"
 repository = "https://github.com/multiversx/mx-sdk-rs"
 homepage = "https://multiversx.com/"
 documentation = "https://docs.multiversx.com/"
 description = "MultiversX smart contract API"
 keywords = ["multiversx", "wasm", "webassembly", "blockchain", "contract"]
-categories = ["no-std", "wasm", "cryptography::cryptocurrencies", "development-tools"]
+categories = [
+    "no-std",
+    "wasm",
+    "cryptography::cryptocurrencies",
+    "development-tools",
+]
 
 [package.metadata.docs.rs]
 all-features = true
@@ -28,6 +36,10 @@ hex-literal = "=0.4.1"
 bitflags = "=2.8.0"
 num-traits = { version = "=0.2.19", default-features = false }
 unwrap-infallible = "0.1.5"
+serde = { version = "1.0.217", features = [
+    "derive",
+    "alloc",
+], default-features = false }
 
 [dependencies.multiversx-sc-derive]
 version = "=0.56.0"

framework/base/src/abi.rs

@@ -19,14 +19,15 @@ pub use contract_abi::*;
 pub use endpoint_abi::*;
 pub use esdt_attribute_abi::EsdtAttributeAbi;
 pub use event_abi::*;
+use serde::Deserialize;
 pub use type_abi::*;
 pub use type_abi_from::*;
 pub use type_description::*;
 pub use type_description_container::*;
 
 pub type TypeName = alloc::string::String;
 
-#[derive(Clone, Default, Debug, PartialEq, Eq)]
+#[derive(Clone, Default, Debug, PartialEq, Eq, Deserialize)]
 pub struct TypeNames {
     pub abi: alloc::string::String,
     pub rust: alloc::string::String,

framework/base/src/abi/build_info_abi.rs

@@ -1,13 +1,13 @@
 /// Deisgned to hold metadata of the contract crate.
 /// Must be instanced inside the smart contract crate to work,
 /// that is why a `create` associated method would not make sense here.
-#[derive(Clone, Default, Debug)]
+#[derive(Clone, Default, Debug, PartialEq)]
 pub struct BuildInfoAbi {
     pub contract_crate: ContractCrateBuildAbi,
     pub framework: FrameworkBuildAbi,
 }
 
-#[derive(Clone, Default, Debug)]
+#[derive(Clone, Default, Debug, PartialEq)]
 pub struct ContractCrateBuildAbi {
     pub name: &'static str,
     pub version: &'static str,
@@ -16,7 +16,7 @@ pub struct ContractCrateBuildAbi {
 
 /// Gives the multiversx-sc metadata.
 /// Should be instanced via the `create` associated function.
-#[derive(Clone, Default, Debug)]
+#[derive(Clone, Default, Debug, PartialEq)]
 pub struct FrameworkBuildAbi {
     pub name: &'static str,
     pub version: &'static str,

framework/base/src/abi/endpoint_abi.rs

@@ -4,15 +4,16 @@ use alloc::{
     string::{String, ToString},
     vec::Vec,
 };
+use serde::Deserialize;
 
-#[derive(Clone, Debug)]
+#[derive(Clone, Debug, PartialEq, Deserialize)]
 pub struct InputAbi {
     pub arg_name: String,
     pub type_names: TypeNames,
     pub multi_arg: bool,
 }
 
-#[derive(Clone, Debug)]
+#[derive(Clone, Debug, PartialEq, Deserialize)]
 pub struct OutputAbi {
     pub output_name: String,
     pub type_names: TypeNames,
@@ -21,15 +22,15 @@ pub struct OutputAbi {
 
 pub type OutputAbis = Vec<OutputAbi>;
 
-#[derive(Clone, Default, Debug)]
+#[derive(Clone, Default, Debug, PartialEq, Deserialize)]
 pub enum EndpointMutabilityAbi {
     #[default]
     Mutable,
     Readonly,
     Pure,
 }
 
-#[derive(Clone, Default, Debug)]
+#[derive(Clone, Default, Debug, PartialEq, Deserialize)]
 pub enum EndpointTypeAbi {
     #[default]
     Init,
@@ -38,7 +39,7 @@ pub enum EndpointTypeAbi {
     PromisesCallback,
 }
 
-#[derive(Clone, Default, Debug)]
+#[derive(Clone, Default, Debug, PartialEq, Deserialize)]
 pub struct EndpointAbi {
     pub docs: Vec<String>,
     pub name: String,

framework/base/src/abi/esdt_attribute_abi.rs

@@ -1,8 +1,9 @@
 use alloc::string::{String, ToString};
+use serde::Deserialize;
 
 use super::{TypeAbi, TypeDescriptionContainerImpl, TypeName};
 
-#[derive(Clone, Debug)]
+#[derive(Clone, Debug, PartialEq, Deserialize)]
 pub struct EsdtAttributeAbi {
     pub ticker: String,
     pub ty: TypeName,

framework/base/src/abi/event_abi.rs

@@ -4,14 +4,14 @@ use alloc::{
     vec::Vec,
 };
 
-#[derive(Clone, Debug)]
+#[derive(Clone, Debug, PartialEq, Deserialize)]
 pub struct EventInputAbi {
     pub arg_name: String,
     pub type_name: TypeName,
     pub indexed: bool,
 }
 
-#[derive(Clone, Debug)]
+#[derive(Clone, Debug, PartialEq, Deserialize)]
 pub struct EventAbi {
     pub docs: Vec<String>,
     pub identifier: String,

framework/base/src/abi/type_description.rs

@@ -2,10 +2,11 @@ use alloc::{
     string::{String, ToString},
     vec::Vec,
 };
+use serde::Deserialize;
 
 use super::TypeNames;
 
-#[derive(Clone, Debug)]
+#[derive(Clone, Debug, PartialEq, Deserialize)]
 pub struct TypeDescription {
     pub docs: Vec<String>,
     pub names: TypeNames,
@@ -46,7 +47,7 @@ impl TypeDescription {
     }
 }
 
-#[derive(Clone, Debug)]
+#[derive(Clone, Debug, PartialEq, Deserialize)]
 pub enum TypeContents {
     NotSpecified,
     Enum(Vec<EnumVariantDescription>),
@@ -60,7 +61,7 @@ impl TypeContents {
     }
 }
 
-#[derive(Clone, Debug, PartialEq, Eq)]
+#[derive(Clone, Debug, PartialEq, Eq, Deserialize)]
 pub struct EnumVariantDescription {
     pub docs: Vec<String>,
     pub name: String,
@@ -87,7 +88,7 @@ impl EnumVariantDescription {
     }
 }
 
-#[derive(Clone, Debug, PartialEq, Eq)]
+#[derive(Clone, Debug, PartialEq, Eq, Deserialize)]
 pub struct StructFieldDescription {
     pub docs: Vec<String>,
     pub name: String,
@@ -110,7 +111,7 @@ impl StructFieldDescription {
 /// This makes it easier for humans to read readable in the transaction output.
 ///
 /// It cannot have data fields, only simple enums allowed.
-#[derive(Clone, Debug)]
+#[derive(Clone, Debug, PartialEq, Deserialize)]
 pub struct ExplicitEnumVariantDescription {
     pub docs: Vec<String>,
     pub name: String,

framework/base/src/abi/type_description_container.rs

@@ -17,7 +17,7 @@ pub trait TypeDescriptionContainer {
     fn insert_all(&mut self, other: &Self);
 }
 
-#[derive(Clone, Default, Debug)]
+#[derive(Clone, Default, Debug, PartialEq, Deserialize)]
 pub struct TypeDescriptionContainerImpl(pub Vec<(TypeNames, TypeDescription)>);
 
 impl TypeDescriptionContainer for TypeDescriptionContainerImpl {

framework/meta-lib/src/contract/generate_snippets.rs

@@ -1,3 +1,4 @@
+pub mod snippet_abi_check;
 pub mod snippet_crate_gen;
 pub mod snippet_gen_common;
 pub mod snippet_gen_main;