Referral Bonus Batch Distributor (Optimism)

WHAT IT DOES

This tool enables efficient batch distribution of referral bonuses to referrers on Optimism. When a business, protocol, or platform runs a referral program, it needs to distribute varying bonus amounts to referrers based on their referral activity, performance tiers, or program rules. Instead of processing individual bonus payments manually, you provide a list of referrer addresses with their specific bonus amounts, and the tool executes a single batched transaction using the BotGentz ERC-20 bulk sender contract. Each referrer receives their exact bonus amount in one efficient operation. The tool checks your wallet balance and native currency balance to ensure sufficient funds before initiating the distribution, providing a safety net against failed transactions.

HOW TO USE

Connect your wallet using the BGWallet bridge. Select Optimism as your network (other EVM chains are also supported). Enter the ERC-20 token contract address representing the bonus token. Add referrers by entering their address and the bonus amount (in wei) they are entitled to receive — you can add as many rows as needed. Click "Parse" to validate the referrer list and see the total bonus amount. Click "Check balances" to verify you have sufficient tokens and native currency to cover the total plus the bulk sender fee. Review the sender contract address, fee, and owner in the review panel. Click "Distribute bonuses" to approve the exact total and execute the batch transfer to all referrers in a single transaction.

TECHNICAL MECHANISM

The tool looks up the BotGentz bulk sender contract from the BULKSEND registry for Optimism and uses the ERC-20 standard contract. It reads fee() and owner() live from the contract every time — never using hardcoded values. It constructs parallel arrays of referrer addresses and their corresponding bonus amounts, then calculates the total distribution sum. It checks your token balance against the total amount and your native balance against the total plus fee. If the allowance is insufficient, it approves the sender contract for the exact total amount only. It then calls sendERC20() with the referrer list and custom amounts array, paying the fee in native currency. Gas is estimated with a 20% buffer, and the final cost is reported using receipt.effectiveGasPrice for accuracy on post-EIP-1559 chains. All referrers receive their bonuses in a single batched transaction, dramatically reducing gas costs compared to individual transfers.

WHAT IT CANNOT SEE

This tool cannot verify that the referral bonus amounts are correct, program-approved, or based on valid referral criteria. It does not detect if referrer addresses are contracts, exchanges, sybils, duplicates, or ineligible parties. It cannot verify token security, contract safety, or the legitimacy of the bulk sender contract beyond the registry provided. The tool does not validate the authenticity of the referral criteria, tracking data, conversion metrics, or any program documentation. You are responsible for ensuring the referrer list and amounts are accurate and properly authorized before executing the distribution. This tool is for operational efficiency only and does not provide programmatic or legal verification.

PLEASE NOTE

EVM chains only. Optimism is the primary network, but Ethereum, Arbitrum, BNB Chain, Polygon, Fantom, zkSync, Base, Avalanche, and Linea are also supported. Does not support Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. Requires a wallet connected via BGWallet. Gas costs and the bulk sender fee are paid by your wallet. Always verify referrer lists and bonus amounts independently before signing the transaction. This tool is not a substitute for programmatic or legal verification of referral data.