Token Holder Class Action Opt-In Attestation Tool

WHAT IT DOES

This tool connects to your EVM wallet and scans class action contracts and registries across different EVM chains to check token holder eligibility and opt-in status. It reads token holder balances from token contracts, queries class action participation status from legal action contracts, and determines whether a holder is eligible to participate in a class action based on snapshot criteria. The tool then enables eligible holders to submit on-chain opt-in attestations, confirming their intent to participate in the class action and recording their participation on-chain.

HOW TO USE

Connect your Web3 wallet using the Connect button. The tool will automatically detect your connected wallet address and pre-fill the holder address field, but you can also enter any address to query. In the Class Action Configurations textarea, enter each class action or registry contract you want to query in the format name:contract:chain:tokenSymbol—one per line. For example, "ClassAction:0x4b8a4D1F6a2Ff6b9A6B0F4A9A8F0A9A8F0A9A8F0:1:TOKEN" for a class action on Ethereum mainnet or "Registry:0x...:137:TOKEN2" for a registry on Polygon. Click "Check Eligibility & Status" to fetch eligibility and opt-in status for each action. Results appear in the Results card with a summary of actions found, eligible actions, and opted-in count, followed by a detailed breakdown of each action. Click "Submit Opt-In" to execute a transaction that attests to your class action participation.

TECHNICAL MECHANISM: MULTI-INTERFACE ELIGIBILITY AND OPT-IN DETECTION

The tool uses ethers.js to interact with class action contracts through a tiered ABI detection system. For eligibility, it attempts isEligible(address) and falls back to eligible(address). For opt-in status, it attempts hasOptedIn(address) and falls back to optedIn(address). Balance queries use getBalance(address) where available. Each action is evaluated independently, with eligibility and opt-in status aggregated for summary display. The opt-in submission attempts optIn(address) for class action contracts and falls back to attestOptIn(address) for registry implementations. All transactions are executed sequentially to avoid nonce conflicts, with proper error handling for each action.

WHAT IT CANNOT SEE

This tool cannot verify off-chain legal standing or class action certification—it only reads on-chain eligibility data and cannot validate whether the class action has legal standing in any jurisdiction. It cannot validate holder identity or legal jurisdiction—the tool trusts the token contract's reported balance and cannot verify actual ownership or jurisdiction. It cannot prove that tokens were held during the relevant class period without proper snapshot verification—the tool relies on the class action contract's eligibility logic and cannot independently verify historical holdings. It relies on token contract interfaces and may not support all token standards—if a token uses a non-standard interface, balances may not be detected. It cannot ensure opt-in attestations are recognized by courts or legal authorities—on-chain attestations may not have legal standing in all jurisdictions.

PLEASE NOTE

This tool signs transactions to submit opt-in attestations—ensure you trust the class action contracts and registries you configure. All state is in-memory and resets on page reload. The tool supports EVM chains only—Ethereum, Polygon, BSC, Arbitrum, Optimism, Avalanche, Base, and Fantom. Always verify that the contract addresses you enter are correct and correspond to the class action or registry protocols you intend to query. This tool does not provide legal advice—consult with legal professionals for class action participation guidance.