Running on a Host

Running a collateral auction keeper directly on a host


Python 3.6+

Get RAI:

Buy RAI from Uniswap v2 or open a SAFE and generate it.


git clone
cd auction-keeper
git submodule update --init --recursive


This creates a virtual environment and installs requirements.


1) Start virtualenv

source _virtualenv/bin/activate

2) Create a model file

Paste the following code into

#!/usr/bin/env bash
while true; do
echo "{}"
sleep 120

NOTE: Currently, collateral auctions sell collateral at a fixed discount and so the keeper doesn't use a bidding model. This empty bidding model is simply a placeholder.

3) Create the keeper run file

Create a file called and paste the following code in it:

bin/auction-keeper \
--model ./ \
--rpc-uri <ETH_RPC_URL> \
--eth-from <KEEPER_ADDRESS> \
--eth-key key_file=<KEYSTORE_FILE>

Then, substitute the following variables:

ETH_RPC_URL - the URL of the ethereum RPC connection

KEEPER_ADDRESS - the keeper's address. It should be in checksummed format(not lowercase).

KEYSTORE_FILE - your Ethereum UTC JSON keystore filename

For more information about this keystore format and how to generate them:


chmod +x

4) Start the keeper and enter your keystore file password


$ ./
Password for /keystore/key.json: