Liquidate Borrow

Search…
Liquidate Borrow
A user who has negative account liquidity is subject to liquidation by other users of the protocol to return his/her account liquidity back to positive (i.e. above the collateral requirement). When a liquidation occurs, a liquidator may repay some or all of an outstanding borrow on behalf of a borrower and in return receive a discounted amount of collateral held by the borrower; this discount is defined as the liquidation incentive.
A liquidator may close up to a certain fixed percentage (i.e. close factor) of any individual outstanding borrow of the underwater account. Unlike in v1, liquidators must interact with each dToken contract in which they wish to repay a borrow and seize another asset as collateral. When collateral is seized, the liquidator is transferred dTokens, which they may redeem the same as if they had supplied the asset themselves. Users must approve each dToken contract before calling liquidate (i.e. on the borrowed asset which they are repaying), as they are transferring funds into the contract.
DErc20
1
function liquidateBorrow(address borrower, uint amount, address collateral) returns (uint)
Copied!
msg.sender: The account which shall liquidate the borrower by repaying their debt and seizing their collateral.
borrower: The account with negative account liquidity that shall be liquidated.
repayAmount: The amount of the borrowed asset to be repaid and converted into collateral, specified in units of the underlying borrowed asset.
dTokenCollateral: The address of the dToken currently held as collateral by a borrower, that the liquidator shall seize.
RETURN: 0 on success, otherwise an Error code
Before supplying an asset, users must first approve the dToken to access their token balance.
DEther
1
function liquidateBorrow(address borrower, address dTokenCollateral) payable
Copied!
msg.valuepayable: The amount of ether to be repaid and converted into collateral, in wei.
msg.sender: The account which shall liquidate the borrower by repaying their debt and seizing their collateral.
borrower: The account with negative account liquidity that shall be liquidated.
dTokenCollateral: The address of the dToken currently held as collateral by a borrower, that the liquidator shall seize.
RETURN: No return, reverts on error.
Solidity
1
DEther dToken = DEther(0x3FDB...);
2
DErc20 dTokenCollateral = DErc20(0x3FDA...);
3
require(dToken.liquidateBorrow.value(100)(0xBorrower, dTokenCollateral) == 0, "borrower underwater??");
Copied!
Web3 1.0
1
const dToken = DErc20.at(0x3FDA...);
2
const dTokenCollateral = DEther.at(0x3FDB...);
3
await dToken.methods.liquidateBorrow(0xBorrower, 33, dTokenCollateral).send({from: 0xLiquidator});
Copied!
Transfer
Exchange Rate
Last modified 9mo ago
Copy link
Contents