About

The Union7 LND Thin Wallet is a simple, thin mainnet Lightning client that lets you:

  • send & receive Bitcoin privately & instantly
  • easily connect to your LND node by scanning a QR code
  • view all your transaction & channel details
  • open new channels
  • deposit Bitcoin to your mobile wallet
Got questions? Contact us at [email protected].


Video



FAQs & Troubleshooting

How do I connect the Union7 Wallet to my LND node?
To connect to your node, you must provide the wallet with the node's host, TLS cert, and macaroon. You can enter each of these fields into the Union7 Wallet manually, or simply generate and scan a QR code containing them all.
How do I use a QR code to connect my node?
To use a QR code to connect your node, you must first generate a QR code that contains your node's host, cert, and macaroon. You can do that by entering the following command from your .lnd directory:

echo -e "$(curl -s ipinfo.io/ip),\n$(xxd -p -c2000 admin.macaroon)," > qr.txt && cat tls.cert >>qr.txt && qrencode -t ANSIUTF8 < qr.txt

(Note: you may need to first install qrencode, which you can do with sudo apt install qrencode)
I need to manually enter my node's host, TLS cert, and macaroon - how do I get those values and what should they look like?
The host is just the address of node and port - e.g., "example.com:10009". By default LND is exposed on port 10009.

The TLS cert is simply the content of your node's tls.cert file from the .lnd directoy. To print this file, navigate to your .lnd directory (often installed in your home directory) and enter cat tls.cert. The output should look something like "-----BEGIN CERTIFICATE-----< a bunch of characters >-----END CERTIFICATE-----".

The macaroon allows your wallet to authenticate itself to your LND node, and you need to copy in the hex-encoded version of the admin.macaroon file from the .lnd directory. To get this value, navigate to your .lnd directory and enter xxd -p -c2000 admin.macaroon, the output should be a long hex string.
I'm having trouble connecting to my node. How can I troubleshoot?
Here's how to troubleshoot the most common issues:

1.) Make sure that your node will accept external RPC calls. Edit your config file or add --rpclisten=0.0.0.0:10009 when running lnd.

2.) Make sure that your SSL cert includes any host names you are using to reach your node. You can generate a certificate with multiple subjectAltNames using the following commands (the following example create a certificate that can be used for a host reached at localhost or on AWS):

cp /etc/ssl/openssl.cnf /tmp/
echo '[ subject_alt_name ]' >> /tmp/openssl.cnf
echo 'subjectAltName = DNS:ec2-111-11-11-111.compute-1.amazonaws.com, DNS:localhost, DNS:127.0.0.1' >> /tmp/openssl.cnf
openssl req -new -sha256 -key tls.key -out csr.csr -subj '/C=XX/ST=XXXX/L=XXXX/O=lnd/OU=XXXX/CN=localhost/[email protected]' -config /tmp/openssl.cnf -extensions subject_alt_name
openssl req -x509 -sha256 -days 36500 -key tls.key -in csr.csr -out tls.cert -config /tmp/openssl.cnf -extensions subject_alt_name
openssl x509 -text -in tls.cert -noout

3.) Make sure you are using the hex-encoded version of your macaroon file - i.e., run xxd -ps -u -c 1000 admin.macaroon and copy the output into the macaroon hex field of the settings page within the LND Thin Wallet app.
What if I don't have a Lightning node to connect to?

Here's a great guide for installing LND and Bitcoind on Ubuntu 16.04 LTS for Mainnet.