Multi-Season Reward Program Distributor

WHAT IT DOES

This tool enables DAO treasurers, community managers, and project teams to distribute rewards across multiple seasons of a reward program. It connects to your wallet and reads the token contract address, season ID, season parameters (start/end timestamps), recipient list, per-season allocations, cumulative rewards, season timestamps, distribution history, and total distributed per season. The tool signs and submits transactions to distribute season rewards to all recipients, update season status, record distribution metadata with timestamps, and emit season distribution events. It supports batch sending to hundreds of recipients in a single transaction using the BotGentz bulk sender infrastructure with cumulative adjustment tracking across seasons.

HOW TO USE

1. Connect your wallet using the wallet bridge (supports MetaMask, WalletConnect, and other EVM-compatible wallets).

2. Select the target network that matches your token and treasury location.

3. Enter the token contract address you are distributing and the total reward amount for this season.

4. Enter the season ID (e.g., "S1", "S2", "Season 2024 Q1") and the season start/end timestamps for reference.

5. Click "fetch token info" to verify the token decimals and symbol, and "check token balance" to confirm you have sufficient tokens.

6. In the recipient list, enter each recipient's address and their allocation for this season (comma-separated, one per line).

7. Optionally, add cumulative reward adjustments — address and adjustment amount (positive or negative) to carry over rewards from previous seasons or apply corrections.

8. Click "calculate season" to compute the total season distribution with adjustments applied.

9. Click "preview season" to see the first 20 recipients with their allocations and adjustments.

10. Review the sender contract address, contract owner, fee, season details, total distribution, and balances before executing.

11. Click "distribute season" to sign and submit the batch transaction that sends tokens to all recipients for this season.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 with the BotGentz BulkSend registry, which provides verified bulk sender contracts deployed across multiple EVM chains. The fee is read live from the sender contract's fee() view function rather than hardcoded, ensuring accurate payment even if the owner updates the fee. Season allocations are calculated per recipient based on the season amount and the provided allocation data (which can be equal or pro-rata depending on how the user structures the input). The tool supports cumulative reward adjustments — users can add positive or negative adjustments per address to carry over rewards from previous seasons or apply corrections to the current season distribution. Each season is tracked with its own ID and timestamps, and distribution history records season ID, transaction hash, block number, recipient count, and total distributed. The tool performs per-sender balance checks before initiating the transaction (checking both native token balance for fees and token balance for the distribution) and per-sender allowance checks, approving the exact total amount. Batch sends are executed as a single transaction via the bulk sender's sendERC20() function, which distributes tokens to all recipients in one atomic operation with the fee deducted from the sender. Gas costs are reported using receipt.effectiveGasPrice for accurate post-EIP-1559 accounting.

WHAT IT CANNOT SEE

This tool operates purely on-chain and cannot verify season eligibility — it does not check that recipients actually participated in the season's activities, met the season criteria, or completed required tasks. It cannot validate per-season criteria — each season may have different requirements, and the tool has no visibility into those off-chain conditions. The tool cannot detect sybil accounts, identity fraud, or duplicate addresses that might unfairly receive multiple allocations across seasons. It cannot ensure season fairness — the tool does not verify that the distribution aligns with the intended reward program design or that the adjustments are appropriate. The tool also cannot verify that recipients maintained eligibility across seasons — a recipient could have been inactive in earlier seasons but still receive cumulative adjustments. All season data, allocations, and adjustments are accepted as entered — the tool does not cross-reference with on-chain activity, governance participation, or other eligibility records.

PLEASE NOTE

This tool works exclusively with EVM-compatible blockchain networks (Ethereum, Polygon, Arbitrum, Optimism, Base, etc.). It requires the token to implement standard ERC-20 interface. All transactions incur gas fees plus the bulk sender contract fee, paid by the connected wallet. The tool maintains no persistent storage — all state is refreshed from the blockchain on each session. Always test with small amounts on a testnet first and ensure your token balance and allowances are sufficient. For production reward programs, carefully verify season data and consider using on-chain governance or attestation mechanisms to validate season eligibility.