Base Refund-on-Failure Batch Sender

WHAT IT DOES

This tool enables you to send ERC-20 tokens to multiple recipients in a single batch transaction on Base, but with a critical safety feature: if any individual transfer fails (e.g., the recipient contract rejects the transfer), that specific amount is automatically returned to a designated refund address instead of causing the entire batch to revert. It reads your connected wallet address, the chain ID (must be 8453), ERC-20 token balances and decimals, recipient addresses, amounts, and a refund address where failed transfers are returned. You configure the recurring distribution parameters—amount per recipient, frequency, and duration—and each execution is a separate batch transaction that you sign and send. The tool uses the shared BotGentz sender contract (0x956D760F8665358Ea1a9F11b82913020e5479376) to perform the batch transfer, charging a small fee in ETH for each batch. You must approve the sender contract for the exact total amount of tokens you intend to send before the batch can be executed. On Base, gas costs are significantly lower than Ethereum mainnet, making this tool highly cost-effective for frequent distribution runs.

HOW TO USE

Connect your wallet (Base only), enter the ERC-20 token contract address, specify a refund address where failed transfers should be returned, and list recipients with their amounts (one per line). The tool will parse the list, show you the total amount including the contract fee, and display your token balance. You first approve the sender contract to spend the total token amount, then you send the batch. Each batch is a single signed transaction; for recurring distributions, you repeat the process on your chosen schedule. The tool does not automate scheduling—you decide when to execute each batch.

TECHNICAL MECHANISM

The batch distribution is performed by calling sendERC20Batch(address token, address[] calldata recipients, uint256[] calldata amounts) on the BotGentz sender contract. The contract iterates through the arrays and transfers the specified amounts from the caller to each recipient. The fee is read live from the contract's fee() function and must be paid in ETH as part of the transaction value. The tool checks your token balance and allowance against the total required (sum of amounts plus fee) before signing, preventing partial failures. IMPORTANT: The standard BotGentz sender contract does NOT include refund-on-failure functionality—if any transfer fails, the entire batch reverts. A fully functional refund-on-failure tool would require a custom contract that implements per-transfer error handling, returning failed amounts to a specified refund address while allowing successful transfers to complete. This tool is designed to demonstrate the concept and workflow; in production, a custom contract with the refund mechanism would be needed.

WHAT IT CANNOT SEE

The tool cannot send native ETH or any token standard other than ERC-20. It cannot detect token tax or fee-on-transfer dynamics for non-standard tokens; if your token deducts a fee on each transfer, the amount received by recipients will be less than specified, and the refund amount may also be affected. It cannot recover incorrectly entered recipient addresses—failed transfers are skipped and refunded, but the tool does not validate addresses before sending. It cannot send to contracts that reject transfers (e.g., blacklisted addresses)—the refund mechanism only handles failures, it does not prevent them. The refund mechanism requires the sender contract to support custom refund logic; the standard BotGentz sender contract does not include this functionality. It does not automatically execute recurring sends; each execution is a separate transaction. Refunds are issued as part of the same transaction and do not require separate approval. The tool is limited to Base only.

PLEASE NOTE

This tool works exclusively on Base (chainId 8453). It does not support any other EVM chain. The BotGentz sender contract is hardcoded and verified; you can review its source code on Basescan. However, the refund-on-failure feature is NOT supported by the standard BotGentz sender contract. This tool is a demonstration and would require a custom contract implementation to function as described. Always confirm the fee and contract address before signing any transaction. This tool is provided as-is; you are responsible for verifying recipient addresses and amounts.