Protocol Fee Claimer

WHAT IT DOES

Protocol Fee Claimer connects to any EVM-based protocol fee contract and enables you to claim accrued protocol fees with a single click. The tool reads comprehensive contract state including accumulated protocol fees, token address, fee recipient address, claimable amount per recipient, fee distribution parameters, distribution period, current block timestamp, claim history, fee rate parameters, and fee sources breakdown. It then displays your claimable amount, the total fee pool, the current fee rate, distribution period, and whether you have already claimed. When fees are available and you are the designated fee recipient, the tool enables a one-click claim transaction. The tool handles multiple claim function signatures (claimFees, withdrawProtocolFees, executeFeeClaim) and automatically detects the correct function to call. After submission, the tool displays the transaction hash and refreshes the contract data to show the updated claim status. This is ideal for protocol operators, DAO treasuries, governance recipients, and any fee-sharing arrangement where participants need to track and withdraw their share of protocol-generated revenue.

HOW TO USE

Connect your Web3 wallet (MetaMask, WalletConnect, or any EIP-1193 provider). Select the correct network for your protocol fee contract — the tool supports Ethereum, Polygon, Arbitrum, Optimism, Base, Avalanche C-Chain, and BNB Chain. Paste your fee contract address into the input field. The tool reads the contract using a default ABI that covers standard protocol fee functions, but you can paste a custom ABI if your contract uses non-standard naming. Review the displayed data carefully: your claimable amount, token type, total fee pool, fee rate percentage, distribution period, and whether you have already claimed. The status indicator will show "Ready to claim" when fees are available and you are the designated recipient, "Claimed" if you have already withdrawn, "No fees" if nothing is available, or "Not your fees" if you are not the fee recipient for that contract. When fees are available and you are the recipient, the "Claim protocol fees" button becomes enabled. Click it to submit the claim transaction — the tool will show a confirmation dialog with all details, submit the transaction, and wait for confirmation. After successful execution, the contract data refreshes automatically to show the updated claim status.

THE REAL MECHANISM

This tool does not assume a single fee structure — it adapts to the contract's actual implementation. It first detects the correct claim function by testing common names (claimFees, withdrawProtocolFees, executeFeeClaim) through static calls, falling back to the user-provided name if none are found. For fee data, the tool reads claimableFees(yourAddress) to determine what you are owed, token() to identify the payment currency, feePool() to check the total available funds, feeRate() to display the current fee percentage, distributionPeriod() to show the payout frequency, and hasClaimed(yourAddress) to prevent duplicate claims. The tool also reads feeRecipient() to verify that you are the designated recipient before enabling the claim button. This multi-step verification ensures you only attempt to claim when funds are actually available and you are the correct recipient. The tool auto-refreshes data after each claim to keep the display current. All transaction parameters are estimated using eth_estimateGas and sent with the wallet's preferred gas strategy. The tool monitors the transaction receipt and extracts the effectiveGasPrice to display actual gas cost, not the cap.

WHAT IT CANNOT SEE

Protocol Fee Claimer cannot verify that fee calculations are accurate or fairly determined by the protocol. It cannot detect if the fee rate has been changed without notice or if the protocol has adjusted rates retroactively. It cannot guarantee that the fee pool contains sufficient funds for all recipients or that funds will be available when you claim. It cannot ensure that the fee contract has not been upgraded, modified, or paused by its owner. It cannot prevent the protocol from pausing, adjusting, or cancelling fee claims at any time. It cannot recover funds if the claim transaction fails due to contract bugs, out-of-gas errors, or network conditions. It cannot verify that the protocol is accurately tracking all fee-generating activities or that the fee source data is complete and correct. It cannot detect if the fee contract is malicious, contains hidden fee structures, or has been deployed by an untrusted party. It cannot validate that the fee attribution correctly reflects actual protocol usage or that fee recipients are properly authorized.

PLEASE NOTE — EVM CHAINS ONLY

This tool works exclusively with EVM-compatible blockchains. Non-EVM chains are not supported. The tool does not deploy contracts, manage private keys, or sign anything outside the connected wallet's secure environment. It is a read-and-execute interface that relies entirely on the protocol fee contract's implementation and the distribution logic defined therein. Always verify the fee contract address and fee recipient status directly on-chain before claiming.