Liquidation Bonus Claim Tool

WHAT IT DOES

The Liquidation Bonus Claim Tool enables users to claim bonus tokens earned from participating in liquidations on lending protocols. It reads lending protocol contract state, user address, wallet balance, and liquidation event state. The tool processes bonus token contract state, bonus amount, bonus eligibility, claim deadline, and claim status. It supports claimBonus for single bonus claims, batchClaimBonuses for multiple claims in one transaction, and claimWithProof for proof-based claims. The tool reads gas price, base fee, block timestamp, chain ID, transaction nonce, approval state, contract owner state, and bonus distribution state before execution.

HOW TO USE

Connect your wallet and select the target network. Enter the bonus distribution contract address and the lending protocol address (for context). Provide the claim ID or liquidation event ID. Optionally enter proof data if using claimWithProof. Choose the execution method (claimBonus, batchClaimBonuses, or claimWithProof). The tool will fetch bonus eligibility, bonus amount, claim deadline, and claim status. Once confirmed, it submits the claim transaction. The tool displays the bonus amount, eligibility status, and claim deadline before you sign.

TECHNICAL MECHANISM

Unlike generic claim tools, this executor is purpose-built for liquidation bonus workflows. It first reads the bonus distribution contract's isActive() to ensure the contract is operational. The tool fetches bonus eligibility via isEligible() and bonus amount via getBonusAmount() to display the user's claimable rewards. It checks claim status using isClaimed() to prevent duplicate claims. The tool reads the claim deadline via getClaimDeadline() to warn if the claim window has expired. It selects the optimal method: claimBonus for standard claims, batchClaimBonuses for multiple claims in one transaction, or claimWithProof for Merkle-proof-based claims when eligibility is not directly queryable. The tool reads the bonus token address and fetches its symbol and decimals for display. Gas costs are calculated using receipt.effectiveGasPrice for accurate post-EIP-1559 fee accounting.

WHAT IT CANNOT SEE

This tool cannot verify that the bonus is correctly calculated or that the user is eligible beyond the contract's own verification. It cannot detect if the bonus has been claimed already or if the claim window has expired. It also cannot guarantee that the bonus tokens have sufficient liquidity. The tool cannot verify the authenticity of proof data or detect if the proof has been compromised. It also cannot detect if the bonus distribution contract has been paused or upgraded.

PLEASE NOTE

This tool supports EVM-compatible chains. Claiming a bonus is irreversible—verify eligibility, amount, and deadline before proceeding. The bonus distribution contract must implement the claim functions expected by this tool. For claimWithProof, proof data must be generated off-chain. Batch claims use arrays of claim IDs and users; ensure all data is correctly aligned. This tool does not trigger liquidations—for that, use the Liquidation Bot Trigger Tool. For profit analysis, use the Searcher Bundle Simulation Tool.