Skip to content

1.0.0
Compare
Choose a tag to compare
@pgebheim pgebheim released this 10 Jul 07:50
· 1107 commits to master since this release
v1.0.0
f10e811

Augur App v1.0.0

Augur App is a lightweight Electron app that bundles the Augur UI and Augur Node together and deploys them locally to your machine. The Augur UI is a reference client used to interact with the Augur protocols core smart contracts on the Ethereum blockchain. Augur Node is a locally ran database that parses the Ethereum blockchain for logs relevant to Augur, and serves the respective data to the Augur UI.

Install

Executable Installer:

Download the executable for your respective operating system:

Mac OSX : mac-augur-1.0.0.dmg
Windows : win-augur-1.0.0.exe
Linux : linux-augur-1.0.0.deb

Running

  1. Download the executable for your respective operating system.
  2. Double click to install Augur App.
  3. Select your configuration: Mainnet, Local, Rinkeby, Ropsten, or Kovan.
  4. Point Augur App to an Ethereum node (Either via HTTP or WS endpoints, or both).
  5. Select "Connect", and Augur App will begin to sync Augur Node in the background.
  6. Once synced to 100%, click "Open Augur App" to deploy the UI locally in your browser.
  7. Authenticate using MetaMask, Edge, Ledger or Trezor.

Selecting An Ethereum Node

You have two options for connecting to an Ethereum node: local or remote.

  • Run a synced Geth or Parity client locally.

    or

  • Use a remote node, such as Infura. Not all remote nodes support Websockets or RPC, so your mileage may vary.

Using Ledger Hardware Wallet

Key Derivation Path

Augur derives Ledger account addresses using the BIP0044 standard, or the m/44'/60'/0'/0 key derivation path. Commonly used client-side wallets such as MyCrypto and MyEtherWallet, and the Ledger ETH App, use the "non-standard" key derivation path m/44'/60'/0'. To access the address Augur derives for you on MyCrypto, MyEtherWallet, and the Ledger ETH App, you must change your key derivation path to m/44'/60'/0'/0 (BIP0044).

Local SSL Cert

Ledger requires SSL, which isn't available by default while running software on localhost. If you plan to use a Ledger hardware wallet with Augur, you must first select "Enable SSL For Ledger" before clicking "Open Augur App". Selecting "Enable SSL For Ledger" generates a self-signed SSL certificate locally, allowing you to interact with your Ledger hardware wallet. Other available authentication methods do not require this. Reference.

Firefox Not Supported

Due to the current architecture of this implementation, the use of self-signed SSL certificates, and Firefox's security model, using a Ledger with Firefox is not currently supported. We will be working to fix this issue. In the meantime, it is recommended to use Chrome with Ledger.

Clearing Configuration File

If you’ve installed a previous pre-release of Augur App locally on your machine prior to the main Ethereum network deployment, you will need to clear your local Augur App configuration file in order to properly run this Augur App release and connect to the Ethereum main network.

Please delete the augur directory (or, just the config.json file) in the following location:

Mac OSX : ~/Library/Application\ Support/augur
Windows : %AppData%\augur
Linux : ~/.augur

Questions, Bugs and Issues

Please file any bugs or issues related to Augur App as a GitHub issue in the Augur App repository. If your issue is related to Augur Node, use the Augur Node repository. If you have a UI bug or issue to report, use the Augur Client repository.

Alternatively, you can share feedback or seek help from community members in the Augur Discord.

FAQ & Disclaimer

It is highly encouraged and recommended that users read the FAQ and disclaimer prior to interacting with the Augur protocol on the main Ethereum network.

Assets 5