Token Holder Dividend Claim Tool

WHAT IT DOES

This tool enables token holders to claim their share of dividends distributed by protocols that share revenue with token holders. Dividends are distributed proportionally based on token holdings, rewarding users who hold the protocol's token. It connects to your wallet and reads the dividend contract address, token balance, dividend rate, claimable amount, distribution period, claim history, and timestamps. The tool signs and submits transactions to claim token holder dividends, transfer dividend tokens, update claim status, record claim metadata, and emit claim events.

HOW TO USE

1. Connect your wallet using the wallet bridge (supports MetaMask, WalletConnect, and other EVM-compatible wallets).

2. Select the target network that matches your dividend contract deployment.

3. Enter the dividend contract address and click "load contract" to initialize the connection.

4. Click "fetch dividend status" to retrieve your token balance, dividend rate, claimable amount, distribution period, and claim history.

5. Review your token balance and the claimable amount — this is the dividend you have earned and can claim.

6. Check the dividend rate to understand the current yield.

7. Click "validate claim" to verify that you have claimable dividends.

8. Click "check claim history" to view your past dividend claims.

9. Review the claimable amount, token balance, and dividend rate before executing.

10. Click "claim dividends" to sign and submit the transaction that transfers your earned dividends to your wallet.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with any EVM-compatible dividend contract that implements a standard interface (getTokenBalance(address) view returns (uint256), getDividendRate() view returns (uint256), getClaimableAmount(address) view returns (uint256), getDistributionPeriod() view returns (uint256, uint256), claimDividend() external, getClaimHistory(address) view). The getTokenBalance view returns the user's token holdings, which determines their dividend entitlement. The getDividendRate view returns the current dividend rate (APY or per-period rate). The getClaimableAmount view calculates the user's accumulated dividends based on their token balance, the dividend rate, and the distribution period. The claimDividend function transfers the claimable amount to the user and updates their claim status. The getDistributionPeriod view returns the start and end timestamps of the current distribution period, allowing users to track when dividends are being generated. Transaction handling follows EIP-1559 gas price calculations using receipt.effectiveGasPrice for accurate cost reporting. Claim metadata is recorded both in the contract's history and locally for the user's reference.

WHAT IT CANNOT SEE

This tool operates purely on-chain and cannot verify off-chain token holdings — it does not check whether the token balance is accurate or if tokens are held in other wallets. It cannot validate dividend eligibility — the tool cannot confirm that the user is eligible for dividends or that the dividend rate is correct. It cannot detect sybil accounts — the tool cannot identify users who create multiple wallets to claim dividends. It cannot ensure fair distribution — the tool does not verify that the dividend distribution is proportional to token holdings. The tool also cannot verify that dividends are actually generated — it relies on the contract's state and does not independently verify that the protocol is generating revenue.

PLEASE NOTE

This tool works exclusively with EVM-compatible blockchain networks (Ethereum, Polygon, Arbitrum, Optimism, Base, etc.). It requires the dividend contract to implement the interface described above. All transactions incur gas fees paid by the connected wallet. The tool maintains no persistent storage — all state is refreshed from the blockchain on each session. Dividends are typically generated from protocol revenue — ensure the protocol is reputable and the dividend rate is sustainable before claiming. Always verify the claimable amount before executing. Consider the gas costs relative to the claimable amount — claiming small amounts may not be cost-effective.