Point-System-to-Token Conversion Batch Distributor (Any L2)

WHAT IT DOES

This tool enables projects to batch convert user points into tokens and distribute them to participants in a single transaction on any supported L2. Instead of manually calculating conversions and sending tokens to each user individually, it combines all conversions and distributions into one call to a shared batch-sender contract. You specify the token contract address, the decimals, a conversion rate (e.g., 1000 points = 1 token), an optional program name, and a list of participant addresses with their point balances. The tool automatically calculates the token amount for each participant (using integer division to avoid fractional tokens), computes the total tokens to distribute, checks your balance, verifies you have sufficient allowance for the sender contract, and submits one transaction that pays all participants atomically. If allowance is insufficient, the tool automatically requests approval before sending. This is a true push distribution — participants receive their converted tokens directly without any claim action required. The tool works on any supported L2 including Arbitrum, Optimism, Base, zkSync Era, Linea, Scroll, Polygon, and more.

HOW TO USE

Connect your EVM wallet via the BotGentz wallet bridge. Select your preferred L2 from the network dropdown. Enter the token contract address and its decimals. Set the conversion rate — the number of points required to receive one token. Optionally enter a program name for record-keeping. In the text area, list each participant on a separate line with their address and their point balance, separated by a comma. The tool will automatically convert points to tokens using floor division. Click "Review conversion" to see the token contract, conversion rate, participant count, total tokens to distribute, your allowance, and the sender contract fee. The tool will display a warning if your allowance is insufficient. If everything looks correct, click "Convert & distribute" — your wallet will first ask you to approve the token spend if needed, then to confirm the batch transaction. Once confirmed, the tool shows progress and the final transaction hash with a link to the block explorer.

TECHNICAL MECHANISM

This tool uses the BotGentz shared bulk-sender contract registry, keyed by chain ID and ERC standard. It looks up `BULKSEND[String(chainId)].erc20` to get the sender contract address for the selected chain. The tool creates a contract instance using `BGWallet.getSigner()` connected to the current chain's provider. It calls `fee()` and `owner()` on the sender contract live — no values are cached. It also instantiates the token contract using the ERC-20 ABI and checks `balanceOf()`, `allowance()`, and `decimals()` for your wallet. The tool calculates token amounts by dividing each participant's point balance by the conversion rate using `Math.floor()` (integer division), ensuring fractional points are not minted. It sums the total tokens and verifies both your token balance and native balance (for the sender contract fee) are sufficient. If allowance is insufficient, it sends an approval transaction for the exact total amount before the batch transfer. The batch transfer uses `batchSend20(address token, address[] recipients, uint256[] amounts)` on the sender contract, sending the contract fee as `msg.value`. After confirmation, it logs gas usage using `receipt.effectiveGasPrice`.

WHAT IT CANNOT SEE

This tool cannot verify point balance accuracy, eligibility criteria, or conversion rate validity. It cannot confirm that the point data you input is accurate or that users have actually earned the points claimed. It cannot verify that the conversion rate is fair or appropriate for the program. It cannot confirm recipient wallet readiness or guarantee that participants can receive ERC-20 tokens. The tool does not validate that the token contract implements the ERC-20 standard. It cannot detect front-running or mempool congestion. It cannot provide a cross-chain receipt or rollback mechanism. It also cannot verify that the decimals value you entered matches the actual contract decimals. Projects should always validate point data before converting.

PLEASE NOTE

This tool is EVM-only. It works on any supported L2 where the BotGentz registry has an erc20 entry. It does not support Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. The tool requires the token contract to be deployed on the L2 and for the sender contract to have an erc20 entry in the registry. Always test with a small amount and a single participant before converting all points. The sender contract charges a fee in native tokens — ensure you have enough native balance to cover the fee. This is a push distribution — the sender pays all gas, participants receive tokens without any action.