package new_bedford

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc submitCandidates (stream LiquidateRequest, LiquidateReply)

  txmanager.proto:48

  Send the candidates in bulk. If multiple queries come in, the service will be able to update it's parameters.

  message LiquidateRequest

  txmanager.proto:9

  • repeated LiquidationCandidate candidates = 1

    Can send multiple liquidation candidates at once

  message LiquidateReply

  txmanager.proto:14

  Success signalled by gRPC status code

  (message has no fields)

• rpc cancelCandidates (stream CancelCandidateRequest, CancelCandidateReply)

  txmanager.proto:51

  Also send liquidatability falling-edge, transitions from liquidatable -> not liquidatable. (Usually from someone else liquidating, possibly from other events)

  message CancelCandidateRequest

  txmanager.proto:38

  • repeated int32 addresses = 1

  message CancelCandidateReply

  txmanager.proto:42

  Success signalled by gRPC status code

  (message has no fields)

• rpc updateCandidate (stream CandidateRequest, stream CandidateReply)

  worker.proto:103

  Keeps the event stream open rather than sending a new request each time

  message CandidateRequest

  worker.proto:43

  Request and response types

  • CandidateRequest.RequestType requestType = 1

  • repeated Event events = 2

    Both of these fields are optional, and will be filled depending on the request type

  • repeated Candidate candidates = 3

  message CandidateReply

  worker.proto:57

  • CandidateReply.ReplyType replyType = 1

  • string address = 2

    If requesting a bootstrap

• rpc updatePrices (stream PriceRequest, PriceReply)

  worker.proto:104

  message PriceRequest

  worker.proto:68

  • PriceRequest.PriceRequestType priceRequestType = 1

  • repeated TokenPrice minPrices = 2

    Price Oracle posting

  • repeated TokenPrice maxPrices = 3

  • map<int32, uint64> exchangeRates = 4

    cToken->Token exchange rate update, send with off-chain prices Decimals are 10 + underlying

  • uint32 timestamp = 5

    On-chain price posting

  message PriceReply

  worker.proto:88

  Success signalled by gRPC status code

  (message has no fields)

• rpc updateCompoundRates (stream CompoundRateRequest, CompoundRateReply)

  worker.proto:105

  message CompoundRateRequest

  worker.proto:93

  Borrow rate update

  • map<int32, uint64> borrowRate = 1

  message CompoundRateReply

  worker.proto:97

  Success signalled by gRPC status code

  (message has no fields)

Used in: CandidateRequest, WorkerDB

• string address = 1

• map<int32, uint64> supplyBalances = 2

  Maps from Token (enum int) to amount (varying decimals, supply is always 18 (cTokens), borrow is underlying decimals)

• map<int32, uint64> borrowBalances = 3

Used in: CandidateReply

• NO_REPLY = 0

• CLOSING = 1

• REQUEST_BOOTSTRAP = 2

Used in: CandidateRequest

• NO_REQUEST = 0

• BOOTSTRAP_CANDIDATE = 1

  Also interprets candidate events, post-bootstrap data

• CANDIDATE_EVENT = 2

Used in: WorkerDB

• double closeFactor = 1

• double liquidationIncentive = 2

• map<int32, GlobalTokenData> TokenData = 3

  The following field uses the numerical equivalent of the Token enum as keys, because enums are not allowed as protobuf map keys

Used in: CandidateRequest

• Event.EventType eventType = 1

• Token token = 2

• int32 candidateAddress = 3

  from address, in the event of a transfer

• uint64 amount = 4

• int32 transferTo = 5

Used in: Event

• NO_EVENT = 0

• MINT = 1

• REDEEM = 2

• BORROW = 3

• REPAY_BORROW = 4

• LIQUIDATE_BORROW = 5

• TRANSFER = 6

Can only be updated with a new Compound governance proposal, or changes to the token's ERC-20 contracts

Used in: CompoundData

• double collateralFactor = 2

• TokenType tokenType = 3

• int32 underlyingDecimals = 4

• string cTokenAddress = 5

Used in: LiquidateRequest

• repeated TransactionTokenData tokens = 1

  Token prices, signatures, and messages (from Coinbase) corresponding to the ones that were used to determine liquidatability

• double expectedRevenue = 2

  Profitability (to determine maximum allowed transaction fee)

• string candidateAddress = 3

  Candidate address

• string repayTokenAddress = 4

  Address of cToken to repay

• string seizeTokenAddress = 5

  Address of cToken to seize

Used in: PriceRequest

• NO_PRICEREQUEST_TYPE = 0

• OFFCHAIN_PRICE = 1

• PRICES_POSTED_ONCHAIN = 2

Global enums

Used in: Event, TokenPrice

• NO_TOKEN = 0

• cETH = 2

  ETH = 1;

• cWBTC = 4

  WBTC = 3;

• cDAI = 6

  DAI = 5;

• cUSDC = 8

  USDC = 7;

• cUSDT = 10

  USDT = 9;

• cUNI = 12

  UNI = 11;

• cZRX = 14

  ZRX = 13;

• cCOMP = 16

  COMP = 15;

• cBAT = 18

  BAT = 17;

• cSAI = 20

  SAI = 19;

• cREP = 22

  REP = 21;

Used in: PriceRequest

• Token token = 1

• uint64 priceDollars = 2

• uint32 decimals = 3

  Always 6 for now

• string message = 4

• string signature = 6

Used in: GlobalTokenData

• NO_TYPE = 0

• V1 = 1

• V2 = 2

Used in: LiquidationCandidate

• string symbol = 1

  An instance of token data, signature, and message (from Coinbase) corresponding to the ones that were used to determine liquidatability

  Ticker (BAT, USDC, etc)

• string signature = 2

• string message = 3

Data type definitions

• optional CompoundData compoundData = 1

• map<int32, Candidate> candidates = 2