Weighted-by-Holding Batch Sender (Optimism)

WHAT IT DOES

Weighted-by-Holding Batch Sender (Optimism) is a specialized DeFi tool that enables proportional token distribution based on recipient holdings of a specified token on the Optimism network. Instead of distributing equal amounts to all recipients or requiring manual amount calculations, this tool reads the balance of a holding token for each recipient address, calculates the relative weight of each recipient's holdings against the total, and distributes a specified total amount proportionally. This is ideal for protocol rewards, loyalty programs, governance token distributions, and any scenario where you want to reward users proportionally to their existing holdings on Optimism's fast, low-cost L2 network. The tool handles the entire workflow in one unified operation on Optimism—it reads balances, calculates weights, computes individual distribution amounts, and executes a batched transfer to all recipients atomically. By combining balance reading, weight calculation, and batch distribution in a single user experience, the tool eliminates manual spreadsheet work and reduces the risk of calculation errors.

HOW TO USE

Connect your Web3 wallet to Optimism. Enter the holding token contract address—this is the token whose balances will determine distribution weights. Enter the token contract address you wish to distribute. Specify the total amount to distribute across all recipients. Paste or upload your list of recipients with one address per line. Click the parse and calculate weights button—the tool reads each recipient's holding token balance on Optimism, calculates the total holdings, and computes each recipient's proportional share of the total distribution amount. Review the results in the table showing each recipient's holding, weight percentage, and calculated distribution amount. Review the sender contract address, fee, and contract owner for transparency. If the distribution looks correct, click the send button, review the transaction in your wallet, and confirm. The tool executes a batched transfer on Optimism, distributing the calculated amounts to all recipients atomically.

MECHANISM: PROPORTIONAL WEIGHT CALCULATION WITH OPTIMISM BATCH EXECUTION

The tool implements a two-phase weighted distribution mechanism optimized for Optimism. First, it reads the balance of the holding token for each recipient address on Optimism using the standard ERC-20 balanceOf() function. It reads balances in parallel with a concurrency limit of 6 to avoid RPC rate limits while maintaining performance. The tool calculates the total holdings across all recipients, then computes each recipient's weight as their individual holding divided by the total. It multiplies each weight by the total distribution amount to calculate individual allocations. The tool handles token decimals correctly by reading the decimals() function from both the holding token and the distribution token. After calculation, the tool proceeds with the standard batch transfer flow: it calculates the total tokens to send (which matches the user-specified total), checks the sender's balance of the distribution token on Optimism, approves the sender contract for the exact total, and executes the batchTransferERC20 function on the shared BotGentz sender contract deployed on Optimism. The batch transfer is atomic—either all recipients receive their proportional shares, or the entire transaction reverts. All weights and amounts are displayed in the UI before sending, allowing for full transparency and review.

WHAT IT CANNOT SEE

This tool reads token balances on Optimism to calculate weights 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, a contract that rejects the token, or any other reason, the entire batch reverts. It cannot detect if the holding token uses non-standard balance mechanics or if balances change between read time and transaction execution. It cannot account for Optimism-specific gas mechanics or L2 fee structures. It cannot verify that the holding token corresponds to the intended distribution criteria. It cannot ensure 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 or delegated wallets that might not be captured by a simple balance check. It cannot verify that the distribution is fair or economically appropriate for your use case.

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 holding token address, distribution token address, recipient addresses, and total amount before signing. Always test with a small batch first to confirm the setup is correct. The distribution is proportional to holdings at the time of reading—balances are not snapshotted on-chain and may change between calculation and transaction execution. 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.