Mantle Rewards Station Batch Distributor

WHAT IT DOES

Mantle Rewards Station Batch Distributor is a specialised blockchain audit tool that enables project teams and distribution managers to prepare and verify batch reward distributions for the Mantle Rewards Station programme. It reads on-chain token balances for multiple recipient wallets simultaneously, fetches token decimals to ensure accurate formatting, retrieves current gas price estimates for cost planning, and resolves the chain-specific sender contract address used for distribution. The tool also queries Mantle Rewards Station reward records directly from the sender contract, giving you a consolidated view of recorded allocations alongside actual wallet balances. All data is presented in a clean table with per-address breakdowns, making it easy to spot discrepancies between intended rewards and on-chain holdings. The interface is designed for rapid auditing of large recipient lists without requiring any on-chain transactions.

HOW TO USE

Connect your wallet to the Mantle network using the built-in wallet bridge. Enter the reward token contract address, the sender contract address that holds the reward records (the Rewards Station contract), and a list of recipient wallet addresses (one per line). Click the scan button — the tool will sequentially query each address for its current token balance and reward record from the sender contract. A progress bar shows real-time status, and results appear in a sortable table with balance and reward columns. You can then export this data or use it to plan your distribution transaction. The tool also displays current gas price and token decimals for reference. All operations are read-only and do not modify any state.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the blockchain via the injected wallet provider. It performs batched eth_call requests with controlled concurrency (4 simultaneous queries) to avoid rate limits while maintaining responsiveness. For each recipient address, it executes two parallel calls: one to the ERC-20 token contract's balanceOf method and one to the sender contract's rewardRecords mapping. The concurrency limit prevents overwhelming the RPC endpoint while keeping total scan time practical for lists of up to 100+ addresses. If a call fails for any address, the tool logs an error and continues with the remaining addresses rather than aborting the entire scan. Gas price is fetched using ethers' getFeeData(), which returns the current network fee estimate. The tool adapts to different ERC-20 implementations by attempting to read decimals and defaulting to 18 if the call fails. All queries use the view/pure function pattern, meaning they consume no gas and execute instantly.

WHAT IT CANNOT SEE

This tool cannot verify original participant eligibility for the Mantle Rewards Station programme. It does not confirm whether a wallet actually completed the required on-chain activities or met any off-chain criteria. It cannot validate reward entitlement amounts — these must be provided by the project team based on their own records. The tool has no access to off-chain Mantle Rewards Station activity logs, quest completion statuses, user authentication data, or any private database. It only reads what is publicly available on the blockchain through the contract interfaces you specify. The tool does not verify that the sender contract is the official Rewards Station contract — you must confirm this yourself.

PLEASE NOTE

This tool is designed exclusively for EVM-compatible chains, specifically Mantle mainnet and testnets. It does not support non-EVM networks. The sender contract address you provide must implement a rewardRecords(address) view function that returns a uint256. Always verify both contract addresses and the recipient list before relying on the scan output. The tool is read-only and does not execute transfers or modifications. Always double-check that you are on the correct Mantle network before scanning.