README.md

Liquidatable Accounts Feed

This implements a service that listens to Solana updates of Mango related accounts and checks if they are liquidatable. If they are, it notifies connected clients about it.

Its purpose is to hand potentially liquidatable accounts to a Mango liquidator like https://github.com/blockworks-foundation/liquidator-v3.

It is a separate service because computing account health is around two orders of magnitude faster this way.

Architecture

Data flows into this service through

• Solana JSON RPC PubSub websocket streams, for slot and account updates
• Solana JSON RPC getProgramAccounts requests, for snapshots

The service models the current bank state for relevant accounts, checks their health and sends interesting data back out to all clients that connected to its websocket server.

All data resides in memory. The service does not write to disk.

Building

Use a release build (cargo build --release) for production.

Rust 1.59.0 can build this project. 1.57.0 is reported to work too.

Users report that the dependencies libclang-dev libudev-dev pkg-config must be installed.

This is x86_64 only right now. aarch64 is not a supported target.

Running

Run liquidatable-accounts-feed myconfig.toml. The service is supposed to run until aborted. Please report any panics or early exits as issues.

Configuration

Check example-config.toml.

Note that you will need to configure an RPC server that allows websocket connections as well as getProgramAccounts RPC calls.

Output

Websocket messages look like this (without the comments):

{
  "jsonrpc": "2.0",
  // "candidate" is sent each time an account is looked at
  // "candidateStart" is sent the first time account health is below threshold
  // "candidateStop" is send when a candidate's health is above threshold again
  "method": "candidate",
  "params": {
    "account": "DopjuzaqPURVDy3DQhffGa1YZ9maMe5StGY1aXfJAymk",
    // the being_liquidated flag on the account
    "being_liquidated": false,
    // assets divided by liabilities; <1.0 means liquidatable
    "health_fraction": 1.0000339686978705,
    // weighted sum of assets
    "assets": 48741,
    // weighted sum of liabilities
    "liabilities": 48740
  }
}