Token-Balance-Gated Conditional Batch Sender (Ethereum L1)

WHAT IT DOES

Token-Balance-Gated Conditional Batch Sender is a specialized DeFi tool that adds a conditional requirement to batch token distributions. Before executing any batch transfer, the tool checks the sender's wallet balance of a specified gating token. Only if the sender holds at least the minimum configured balance does the batch transaction proceed. This creates a powerful access-control mechanism for token distributions—you can require that distributors hold a certain amount of a governance token, membership token, or any other ERC-20 token before they are allowed to send tokens to recipients. The tool is ideal for DAO treasury management, partner reward programs, privileged distribution roles, and any scenario where you want to restrict who can execute batch sends based on token holdings. By combining balance gating with batch transfers, you add an extra layer of control and accountability to your distribution workflows.

HOW TO USE

Connect your Web3 wallet to Ethereum L1. Enter the gating token contract address—this is the token whose balance will be checked. Enter the minimum balance required to pass the gate. Enter the token contract address you wish to distribute. Paste or upload your list of recipients in the format "address, amount" with one entry per line—amounts are in human-readable token units. The tool parses the list and calculates the total tokens to be sent. It then reads your current balance of the gating token and displays whether you meet the minimum threshold. Review the sender contract address, fee, and contract owner for transparency. If the gating condition passes, click the send button, review the transaction in your wallet, and confirm. The tool performs a final on-chain balance check before executing the batch transfer, ensuring the condition is met at the moment of transaction execution. If the condition fails at any point, the batch transfer is blocked.

MECHANISM: ON-CHAIN BALANCE GATING WITH BATCH EXECUTION

The tool implements a two-phase gating mechanism. First, it reads the sender's balance of the gating token using the standard ERC-20 balanceOf() function and compares it against the minimum threshold. This initial check is displayed in the UI and used to enable or disable the send button. When the user clicks send, the tool performs a second on-chain balance verification using the signer's address to ensure the condition still holds—this prevents race conditions where the balance might change between the UI check and transaction submission. If the balance check passes, the tool proceeds with the standard batch transfer flow: it calculates the total tokens to send plus the sender contract fee, checks the sender's balance of the distribution token, approves the sender contract for the exact total, and executes the batchTransferERC20 function on the shared BotGentz sender contract. The batch transfer is atomic—either all recipients receive their tokens, or the entire transaction reverts. The gating check is performed off-chain by the tool before signing, ensuring the user does not waste gas on a transaction that would fail the gating condition.

WHAT IT CANNOT SEE

This tool reads token balances for gating purposes 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 gating token uses non-standard balance mechanics or if the sender's balance changes between the initial read time and transaction execution (though it does re-check at execution). It cannot verify that the gating token is not paused or blacklisted. It does not account for gas price changes during execution. It cannot ensure that the condition check is atomic with the transfer if the contract does not support atomic re-verification on-chain. It cannot verify that the sender will maintain the required balance after the transaction completes.

PLEASE NOTE

This tool works exclusively on EVM-compatible chains and is designed for Ethereum L1. It requires the user to have sufficient native ETH for gas, sufficient distribution token balance to cover the total amount sent plus the sender contract fee, and sufficient gating token balance to meet the minimum threshold. The user is solely responsible for verifying the gating token address, distribution token address, recipient addresses, and amounts before signing. Always test with a small batch first to confirm the setup is correct. The gating condition is a prerequisite for sending—if you do not meet the minimum balance, the tool will not allow the transaction to proceed. 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.