Cross-Chain NFT Metadata Sync Tool

WHAT IT DOES

This tool provides cross-chain NFT metadata synchronization, enabling you to read metadata from a source chain NFT contract, verify consistency against a target chain, and update metadata on the target chain. It reads your connected wallet address, source chain NFT contract address, target chain NFT contract address, token IDs, metadata URIs, source chain metadata, target chain metadata, current block timestamp, and sync status per token. You can then sign and send transactions to read metadata from the source chain, verify consistency between source and target, update metadata on the target chain, and record sync metadata on-chain. All metadata parameters are displayed in a clear review panel before you sign, so you know exactly what you are syncing. The tool also logs transaction hashes, confirmation status, and gas costs, providing a complete audit trail of all sync activities.

HOW TO USE

Connect your wallet using the built-in wallet bridge, choose the network that matches your target chain (the source chain's metadata is read via tokenURI, which may require cross-chain compatibility or off-chain storage), and paste the source chain NFT contract address and target chain NFT contract address. Enter the token IDs you want to sync as a comma-separated list. The review panel shows all inputs and the current block timestamp before you sign. Use the numbered action buttons: read source metadata to fetch token URIs from the source chain contract, verify consistency to compare source and target metadata and identify mismatches, or sync to target to update the target chain contract with the source metadata for each token. You can also check sync status to view current metadata on the target chain. Each transaction is signed sequentially, and the tool displays transaction details and confirmation status.

THE REAL MECHANISM

This tool uses ethers.js v5.7.2 to build and send transactions through the wallet's signer. It does not rely on any hardcoded contract addresses – you paste the contracts you are using, so you are in full control. When you read source metadata, the tool calls the tokenURI function on the source chain contract for each token ID, fetching the URI string that points to the off-chain metadata. When you verify consistency, the tool compares the source and target URIs for each token ID and identifies any mismatches or missing entries. When you sync to the target, the tool calls the setTokenURI function on the target chain contract for each token ID, updating the metadata URI to match the source. The tool reads target metadata via the same tokenURI call to confirm the update. All transactions are sequential to prevent nonce conflicts, and gas costs are calculated using effectiveGasPrice for accurate post-EIP-1559 reporting.

WHAT IT CANNOT SEE

This tool cannot verify off-chain metadata authenticity, detect metadata tampering, ensure IPFS/Arweave availability, or verify that the target chain contract supports metadata updates correctly. It cannot detect if the metadata URI points to valid content or if the content has been altered off-chain. The tool also cannot verify that the target chain contract correctly handles metadata updates or that the source chain metadata is accurate. It cannot simulate the outcome of a transaction before you sign it, nor can it guarantee that the sync will be processed correctly if the contract is not properly implemented.

PLEASE NOTE

This tool works only on EVM-compatible chains supported by your wallet and provider. Always double-check the contract addresses, token IDs, and parameters before signing. Use testnet first. The tool is a transaction-signing interface and metadata management tool, not a metadata authenticity or content verification system.