Polygon zkEVM NFT Collection Airdrop-Push Tool

WHAT IT DOES

Polygon zkEVM NFT Collection Airdrop-Push Tool is a comprehensive NFT analytics and distribution tool that automates the entire workflow of identifying NFT holders and pushing airdrops to them on Polygon zkEVM. The tool scans the blockchain to find all current holders of a specified NFT collection (ERC-721 or ERC-1155) by analyzing Transfer events, reads their holdings, and then pushes an airdrop—either ERC-20 tokens, ERC-721 NFTs, or ERC-1155 tokens—to all holders in a single batched transaction. This is ideal for NFT collection rewards, holder airdrops, token-gated distributions, and any scenario where you want to reward all holders of an NFT collection based on their holdings on Polygon zkEVM. The tool handles the complete workflow—from on-chain data gathering to distribution—in one unified interface on Polygon zkEVM's low-cost zk-rollup network, eliminating the need for external analytics tools, manual CSV creation, and multiple transaction submissions.

HOW TO USE

Connect your Web3 wallet to Polygon zkEVM. Enter the NFT contract address—this can be either an ERC-721 or ERC-1155 collection. Select the NFT standard and optionally specify a token ID for ERC-1155 collections. Set a minimum holding threshold to exclude holders with too few NFTs. Enter the token contract address to airdrop. Select the airdrop type: ERC-20 token, ERC-721 NFT, or ERC-1155 token. Enter the amount per holder (or token ID for NFTs). Optionally, paste an exclude list of addresses to omit. Click the take snapshot button—the tool scans Transfer events from the NFT contract's genesis to the current block using chunked log queries that automatically halve the chunk size on RPC failures, ensuring reliable scanning even with public RPC limits. Click prepare airdrop to calculate the distribution. Review the holder list, then click the push airdrop button to distribute in a single batched transaction on Polygon zkEVM.

MECHANISM: CHUNKED LOG SCANNING WITH NFT HOLDER AGGREGATION AND PUSH DISTRIBUTION

The tool implements a robust two-phase mechanism for NFT collections on Polygon zkEVM. First, it scans Transfer events from the NFT contract using eth_getLogs with automatic chunking and halving on failure—a critical feature because public RPCs cap block ranges differently and a single refusal should not end the scan. Starting from block 0, the tool queries logs in chunks of 50,000 blocks. If an RPC refuses a request, the tool halves the chunk size and retries. The tool supports both ERC-721 (Transfer event with tokenId) and ERC-1155 (TransferSingle events with amount and tokenId) standards. It aggregates holdings by recipient address, filters by minimum holding and exclude list, and displays the holder list. Second, the tool pushes the airdrop using the appropriate sender contract function—batchTransferERC20 for ERC-20 tokens, batchTransferERC721 for NFTs, or batchTransferERC1155 for ERC-1155 tokens—all in one atomic transaction.

WHAT IT CANNOT SEE

This tool scans on-chain NFT data for holders on Polygon zkEVM but cannot verify recipient validity, NFT contract correctness, transfer pausing, blacklisting, or gas fluctuations. It cannot guarantee that all transfers will succeed—if one transfer fails due to a blacklisted address or any other reason, the entire batch reverts. It cannot detect if the NFT contract uses non-standard ownership mechanics or if the holder list is incomplete due to RPC limits. It cannot account for Polygon zkEVM-specific gas mechanics or L2 fee structures. It cannot verify that the snapshot is atomic with the distribution if the contract does not support atomic re-verification. It cannot account for NFTs held in contracts that should be excluded. It cannot guarantee that holders haven't transferred NFTs between the snapshot and distribution execution. It cannot handle extremely large holder lists that exceed gas limits or RPC response limits. It cannot verify that the token IDs exist or that the sender has the NFTs to push.

PLEASE NOTE

This tool works exclusively on EVM-compatible chains and is specifically designed for Polygon zkEVM. It requires the user to have sufficient native ETH for gas and sufficient token balance (for ERC-20) or NFT ownership (for NFT airdrops) to cover the total distribution. The user is solely responsible for verifying the NFT contract address, airdrop token address, and amounts before signing. Always test with a small distribution first to confirm the setup is correct. The snapshot is taken at the moment of scanning—holders who transfer NFTs after the scan but before the transaction execution may not receive the expected amounts. The sender contract addresses are hardcoded per chain and are publicly available for verification; no third-party custody is involved; you remain in full control of your wallet and funds at all times. Polygon zkEVM's low transaction costs make this tool particularly cost-effective for large-scale NFT holder airdrops.