Lightning

An easy-to-use cross platform lightning wallet

N.B. This is still early technology and there’s a risk of losing all of your funds. We recommend not putting in more money than you are willing to lose.

Getting Started

The app comes for two threat models:

1. Pocket Money: prebuilt and signed releases with auto update (recommended for most users).

2. Tin Foil Hat: if you'd rather build it yourself and do without auto updates, see the instructions below.

Contributing

See the

ToDo (next release)

help wanted

Developing Locally

To build the mobile app locally, see the README in the

/mobile

To build the desktop app locally follow the instructions below:

Install lnd

We will use

lnd

git clone https://github.com/lightningnetwork/lnd $GOPATH/src/github.com/lightningnetwork/lnd
cd $GOPATH/src/github.com/lightningnetwork/lnd
make && make install tags="experimental autopilotrpc signrpc walletrpc chainrpc invoicesrpc routerrpc"

Install btcd

We will use

btcd

git clone https://github.com/btcsuite/btcd $GOPATH/src/github.com/btcsuite/btcd
cd $GOPATH/src/github.com/btcsuite/btcd
GO111MODULE=on go install -v . ./cmd/...

Set up & run

Cloning this git repo

git clone https://github.com/lightninglabs/lightning-app

npm test ```

To start the app in development mode (simnet):

npm run electron-dev

Running in development mode can allow you to run in full node mode instead of the default neutrino mode, and will also allow you to run in simnet node for testing. The app will use it's own lnd

data/lnd

Review UI style guide

To build the UI style guide

npm run storybook

Building the Packaged App

To build the packaged version of the app e.g. for macOS run:

cp $GOPATH/bin/lnd ./assets/bin/darwin
npm run electron-pack

The packaged app will then be available in the

dist

Starting the Packaged App (light client)

To run the packaged version of the app e.g. for macOS run:

./dist/mac/Lightning.app/Contents/MacOS/Lightning

The app is configured for mainnet by default but you can opt-in to testnet:

./dist/mac/Lightning.app/Contents/MacOS/Lightning --bitcoin.testnet --bitcoin.node=neutrino --neutrino.addpeer=btcd-testnet.lightning.computer --neutrino.feeurl=https://nodes.lightning.computer/fees/v1/btc-fee-estimates.json

Starting the Packaged App (full node)

btcd

Start btcd in a separate terminal session and wait until it's fully synced (can take a while):

btcd --txindex --rpcuser=kek --rpcpass=kek

To run the packaged version of the app e.g. for macOS run:

./dist/mac/Lightning.app/Contents/MacOS/Lightning --bitcoin.mainnet --btcd.rpcuser=kek --btcd.rpcpass=kek

bitcoind

Start bitcoind in a separate terminal session and wait until it's fully synced (can take over a day):

bitcoind -txindex=1 -rpcuser=kek -rpcpassword=kek -rpcbind=localhost -zmqpubrawblock=tcp://127.0.0.1:28332 -zmqpubrawtx=tcp://127.0.0.1:28333

To run the packaged version of the app e.g. for macOS run:

./dist/mac/Lightning.app/Contents/MacOS/Lightning --bitcoin.mainnet --bitcoin.node=bitcoind --bitcoind.rpcuser=kek --bitcoind.rpcpass=kek --bitcoind.zmqpubrawblock=tcp://127.0.0.1:28332 --bitcoind.zmqpubrawtx=tcp://127.0.0.1:28333

Lnd data and logs

Lnd data and logs are written to the following locations in production:

• Linux:

  ~/.config/lightning-app/lnd

• OSX:

  ~/Library/Application Support/lightning-app/lnd

• Windows:

  %USERPROFILE%\AppData\Roaming\lightning-app\lnd