Liquidation Bot Trigger Tool

WHAT IT DOES The Liquidation Bot Trigger Tool enables users to trigger liquidations on undercollateralized positions in lending protocols like AAVE and Compound. It reads lending protocol contract state, user address, wallet balance, and position health factor. The tool processes collateral asset state, debt asset state, collateral balance, debt balance, liquidation threshold, and liquidation bonus. It supports liquidatePosition for single position liquidation, batchLiquidatePositions for multiple positions in one transaction, and flashLiquidate for flash loan-based liquidations. The tool reads gas price, base fee, block timestamp, chain ID, transaction nonce, approval state, contract owner state, oracle price state, and position status before execution. HOW TO USE Connect your wallet and select the target network. Enter the lending protocol contract address (e.g., AAVE Pool or Compound Comptroller). Provide the target user address whose position is undercollateralized, along with the collateral asset address and debt asset address. Optionally set a liquidation amount—the protocol will use the default if left blank. Choose the execution method (liquidatePosition, batchLiquidatePositions, or flashLiquidate). The tool will fetch the position's health factor, liquidation threshold, and liquidatable status. Once confirmed, it submits the liquidation transaction. The tool displays the health factor and warns if the position is liquidatable. TECHNICAL MECHANISM Unlike generic liquidation tools, this executor is purpose-built for lending protocol liquidation workflows. It first reads the position's health factor via getUserHealthFactor() to determine if the position is undercollateralized (health factor < 1.0). The tool fetches the liquidation threshold using getLiquidationThreshold() and checks liquidatability via isLiquidatable() when available. It reads the collateral and debt balances using getCollateralBalance() and getDebtBalance() to provide context on position size. The tool selects the optimal method: liquidatePosition for standard liquidation, batchLiquidatePositions for multiple positions in one transaction, or flashLiquidate for flash loan-based liquidations. The liquidation amount is validated and formatted with appropriate decimals. Gas costs are calculated using receipt.effectiveGasPrice for accurate post-EIP-1559 fee accounting. The tool displays the health factor and liquidation status before confirmation. WHAT IT CANNOT SEE This tool cannot guarantee that the position will still be liquidatable at the time of execution due to price changes, repayments, or other transactions. It cannot predict the exact gas price required for inclusion, nor can it detect if the position has already been liquidated. It also cannot guarantee that the liquidation will be profitable after gas costs and liquidation penalties. The tool cannot verify oracle price accuracy or detect if the protocol is paused. It also cannot detect if the collateral or debt asset has been altered. PLEASE NOTE This tool supports EVM-compatible chains. Liquidating a position is irreversible—verify the health factor is below 1.0 before triggering. The user must have sufficient native balance for gas. Flash liquidations may have additional requirements (e.g., flash loan repayment). The tool does not provide liquidation profitability analysis—only position status. For profitability, use the Searcher Bundle Simulation Tool or Backrun Opportunity Executor.