Genesis NFT Holder Batch Reward Distributor (Ethereum L1)

WHAT IT DOES

Genesis NFT Holder Batch Reward Distributor (Ethereum L1) is a comprehensive NFT analytics and distribution tool that automates the entire workflow of identifying genesis NFT holders and distributing rewards proportionally on Ethereum L1. The tool scans the blockchain to find all current holders of a specified genesis 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 Ethereum L1. This is ideal for genesis NFT collection rewards, early adopter token distributions, loyalty programs, and any scenario where you want to reward all holders of a genesis NFT collection based on their holdings. The tool handles the complete workflow—from on-chain data gathering to proportional distribution—in one unified interface, eliminating the need for external analytics tools, manual CSV creation, and multiple transaction submissions.

HOW TO USE

Connect your Web3 wallet to Ethereum L1. Enter the genesis 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 reward token contract address. Specify the total amount to distribute across all genesis NFT holders. Optionally, paste an exclude list of addresses to omit from the distribution (e.g., team wallets, contracts). 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. Click prepare rewards to calculate the distribution. Review the results, then click the distribute rewards button to send tokens proportionally to all genesis NFT holders in a single batched transaction on Ethereum L1.

MECHANISM: CHUNKED LOG SCANNING WITH PROPORTIONAL DISTRIBUTION

The tool implements a robust two-phase mechanism for genesis NFT collections on Ethereum L1. 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 by minimum holding 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 Ethereum L1, distributing all rewards atomically in one transaction.

WHAT IT CANNOT SEE

This tool scans on-chain NFT data for genesis NFT holders on Ethereum L1 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 Ethereum L1 gas mechanics or 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 genesis collection or that the holder data is accurate.

PLEASE NOTE

This tool works exclusively on EVM-compatible chains and is specifically designed for Ethereum L1. It requires the user to have sufficient native ETH for gas and sufficient reward token balance on Ethereum L1 to cover the total amount sent plus the sender contract fee. The user is solely responsible for verifying the genesis NFT contract address, reward 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.