On-Chain Scholarship Fund Distributor

WHAT IT DOES

On-Chain Scholarship Fund Distributor is a DeFi tool that enables organizations to distribute scholarship funds to eligible scholars in a single batch transaction. It reads the scholarship fund contract address, scholar addresses and award amounts, eligibility criteria (GPA, attendance, etc.), fund balance, distribution schedule (start date and frequency), disbursement history, account nonce, gas estimates for distribution, and previous distribution records. The tool then guides you through distributing scholarship funds to eligible scholars, updating each scholar's payment status, recording the distribution on-chain, and syncing fund status across chains.

HOW TO USE

Connect your wallet via the built-in connector. Select the network where the scholarship fund contract is deployed. Enter the fund contract address, the scholarship token address, the list of scholars with their award 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, scholarship token, payment token, fund balance, distribution schedule, scholar list, total distribution amount, the bulk sender contract (from registry), its owner, the sender fee, and estimated gas. Review all details carefully. Click "distribute scholarships" to execute the batch distribution in a single transaction. The tool will guide you through three steps: verifying fund balance and eligibility, preparing the batch, and executing the distribution.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the scholarship fund contract and the bulk sender contract. It reads the fund balance using `getFundBalance()` or `balanceOf()` on the fund contract. Eligibility criteria are read via `getEligibilityCriteria()` which returns GPA, attendance, and other requirements. Distribution schedule is read using `getDistributionSchedule()` which returns the start date and frequency. Disbursement history is scanned using `eth_getLogs` for `ScholarshipPaid` 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 distribution transaction calls `distribute()` on the sender contract with the scholar 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 scholars meet eligibility criteria off-chain—it only reads what is stored on-chain. It cannot detect if scholars are misrepresenting their credentials. It cannot guarantee that the fund will have sufficient balance for future distributions. It cannot prevent front-running of distributions. It cannot validate that scholar addresses are correct—this must be verified off-chain. It cannot detect if the fund contract has been modified. It cannot ensure that distribution schedules are appropriate for each scholar. It cannot verify that scholarship 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 fund has sufficient token balance to cover the distribution plus fees. The tool does not store or transmit any scholar data. Always verify scholar addresses and amounts before distributing.