Scroll Sessions Reward Batch Distributor

WHAT IT DOES

Scroll Sessions Reward Batch Distributor is a specialised blockchain audit tool that enables project teams and distribution managers to prepare and verify batch reward distributions for the Scroll Sessions 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 Scroll Sessions 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.

HOW TO USE

Connect your wallet to the Scroll network using the built-in wallet bridge. Enter the reward token contract address, the sender contract address that holds the reward records, 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.

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.

WHAT IT CANNOT SEE

This tool cannot verify original participant eligibility for the Scroll Sessions 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 Scroll Sessions 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.

PLEASE NOTE

This tool is designed exclusively for EVM-compatible chains, specifically Scroll 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.