Latest API Releases

This release unlocks native execution of smart contracts in blackbox tests for the first time. That means you can now test your code against real contracts, even without their source, and simulate realistic, multi-contract behavior. 

‍

It also adds Rust 1.87 support, experimental gas metering, Wasmer 6 support, and a streamlined build system.

‍

For questions or help, reach us on Telegram or Discord channels. 

‍

• Replicated VM 1.5 in the Rust VM. This includes support for:
• promises,
• back-transfers,
• modified event logs.
• New endpoint annotation, `#[upgrade]`. Contract variants with upgrade endpoint, but without init now allowed.
• Build system:
• `wasm` crates now fully generated based on data from `sc-config.toml` and root `Cargo.toml`.
• Setting wasm target dir automatically, if not specified, based on workspace.
• Better hygiene in codec derive.

• Back-transfer:
• API support in framework (not yet implemented in the Rust VM);
• Feature flag: `"back-transfers"`;
• EI updated.
• ESDT attribute ABI annotation and generator.
• Multiple var-args disallowed, unless annotating endpoint with `#[allow_multiple_var_args]`.
• Build system updates:
• `multicontract.toml` renamed to `sc-config.toml`;
• `add-unlabelled` default true.
• New `FunctionCall` object & refactoring. Can be used as multi-value to pass contract call info to contracts.
• `AddressToId` storage mapper.

Hello xWorld!

• Fixed a rustc compatibility issue when building contracts. The meta crate looks at the rustc version when generating the wasm crate code.
• Initial version of the contract template tool in multiversx-sc-meta.
• The Rust debugger is now thread safe.
• Removed the `big-float` feature of multiversx-sc, because the functionality is already available on mainnet.
• CLI fixes in multiversx-sc-meta: arguments `--target-dir-wasm`, `--target-dir-meta`, and `--target-dir-all` in the `multiversx-sc-meta`
• Fixed an issue with contract calls and ESDT transfers in the `StaticApi` environment.

And many many other goodies. Check the detailed description of this release and join us on Discord, where you can connect with fellow builders and developers, share your feedback, ask for details, contribute with constructive ideas. And starting last week we have the monthly live dev sessions where you can meet us and discuss in detail every characteristic and detail.

• Multi-endpoints in multi-contracts:
• It is now possible to have multiple versions of the same endpoint in different multi-contract variants.
• We can also have multiple versions of the constructor.
• Major architectural redesign of the debugger:
• The VM executor interface inserted between the smart contract API objects and the Rust VM. A new VMHooksApi is used to connect on the smart contract side. A VMHooksDispatcher object and VMHooksHandler interface provide the connection on the VM side.
• The VMHooksApi comes in several flavors (backends):
• The old DebugApi is now only used at runtime, on the VM context stack;
• A new StaticApi provides support for managed types in a regular context, without needing to be initialized;
• An additional SingleTxApi is useful for unit tests. Aside managed types, it also allows some basic context for tx inputs, results, storage and block info.
• Removed almost all of the legacy functionality from the smart contract APIs.
• System SC mock.
• It is now possible to issue tokens (fungible, SFT, NFT) in integration tests.
• Setting roles is modeled.
• It is, however, not fully mocked.

And many many other goodies. Check the detailed description of this release and join us on Discord, where you can connect with fellow builders and developers, share your feedback, ask for details, contribute with constructive ideas.

Hello xWorld!

This is a hotfix release, there will be more substantial changes to these mappers in the next minor release:

• Fixed an edge case for the token storage mappers (FungibleTokenMapper, NonFungibleTokenMapper);

Send us feedback and let's get in touch if you have any improvement ideas. Become a maintainer!