Cross-L2 Points Program Conversion Batch Distributor

WHAT IT DOES

Cross-L2 Points Program Conversion Batch Distributor is a specialized DeFi and loyalty tool that enables points programs, loyalty platforms, and DAOs to distribute converted points tokens to multiple users in a single batched transaction while attaching rich points metadata to each distribution on any major L2 network. Instead of sending individual transactions for each user, this tool aggregates all points conversions into one atomic contract call. You provide each user's address, converted token amount, points earned, and optional notes, along with points program metadata including program name, season or round, and conversion rate. The tool stores this metadata on-chain alongside each transfer, creating a permanent, auditable record of points-to-token conversions. This is ideal for loyalty program conversions, points redemption events, season rewards, and any scenario where a points program needs to convert points to tokens for multiple users with clear record-keeping for transparency and compliance on Optimism, Arbitrum, Base, zkSync Era, Polygon, and other L2s. By combining batched distributions with on-chain points metadata, the tool ensures that every conversion is verifiable, attributable, and context-rich.

HOW TO USE

Connect your Web3 wallet to your preferred L2 network—Optimism, Arbitrum, Base, zkSync Era, or Polygon. Enter the token contract address for the converted tokens. Enter points program metadata: program name (e.g., "Summer Points", "Season 3"), season or round, and conversion rate (points per token). Paste or upload your list of users in the format "address, amount, pointsEarned, notes" with one entry per line—amounts are in human-readable token units. The tool parses the list and displays a preview showing each user, their converted token amount, points earned, and notes. Review the sender contract address, fee, and contract owner for transparency. Click the distribute converted tokens button, review the transaction in your wallet, and confirm. The tool executes a batched transfer with points metadata attached on your chosen L2, storing each user's points earned and notes on-chain alongside the transfer, along with the program name, season, and conversion rate. After confirmation, all users receive their converted tokens, and the conversion metadata is permanently recorded on-chain.

MECHANISM: BATCH POINTS CONVERSION DISTRIBUTION WITH ON-CHAIN METADATA

The tool interacts with a specialized BotGentz sender contract deployed on each major L2 that supports a batchTransferERC20WithPointsMetadata function. This function accepts arrays of user addresses, token amounts, points earned, and notes, along with program name, season, and conversion rate values. The contract stores the metadata by emitting events that include all fields, ensuring the metadata is permanently recorded on-chain and searchable via event logs. The tool builds the batch transaction by encoding each user's address, token amount, points earned, and notes into the appropriate arrays. It reads the fee() function live from the sender contract, checks the sender's token balance and allowance on the selected L2, approves the exact total, and executes the batch transfer. The program metadata strings are stored once for the entire batch. The transaction is atomic—either all users receive their converted tokens with metadata, or the entire transaction reverts with no partial distributions.

WHAT IT CANNOT SEE

This tool reads no on-chain data directly. It does not verify that user addresses are valid, that the points program has sufficient token balance, or that the token contract address provided is correct. It cannot guarantee that all transfers will succeed—if one transfer fails due to a blacklisted address, insufficient balance, or any other reason, the entire batch reverts. It cannot account for L2-specific gas mechanics or fee structures. It cannot verify that the points metadata is accurate or that users are eligible for conversion. It cannot provide on-chain dispute resolution or clawback mechanisms. It cannot ensure that metadata is indexed or searchable. It cannot recover from failed transactions or generate reports for failed batches. It cannot verify that the program has sufficient funds or that the conversion complies with governance requirements. It cannot verify that the points earned or conversion rate corresponds to actual user activity.

PLEASE NOTE

This tool works exclusively on EVM-compatible chains and supports Optimism (10), Arbitrum (42161), Base (8453), zkSync Era (324), and Polygon (137). It requires the user to have sufficient native ETH for gas and sufficient token balance to cover the total amount sent plus the sender contract fee. The user is solely responsible for verifying the token contract address, user addresses, token amounts, and points metadata before signing. Always test with a small batch first to confirm the setup is correct. Metadata storage consumes additional gas—longer notes will increase transaction costs. The sender contract addresses are hardcoded per chain and are publicly available for verification; no third-party custody is involved; you remain in full control of your wallet and funds at all times. On-chain points metadata is public and immutable—do not include sensitive user information. L2 networks offer significantly lower gas costs than Ethereum L1, making this tool particularly cost-effective for large points conversion distributions.