multiversx-scenario-migration

Convert legacy .scen.json tests to Rust blackbox tests with sc-meta scen-blackbox.

12|5|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/multiversx/mx-ai-skills --skill multiversx-scenario-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: multiversx-scenario-migration
Source: https://github.com/multiversx/mx-ai-skills/tree/main/skills/multiversx-scenario-migration
Command: npx skills add https://github.com/multiversx/mx-ai-skills --skill multiversx-scenario-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the conversion of legacy .scen.json test files into modern, type-safe Rust blackbox tests, streamlining the testing process for MultiversX smart contracts.

Core Features & Use Cases

  • Automated Test Generation: Converts existing scenario JSON files into executable Rust test code.
  • Code Structure: Generates separate test and step functions for reusability and maintainability.
  • Use Case: You have a MultiversX smart contract project with many old .scen.json files. Use this Skill to quickly generate Rust equivalents, saving significant manual conversion time and reducing the risk of errors.

Quick Start

Run the sc-meta scen-blackbox command to convert your contract's scenario JSON files to Rust blackbox tests.

Frequently Asked Questions about multiversx-scenario-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert MultiversX .scen.json scenario tests to Rust?

To convert MultiversX scenario tests to Rust, use the `sc-meta scen-blackbox` utility to parse legacy `.scen.json` files and auto-generate typed Rust blackbox test modules. This automates the transition from JSON scenario definitions to idiomatic Rust code.

What is the best way to migrate legacy scenario tests for MultiversX smart contracts?

The best way to migrate legacy scenario tests is using automated test generation. Converting `.scen.json` files into executable Rust blackbox tests saves significant manual conversion time and reduces the risk of errors by generating separate test and step functions for reusability.

Does the sc-meta scen-blackbox utility generate reusable Rust test functions?

Yes, the `sc-meta scen-blackbox` utility generates separate test and step functions. This code structure ensures reusability and maintainability when transitioning your MultiversX smart contract testing frameworks from legacy JSON definitions to Rust.

Can I use this scenario test migration for existing MultiversX smart contract projects?

Yes, if you have a MultiversX smart contract project with many old `.scen.json` files, you can use this migration process to quickly generate Rust equivalents. It requires the `sc-meta` tool to parse your existing JSON test structures.

Why should I migrate .scen.json files to Rust blackbox tests?

You should migrate `.scen.json` files to Rust blackbox tests to achieve type-safe, modern testing for MultiversX smart contracts. Auto-generating executable Rust test code from existing scenario definitions streamlines the testing process and reduces manual conversion errors.