Agama Desktop App

Desktop App for SuperNET DAPPs

For Developers

You must have node.js, npm and webpack (npm install [email protected]) installed on your machine.

Use install.sh script or

Clone Agama Desktop App with EasyDEX-GUI submodule

1) git clone https://github.com/komodoplatform/agama --recursive --branch dev --single-branch
with this command you git clone agama - but explicitly just the dev branch (therefore --single-branch) which we also use for the release packages.
2) cd agama && cd gui/EasyDEX-GUI/
3) git checkout dev && git pull origin dev
4) npm install && npm install webpack
5) ./binary_artifacts.sh
6) npm start in project root folder
7) cd gui/EasyDEX-GUI/react/src
8) npm start
8) toggle dev and debug options in settings
9) restart the app
10) sync komodod and/or asset chains

You are ready to dev

Important dev notes

Sockets.io

In dev mode backend is configured to send/receive messages from/to http://127.0.0.1:3000 address. If you open it as http://localhost:3000 sockets server will reject any messages.

Coin daemon binaries

Run binary_artifacts.sh from under agama folder you cloned previously. The script will fetch

For end users

The instructions to make production build of Agama App will be updated soon.

To build the production ready app, install electron-packager and electron-prebuilt packages from npm

npm install electron-packager -g
npm install electron-prebuilt -g

Build the Wallet-App

You need to install webpack and webpack-cli first.

Refer to the original electron-packager repository for more detailed information.

Linux

Change directory to agama and execute the following command to build the Linux app

cd agama
electron-packager . --platform=linux --arch=x64 --icon=assets/icons/agama_icons/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

OSX

Change directory to agama and execute the following command to build the OSX app

cd agama
electron-packager . --platform=darwin --arch=x64 --icon=assets/icons/agama_icons/agama_app_icon.icns --out=build/ --buildVersion=VERSION_NUMBER_HERE --ignore=assets/bin/win64 --ignore=assets/bin/linux64 --overwrite

Windows

Change directory to agama and execute the following command to build the Windows app

dir agama
electron-packager . --platform=win32 --arch=x64 --icon=assets/icons/agama_icons/agama_app_icon.ico --out=build/ --buildVersion=VERSION_NUMBER_HERE --ignore=assets/bin/osx --ignore=assets/bin/linux64 --overwrite

# If generating 32bit desktop package
electron-packager . --platform=win32 --arch=ia32 --icon=assets/icons/agama_icons/agama_app_icon.ico --out=build/ --buildVersion=VERSION_NUMBER_HERE --ignore=assets/bin/osx --ignore=assets/bin/linux64 --overwrite

# To build both x64 and x86 desktop package
electron-packager . --platform=win32 --arch=all --icon=assets/icons/agama_icons/agama_app_icon.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

Troubleshooting Instructions

Windows DLL issues

On Windows it's noticed agama.exe complains about VCRUNTIME140D.DLL and ucrtbased.dll file.

Please see windeps directory and README file for instructions to install the required DLL files on Windows, and then try again running Agama App.

Optional packages to make rpm and deb distros

electron-installer-debian

electron-installer-redhat

refer to ./make-deb.js and ./make-rpm.js