composability interactor (mesh), part 1

.claude.md

@@ -0,0 +1,12 @@
+# Claude Guidelines for mx-sdk-rs
+
+## Auto-Generated Files — Do Not Edit
+
+Never modify files that begin with `// Code generated`. These are auto-generated by the build system and will be overwritten.
+
+This applies especially to:
+
+- **Proxy files** (`*_proxy.rs`) — generated with: `sc-meta all proxy`
+- **Wasm crate contents** (`*/wasm/src/lib.rs`, `*/wasm/Cargo.toml`) — generated by the multiversx-sc build system, with: `sc-meta all build`
+
+If a change is needed in an auto-generated file, modify the source it is generated from (e.g. the smart contract trait or `sc-config.toml`) and regenerate:

.gitignore

@@ -37,6 +37,7 @@ my-vm-tests.sh
 quick.sh
 template-test
 install-debugger-test
+.DS_Store
 
 # Zip output with example wasm binaries
 examples-wasm.zip

CHANGELOG.md

@@ -871,7 +871,7 @@ First pre-release of the unified syntax. Syntax not yet stabilized, should only
 	- build post-processing: `wasm2wat`, imports via `wasm-objdump`.
 - Support for the new async call system (promises):
 	- new APIs;
-	- a new flavor of callbacks (`#[promises-callback]`);
+	- a new flavor of callbacks (`#[promises_callback]`);
 	- callback optimizations.
 - `elrond-codec` refactor: removed `TopEncodeNoErr`, `NestedEncodeNoErr` and `TypeInfo`
 - System SC proxy: added support for `controlChanges` endpoint and transfer create role (from community).

Cargo.toml

@@ -125,7 +125,6 @@ members = [
   "contracts/feature-tests/big-float-features",
   "contracts/feature-tests/big-float-features/meta",
   "contracts/feature-tests/composability",
-  "contracts/feature-tests/composability/interact",
   "contracts/feature-tests/composability/builtin-func-features",
   "contracts/feature-tests/composability/builtin-func-features/meta",
   "contracts/feature-tests/composability/esdt-contract-pair",
@@ -142,14 +141,15 @@ members = [
   "contracts/feature-tests/composability/forwarder-interactor",
   "contracts/feature-tests/composability/forwarder-legacy",
   "contracts/feature-tests/composability/forwarder-legacy/meta",
-  "contracts/feature-tests/composability/forwarder-queue",
-  "contracts/feature-tests/composability/forwarder-queue/meta",
   "contracts/feature-tests/composability/forwarder-blind",
   "contracts/feature-tests/composability/forwarder-blind/meta",
   "contracts/feature-tests/composability/forwarder-raw",
   "contracts/feature-tests/composability/forwarder-raw/meta",
   "contracts/feature-tests/composability/local-esdt-and-nft",
   "contracts/feature-tests/composability/local-esdt-and-nft/meta",
+  "contracts/feature-tests/composability/mesh-interactor",
+  "contracts/feature-tests/composability/mesh-node",
+  "contracts/feature-tests/composability/mesh-node/meta",
   "contracts/feature-tests/composability/proxy-test-first",
   "contracts/feature-tests/composability/proxy-test-first/meta",
   "contracts/feature-tests/composability/proxy-test-second",

chain/core/src/types/flags/code_metadata.rs

@@ -10,29 +10,49 @@ const PAYABLE_BY_SC_STRING: &str = "PayableBySC";
 const DEFAULT_STRING: &str = "Default";
 
 bitflags! {
+    /// Flags representing the smart contract's allowed actions after deploy.
     #[derive(Default, PartialEq, Debug, Clone, Copy)]
     pub struct CodeMetadata: u16 {
+        /// No flags set. The contract is not upgradeable, not readable, and not payable.
         const DEFAULT = 0;
+
+        /// The contract can be upgraded in the future.
         const UPGRADEABLE = 0b0000_0001_0000_0000; // LSB of first byte
+
+        /// The contract's storage can be read by other contracts.
         const READABLE = 0b0000_0100_0000_0000; // 3rd LSB of first byte
+
+        /// The contract can receive funds without having any endpoint called,
+        /// just like user accounts.
+        ///
+        /// Note: a contract does NOT have to be payable to receive funds
+        /// in payable endpoints.
         const PAYABLE = 0b0000_0000_0000_0010; // 2nd LSB of second byte
+
+        /// Like [`CodeMetadata::PAYABLE`], but only allows receiving funds from
+        /// other smart contracts. Direct user transfers will be rejected.
         const PAYABLE_BY_SC = 0b0000_0000_0000_0100; // 3rd LSB of second byte
     }
 }
 
 impl CodeMetadata {
+    /// Returns `true` if the contract is allowed to be upgraded.
     pub fn is_upgradeable(&self) -> bool {
         *self & CodeMetadata::UPGRADEABLE != CodeMetadata::DEFAULT
     }
 
+    /// Returns `true` if the contract can receive funds without an endpoint call.
     pub fn is_payable(&self) -> bool {
         *self & CodeMetadata::PAYABLE != CodeMetadata::DEFAULT
     }
 
+    /// Returns `true` if the contract can receive funds from other smart contracts
+    /// without an endpoint call. Direct user transfers are rejected.
     pub fn is_payable_by_sc(&self) -> bool {
         *self & CodeMetadata::PAYABLE_BY_SC != CodeMetadata::DEFAULT
     }
 
+    /// Returns `true` if the contract's storage can be read by other contracts.
     pub fn is_readable(&self) -> bool {
         *self & CodeMetadata::READABLE != CodeMetadata::DEFAULT
     }

chain/core/src/types/shard_config.rs

@@ -5,6 +5,11 @@ use super::Address;
 /// Regular shards are numbered from `0` to `number_of_shards - 1`.
 /// The special value [`ShardId::METACHAIN_ID`] (`u32::MAX`) identifies the metachain.
 #[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
+#[cfg_attr(
+    feature = "serde",
+    derive(serde::Serialize, serde::Deserialize),
+    serde(transparent)
+)]
 pub struct ShardId(u32);
 
 impl ShardId {

contracts/feature-tests/composability/Cargo.toml

@@ -14,15 +14,15 @@ path = "forwarder"
 [dev-dependencies.forwarder-legacy]
 path = "forwarder-legacy"
 
-[dev-dependencies.forwarder-queue]
-path = "forwarder-queue"
-
 [dev-dependencies.forwarder-blind]
 path = "forwarder-blind"
 
 [dev-dependencies.forwarder-raw]
 path = "forwarder-raw"
 
+[dev-dependencies.mesh-node]
+path = "mesh-node"
+
 [dev-dependencies.proxy-test-first]
 path = "proxy-test-first"