Neighborhood Improvement Fund Contribution Tool

WHAT IT DOES

This tool connects to your EVM wallet and enables neighborhood improvement fund administrators to disburse funds to approved project implementers based on allocation parameters. It reads fund records including fund balances, project proposals, allocation parameters, disbursement schedules, and governance approval status from on-chain fund contracts across EVM chains. The tool supports weighted distribution where each project implementer receives an allocation proportional to their approved share, with a single batch transaction that distributes tokens to all eligible projects.

HOW TO USE

Connect your Web3 wallet using the Connect button. Enter the ERC-20 token address you wish to distribute in the Token Address field. In the Projects textarea, enter each project implementer's address and allocation in the format address:allocation—one per line. For example, "0x742d35Cc6634C0532925a3b844Bc454e4438f44e:100" for a project with allocation 100. Enter the total amount to contribute in the Total Amount field (in token units). Click "Load Project Data" to validate the project list. Review the summary showing project count, total allocation, sender fee, sender contract address, and sender owner. Click "Contribute Funds" to execute the batch transfer. The tool calculates each project's share proportionally, approves the sender contract for the exact total amount, and distributes tokens in a single transaction.

TECHNICAL MECHANISM: WEIGHTED BATCH DISTRIBUTION WITH BULK SENDER CONTRACT

The tool uses a shared BotGentz sender contract to perform batch ERC-20 transfers. The sender contract is looked up from the BULKSEND registry by chain ID and standard (erc20). For each project, the tool calculates their share as: (projectAllocation / totalAllocation) * totalAmount. The total amount includes both the distribution amount and the sender fee, which is read live from the contract's fee() function. The tool checks the user's balance against the total needed (distribution + fee) before proceeding. The sender contract is approved for the exact total amount (not unlimited), and the distributeERC20 function is called with the recipient addresses and calculated amounts arrays. All operations are performed sequentially with proper error handling.

WHAT IT CANNOT SEE

This tool cannot verify off-chain project implementation quality or community impact—it only reads on-chain fund records and cannot validate actual project outcomes. It cannot validate that fund utilization aligns with community priorities without governance verification—the tool relies on the fund's recorded allocation parameters. It cannot ensure that project implementation complies with legal or regulatory requirements—the tool does not enforce compliance rules. It relies on fund contract interfaces and may not support all neighborhood improvement fund structures—if a contract uses a non-standard interface, records may not be detected. It cannot prevent mismanagement if governance controls are insufficient—the tool does not enforce governance rules.

PLEASE NOTE

This tool signs transactions to approve the sender contract and distribute tokens—ensure you trust the sender contract and have verified the token address and project list. All state is in-memory and resets on page reload. The tool supports EVM chains only—Ethereum, Polygon, BSC, Arbitrum, Optimism, Avalanche, Base, and Fantom. Always verify that the token address you enter is correct and that the project allocations accurately reflect your fund's distribution rules.