v3.0.0

Features

• Store transaction sender in events

API Refactoring

• Breaking: use Erc20Asset interface for swaps, arbitrages, liquidations, sandwiches, JIT sandwiches, and liquidity deposits/withdrawals. To keep the old behavior, use address field (e.g. arbitrage.swap[0].assetIn -> arbitrage.swap[0].assetIn.address, liquidation.collateral -> liquidation.collateral.address, etc).
• Breaking: split searcher into sender (transaction sender, EOA) and beneficiary (usually, a transaction target, smart contract). This affects Arbitrage.arbitrager, Liquidation.liquidator, Sandwich.sandwicher, JitSandwich.sandwicher, and NftArbitrage.arbitrager. To keep the old behavior, use beneficiary (e.g. arbitrage.arbitrager -> arbitrage.arbitrager.beneficiary).

v2.1.4

Features

• Detect NFT arbitrages
• Classify Opensea swaps
• Classify LooksRare swaps
• Classify X2Y2 swaps
• Classify Sudoswap swaps

Fixes

• Fix some trades are wrongly detected as JIT sandwich

v2.0.0

Features

• Support imbalanced liquidity deposits and withdrawals

API Refactoring

• Breaking: Rename Sandwich param: sandwichedSwaps -> sandwiched
• Breaking: Rename JitLiquiditySandwich -> JitSandwich
• Breaking: Rename getJitLiquiditySandwiches -> getJitSandwiches
• Breaking: Rename JitSandwich param: sandwichedSwaps -> sandwiched
• Breaking: Rename JitSandwich param: addition -> deposit
• Breaking: Rename JitSandwich param: removal -> withdrawal
• Breaking: Rename LiquidityAddition -> LiquidityDeposit
• Breaking: Rename LiquidityDeposit param: owner -> depositor
• Breaking: Rename LiquidityRemoval -> LiquidityWithdrawal
• Breaking: Rename LiquidityWithdrawal param: owner -> withdrawer

v1.1.1

Features

• Add "JIT liquidity sandwich" MEV type detection (Uniswap V3)

v1.0.0

Features

• Breaking: Wrap profitAsset/profitAmount into profit
• Add Optimism and Avalanche Curve pools

Misc

• Add "API" section to readme
• Update "usage" section on readme
• Clean-up examples directory
• Bump dependencies

v0.13.1

Features

• Breaking: replace startAmount and endAmount with profitAmount in Arbitrage
• Add missing metapool assets to Curve V1 pools

v0.12.0

Features

• Add 0x V3/V4
• Add Curve V1/V2
• Add Bancor V2/V3
• Add Aave V1
• Add Optimism chain
• Add Avalanche chain
• Breaking: remove isArbitrage/isLiquidation/isSandwich. Use getArbitrages/getLiquidations/getSandwiches instead.

v0.11.0

Features

• Breaking: Merge TxMev and BlockMev interfaces into Mev. While correct semantically, the split creates confusion and worsens DX in practice.

v0.10.0

Features

• Sandwich trade detection

v0.9.0

Changes

• Breaking: add fork labels to protocol factories / lending pools
• Fix contract address in liquidation events are checksumcased
• Add fork support for Balancer V2