Dynamic NFT Metadata Updater

WHAT IT DOES

The Dynamic NFT Metadata Updater enables users to update the on-chain metadata of dynamic NFTs. It reads NFT contract state for ERC-721 and ERC-1155 tokens, user address, wallet balance, token ID, and current metadata including name, description, image, and attributes. The tool processes update parameters such as new name, new description, new image, and new attributes. It supports updateMetadata for standard updates, batchUpdateMetadata for multiple updates in one transaction, and updateMetadataWithProof for proof-based updates. The tool reads gas price, base fee, block timestamp, chain ID, transaction nonce, approval state, contract owner state, and update authority before execution.

HOW TO USE

Connect your wallet and select the target network. Enter the NFT contract address and the token ID. Provide the new metadata fields: name, description, image URL, and attributes (as JSON). Choose the execution method (updateMetadata, batchUpdateMetadata, or updateMetadataWithProof). The tool will fetch the current metadata and display the existing values. Once confirmed, it submits the update transaction. The tool validates that at least one field is being updated before signing.

TECHNICAL MECHANISM

Unlike static NFT tools, this executor is purpose-built for dynamic metadata workflows. It first reads the contract's isActive() to ensure the contract is operational. The tool fetches the current metadata via getMetadata() to display existing values and check the last update timestamp. It selects the optimal method: updateMetadata for standard updates, batchUpdateMetadata for multiple tokens in one transaction, or updateMetadataWithProof for proof-based updates where the update must be authorized by a proof. The metadata fields (name, description, image, attributes) are stored as strings on-chain. Gas costs are calculated using receipt.effectiveGasPrice for accurate post-EIP-1559 fee accounting. The tool displays the current and new metadata before confirmation.

WHAT IT CANNOT SEE

This tool cannot verify that the updated metadata accurately reflects the intended content or that the new data is valid. It cannot detect if the metadata has already been updated or if the updater has sufficient authority. It also cannot guarantee that the updated metadata will be displayed correctly by all platforms. The tool cannot verify the image URL accessibility or detect if the attributes are correctly formatted. It also cannot detect if the contract has been paused or upgraded.

PLEASE NOTE

This tool supports EVM-compatible chains. Updating metadata is irreversible—verify all fields before signing. The NFT contract must implement the update functions expected by this tool. Attributes must be valid JSON format. Batch updates require arrays of token IDs and metadata fields. Proof-based updates require valid proof data. This tool does not validate image URLs or metadata formatting—it only submits the update. For SVG rendering, use the On-Chain SVG NFT Renderer Tool.