A script for liquidating undercollateralized account on Mango Markets.

To run the liquidator you will need:

• A Solana account with some SOL deposited to cover transaction fees
• A Mango Account with some collateral deposited
• Your wallet keypair saved as a JSON file
• node (v14+) and yarn
• A clone of this repository
• Dependencies installed with yarn install

The liquidator will attempt to close all perp positions, and balance the tokens in the liqor account after each liquidation. By default it will sell all token assets into USDC. You can choose to maintain a certain amount of each asset through this process by editing the value in the TARGETS environment variable at the position of the asset. You can find the order of the assets in the 'oracles' property of the group in ids.json The program will attempt to make buy/sell orders during balancing to maintain this level.

The liquidator triggers advanced orders for users when their trigger condition is met. Upon successfully triggering the order, the liquidator wallet will receive 100x the transaction fee as a reward.

yarn liquidator

The liquidator can be run in two different modes:

The liquidator will connect to an RPC node websocket feed itself and request snapshots occasionally. This is simpler to get started with, as no separate service is needed to watch for potentially liquidatable accounts, but scanning for accounts can be slow.

To use this mode, leave LIQUIDATABLE_FEED_WEBSOCKET_ADDRESS unset.

Only this mode allows advanced order triggering.

In this mode the https://github.com/blockworks-foundation/liquidatable-accounts-feed service provides information about potentially liquidatable accounts to the liquidator.

The external service is much faster at scanning for newly liquidatable accounts when the price cache is updated than Mode 1.

To use it, set up the liquidatable-accounts-feed service (probably on the same machine) and then set the liquidator's LIQUIDATABLE_FEED_WEBSOCKET_ADDRESS to the other service's websocket_server_bind_address.

This mode never triggers advanced orders.

You can add these variables to a .env file in the project root to load automatically on liquidator startup. For example:

ENDPOINT_URL=https://solana-api.projectserum.com
KEYPAIR=${HOME}/.config/solana/my-keypair.json
TARGETS=500 0.1 0.75 0 0 0 0 0