Skip to content

XUD UI - a graphical user interface & desktop app for xud-docker ๐ŸŒˆ

License

Notifications You must be signed in to change notification settings

ExchangeUnion/xud-ui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

XUD UI

A graphical user interface for interacting with a xud-docker environment.

Features

  • Connect to an existing xud-docker environment, local or remote
  • Provides read-only views & downloads for
    • services running in xud-docker
    • wallets
    • trade history

Getting started

  • Download and run the XUD UI executable. The latest release can be found here.

  • Make sure to have a xud-docker environment running with API enabled. You can do that by either entering the environment with bash xud.sh --proxy.disabled=false or enabling the API permanently in mainnet.conf:

[proxy]
disabled = false
expose-ports = ["8889"]
  • The API is accessible via the following ports
    • mainnet: 8889 (localhost:8889) - default
    • testnet: 18889 (localhost:18889)
    • simnet: 28889 (localhost:28889)
  • If you are running xud-docker mainnet locally, XUD UI connects automatically to this instance

Application logs

Logs are written to the following locations

  • on Linux: ~/.config/xud-ui/logs/
  • on macOS: ~/Library/Logs/xud-ui/
  • on Windows: %USERPROFILE%\AppData\Roaming\xud-ui\logs\

Application data

Application data is stored in the following locations

  • on Linux: ~/.config/xud-ui/
  • on macOS: ~/Library/Application\ Support/xud-ui/
  • on Windows: %USERPROFILE%\AppData\Roaming\xud-ui\

Development

Requirements

  • Node v12.1.0+
  • Yarn

Install dependencies

yarn

Start in development mode

Windows (Powershell)

($env:HTTPS = "true") -and (yarn start)

Linux, macOS (Bash)

HTTPS=true yarn start

Tests

yarn test

Lint

yarn lint

Building an executable

yarn build to build for an OS the command is executed from.