Matching Gift Batch Distributor (Any L2)

WHAT IT DOES

Matching Gift Batch Distributor (Any L2) is a specialised blockchain audit tool that enables project teams and program managers to prepare and verify batch matching gift distributions across any L2 network. It reads on-chain matching gift contract balances, checks token balances for multiple recipient wallets simultaneously, fetches token decimals to ensure accurate formatting, and retrieves current gas price estimates for cost planning. The tool also queries matching gift program contract records, including match ratio and total matched amounts, providing a consolidated view of the proposed matching gift plan alongside actual on-chain holdings. All data is presented in a clean table with per-address breakdowns, making it easy to spot discrepancies between intended matching gift amounts and on-chain balances. The interface is designed for rapid auditing of large recipient lists without requiring any on-chain transactions.

HOW TO USE

Connect your wallet to the appropriate L2 network using the built-in wallet bridge. Enter the matching gift program contract address, optionally specify a token contract address (leave blank for native currency), and a list of recipient addresses with their matching gift amounts (format: address,amount — one per line). Click the scan button — the tool will read the matching gift contract balance, query each recipient address for its current token balance, and calculate the total allocation against the contract balance. A progress bar shows real-time status, and results appear in a sortable table with matching gift amounts and current balance columns. You can then use this data to prepare your matching gift distribution transaction with confidence. All operations are read-only and do not modify any state.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the blockchain via the injected wallet provider. It performs batched eth_call requests with controlled concurrency (4 simultaneous queries) to avoid rate limits while maintaining responsiveness. For the matching gift contract address, it queries the total balance using the provider's getBalance method or the ERC-20 balanceOf method, and also attempts to read contract state including matchRatio and totalMatched via standard matching gift program interfaces. For each recipient, it fetches the current balance to show the pre-distribution state. The tool parses matching gift amounts, converts them using the correct decimals, and sums them to compare against the contract balance. Gas price is fetched using ethers' getFeeData(), which returns the current network fee estimate. All queries use the view/pure function pattern, meaning they consume no gas and execute instantly.

WHAT IT CANNOT SEE

This tool cannot verify matching gift eligibility. It does not confirm whether recipients are entitled to matching gifts based on donor contributions or program criteria. It cannot validate matching entitlement amounts — these must be provided by the project team based on their own records. The tool has no access to off-chain donor contribution data, matching records, or private decision-making records. It cannot determine whether the matching gift plan is compliant with program policies or has received proper authorisation. It only reads what is publicly available on the blockchain through the contract interfaces you specify.

PLEASE NOTE

This tool is designed exclusively for EVM-compatible chains, including Optimism, Arbitrum, Base, Scroll, Mantle, Linea, and other L2 networks. It does not support non-EVM networks. The matching gift contract address you provide should implement standard matching gift program interfaces. Always verify the recipient list and matching gift amounts before relying on the scan output. The tool is read-only and does not execute transfers or modifications. Always double-check that you are on the correct network before scanning.