Snapshot-Current-Holders-Then-Send Tool (Base NFT Collection)

WHAT IT DOES

Snapshot-Current-Holders-Then-Send Tool (Base NFT Collection) is a comprehensive NFT analytics and distribution tool that automates the entire workflow of identifying NFT holders and distributing rewards proportionally on the Base network. 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 distributes a specified total token amount proportionally to all holders in a single batched transaction on Base. This is ideal for NFT collection rewards, loyalty programs, token-gated airdrops, and any scenario where you want to reward all holders of an NFT collection based on their holdings. The tool handles the complete workflow—from on-chain data gathering to proportional distribution—in one unified interface on Base's low-cost L2 network, eliminating the need for external analytics tools, manual CSV creation, and multiple transaction submissions.

HOW TO USE

Connect your Web3 wallet to the Base network. Enter the NFT contract address—this can be either an ERC-721 or ERC-1155 collection. Optionally, for ERC-1155 collections, specify a specific token ID to filter holders of that token type. Set a minimum holding threshold to exclude holders with too few NFTs. Enter the token contract address you wish to distribute. Specify the total amount to distribute across all NFT holders. Optionally, paste an exclude list of addresses to omit from the distribution. 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. The tool displays the number of holders found, total NFT holdings, and a preview table of holders and their NFT counts. Review the results, then click the send button to distribute tokens proportionally to all NFT holders.

MECHANISM: CHUNKED LOG SCANNING WITH NFT HOLDER AGGREGATION

The tool implements a robust two-phase mechanism for NFT collections on Base. 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 and TransferBatch events with amount and tokenId) standards. It aggregates holdings by recipient address, filters out zero balances, applies the minimum holding threshold and exclude list, and displays the holder list. Second, the tool calculates proportional distribution amounts: for each holder, amount = (holder_nft_count / total_nft_held) * total_distribution. It then executes a batchTransferERC20 call to the shared BotGentz sender contract on Base, distributing all tokens atomically in one transaction.

WHAT IT CANNOT SEE

This tool scans on-chain NFT data for holders but cannot verify recipient validity, token 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 Base-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 NFT collection is the intended one or that the holder data is accurate.

PLEASE NOTE

This tool works exclusively on EVM-compatible chains and is specifically designed for Base. It requires the user to have sufficient native ETH for gas and sufficient distribution token balance on Base to cover the total amount sent plus the sender contract fee. The user is solely responsible for verifying the NFT contract address, distribution token address, and total amount 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. Base's low transaction costs make this tool particularly cost-effective for large-scale NFT holder distributions.