Running on a Host

Running a surplus auction-keeper on a host

In order to participate in surplus auctions you need to bid with protocol tokens


Python 3.6+


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

Pick a protocol token/system coin price and paste the following code into

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


chmod +x

3) Create the keeper run file

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

bin/auction-keeper \
--type surplus \
--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 your 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, check:


chmod +x

4) Start the keeper and enter your keystore file password


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