The Wanwallet browser is the tool of choice to browse and use Ðapps.
Please note that this repository is the Electron host for the Meteor based wallet dapp whose repository is located here: https://github.com/wanchain/meteor-dapp-wallet.
Please check the Wanwallet troubleshooting guide.
If you want to install the app from a pre-built version on the release page, you can simply run the executeable after download.
For updating simply download the new version and copy it over the old one (keep a backup of the old one if you want to be sure).
The data folder for wallet is stored in other places:
- Windows
%APPDATA%\wallet - macOS `~/Library/Application\ Support/
- Linux
~/.config/wallet
For development, a Meteor server will need to be started to assist with live reload and CSS injection.
Once a wallet version is released the Meteor frontend part is bundled using the meteor-build-client npm package to create pure static files.
To run wallet in development you need:
- Node.js
v7.x(use the prefered installation method for your OS) - Meteor javascript app framework
- Yarn package manager
- Electron
v1.7.9cross platform desktop app framework - Gulp build and automation system
Install the latter ones via:
$ curl https://install.meteor.com/ | sh
$ curl -o- -L https://yarnpkg.com/install.sh | bash
$ yarn global add electron@1.7.9
$ yarn global add gulp
Now you're ready to initialise wanwallet for development:
$ git clone https://github.com/wanchain/wanwallet.git
$ cd wanwallet
$ yarn
To update wanwallet in the future, run:
$ cd wanwallet
$ git pull
$ yarn
For development we start the interface with a Meteor server for autoreload etc. Start the interface in a separate terminal window:
$ cd wanwallet/interface && meteor --no-release-check
In the original window you can then start wanwallet with:
$ cd wanwallet
$ yarn dev:electron
NOTE: client-binaries (e.g. gwan) specified in clientBinaries.json will be checked during every startup and downloaded if out-of-date, binaries are stored in the config folder
NOTE: use --help to display available options, e.g. --loglevel debug (or trace) for verbose output
Start the wallet app for development, in a separate terminal window:
$ cd wanwallet/interface && meteor --no-release-check
// and in another terminal
$ cd my/path/meteor-dapp-wallet/app && meteor --port 3050
In the original window you can then start wanwallet using wallet mode:
$ cd wanwallet
$ yarn dev:electron --mode wallet
Our build system relies on gulp and electron-builder.
meteor-build-client bundles the meteor-based interface. Install it via:
$ npm install -g meteor-build-client
Furthermore cross-platform builds require additional electron-builder dependencies. On macOS those are:
// windows deps
$ brew install wine --without-x11 mono makensis
// linux deps
$ brew install gnu-tar libicns graphicsmagick xz
To generate the binaries for wanwallet run:
$ gulp
To generate the Wanchain Wallet (this will pack the one Ðapp from https://github.com/wanchain/meteor-dapp-wallet):
$ gulp --wallet
The generated binaries will be under dist_mist/release or dist_wallet/release.
To build binaries for specific platforms (default: all available) use the following flags:
// on mac
$ gulp --win --linux --mac
// on linux
$ gulp --win --linux
// on win
$ gulp --win
With the walletSource you can specify the Wallet branch to use, default is master:
$ gulp --wallet --walletSource develop
Options are:
masterdeveloplocalWill try to build the wallet from [wallet/]../meteor-dapp-wallet/app
Note: applicable only when combined with --wallet
When building a binary, you can optionally skip some tasks — generally for testing purposes.
$ gulp --mac --skipTasks=bundling-interface,release-dist
Spits out the MD5 checksums of distributables.
It expects installer/zip files to be in the generated folders e.g. dist_wallet/release
$ gulp checksums [--wallet]
Note: Integration tests are not yet supported on Windows.