LightningPeach Wallet User Guide Lightning Peach

User Manual:

Open the PDF directly: View PDF PDF.
Page Count: 27

DownloadLightningPeach Wallet User Guide Lightning Peach
Open PDF In BrowserView PDF
LightningPeach Wallet: User Guide

October 17, 2018

User Guide

Table of Contents

Table of Contents
Introduction ............................................................................................................................... 3
General description ............................................................................................................. 3
Possible issues .................................................................................................................... 3
Creating wallet account .......................................................................................................... 4
Main menu ................................................................................................................................ 8
Lightning ................................................................................................................................... 9
Regular Payment................................................................................................................. 9
Recurring Payment ............................................................................................................. 9
History .................................................................................................................................10
Onchain ...................................................................................................................................12
Regular Payment...............................................................................................................12
History .................................................................................................................................13
Channels.................................................................................................................................14
Creating new channel .......................................................................................................14
Channel list .........................................................................................................................15
Address book .........................................................................................................................17
Creating a contact .............................................................................................................17
Contact list ..........................................................................................................................17
Profile ......................................................................................................................................19
How to… .................................................................................................................................21
… add funds to onchain balance ....................................................................................21
… create regular lightning payment. ..............................................................................21
… create recurring lightning payment. ...........................................................................21
… make regular onchain payment..................................................................................22
… recover wallet ................................................................................................................22
Appendix I. Messages ..........................................................................................................25

2

User Guide

Introduction

Introduction
General description
LightningPeach wallet is a free cross-platform desktop Lightning Network wallet. It
simplifies the process of making micro payments, which are processed seamlessly
thanks to user-friendly application and built-in payment server solution.
Common features
The LightningPeach wallet supports the following features, which have already
become common for existing Lightning Network wallets:
• Sending & receiving payments within the Lightning Network using payment
request.
• Sending & receiving onchain payments. Regular transactions within Bitcoin
blockchain.
• Transaction history. Details on payments that are sent and received with your
wallet account are kept in history section, so you can always have access to
them when it is needed.
• Payment request. You can generate kind of invoice and send it to another
person to pay it.
• Custom channel opening. You can create custom channel by specifying
Lightning ID and host IP of a peer.
Unique features
• Sending & receiving payments within the Lightning Network using Lightning
ID. Works only between LightningPeach users.
• Recurring payments between LightningPeach users. Recurring payments can
be useful in cases when periodic charges are more appropriate than regular
payments (for example, voice with per second charge or streaming service
monthly subscription). Works only between LightningPeach users.
• Address book. With the help of address book, you can specify clear and
convenient contact names. This is very useful as later you can select them on
the Lightning page, thus no need to copy & paste, remember or keep
Lightning ID somewhere on paper or PC.

Possible issues
During installation antivirus or firewall can block some features of the wallet and ask
for additional permissions. You should grant requested permissions for the
LightningPeach application. This is necessary for the proper work of the wallet.

3

User Guide

Creating wallet account

Creating wallet account
If you don’t have an account yet or want to create a new one, then you need to go
through the process of signing up:
1. On the first screen you can see the “Terms and Conditions” and “Privacy
Policy” documents. Read them carefully. Below the text there are 2 check
boxes. The first one “I accept the agreement” is mandatory. By selecting it you
acknowledge that you have read and understood terms and conditions of the
both documents. The second check box “I agree to the personal data
processing” is optional. By selecting it you agree to the processing of your
personal data, this will help us to improve our product. After reading and
selecting check boxes, click NEXT.

2. On the next screen of the wallet click Sign up.

4

User Guide

Creating wallet account

3. Specify desired username and password. Click Next.

5

User Guide

Creating wallet account

4. The system will offer you seed words (they are needed to recover access to
wallet account). You can click regenerate button to change them. Write them
down or save to a file and click Next.
Important! On the next screen you will need to specify these seed words.

5. Specify your seed words. Click SIGN UP.

6. First synchronization can take some time. You can read guided tour while
synchronization is in progress. When synchronization is finished, you will see
the Open wallet button in the upper right corner.

6

User Guide

Creating wallet account

Further authorizations require only username and password.

7

User Guide

Main menu

Main menu
The interface of the LightningPeach wallet application consists of 5 parts: Lightning,
Onchain, Channels, Address book and Profile.

Under the wallet menu there is information on Lightning balance (1), Onchain
balance (2), Locked Onchain balance (3), and current bitcoin exchange rate (4).

8

User Guide

Lightning

Lightning
On this page you can create payments within the Lightning Network and view
transaction history of such payments.
There are two types of lightning payments: regular and recurring.

Regular Payment
Allows you to create lightning payments.
Important! Before making a payment make sure you have open channels.

Field

Description

Name of payment

Optional. Name of payment. Later this name will be used in History
of payments.

To

Mandatory. Recipient of payment (LightningPeach users only).
Possible variants:
• Specify Lightning ID;
• Select contact from the Address book;
• Specify payment request in the following format:
@.

Amount in …

Mandatory. Amount of payment in selected Bitcoin denomination:
BTC, mBTC, satoshi (BTC – Bitcoin; mBTC – millibitcoin, 1 BTC =
1000 milibitcoins = 100 000 000 satoshi). Active only if you pay by
Lightning ID or to a contact from the Address book.

Recurring Payment
Allows you to create recurring payments. Can be useful in cases when per second
charge is more appropriate than regular one. For example, it can be useful for voice

9

User Guide

Lightning

calls with per second (per minute) charge or monthly subscription for streaming
service.

Field

Description

Name of Payment

Optional. Specify name for recurring payment. Later this name will
be used in History of payments. Default value: Stream payment.

To

Mandatory. Recipient of payment.
Possible variants: specifying Lightning ID or selecting contact from
the Address book.

Frequency

Specify how often to charge wallet in specified time unit.

Time unit

Time unit in which payment frequency is calculate.

Price per payment

The amount of 1 single payment.

Value unit

Currency unit of payment.

Number of payments

Total number of payments.

History
Here you can see history of transactions made within the Lightning Network.

Field

Description

Name of payment

Name of payment. Click on the name of the column to sort
payments by name.

Amount

Amount of payment in selected Bitcoin denomination. For recurring
payments spent amount and number of payments are displayed.

10

User Guide

Lightning

Type

Type of payment: regular or recurring. If recurring payment is not
finished it is marked with icon
– payment is currently stopped or
– payment is in progress at the moment, clicking stop button
will finish recurring payment beforehand.
Click on the name of the column to sort payments by type.

To

Recipient of the payment.
Possible values: Lightning ID or name of a contact from the
Address book.

Date

Date and time of transaction creation. Click on the name of the
column to sort payments by date.

11

User Guide

Onchain

Onchain
On this page you can create payments within the Bitcoin blockchain and view
transaction history of such payments.

Regular Payment
Allows you to create onchain payments in selected Bitcoin denomination.
Field

Description

Name of payment

Optional. Name of payment. Later this name will be used in History of
payments.

To

Mandatory. Recipient of payment.
Possible values: bitcoin address.

Amount in …

Mandatory. Amount of payment in selected Bitcoin denomination.

12

User Guide

Onchain

History
Here you can see history of transactions made within the Bitcoin blockchain network.

Field

Description

Name of payment

Name of payment. Click on the name of the column to sort payments
by name.

Amount

Amount of payment in selected Bitcoin denomination.

To

Recipient of payment.
Possible values: bitcoin address.

Confirmations

Number of transaction confirmations.

Transaction ID

Unique transaction identifier that can be used in Bitcoin transaction
explorer. It can be copied by clicking on Transaction ID.

Date

Date and time of transaction creation. Click on the name of the column
to sort payments by date.

13

User Guide

Channels

Channels
On this page you can create new channel and view list of existing channels.

Creating new channel
To create new channel, click the Create Channel button.

New window appears. You can create channel with default settings or a custom one
(if you know the Lightning ID and host IP of a peer / hub).
Default channel creation requires the following information:

Field

Description

Name of channel

Name for a new channel.

Amount in …

The amount you want to transfer for this channel from your onchain
balance.

If you would like to create custom channel, select the Custom channel check box.
Here, apart from name of a channel and its amount, you need to specify Lightning ID
and host IP in the following format:
@.

14

User Guide

Channels

Channel list

The list of channels contains active and not active opened channels, and opening
channels with the following information:
•
•
•

Name of a channel, in the brackets Lightning ID or name of a contact (if you
have it in your Address book) is specified.
My balance – amount that you can send via this channel (available only for
active open channels).
Available to receive – amount that you can receive through this channel
(available only for active open channels).

15

User Guide

Channels

You can copy Lightning ID of the channel by clicking on it. Then you can paste it in
Regular or Recurring Payment section to make a payment to the Lightning ID of that
channel.
While pointing to the name of a channel you can see the Edit and the Close buttons.
Click the Close button if you don’t need this channel anymore, available balance will
be added to your onchain balance (when confirmed on Bitcoin blockchain). Click
Edit to edit a name of a channel.

16

User Guide

Address book

Address book
On this page you can manage your contact list of Lightning addresses.

Creating a contact
To create new contact, click the Add contact button.

A new window will appear, where you can specify a name of the contact and
Lightning ID.

Contact list

Contact list contains contacts with the following information:
• Name of contact.
• Lightning ID.
When pointing to the name of contact you see the following options:
17

User Guide
•
•
•

Address book

Edit – allows to change a name of a contact or delete it from your Address
book.
Copy – allows to copy Lightning ID to clipboard.
Pay – when you click this button you are redirected to the Lightning page,
where this contact is already filled in the To field. You just need to specify
name and amount of payment.

18

User Guide

How to…

Profile
The Profile page provides information on your wallet account.

Field

Description

Lightning ID

Your lightning ID. You can copy it by clicking the corresponding
button

BTC Address

Your BTC address. You can copy it or generate a new one.

Payment Request – here you can create new payment request. Other users of the Lightning
Network will have possibility to pay generated invoice (one payment for each request).
Amount of …

Specify amount of payment in selected Bitcoin denomination.

Generate request

Create payment request.

19

User Guide
Your payment request

How to…
Payment request. You can copy it and submit to a payer.

Settings – here you can change Bitcoin denomination and manage notifications settings.
Bitcoin denomination

Select one of the possible Bitcoin denominations: BTC, mBTC,
satoshi (BTC – Bitcoin; mBTC – millibitcoin, 1 BTC = 1000
milibitcoins = 100 000 000 satoshi).

System notifications

Enable or disable system notifications. When enabled they will be
shown as push messages on your PC. System notifications will
inform you about incoming payments, opening and closing
channels and other types of the wallet activities.

Sounds

Enable or disable sound of system notifications.

Log out

Log out from this account.

At the bottom of the page you can see contact information of wallet developer
company; link to the User Guide; link to the “License agreement” and “Terms and
conditions” documents; port allocated to current wallet for rpc connection with LND;
and current version of the LightningPeach wallet application.

20

User Guide

How to…

How to…
… add funds to onchain balance
One of the steps required before using all advantages of the Lightning Network is adding
funds to your Onchain balance. Follow the steps below to accomplish this task.
1. Open the Profile page. Find there the BTC Address field and copy it by clicking the
corresponding button

2. Copied address can be used for funding via the most convenient way: another
wallet or exchange.

… create regular lightning payment.
Regular lightning payments can be useful when you need to make an ordinary
payment as quickly as possible.
1. Open the Lightning page.
2. Open the Regular payment tab.
3. Specify a name of payment (optional), recipient (can be taken from contact list
or from the list of opened channels) and amount of payment.
4. Click Pay.
5. Pop-up with details of your payment appears. Check data and if everything is
correct – click Pay.

… create recurring lightning payment.
Recurring lightning payments can be useful when there is a need in services with per
second charge. It can be voice calls or any other kind of a service that has per
second billing. For this you need to create recurring lightning payment and launch it
when you need to pay for recurring service:
1. Open the Lightning page.
2. Open the Recurring payment tab.
3. Specify a name of recurring payment (optional), recipient (can be taken from
contact list or from the list of opened channels), frequency, time unit, price per
payment, value unit and number of payments.
21

User Guide

How to…

4. Click Create payment.
5. Pop-up with details of your payment appears. Check data and if everything is
correct – click Pay.
6. The payment appears in History section of the page and will marked as Start
button
(in the Type column). All unfinished recurring payments are
displayed in the beginning of the list.
7. To launch recurring payment click Start button . Now you will see that
number of payments is counting and amount in BTC is also changing
accordingly. The button now is displayed as paused .
You can click the pause button to pause recurring payment.
To stop recurring beforehand click stop button , type of payment will be
changed to “stream”.
8. When all payments are finished, type of payment is changed to “stream” and
will be moved in a list according to creation date.

… make regular onchain payment
Regular onchain payments can be useful when you need to make one payment and
there is no need in opening a separate channel for this one-time operation. For this
you need to create regular onchain payment:
1. Open the Onchain page.
2. Specify the Name of payment (optional), recipient in the To field (BTC
address of recipient) and amount of payment.
3. Click Pay.
4. Pop-up with details of your payment appears. Check data and if everything is
correct – click Pay.

… recover wallet
If you forgot your password use the following steps to reset it and regain access to
your wallet.
1. Open the wallet application.

22

User Guide

How to…

2. Click the Wallet recovery link.
3. Specify new username and new password. Click Proceed.

4. On the next page specify seed words associated with your wallet.

23

User Guide

How to…

5. If provided information is correct, you will be redirected to your wallet account.

24

User Guide

Appendix I. Messages

Appendix I. Messages
While using the LightningPeach wallet you can see different messages, both,
success and error ones. Success messages inform you about the positive outcome
of your actions (can be payment or entity creation). Error messages are used to
inform user that something went wrong (also can suggest how to fix it).
Some error messages are described below.
1. Client offline.

When appears: When recipient is either offline or is not a user of the
LightningPeach wallet.
How to solve: Ask recipient to sign in to the wallet account or sign up if recipient
doesn’t have account yet.

25

User Guide

Appendix I. Messages

2. Not all required fields are filled.

When appears: When some field is not filled.
How to solve: Fill all required fields.
3. Insufficient funds

When appears: When making payment and there are not enough funds on balance.
How to solve: Specify an amount that correspond to wallet balance and fill the field
correctly.

26

User Guide

Appendix I. Messages

4. No active channel

When appears: When making payment and there are no channels created.
How to solve: Create channel either by clicking the Create channel button within
pop-up or open the Channels page on your own.
5. Payment amount exceeded

When appears: When creating payment request.
How to solve: Reduce amount of payment request.

27



Source Exif Data:
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.7
Linearized                      : No
Page Count                      : 27
Language                        : en-US
Tagged PDF                      : Yes
XMP Toolkit                     : 3.1-701
Title                           : LightningPeach Wallet User Guide
Creator                         : Bitfury Labs
Creator Tool                    : Microsoft Word
Create Date                     : 2018:10:17 15:05:55+00:00
Modify Date                     : 2018:10:17 15:05:55+00:00
Document ID                     : uuid:0B97009B-2FE7-409A-8B6F-5B8C44F17B3D
Instance ID                     : uuid:0B97009B-2FE7-409A-8B6F-5B8C44F17B3D
Author                          : Bitfury Labs
EXIF Metadata provided by EXIF.tools

Navigation menu