On-Chain Apprenticeship Stipend Distributor

WHAT IT DOES

This tool connects to your EVM wallet and enables apprenticeship programs to distribute stipends to participants based on program parameters. It reads apprenticeship program records including apprentice addresses, stipend amounts, program duration, milestone completion status, and distribution schedules from on-chain apprenticeship contracts across EVM chains. The tool supports weighted distribution where each apprentice receives a stipend proportional to their program allocation, with a single batch transaction that distributes tokens to all eligible apprentices.

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 Apprentices textarea, enter each apprentice's address and stipend weight in the format address:stipend—one per line. For example, "0x742d35Cc6634C0532925a3b844Bc454e4438f44e:100" for an apprentice with stipend weight 100. Enter the total stipend amount to distribute in the Total Amount field (in token units). Click "Load Apprentice Data" to validate the apprentice list. Review the summary showing apprentice count, total stipends, sender fee, sender contract address, and sender owner. Click "Distribute Stipends" to execute the batch transfer. The tool calculates each apprentice'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 apprentice, the tool calculates their share as: (apprenticeStipend / totalStipends) * 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 apprenticeship participation or skill development—it only reads on-chain program records and cannot validate actual participation or skill acquisition. It cannot validate that program milestones are completed to satisfaction—the tool trusts the program's recorded milestone status. It cannot ensure that stipend amounts reflect agreed-upon terms without program governance verification—the tool relies on the program's recorded allocation parameters. It relies on apprenticeship contract interfaces and may not support all training program models—if a program uses a non-standard interface, records may not be detected. It cannot prevent over-distribution if program parameters are improperly configured—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 apprentice 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 apprentice stipend weights accurately reflect your program's distribution rules.