The minimum hardware requirements are very low. A single board computer could run multiple instances of the bot, along with other tasks and services, without perceiving an impact on performance.


git clone
cd ssv-liquidator
yarn install
yarn cli --help

This installation requires NodeJS on your machine.




The Ethereum execution node end-point


Private key of the liquidator's wallet


SSV token contract address


The contract address


The views contract address


Gas price heuristic according to the median gas price suggested by web3 gas price oracle:

  • Low (*0.1)

  • Med (*0.2)

  • High (*0.3)


The liquidator bot could be initiated with arguments in the yarn cli command or by using the .env variables.

yarn cli --ssv-sync-env=<prod | stage> --ssv-sync=<v4.holesky | v4.mainnet | v4.prater> --node-url=<NODE_URL>  --private-key=<PRIVATE_KEY>  --gas-price=slow --max-visible-blocks=<MAX_BLOCKS>

Make sure that --ssv-sync and --node-url parameters (or SSV_SYNC and NODE_URL environment variables) are all relative to the same blockchain.

For example, for Holesky (using a sample QuickNode RPC endpoint), the command should look like this:

yarn cli \
--ssv-sync-env=prod \
--ssv-sync=v4.holesky \
--node-url=<ACCOUNT_ID>/  \
--private-key=<PRIVATE_KEY>  \
--gas-price=slow    \

The smart contract addresses were taken from this page, in this instance.

Last updated