Aave V3 Liquidator

This is an Artemis bot that liquidates aave v3 positions

Based on work by marktoda (https://github.com/marktoda/artemis-aave-v3-liquidator), Seamless Protocol (https://github.com/seamless-protocol/liquidator) and Hypurrfi team (https://github.com/lastdotnet/hypurrfi-liquidator)

Getting Started

1. Install Rust ref

   • Install deps: sudo apt install -y build-essential libssl-dev (Linux) or xcode-select --install (Mac)

2. Install Foundry ref

3. Deploy liquidator contract

cd crates/liquidator-contract
forge install
forge create ./src/Liquidator.sol:Liquidator --private-key <xyz> --rpc-url <xyz> --broadcast

for mainnet verification:

forge create ./src/Liquidator.sol:Liquidator --private-key <xyz> --rpc-url <xyz> --broadcast --verify --verifier sourcify --verifier-url https://sourcify.parsec.finance/verify

4. Build Rust Application

a. cd to root of project

b. (if not cross compiling) Compile binary for host arch:

cargo build --release

c. (if cross compiling) Compile binary on Mac for Linux: Cross is a tool developed by Rust devs to simplify cross compilation (compiling on one machine architecture for another architecture, e.g.: compile binary on mac for running on a linux machine). Make sure to install from github repo not latest release in cargo (it's quite outdated). Github link

If you are using an ARM based Mac (e.g.: M1), you need to set DOCKER_DEFAULT_PLATFORM env to linux/amd64

cargo install cross --git https://github.com/cross-rs/cross
DOCKER_DEFAULT_PLATFORM=linux/amd64 cross build --target x86_64-unknown-linux-gnu --release

d. Copy (scp) binary to liquidator host

6. Run liquidator

./target/release/aave-v3-liquidator \
    --archive-rpc <xyz> \
    --write-rpc <xyz> \
    --private-key <xyz> \
    --bid-percentage 100 \
    --deployment hyperlend \
    --liquidator-address <xyz> \
    --chain-id <xyz>

• Write rpc: https://rpc.hyperliquid.xyz/evm
• Archive rpc: https://rpc.hyperlend.finance/archive

Re-generate Contract Bindings

Liquidator

forge bind --bindings-path ./crates/bindings-liquidator --root ./crates/liquidator-contract --crate-name bindings-liquidator --overwrite

Aave

forge bind --bindings-path ./crates/bindings-aave --root {path to aave-v3-core} --crate-name bindings-aave --overwrite