Pro-Rata Airdrop Calculator-and-Distributor

WHAT IT DOES

This tool enables DAO treasurers, project teams, and token distributors to calculate and execute pro-rata airdrops based on snapshot balances. It connects to your wallet and reads the token contract address, recipient list, recipient balance snapshots, total supply snapshot, allocation percentages, pro-rata calculations, distribution totals, current block timestamp, and distribution history. The tool signs and submits transactions to distribute tokens pro-rata 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.

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 airdrop 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 snapshot balance (comma-separated, one per line). The snapshot balance represents their proportional share of the distribution.

6. Enter the total snapshot supply (sum of all snapshot balances) — this is used to calculate each recipient's percentage allocation.

7. Click "parse & calculate" to compute the pro-rata allocation for each recipient based on their snapshot balance relative to the total snapshot supply.

8. Click "preview distribution" to see the calculated allocations for the first 20 recipients.

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

10. Click "distribute airdrop" to sign and submit the batch transaction that sends tokens to all recipients in one atomic operation.

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. For each chain, the tool looks up the correct sender contract address by chain ID and ERC-20 standard, preventing cross-chain address mismatches. 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. The pro-rata calculation uses total snapshot supply and total airdrop amount to compute each recipient's allocation as (snapshot_balance / total_snapshot) * total_amount, with rounding corrections applied to ensure the sum of allocations exactly equals the total amount. 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 rather than unlimited approval. 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 snapshot accuracy — it does not check that the snapshot balances reflect actual holdings at a specific block or that the snapshot was taken correctly. It cannot validate recipient eligibility beyond what is entered in the list — it does not verify that recipients meet qualification criteria, hold specific NFTs, participated in governance, or completed required actions. The tool cannot detect sybil accounts, identity fraud, or duplicate addresses that might unfairly receive multiple allocations. It cannot ensure that the distribution is fair or that the calculated pro-rata percentages correctly reflect the intended economic design. The tool also cannot verify that recipients actually hold the assets they claim to have held during the snapshot period — all snapshot data is accepted as entered.

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 airdrops, verify your snapshot data carefully and consider using Merkle trees or claim-based distribution for better gas efficiency on very large recipient lists.