Snapshot-Current-Holders-Then-Send Tool (Optimism Token Holders)

WHAT IT DOES

Snapshot-Current-Holders-Then-Send Tool (Optimism Token Holders) is a comprehensive DeFi analytics and distribution tool that automates the entire workflow of identifying token holders and distributing rewards proportionally on the Optimism network. The tool scans the blockchain to find all current holders of a specified token by analyzing Transfer events, reads their balances, and then distributes a specified total token amount proportionally to all holders in a single batched transaction on Optimism. This is ideal for protocol rewards, loyalty programs, airdrop distributions, and any scenario where you want to reward all token holders based on their current holdings. The tool handles the complete workflow—from on-chain data gathering to proportional distribution—in one unified interface on Optimism's fast, 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 Optimism network. Enter the token contract address to snapshot—this is the token whose holders you want to identify and reward. Set a minimum balance threshold to exclude dust holders. Enter the token contract address you wish to distribute. Specify the total amount to distribute across all 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 token'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 holdings, and a preview table of holders and their balances. Review the results, then click the send button to distribute tokens proportionally to all holders. The tool calculates each holder's proportional share and executes a single batched transfer on Optimism.

MECHANISM: CHUNKED LOG SCANNING WITH PROPORTIONAL DISTRIBUTION

The tool implements a robust two-phase mechanism optimized for Optimism. First, it scans Transfer events from the token 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 (too large, timeout, rate limit), the tool halves the chunk size and retries, ensuring the scan completes even under restrictive conditions. The tool aggregates balances by recipient address from Transfer events, filters out zero balances, applies the minimum balance threshold and exclude list, and displays the holder list. Second, the tool calculates proportional distribution amounts: for each holder, amount = (holder_balance / total_supply_held) * total_distribution. It then executes a batchTransferERC20 call to the shared BotGentz sender contract on Optimism, distributing all tokens atomically in one transaction. The tool reads the fee() function live from the sender contract and checks the sender's balance before approval, ensuring transaction success.

WHAT IT CANNOT SEE

This tool scans on-chain data for holders on Optimism 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 token uses non-standard balance mechanics or if the holder list is incomplete due to RPC limits. It cannot account for Optimism-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 tokens held in contracts that should be excluded. It cannot guarantee that holders haven't transferred tokens between the snapshot and distribution execution. It cannot handle extremely large holder lists that exceed gas limits or RPC response limits—the tool will display a warning if the holder count is too high.

PLEASE NOTE

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