Participatory Budget Fund Disbursement Tool

WHAT IT DOES

Participatory Budget Fund Disbursement Tool is a DAO tool that enables the disbursement of participatory budget funds to approved projects in a single batch transaction. It reads the participatory budget contract address, approved project proposals and budget allocations, fund balance, disbursement schedule, project completion status, disbursement history, account nonce, gas estimates for disbursement, and previous disbursement records. The tool then guides you through disbursing budget funds to approved projects, updating project funding status, recording the disbursement on-chain, and syncing budget status across chains.

HOW TO USE

Connect your wallet via the built-in connector. Select the network where the participatory budget contract is deployed. Enter the budget contract address, the fund token address, the list of approved projects 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: budget contract, fund token, payment token, fund balance, approved project 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 funds" to execute the batch distribution in a single transaction. The tool will guide you through three steps: verifying project approvals and fund balance, preparing the batch, and executing the disbursement.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the participatory budget contract and the bulk sender contract. It reads approved project proposals using `getApprovedProjects()` which returns the list of approved project addresses and their allocated amounts. Project completion status is read via `getProjectStatus(project)` which returns the current completion status. Disbursement schedule is read via `getDisbursementSchedule()` which returns the frequency and timing of disbursements. Fund balance is read via `getFundBalance()` or `balanceOf()` on the fund token. Disbursement history is scanned using `eth_getLogs` for `FundsDisbursed` 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 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 projects have actually been completed off-chain—it relies on on-chain status. It cannot detect if project funds are being misused. It cannot guarantee that the budget will have sufficient balance for all approved projects. It cannot prevent front-running of disbursements. It cannot validate that project completion status is accurate. It cannot detect if the budget contract has been modified. It cannot ensure that disbursement schedules are appropriate. It cannot verify that project 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 budget has sufficient fund token balance to cover the disbursement plus fees. The tool does not store or transmit any project data. Always verify project approvals and completion before disbursing funds.