BarterDEX/ReadMe.md

88 lines
3.6 KiB
Markdown
Raw Normal View History

# BarterDEX-Simple App
2017-05-15 09:31:38 -07:00
2017-08-17 07:04:16 -07:00
Before starting make sure you have `marketmaker` daemon compiled and running on your machine.
2017-05-15 09:31:38 -07:00
2017-08-17 07:04:16 -07:00
You can find instructions to install `marketmaker` here:
2017-05-15 09:35:07 -07:00
2017-05-15 09:34:33 -07:00
https://github.com/SuperNETorg/komodo/wiki/Setting-up-Liquidity-Provider-(LP)-Node#installing-liquidity-provider-lp-node-on-ubuntudebian-system
2017-08-03 00:59:04 -07:00
### Setup
2017-05-15 09:31:38 -07:00
Once running, follow these steps:
```shell
git clone https://github.com/SuperNETorg/BarterDEX-Simple.git
cd BarterDEX-Simple
2017-11-26 07:23:52 -08:00
git checkout v0.7
2017-08-17 05:42:02 -07:00
npm install
npm start
2017-05-15 09:31:38 -07:00
```
It will download "BarterDEX-Simple". Open "BarterDEX-Simple", and from there open "index.html" file in your web browser.
2017-05-20 06:46:23 -07:00
2017-08-03 00:59:04 -07:00
### Update
To update, follow these steps:
```shell
cd BarterDEX-Simple
2017-11-26 07:23:52 -08:00
git checkout v0.7
git pull
2017-08-17 07:04:16 -07:00
```
2017-08-20 09:13:36 -07:00
#### For end users
To build the production ready app, install `electron-packager` and `electron-prebuilt` packages from npm
```shell
sudo npm install electron-packager -g
sudo npm install electron-prebuilt -g
```
2017-11-17 17:55:54 -08:00
### Instructions to test
1. Start Komodo Native Wallet
2. Start Monaize Native Wallet
3. Wait for both Komodo and Monaize to sync 100%
4. Start BarterDEX-Simple
5. Select 'Monzie (MNZ) dICO' option at the login screen.
6. Login with `passphrase` (either pre-generated or make a new one).
7. Look for the KMD address and send KMDs to it. Once sent, it will start reflecting there in a minute.
8. Give the maximum price that you would like to pay for MNZ. Example: 0.15
9. Give the maximum amount of MNZ you would like to buy. Example: 19
10. Wait and watch the MNZ balance increasing as trades happen.
#### Report Issues
Please feel free to test and post any bugs or issues found here: https://github.com/SuperNETorg/BarterDEX-Simple/issues
#### Testing Notes
If your wallet is encrypted, the app will not work with it. This feature will be made available in coming releases.
### **Build the App**
2017-08-20 09:13:36 -07:00
Refer to the original [electron-packager](https://github.com/electron-userland/electron-packager) repository for more detailed information.
##### Linux
Change directory to BarterDEX-Simple and execute the following command to build the Linux app
```shell
cd BarterDEX-Simple
2017-11-16 14:30:43 -08:00
electron-packager . --platform=linux --arch=x64 --icon=assets/icons/barterdex/128x128.png --out=build/ --buildVersion=VERSION_NUMBER_HERE --ignore=assets/bin/win64 --ignore=assets/bin/osx --overwrite
```
change architecture build parameter to ```--arch=x32``` for 32 bit build
2017-08-20 09:13:36 -07:00
##### OSX
Change directory to BarterDEX-Simple and execute the following command to build the OSX app
2017-08-20 09:13:36 -07:00
```shell
cd BarterDEX-Simple
2017-11-16 14:30:43 -08:00
electron-packager . --platform=darwin --arch=x64 --icon=assets/icons/barterdex/barterdex.icns --out=build/ --buildVersion=VERSION_NUMBER_HERE --ignore=assets/bin/win64 --ignore=assets/bin/linux64 --overwrite
```
##### Windows
Change directory to iguana and execute the following command to build the Windows app
```shell
dir iguana
2017-11-16 14:30:43 -08:00
electron-packager . --platform=win32 --arch=x64 --icon=assets/icons/barterdex/barterdex.ico --out=build/ --buildVersion=VERSION_NUMBER_HERE --ignore=assets/bin/osx --ignore=assets/bin/linux64 --overwrite
# If generating 32bit desktop package
2017-11-16 14:30:43 -08:00
electron-packager . --platform=win32 --arch=ia32 --icon=assets/icons/barterdex/barterdex.ico --out=build/ --buildVersion=VERSION_NUMBER_HERE --ignore=assets/bin/osx --ignore=assets/bin/linux64 --overwrite
# To build both x64 and x86 desktop package
2017-11-16 14:30:43 -08:00
electron-packager . --platform=win32 --arch=all --icon=assets/icons/barterdex/barterdex.ico --out=build/ --buildVersion=VERSION_NUMBER_HERE --ignore=assets/bin/osx --ignore=assets/bin/linux64 --overwrite
```
change architecture build parameter to ```--arch=x64``` for 64 bit build