• Compiling Zap From Source
• Lightning Network Daemon (lnd)
• Running Zap

Note: If you have installation or compilation issues, please file a Github issue or ping us in Slack.

To compile the Zap wallet, you will need:

• Node.js version >= 12 and npm version >= 5
• yarn
• nvm is suppported but not required

After installing the above prerequisites, clone the repo via git:

git clone https://github.com/LN-Zap/zap-desktop.git

Install all the dependencies with yarn:

cd zap-desktop
yarn

Zap installs lnd for you as part of the installation process. Zap will automatically start the internal lnd daemon for you when you select the default connection type during the on-boarding process. In this mode we run lnd as a light client called neutrino (BIP 157 & BIP 158) which allows us to run lnd without requiring a Bitcoin full node on your system - Instead, Zap will connect to one Zap's hosted BTC full nodes.

It is possible to connect to the lnd instance that Zap runs using a standard lncli binary which you can download from the lnd releases page (lncli is bunded with the lnd download). Please be sure to download the version of lncli that corresponds with the version of lnd that Zap is running (you can find this out by navigating to the "Profile" screen when logged into your Zap wallet).

To connect to lnd using lncli you must have Zap open and logged into your wallet. Then, run lncli telling it the host and port where lnd is running and the location of the lnd data directory.

The lnd data directory will be located within:

• %APPDATA%\Zap on Windows
• $XDG_CONFIG_HOME/Zap or ~/.config/Zap on Linux
• ~/Library/Application Support/Zap on macOS

For example, on a Mac:

lncli --rpcserver=localhost:11009 --lnddir=~/Library/Application\ Support/Zap/lnd/bitcoin/mainnet/wallet-2 getinfo

See lncli --help for help with lncli.

To setup your own lnd for use with Zap please follow the instructions on the lnd installation page. Select the custom connection type during the on-boarding process to use your own lnd with Zap.

Note: Your lnd node must already be running and unlocked in order for Zap to connect to it. Ensure that lnd's RPC server is listening on an external interface and that your firewall permits access to it.

To test that everything has been installed correctly:

yarn test

To run Zap in development mode:

yarn dev

To check linting:

yarn lint

To build a production ready version of the app for your target platform:

yarn package --mac // Build for mac
yarn package --win // Build for windows
yarn package --linux // Build for linux

See DEBUGGING.md

See CONFIG.md