Running on a Host

In order to participate in surplus auctions you need to bid with protocol tokens
Prerequisties
Python 3.6+
Clone:
1
git clone https://github.com/reflexer-labs/auction-keeper.git
2
cd auction-keeper
3
git submodule update --init --recursive
Copied!
Install:
This creates a virtual environment and installs requirements:
./install.sh
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 surplus_model.sh:
1
#!/usr/bin/env bash
2
while true; do
3
  echo "{\"price\": \"325.0\"}"
4
  sleep 120                   
5
done
Copied!
Then:
chmod +x surplus_model.sh
3) Create the keeper run file
Create a file called run_auction_keeper.sh and paste the following code in it:
1
#!/bin/bash
2
bin/auction-keeper \
3
     --type surplus \
4
     --model surplus_model.sh \
5
     --rpc-uri <ETH_RPC_URL> \
6
     --eth-from <KEEPER_ADDRESS> \
7
     --eth-key key_file=<KEYSTORE_FILE>
Copied!
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:
​Ethereum UTC / JSON Wallet Encryption​
​keythereum​
Finally:
chmod +x run_auction_keeper.sh
4) Start the keeper and enter your keystore file password
./run_auction_keeper.sh
1
$ ./run_auction_keeper.sh
2
Password for /keystore/key.json:
Copied!

Running in Docker

Next - Keepers

Bidding Models

Last modified 10mo ago

Copy link

Contents

2) Create a model file

Then:

3) Create the keeper run file

Then, substitute the following variables:

Finally:

4) Start the keeper and enter your keystore file password