Files
documentation/site/source/user-manual/service-guides/lightning/bluewallet.rst
BitcoinMechanic d0091a1c10 LNbits & Zeus guide (#354)
* skeleton guide for lnbits/zeus

* almost finished

* almost finished

* typos

* final edits for review

* rewording

* change format to be just lnbits with two tabs (zeus/alby), update to new LNbits UI

* begin adding blue wallet, rework everything else

* add blue wallet words

* add bluewallet pictures

* alby guide

* finish up alby

* wording

* formatting

* mention firefox/tor for alby guide

* make each integration its own page

* .

* reorder everything, rewriting as necessary

* zeus LNC guide

* more lnc stuff

* almost done, just waiting for new alby

* new alby guides, tweaks

* everything except Zap

* .

* reorder

* deeper tree

* zap

* davids suggestions

* fix alignment

* more formatting errors

* .

* .

* fix build errors

* rename bluewallet header in bitcoin doc

* capitalize a word, remove quotes from bold stuff

* add alts for images

* davids changes
2023-05-05 13:46:48 -07:00

137 lines
4.3 KiB
ReStructuredText

.. _blue-wallet:
BlueWallet
----------
.. note:: This guide assumes you have already setup LNbits as per :ref:`this guide <connecting-lnbits>` with **LND** as your underlying node.
.. warning:: **This will not work with CLN as your underlying node!**
#. Bluewallet requires that we use the LnbHub extension in order to connect to LNbits.
#. To do this, click **Manage Extensions**:
.. figure:: /_static/images/services/lnbits/manage-extensions.png
:width: 50%
:alt: manage-extensions
#. Click **MANAGE** under the LndHub extension:
.. figure:: /_static/images/services/lnbits/lndhub-manage.png
:width: 40%
:alt: lndhub-manage
#. Click the two arrows on the right, then click install:
.. figure:: /_static/images/services/lnbits/arrows-install.png
:width: 40%
:alt: arrows-install
#. Now ensure that it says **Activated** underneath LndHub and then click **Extensions** on the left:
.. figure:: /_static/images/services/lnbits/activated-click-extensions.png
:width: 40%
:alt: activated-click-extensions
#. Click **ENABLE**:
.. figure:: /_static/images/services/lnbits/extensions-enable.png
:width: 40%
:alt: extensions-enable
#. Click **OPEN** *or* **LndHub** under *Extensions*:
.. figure:: /_static/images/services/lnbits/lndhub-open.png
:width: 40%
:alt: lndhub-open
#. Make sure the wallet you just created is selected below the two QR codes:
.. figure:: /_static/images/services/lnbits/lndhub-select-wallet.png
:width: 40%
:alt: lndhub-select-wallet
#. Open up BlueWallet and click on the three dots in the top right:
.. figure:: /_static/images/services/lnbits/bluewallet-three-dots.jpg
:width: 20%
#. Click "Network" then "Tor settings":
.. figure:: /_static/images/services/lnbits/bluewallet-network.jpg
:width: 20%
.. figure:: /_static/images/services/lnbits/bluewallet-tor-settings.jpg
:width: 20%
#. Click "Start" and it should say "Done" after a short time:
.. figure:: /_static/images/services/lnbits/bluewallet-tor-start.jpg
:width: 20%
.. figure:: /_static/images/services/lnbits//bluewallet-tor-done.jpg
:width: 20%
#. Head back to the main screen and click the **"+"** sign:
.. figure:: /_static/images/services/lnbits/bluewallet-add-wallet.jpg
:width: 20%
#. Click "Import wallet":
.. figure:: /_static/images/services/lnbits/bluewallet-plus.jpg
:width: 20%
#. Click "Scan or import a file"
.. note:: Screenshots not possible for this step!
#. *If you only want this wallet to be able to RECEIVE PAYMENTS, scan this QR code:*
.. figure:: /_static/images/services/lnbits/left-qr.png
:width: 40%
:alt: left-qr
*If you are happy for this wallet to be able to both receive and MAKE payments scan this QR code:*
.. figure:: /_static/images/services/lnbits/right-qr.png
:width: 40%
:alt: right-qr
#. You'll see this once the wallet is added:
.. figure:: /_static/images/services/lnbits/bluewallet-wallet-added.jpg
:width: 30%
:alt: bluewallet-with-funds
#. You can now allocate sats to this wallet within LNbits by clicking the **"+"** icon here:
.. figure:: /_static/images/services/lnbits/plus-icon.png
:width: 60%
:alt: plus-icon
Let's add 1000 satoshis:
.. figure:: /_static/images/services/lnbits/add-1000-sats.png
:width: 60%
:alt: add-1000-sats
.. figure:: /_static/images/services/lnbits/1k-sats.png
:width: 60%
:alt: 1k-sats
#. BlueWallet should now show a balance:
.. figure:: /_static/images/services/lnbits/blue-wallet-balance.jpg
:width: 25%
:alt: blue-wallet-balance
#. You can also receive funds the normal way by hitting "Receive" within BlueWallet.
.. figure:: /_static/images/services/lnbits/blue-wallet-receive.jpg
:width: 25%
:alt: blue-wallet-receive
.. note:: Funds received this way must be sent from another lightning node, not the LND node underneath LNbits. A lightning payment that originates and terminates at the same node is technically a rebalance, not a normal payment.
Congratulations! BlueWallet is set up and ready to use lightning via your own lightning node - furthermore it will only be able to use your node in the way you allow it, via LNbits.