Public Goods Matching Pool Distributor

WHAT IT DOES

Public Goods Matching Pool Distributor is a DeFi tool that distributes matching funds to eligible public goods projects based on community contributions. It reads the matching pool contract address, project addresses and contribution amounts, matching formula parameters, total matching pool balance, distribution schedule, project eligibility criteria, distribution history, account nonce, gas estimates for distribution, and previous distribution records. The tool then guides you through distributing matching funds to eligible projects, updating project funding status, recording the distribution on-chain, and syncing matching pool status across chains.

HOW TO USE

Connect your wallet via the built-in connector. Select the network where the matching pool contract is deployed. Enter the matching pool contract address, the matching token address, the list of projects with their contribution amounts (one per line, address,contributions), the total matching pool amount, and the payment token address (use address(0) for native token). The tool will read on-chain data and display a preview including: matching pool contract, matching token, payment token, total match amount, project list with contributions and calculated matching amounts, the bulk sender contract (from registry), its owner, the sender fee, and estimated gas. Review all details carefully. Click "distribute matching funds" to execute the batch distribution in a single transaction. The tool will guide you through three steps: verifying the matching formula and eligibility, preparing the batch, and executing the distribution.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the matching pool contract and the bulk sender contract. It reads project contributions using `getContributions(project)` which returns the total contributions received. Matching formula parameters are read via `getMatchingParameters()` which returns the formula used to calculate matching amounts (e.g., quadratic funding, proportional matching). Total matching pool balance is read via `getMatchingBalance()` or `balanceOf()` on the matching token. Project eligibility is checked using `isEligible(project)` which verifies that the project meets the criteria for matching funds. Distribution history is scanned using `eth_getLogs` for `MatchingDistributed` 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. The fee is read live via `fee()`. The distribution transaction calls `distribute()` on the sender contract with the project 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.

WHAT IT CANNOT SEE

This tool cannot verify that project contributions are legitimate—it reads on-chain data only. It cannot detect if projects are misrepresenting their impact. It cannot guarantee that the matching formula is fair. It cannot prevent front-running of distributions. It cannot validate that project eligibility is correctly enforced. It cannot detect if the matching pool contract has been modified. It cannot ensure that distribution schedules are appropriate. It cannot verify that matching terms are enforced off-chain.

PLEASE NOTE

This tool is EVM-only and supports 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 distribution amount. Ensure the matching pool has sufficient token balance to cover the distribution plus fees. The tool does not store or transmit any project data. Always verify project contributions and eligibility before distributing matching funds.