NFT Collection Viewer

WHAT IT DOES

NFT Collection Viewer is a read-only tool that connects to any EVM-compatible blockchain and displays on-chain data for any NFT contract you specify. It works with both ERC-721 (non-fungible) and ERC-1155 (semi-fungible/multi-token) standards. Enter a contract address and the tool fetches the collection name, symbol, total supply, and the token IDs owned by your wallet (or a specified address). Each token's URI is displayed, showing where the off-chain metadata is hosted. The tool also shows your balance for the collection — how many NFTs you own from that contract.

HOW TO USE

Connect your wallet using the BGWallet bridge (MetaMask or any Web3 wallet). Ensure you are on the same network as the NFT contract you want to view — Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Base, or any EVM chain. Paste the contract address into the input field. Click "View collection" to see the collection metadata and a list of token IDs with their URIs. Click "My NFTs" to filter the results to only tokens owned by your connected wallet address. The tool automatically detects whether the contract is ERC-721 or ERC-1155 and uses the appropriate ABI for reading data.

TECHNICAL MECHANISM

The tool queries the contract directly via ethers.js using the provider from the connected wallet. It first checks if the contract exists and then attempts to detect the token standard by calling standard functions. For ERC-721, it checks the existence of ownerOf(0); for ERC-1155, it attempts balanceOf(address, 0). Once the standard is identified, it reads name(), symbol(), totalSupply(), and balanceOf(address) or balanceOf(address, id) accordingly. To find token IDs owned by an address, the tool fetches Transfer or TransferSingle events. Because public RPC nodes cap eth_getLogs block ranges, the tool uses a chunked scanning approach (PLAYBOOK-C §5.1): it walks backward from the latest block in configurable chunks, and if a chunk fails, it halves the chunk size and retries. This ensures the scan completes even on restrictive RPCs. The tool then retrieves tokenURI() for each discovered token ID — but does not fetch the external URL content, displaying only the URI string itself.

WHAT IT CANNOT SEE

The tool cannot view off-chain metadata (images, descriptions, attributes, animations) stored on IPFS, Arweave, or centralized servers without fetching external URLs — it only displays the URI string. It cannot display animated or interactive NFT media such as videos, 3D models, or audio files. It cannot verify the authenticity of a collection beyond the on-chain contract data — it does not check for verified contracts on block explorers, nor does it validate that the token URI points to genuine content. It cannot detect spam or duplicate collections. It cannot filter tokens by metadata attributes or traits. It cannot show transfer history beyond the current owner's tokens. The tool is read-only and does not sign any transactions.

PLEASE NOTE

This tool works exclusively on EVM-compatible chains (Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Base, Avalanche C-Chain, Fantom, and others). Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. The tool does not store any data — all reads happen live from the blockchain through your wallet provider. Performance depends on RPC response times and contract size. Large collections with many transfers may take longer to scan. The tool is provided as-is with no warranty or liability. Always verify contract addresses from trusted sources.