mvx_sdk_py_transactions_skill

Overview

This skill implements transaction creation and token operations for the MultiversX Python SDK. It provides Controllers and Factories to build native EGLD transfers, ESDT token transfers (fungible and non-fungible), token issuance transactions, and relayed transactions. It also includes utilities for decoding transaction data and parsing on-chain events.

How this skill works

Controllers expose high-level methods to build transactions: transfers, token issuance, and token management actions. TokenTransfer helpers normalize amounts and decimals for ESDT operations. Transactions can be signed by sender and relayer when using relayed (V3) flows, and the SDK includes decoding/parsing helpers to inspect transaction function calls and events.

When to use it

• To send native EGLD between accounts with correct nonce handling.
• To transfer fungible ESDT tokens while preserving decimal precision.
• To transfer NFTs or SFTs with the correct token amount encoding.
• To issue new fungible tokens and await on-chain issuance outcome.
• To create and submit relayed transactions requiring both sender and relayer signatures.
• To decode transaction payloads and parse on-chain events for auditing or UI updates.

Best practices

• Use TokenTransfer helper constructors (fungible_from_amount, nft_from_amount) to avoid manual decimal mistakes.
• Always increment or fetch nonce via account.get_nonce_then_increment() to prevent replay or nonce conflicts.
• Check issuance outcome after sending token-creation transactions — issued identifiers include randomized suffixes.
• When using relayed transactions ensure sender and relayer accounts are in the same shard and allocate extra gas for relayer execution.
• Rely on Controller gas estimation for common flows but validate gas limits for complex smart contract interactions.

Example use cases

• Create and send a simple EGLD transfer from a custodial account to a user.
• Transfer 100.5 units of a fungible ESDT token to a marketplace contract using TokenTransfer helpers.
• Issue a new fungible token with custom permissions and retrieve the generated token identifier after confirmation.
• Transfer an NFT/SFT from a user to another address as part of a marketplace settlement.
• Build a relayed transaction where the user signs the payload and a relayer pays gas and appends a relayer signature.
• Decode transaction data and iterate contract event logs to extract emitted identifiers and topics for indexing.