Liquidation Penalty Fee Claim Tool (Protocol Share)

WHAT IT DOES

Liquidation Penalty Fee Claim Tool (Protocol Share) enables protocol administrators or authorized addresses to claim the protocol's share of liquidation penalty fees from specific liquidation events. The tool reads your connected wallet address, protocol contract address, liquidation event data, penalty fee amount, fee token address, token decimals, claim eligibility, claim status, current block timestamp, claim deadline, and fee distribution schedule. It displays the penalty fee amount, eligibility status, claim status, deadline, and distribution schedule before you claim. Once confirmed, the tool executes the claim transaction, transferring the protocol's share of the liquidation penalty to the designated address.

HOW TO USE

Connect your wallet and select your network. Enter the protocol contract address, the liquidation event ID you want to claim from, and the fee token address. Click "Check fee claim status" to load the fee details including the penalty fee amount, eligibility status, claim status, claim deadline, and fee distribution schedule. Review all details carefully—the tool will show you whether you are eligible to claim and whether the claim deadline has passed. If you are eligible and the claim is open, click "Claim protocol fee" to submit the claim transaction. The protocol's share of the liquidation penalty fee will be transferred to your wallet.

THE REAL MECHANISM — EVENT-BASED FEE CLAIMING WITH DEADLINE AND SCHEDULE TRACKING

Unlike simple fee withdrawals that only check a balance, this tool implements an event-based fee claiming system with deadline and schedule tracking. The getLiquidationFee function returns the penalty fee amount, claim deadline, and whether the fee has already been claimed for a given liquidation event. The claimFee function verifies that the caller is authorized to claim the protocol share, that the fee amount is greater than zero, that the claim deadline has not passed, and that the fee has not already been claimed. The getFeeSchedule function returns the distribution schedule (e.g., every N events or one-time). The tool reads all fee data via these functions and validates that the claim conditions are met before enabling the claim button. All arithmetic uses ethers.js BigNumber with the token's decimal precision, and gas costs are reported using receipt.effectiveGasPrice.

WHAT IT CANNOT SEE

Cannot verify off-chain liquidation event accuracy—the tool relies on the protocol's on-chain event data and cannot audit whether the liquidation event was valid. It cannot ensure fee calculation correctness—the tool does not verify the fee calculation formula or the protocol's share percentage. It cannot predict future liquidation events—the tool cannot forecast when liquidations will occur. It cannot detect if the protocol contract contains vulnerabilities or malicious code—the tool does not audit the protocol logic. It cannot recover fees if the claim fails or if the claim deadline has passed.

PLEASE NOTE — EVM CHAINS ONLY

This tool exclusively supports EVM-compatible chains where ethers.js can connect via standard JSON-RPC. It does not support non-EVM chains such as Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. The protocol contract must implement the specific interface expected by this tool (getLiquidationFee, claimFee, getFeeSchedule, getToken). Only authorized addresses can claim protocol shares. This tool is a protocol management interface, not a financial advisor or investment strategist.