On-Chain Community Trust Fund Disbursement Tool

WHAT IT DOES

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

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 Beneficiaries textarea, enter each beneficiary's address and allocation in the format address:allocation—one per line. For example, "0x742d35Cc6634C0532925a3b844Bc454e4438f44e:100" for a beneficiary with allocation 100. Enter the total amount to disburse in the Total Amount field (in token units). Click "Load Beneficiary Data" to validate the beneficiary list. Review the summary showing beneficiary count, total allocation, sender fee, sender contract address, and sender owner. Click "Disburse Funds" to execute the batch transfer. The tool calculates each beneficiary'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 beneficiary, the tool calculates their share as: (beneficiaryAllocation / 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 community needs assessment or beneficiary eligibility—it only reads on-chain trust fund records and cannot validate actual community needs. It cannot validate that fund utilization aligns with community priorities without governance verification—the tool relies on the trust fund's recorded allocation parameters. It cannot ensure that disbursements comply with legal or regulatory requirements—the tool does not enforce compliance rules. It relies on trust fund contract interfaces and may not support all 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 beneficiary 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 beneficiary allocations accurately reflect your trust fund's distribution rules.