multiversx-sharp-edges

Catalog MultiversX smart contract pitfalls and platform-specific quirks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers avoid common pitfalls and unexpected behaviors specific to the MultiversX blockchain, preventing bugs and security vulnerabilities.

Core Features & Use Cases

  • Identify Gotchas: Understand non-obvious behaviors in async calls, gas limits, storage, and upgradeability.
  • Prevent Bugs: Learn from examples of common mistakes and their solutions.
  • Security Audits: Use as a checklist to find subtle platform-specific vulnerabilities.
  • Onboarding: Accelerate learning for new MultiversX developers.

Quick Start

Explain the sharp edge regarding async callbacks and state reverts in MultiversX.

Frequently Asked Questions about multiversx-sharp-edges

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

FAQPage Schema
Why do MultiversX smart contract async callbacks cause state reverts, and how do I handle them?

MultiversX async callbacks can trigger state reverts due to non-obvious platform behaviors and pending callback tracking issues. This catalog identifies these async boundary quirks and offers solutions to prevent unexpected state changes and cache invalidation during contract execution.

What are common MultiversX storage mapper gotchas like VecMapper indexing and MapMapper memory models?

Common MultiversX storage mapper gotchas involve VecMapper indexing offsets, MapMapper memory model overhead, and storage key collisions. Reviewing these platform-specific behaviors helps prevent data corruption and optimize gas limits during smart contract debugging.

How do I prevent rounding attack vectors and token decimal precision errors in MultiversX dApps?

Preventing rounding attack vectors and token decimal precision errors in MultiversX dApps requires understanding NonZeroBigUint in payments and EGLD/ESDT transfer behaviors. This Skill highlights these subtle vulnerabilities to secure your smart contracts.

When should I use require vs sc_panic in MultiversX smart contracts for security audits?

Choosing between require vs sc_panic in MultiversX smart contracts impacts error handling and backtransfers accumulation during security audits. This catalog explains the distinct behaviors of each method to help you avoid common pitfalls and secure contract upgradeability.

Does block info in MultiversX view functions behave differently than in regular smart contract calls?

Block info in MultiversX view functions exhibits non-obvious behaviors compared to regular calls, which can lead to unexpected logic errors. This Skill documents these platform-specific quirks to ensure accurate data retrieval during code reviews and debugging.

What MultiversX upgradeability pitfalls should I check for storage key collisions and cache invalidation?

MultiversX upgradeability pitfalls often involve storage key collisions and cache invalidation across async boundaries after contract updates. This catalog provides a comprehensive checklist to identify these known limitations and secure your dApps during migration.