126 lines
5.4 KiB
Python
126 lines
5.4 KiB
Python
from typing import Dict, List, Optional
|
|
from web3 import Web3
|
|
|
|
from mev_inspect.traces import get_child_traces
|
|
from mev_inspect.schemas.traces import (
|
|
ClassifiedTrace,
|
|
Classification,
|
|
Protocol,
|
|
)
|
|
|
|
from mev_inspect.schemas.liquidations import Liquidation
|
|
from mev_inspect.abi import get_raw_abi
|
|
from mev_inspect.transfers import ETH_TOKEN_ADDRESS
|
|
|
|
V2_COMPTROLLER_ADDRESS = "0x3d9819210A31b4961b30EF54bE2aeD79B9c9Cd3B"
|
|
V2_C_ETHER = "0x4Ddc2D193948926D02f9B1fE9e1daa0718270ED5"
|
|
CREAM_COMPTROLLER_ADDRESS = "0x3d5BC3c8d13dcB8bF317092d84783c2697AE9258"
|
|
CREAM_CR_ETHER = "0xD06527D5e56A3495252A528C4987003b712860eE"
|
|
|
|
# helper, only queried once in the beginning (inspect_block)
|
|
def fetch_all_underlying_markets(w3: Web3, protocol: Protocol) -> Dict[str, str]:
|
|
if protocol == Protocol.compound_v2:
|
|
c_ether = V2_C_ETHER
|
|
address = V2_COMPTROLLER_ADDRESS
|
|
elif protocol == Protocol.cream:
|
|
c_ether = CREAM_CR_ETHER
|
|
address = CREAM_COMPTROLLER_ADDRESS
|
|
else:
|
|
raise ValueError(f"No Comptroller found for {protocol}")
|
|
token_mapping = {}
|
|
comptroller_abi = get_raw_abi("Comptroller", Protocol.compound_v2)
|
|
comptroller_instance = w3.eth.contract(address=address, abi=comptroller_abi)
|
|
markets = comptroller_instance.functions.getAllMarkets().call()
|
|
token_abi = get_raw_abi("CToken", Protocol.compound_v2)
|
|
for token in markets:
|
|
# make an exception for cETH (as it has no .underlying())
|
|
if token != c_ether:
|
|
token_instance = w3.eth.contract(address=token, abi=token_abi)
|
|
underlying_token = token_instance.functions.underlying().call()
|
|
token_mapping[
|
|
token.lower()
|
|
] = underlying_token.lower() # make k:v lowercase for consistancy
|
|
return token_mapping
|
|
|
|
|
|
def get_compound_liquidations(
|
|
traces: List[ClassifiedTrace],
|
|
collateral_by_c_token_address: Dict[str, str],
|
|
collateral_by_cr_token_address: Dict[str, str],
|
|
) -> List[Liquidation]:
|
|
|
|
"""Inspect list of classified traces and identify liquidation"""
|
|
liquidations: List[Liquidation] = []
|
|
|
|
for trace in traces:
|
|
if (
|
|
trace.classification == Classification.liquidate
|
|
and (
|
|
trace.protocol == Protocol.compound_v2
|
|
or trace.protocol == Protocol.cream
|
|
)
|
|
and trace.inputs is not None
|
|
and trace.to_address is not None
|
|
):
|
|
# First, we look for cEther liquidations (position paid back via tx.value)
|
|
child_traces = get_child_traces(
|
|
trace.transaction_hash, trace.trace_address, traces
|
|
)
|
|
seize_trace = _get_seize_call(child_traces)
|
|
underlying_markets = {}
|
|
if trace.protocol == Protocol.compound_v2:
|
|
underlying_markets = collateral_by_c_token_address
|
|
elif trace.protocol == Protocol.cream:
|
|
underlying_markets = collateral_by_cr_token_address
|
|
|
|
if (
|
|
seize_trace is not None
|
|
and seize_trace.inputs is not None
|
|
and len(underlying_markets) != 0
|
|
):
|
|
c_token_collateral = trace.inputs["cTokenCollateral"]
|
|
if trace.abi_name == "CEther":
|
|
liquidations.append(
|
|
Liquidation(
|
|
liquidated_user=trace.inputs["borrower"],
|
|
collateral_token_address=ETH_TOKEN_ADDRESS, # WETH since all cEther liquidations provide Ether
|
|
debt_token_address=c_token_collateral,
|
|
liquidator_user=seize_trace.inputs["liquidator"],
|
|
debt_purchase_amount=trace.value,
|
|
protocol=trace.protocol,
|
|
received_amount=seize_trace.inputs["seizeTokens"],
|
|
transaction_hash=trace.transaction_hash,
|
|
trace_address=trace.trace_address,
|
|
block_number=trace.block_number,
|
|
)
|
|
)
|
|
elif (
|
|
trace.abi_name == "CToken"
|
|
): # cToken liquidations where liquidator pays back via token transfer
|
|
c_token_address = trace.to_address
|
|
liquidations.append(
|
|
Liquidation(
|
|
liquidated_user=trace.inputs["borrower"],
|
|
collateral_token_address=underlying_markets[
|
|
c_token_address
|
|
],
|
|
debt_token_address=c_token_collateral,
|
|
liquidator_user=seize_trace.inputs["liquidator"],
|
|
debt_purchase_amount=trace.inputs["repayAmount"],
|
|
protocol=trace.protocol,
|
|
received_amount=seize_trace.inputs["seizeTokens"],
|
|
transaction_hash=trace.transaction_hash,
|
|
trace_address=trace.trace_address,
|
|
block_number=trace.block_number,
|
|
)
|
|
)
|
|
return liquidations
|
|
|
|
|
|
def _get_seize_call(traces: List[ClassifiedTrace]) -> Optional[ClassifiedTrace]:
|
|
"""Find the call to `seize` in the child traces (successful liquidation)"""
|
|
for trace in traces:
|
|
if trace.classification == Classification.seize:
|
|
return trace
|
|
return None
|