Mutual Aid Fund Contribution Tool

WHAT IT DOES

Mutual Aid Fund Contribution Tool is a DeFi tool that enables members to contribute to mutual aid funds. It reads the mutual aid fund contract address, member addresses and contribution history, fund balance, contribution schedule (frequency and minimum amounts), member eligibility criteria, fund usage history, account nonce, gas estimates for contribution, and previous contribution records. The tool then guides members through submitting contributions, recording them on-chain, updating the fund balance, and syncing fund status across chains.

HOW TO USE

Connect your wallet via the built-in connector. Select the network where the mutual aid fund contract is deployed. Enter the fund contract address, the contribution amount (in the payment token), and the payment token address (use address(0) for native token). The tool will read on-chain data and display a preview including: fund contract, contribution amount, payment token, fund balance, your contribution history, contribution schedule, eligibility status, and estimated gas. Review all details carefully. Click "submit contribution" to make your contribution. The tool will guide you through three steps: verifying eligibility and schedule, submitting the contribution, and recording the transaction.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the mutual aid fund contract. It reads member contribution history using `getContributions(member)` which returns timestamps and amounts. Fund balance is read via `getFundBalance()` or `balanceOf()` on the fund token. Contribution schedule is read using `getContributionSchedule()` which returns the frequency and minimum contribution amount. Member eligibility is checked via `isEligible(member)` which verifies membership status and any pending requirements. Fund usage history is scanned using `eth_getLogs` for `FundUsed` 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 contribution transaction calls `contribute(amount)` on the fund contract, which transfers the tokens, updates the fund balance, and records the member's contribution. 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.

WHAT IT CANNOT SEE

This tool cannot verify that members are eligible for aid off-chain—it only checks on-chain membership. It cannot detect if members are misrepresenting their eligibility. It cannot guarantee that the fund will have sufficient balance for future aid requests—the fund depends on ongoing contributions. It cannot prevent front-running of contributions. It cannot validate that contribution amounts are appropriate—this is a member decision. It cannot detect if the fund contract has been modified. It cannot ensure that aid distribution is fair. It cannot verify that fund usage terms are enforced off-chain.

PLEASE NOTE

This tool is EVM-only and supports Ethereum, Polygon, BNB Chain, Arbitrum, Optimism, and Avalanche. Contribution transactions are signed by the connected wallet, and the user pays gas fees. Mutual aid funds rely on community participation—contribute responsibly and review the fund's terms before contributing. The tool does not store or transmit any member data.