Mutual Aid Fund Disbursement Tool

WHAT IT DOES

Mutual Aid Fund Disbursement Tool is a DeFi tool that enables mutual aid funds to disburse approved aid requests in a single batch transaction. It reads the mutual aid fund contract address, aid request IDs, requester addresses and amounts, request status (pending/approved/denied/disbursed), fund balance, approval criteria, disbursement schedule, disbursement history, account nonce, gas estimates for disbursement, and previous disbursement records. The tool then guides you through approving aid requests, disbursing funds to approved requesters, updating request status, recording disbursements on-chain, 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 aid token address, the list of aid requests with their addresses and 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: fund contract, aid token, payment token, fund balance, aid request list with amounts and status, total disbursement amount, the bulk sender contract (from registry), its owner, the sender fee, and estimated gas. Review all details carefully. Click "disburse aid" to execute the batch disbursement in a single transaction. The tool will guide you through three steps: verifying aid requests and approval status, preparing the batch, and executing the disbursement.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the mutual aid fund contract and the bulk sender contract. It reads aid request status using `getRequestStatus(requestId)` which returns pending/approved/denied/disbursed. Fund balance is read via `getFundBalance()` or `balanceOf()` on the fund token. Approval criteria are read via `getApprovalCriteria()` which returns the requirements for aid approval. Disbursement schedule is read using `getDisbursementSchedule()` which returns the frequency and timing of disbursements. Disbursement history is scanned using `eth_getLogs` for `AidDisbursed` 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 disbursement transaction calls `distribute()` on the sender contract with the requester 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 aid requests are legitimate or accurately represent need—it only reads on-chain requests. It cannot detect if requesters are misrepresenting their circumstances. It cannot guarantee that the fund will have sufficient balance for all approved requests. It cannot prevent front-running of disbursements. It cannot validate that approval criteria are fair. It cannot detect if the fund contract has been modified. It cannot ensure that disbursement schedules are appropriate. 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. 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 disbursement amount. Ensure the fund has sufficient token balance to cover the disbursement plus fees. The tool does not store or transmit any aid request data. Always verify request legitimacy before disbursing.