Skip to content

sidestream-tech/unified-auctions-ui

Repository files navigation

Screenshot of the application

Unified Auctions UI

The tool to enable easy and straightforward participation in MakerDAO liquidations for users both completely unfamiliar with Maker protocol but also experts. The repository contains both the frontend-only application to fetch and manually interact with the maker auctions, as well as the bot – the "keeper" application to configure and run with your own settings to automatically particiate in specified auctions.

Using the app

The frontend app is officially deployed on the unified-auctions.makerdao.com

Running locally

Besides being officially deployed on the public internet, the app can also be run locally in case there are problems with the website avialablility. In order to simplify this process, we packaged the frontend application into the crossplatform electron app.

  1. Download relevant application from the latest github release page
    • MacOS: download the file ending on .dmg
    • Windows: downalod the file ending on .exe
    • Ubuntu/linux: download the file ending on .AppImage
  2. Install the application
    • MacOS
      • Double click the dmg file
      • Drag and drop application icon into the Applications folder
      • Important! When opening for the first time:
        • Right click the application in the Applications folder, select Open
        • Click Open while being asked "macOS cannot verify the developer of “Unified Auctions UI.app”. Are you sure you want to open it?"
        • In case of you're seeing other messages, please follow this official guide
    • Windows
      • Double click and follow the instructions
    • Ubuntu/linux
      • Make it executable (e.g.: chmod a+x Unified.Auctions.UI-1.18.1.AppImage)
      • Run (e.g.: ./Unified.Auctions.UI-1.18.1.AppImage)
  3. Configure RPC URL
    • In order for the application to make requests to the blockchain, fetch auctions, market data and send transactions, it needs the address of a RPC URL. To get this URL, you can use external services like Alchemy or Infura or run your own Ethereum node.
    • Copy the URL and paste it into the dialog window
  4. Use WalletConnect to sign your transactions (other wallets are not currently supported in the electron version)

Development

Please follow service-level readme instructions inside frontend, core and bot folders.

Statistics

In order to properly collect statics using plausible.io, we ask developers and company members who need to interact with the production version of the website to opt out of plausible tracking using those instructions.