multiversx-project-architecture

Generate MultiversX smart contract project structures with module composition patterns.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides battle-tested project structures and module composition patterns for MultiversX smart contracts, ensuring maintainability, scalability, and adherence to best practices from the start.

Core Features & Use Cases

  • Single Contract Structure: Optimized layout for smaller to medium-sized contracts.
  • Multi-Contract Workspace Structure: Patterns for complex protocols with multiple interacting contracts and shared logic.
  • Module Composition: Guidance on organizing contract logic into reusable modules (storage, views, helpers, etc.).
  • Use Case: When starting a new MultiversX smart contract project, use this Skill to set up a clean, modular, and scalable directory structure that follows established patterns.

Quick Start

Apply the single contract project structure to a new MultiversX smart contract.

Frequently Asked Questions about multiversx-project-architecture

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

FAQPage Schema
How do I structure a MultiversX smart contract project for maintainability?

To structure a MultiversX smart contract project, apply production-grade directory patterns that organize logic into reusable modules like storage, views, and helpers, ensuring scalability and idiomatic Rust practices.

What is the best way to organize multiple interacting MultiversX smart contracts?

For multiple interacting MultiversX smart contracts, use a multi-contract workspace structure that separates complex protocols into distinct contracts while sharing common logic to maintain a scalable codebase.

How do I organize storage and events in a Rust smart contract?

Organize storage and events in a Rust smart contract by separating them into dedicated, reusable modules. This enforces idiomatic practices for validation and error handling, keeping the codebase clean and modular.

When should I use a single contract structure versus a multi-contract workspace?

Use a single contract structure for smaller to medium-sized smart contracts to keep the layout optimized. Choose a multi-contract workspace when dealing with complex protocols that require multiple interacting contracts.

Does this architecture pattern support shared logic across multiple smart contracts?

Yes, the multi-contract workspace pattern supports shared logic across multiple interacting smart contracts. It allows you to organize and reuse common modules, facilitating maintainability for complex protocols.