mvx_protocol_experts_skill

Overview

This skill provides expert knowledge of the MultiversX protocol, including adaptive state sharding, SPoS consensus, ESDT token semantics, and sovereign chain patterns. It is designed to help protocol reviewers, dApp architects, and integrators reason about cross-shard logic, token behavior, and secure integration patterns. The content emphasizes practical checks and common pitfalls for production-grade systems.

How this skill works

The skill inspects and explains MultiversX core components: network/transaction/state sharding, the metachain coordinator, and cross-shard transaction flow (Process -> Relay -> Execute). It details the SPoS consensus mechanics, BLS multi-signing, and instant finality within shards. It also covers ESDT native token behaviors, built-in transfer primitives, and sovereign chain gateway/settlement patterns for interoperability.

When to use it

• Designing dApps that may invoke accounts across shards or require cross-shard callbacks
• Reviewing protocol-level proposals, MIPs, or consensus/validator changes
• Auditing token logic that depends on native ESDT capabilities (mint/burn/freeze)
• Integrating a sovereign chain or building bridge/gateway contracts
• Implementing backend services that must handle reorgs and finality semantics

Best practices

• Assume a call may be cross-shard unless you verify co-location; use async calls with callbacks when results are required
• Wait for finalized status or explicitly handle re-org events in off-chain services
• Use protocol-native ESDT operations for token transfers instead of emulating tokens in smart contracts
• Design cross-shard flows as atomic-but-asynchronous and account for relay/latency delays
• Leverage BLS signature properties and deterministic validator selection when modelling validator or slashing logic

Example use cases

• Architecting a cross-shard marketplace that safely updates buyer and seller balances via async callbacks
• Reviewing a MIP that changes validator selection, slashing, or epoch handling
• Designing a sovereign chain gateway and settlement process to post proofs back to Mainchain
• Implementing an indexer or microservice that tracks only finalized state to avoid inconsistent reads
• Creating batch transfer tooling using MultiESDTNFTTransfer for efficient contract interactions