Hackathon Prize Batch Distributor (Ethereum L1)

WHAT IT DOES

This tool enables hackathon organizers to batch distribute prize tokens to multiple winners in a single transaction on Ethereum L1. Instead of sending tokens to each winner individually and paying gas for every transfer, it combines all prize distributions into one call to a shared batch-sender contract. The tool reads your token balance, allowance, and the current gas price before submitting the transaction. You specify the token contract address, the decimals, an optional hackathon name, and a list of winner addresses with per-winner prize amounts. The tool computes the total tokens to distribute, checks your balance, verifies you have sufficient allowance for the sender contract, and submits one transaction that distributes prizes to all winners atomically. If allowance is insufficient, the tool automatically requests approval before sending. This is a true push distribution — winners receive their prizes directly without any claim action required. The tool works with any ERC-20 token on Ethereum L1, making it ideal for hackathon sponsorships, bounties, and prize pools.

HOW TO USE

Connect your EVM wallet via the BotGentz wallet bridge. Select Ethereum L1 (chain ID 1) from the network dropdown (or any EVM chain). Enter the token contract address and its decimals. Optionally enter a hackathon name for record-keeping. In the text area, list each winner on a separate line with their address and the prize amount to send, separated by a comma. Amounts should be in base units (not including decimals). Click "Review prizes" to see your token balance, allowance, the sender contract fee, and the total amount being distributed. The tool will display a warning if your allowance is insufficient. If everything looks correct, click "Distribute prizes" — your wallet will first ask you to approve the token spend if needed, then to confirm the batch transaction. Once confirmed, the tool shows progress and the final transaction hash with a link to Etherscan. This is ideal for hackathon prize distributions, bounty payouts, and grant disbursements.

TECHNICAL MECHANISM

This tool uses the BotGentz shared bulk-sender contract registry, keyed by chain ID and ERC standard. It looks up `BULKSEND[String(chainId)].erc20` to get the sender contract address for the current chain. On Ethereum L1 (chain 1), the sender contract is `0xE0F4E170C434071b167ABA0e64DC3689536f2E07`. The tool creates a contract instance using `BGWallet.getSigner()` connected to the current chain's provider. It calls `fee()` and `owner()` on the sender contract live — no values are cached. It also instantiates the token contract using the ERC-20 ABI and checks `balanceOf()`, `allowance()`, and `decimals()` for your wallet. The tool computes the total token amount from the winner list and verifies both your token balance and native balance (for the sender contract fee) are sufficient. If allowance is insufficient, it sends an approval transaction for the exact total amount (not unlimited) before the batch transfer. The batch transfer uses `batchSend20(address token, address[] recipients, uint256[] amounts)` on the sender contract, sending the contract fee as `msg.value` in native tokens. The sender contract then iterates the winner list and transfers prizes atomically within the same transaction using `transferFrom` from your wallet. After confirmation, it logs gas usage using `receipt.effectiveGasPrice`.

WHAT IT CANNOT SEE

This tool cannot verify winner eligibility, prize category correctness, or whether the prize distribution has been properly approved by the hackathon organizers. It cannot confirm recipient wallet readiness or guarantee that winners can receive ERC-20 tokens. The tool does not validate that the token contract implements the ERC-20 standard or has the required `transferFrom` function. It cannot detect front-running or mempool congestion. It cannot provide a cross-chain receipt or rollback mechanism. It also cannot verify that the decimals value you entered matches the actual contract decimals — the tool warns but does not automatically correct discrepancies. Organizers should ensure proper winner verification before using this tool.

PLEASE NOTE

This tool is EVM-only. It works on Ethereum L1 and other EVM chains where the BotGentz registry has an erc20 entry. It does not support Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. The tool requires the token contract to be deployed on the chain and for the sender contract to have an erc20 entry in the registry. Always test with a small amount and a single winner before distributing full prizes. The sender contract charges a fee in native tokens — ensure you have enough native balance to cover the fee. This is a push distribution — the sender pays all gas, winners receive prizes without any action. Ethereum L1 gas costs are higher than L2s — consider using L2s for larger distributions if gas is a concern.