Test Fixture Account Funder (Testnet)

WHAT IT DOES

Test Fixture Account Funder (Testnet) is a developer tool that funds multiple testnet accounts in a single batch transaction. It reads the testnet faucet contract address, recipient addresses, funding amounts, token address (native or ERC-20), faucet balance, funding limits (min/max per address), funding history, account nonce, gas estimates for funding, and previous funding records. The tool then guides you through funding specified accounts in a batch, recording the funding transaction, updating the faucet balance, and updating recipient funding status.

HOW TO USE

Connect your wallet via the built-in connector. Select the testnet network where the faucet is deployed. Enter the faucet contract address, the token address (use address(0) for native token), the list of recipients with their funding amounts (one per line, address,amount), and the payment token address (use address(0) for native token). The tool will read on-chain data and display a preview including: faucet contract, token, payment token, faucet balance, funding limits, recipient list with amounts, total funding amount, the bulk sender contract (from registry), its owner, the sender fee, and estimated gas. Review all details carefully. Click "fund accounts" to execute the batch funding in a single transaction. The tool will guide you through three steps: verifying faucet balance and limits, preparing the batch, and executing the funding.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the faucet contract and the bulk sender contract. It reads the faucet balance using `getBalance()` or `balanceOf()` on the token contract. Funding limits are read via `getMinFunding()` and `getMaxFunding()`. Funding history is scanned using `eth_getLogs` for `FundsSent` events, with adaptive chunking (halving chunk size on failure) to handle different RPC limits—the tool walks backward from the current block and continues even if some ranges are rejected. The bulk sender contract is looked up from the BULKSEND registry using the current chain ID and the ERC-20 standard (native funding uses a different path). The fee is read live via `fee()`. The funding transaction calls `distribute()` on the sender contract with the recipient addresses and amounts. Gas estimates are calculated using `estimateGas` with EIP-1559 fee data from `feeData`. All transactions are built with EIP-1559 fee data, and the tool uses `effectiveGasPrice` from receipts for accurate cost accounting. The tool checks the user's balance against the total (amount + fee) before sending and approves the sender contract for the exact total. For native funding, the tool uses the faucet contract's `fund()` method with the recipients and amounts encoded in the transaction data.

WHAT IT CANNOT SEE

This tool cannot verify that recipient addresses are valid or active—it will send funds to any address provided. It cannot detect if funds are being misused or if the recipient is a contract. It cannot guarantee that the faucet has sufficient balance for all requests. It cannot prevent front-running of funding requests. It cannot validate that funding limits are appropriate for the testnet. It cannot detect if the faucet contract has been modified. It cannot ensure that funds are used for testing purposes only. It cannot verify that testnet tokens have any value.

PLEASE NOTE

This tool is EVM-only and supports testnets on Ethereum, Polygon, BNB Chain, Arbitrum, Optimism, and Avalanche. The bulk sender contract address is automatically looked up from the registry—no manual entry required. The fee is set by the contract owner and is deducted from the total funding amount. Ensure the faucet has sufficient token balance to cover the funding plus fees. This tool is for testnet use only—never use on mainnet. The tool does not store or transmit any recipient data. Always verify recipient addresses before funding.