Weighted-by-Tenure Distribution Executor

WHAT IT DOES

This tool enables DAO treasurers, community managers, and project teams to distribute tokens based on member tenure, rewarding long-standing participants with larger allocations. It connects to your wallet and reads the token contract address, recipient list, recipient join timestamps, current block timestamp, tenure weights, allocation percentages, weighted calculations, distribution totals, and distribution history. The tool signs and submits transactions to distribute tokens weighted by tenure to all recipients, update distribution status, record distribution metadata with timestamps, and emit distribution events for transparency. It supports batch sending to hundreds of recipients in a single transaction using the BotGentz bulk sender infrastructure with configurable tenure weighting curves.

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 distribution amount (in token decimals).

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

5. In the recipient list, enter each recipient's address and their join timestamp (unix timestamp, comma-separated, one per line). The join timestamp represents when they became a member or started contributing.

6. Configure the tenure weight exponent — higher values (e.g., 2.0) give stronger weight to long-tenured members, while lower values (e.g., 0.5) create a flatter distribution. The default is 1.5.

7. Click "fetch current timestamp" to get the current block timestamp for accurate tenure calculation.

8. Click "calculate weights & allocations" to compute each recipient's tenure weight as (tenure_in_days)^exponent and their proportional allocation.

9. Review the sender contract address, contract owner, fee, total distribution, weighted total, and balances before executing.

10. Click "distribute weighted" to sign and submit the batch transaction that sends tokens to all recipients based on their tenure-weighted allocations.

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. Tenure is calculated as (current_timestamp - join_timestamp) in seconds, then converted to days for weighting. The weighting formula uses an exponential curve: weight = (tenure_in_days)^exponent, where the exponent is user-configurable. Higher exponents create stronger tenure advantages, while lower exponents produce more egalitarian distributions. Allocations are computed as (recipient_weight / total_weight) * total_amount, with rounding corrections to ensure exact sum. 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 tenure accuracy — it does not check that join timestamps are correct or that members actually joined at the stated time. It cannot validate that recipients held positions or remained active during the entire tenure period — a member could have joined and left but still receive a large allocation. The tool cannot detect sybil accounts, identity fraud, or duplicate addresses that might unfairly receive multiple allocations. It cannot ensure that the tenure weighting is fair or that the chosen exponent correctly reflects the community's values. The tool also cannot verify that recipients performed duties, contributed value, or met any other eligibility criteria beyond what is entered in the list. All tenure data is accepted as entered — the tool does not cross-reference with on-chain membership records or activity logs.

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 distributions, carefully verify tenure data and consider using on-chain membership registries for automated tenure validation.