bitcointxoko/guides
1
1
Fork 0
Code Issues Pull Requests 9 Actions Packages Projects Releases Wiki Activity

Add files via upload

Browse Source
This commit is contained in:
Bitcoin Txoko
2023-09-20 16:20:02 +02:00
committed by GitHub
parent c5151c19b4
commit 8b86a0e68e
3 changed files with 176 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
en/How to export your LNbits wallet.md
+50
View File
@@ -0,0 +1,50 @@
While you can save your Bitcoin Txoko LNbits wallet to your phone as a progressive web app (PWA), a native app like [Zeus](https://zeusln.app/) or [BlueWallet](https://bluewallet.io/) offers a better user experience and better security. With [Alby](https://getalby.com/), you can also import the wallet into your browser extension for easy Lightning on the web and for Nostr zaps. It's possible to import your LNbits wallet into Zeus, BlueWallet, or Alby with LNDhub. We will cover how to do it with Alby and Zeus in this guide. With the Alby setup, one of the steps will easily allow you to import your wallet into Zeus as well. But if you only want to import your wallet onto Zeus, you can skip to the Zeus section.
### Alby
Alby is a browser extension that brings Lightning and Nostr to your browser. Using the [WebLN](https://www.webln.dev/) protocol, the extension can easily detect invoices on webpages and pay them as well as let you sign into websites with Lightning. You can also set budgets for your favourite Lightning sites. Furthermore, it can act as a Nostr signer using [NIP-07](https://github.com/nostr-protocol/nips/blob/master/07.md), which is much more secure than entering your private key into web clients.
#### What do I need?
- Web browser that supports Chrome or Firefox extensions. [Kiwi Browser](https://kiwibrowser.com/) supports it on Android.
- Access to your LNbits wallet.
- (Optional) A mobile device for setting up Zeus.
#### 1. Enable the LNDhub extension on your LNbits wallet
In your browser, head over to your wallet link. Click on *Extensions* and enable the *LNDhub* extension. After it has been enabled, go to the LNDhub extension page.
#### 2. Install Alby extension
Head over to [getalby.com](https://getalby.com/) and click on *Add Browser Extension*. Install the extension from your browser's extension store. Set up your unlock password and store it in a safe place.
#### 3. Import into Alby
In the next screen, choose *Connect*, then choose *LNDhub*. Go back to your LNDhub extension and copy the connection URL. Paste that into the *LNDhub export URI* field. Press continue. You should now have been connected to your LNbits wallet with LNDhub!
💡 You can choose between invoice URL and admin URL. They give Alby different permissions to interact with your LNbits wallet.
- Invoice URL allows you to generate invoices and receive payments.
- Admin URL also allows you to send payments.
#### 4. (Optional) Set up Zeus with Alby
Now that you have connected your LNbits with Alby, you can also easily import it into Zeus with Alby. Simply open the extension, click on your wallet name, and go to Account Settings. Under **Account** you can find the option to *Connect your mobile wallet*. When you press *Connect*, you will be shown a QR code to scan from Zeus.
If you haven't installed Zeus previously, go to [zeusln.app](https://zeusln.app/) and download Zeus for your mobile operating system.
Once Zeus has been downloaded, go to *Settings -> Add a new node*. Here you can scan the QR code that Alby is showing to import the wallet.
Voilà! Now you have the power of Lightning at your fingertips. Do you feel like a god yet?
### Zeus
Zeus is an awesome open-source app that allows you to connect your own node to your mobile device. It supports all the major Lightning node implementations, such as LND, CLN and Eclair, as well as connections over both Tor and clearnet. Recently they have also announced their own LSP (Lightning Service Provider), you can join the waitlist [here](https://olympusln.com/).
### What do I need?
- Android or iOS phone
- Another device on which you can access your LNbits wallet (for displaying the QR code to scan)
- Access to your LNbits wallet
#### 1. Download Zeus
You can download the Zeus app for your operating system [here](https://zeusln.app/).
#### 2. Enable the LNDhub extension on your LNbits wallet
In your browser, head over to your wallet link. Click on *Extensions* and enable the *LNDhub* extension. After it has been enabled, go to the LNDhub extension page.
#### 3. Import into Zeus
Go to *Settings -> Add a new node* on Zeus.
Scan the desired wallet to import it.
💡 You can choose between invoice URL and admin URL.
- Invoice URL allows you to generate invoices and receive payments.
- Admin URL also allows you to send payments.
Once you have scanned the QR code, all the fields should be automatically filled in Zeus. You can add a nickname for your wallet as well.
Now you can *Save Node Config* and control the wallet from your phone!
#### Bonus
Zeus also offers cool features like lurker mode and biometric verification. You can also enable price conversions to a fiat currency of your choice. Furthermore you can personalise the display of the app to what you like. These are beyond the scope of this guide, play around in the app and discover all those features for yourself!
en/How to get your Bitcoin Txoko LN address.md
+76
View File
@@ -0,0 +1,76 @@
### What is a lightning address?
A lightning address looks like a human readable email address, for example username@domain.com, but actually allows you to be paid in bitcoin instantaneously and cheaply, without needing an online node on your device and manually generating an invoice every time someone wants to pay you.
Pretty cool, no?
### So how does it work?
It works using the [LNURL pay protocol](https://github.com/lnurl/luds/blob/legacy/lnurl-pay.md), a layer on top of the Lightning Network.
![Here's a simple diagram of what is happening in the background](https://camo.githubusercontent.com/268abc621585b68fbf1229eab51c3c9344870ec3f227a1ff237c7423ba3ba28e/68747470733a2f2f692e696d6775722e636f6d2f444956357138712e706e67)Here's a simple diagram of what is happening in the background.
In short, when a user wants to pay you using your Lightning Address, their wallet converts the Lightning Address into a LNURL payRequest. A successful LNURL payRequest is then used to obtain a BOLT11 invoice.
💡 Lightning Address -> LNURLp -> BOLT 11 invoice.
### Sounds good, but what's the catch?
At the moment most Lightning Address implementations are custodial, because a domain is needed for Lightning Addresses to work. Because it's custodial, the custodian can rug you at any time and monitor your transactions.
You need to trust the owner of the domain not to change the record of your Lightning Address. And it doesn't work if the LNURL server is not online.
Bitcoin Txoko offers a simple Lightning Address solution backed by [LNbits](https://lnbits.com/). This too is custodial so please only keep a small amount in your Bitcoin Txoko wallet and withdraw to your self-custodial wallet as you receive more sats!
### I'm ready, what do I need to start?
All you need is a mobile phone or computer and an Internet connection!
### 1. Creating your wallet
If you haven't done so already, go to https://bitcointxoko.com and *add a new wallet*. You can name it whatever you want.
⚠️ Make sure you save the link to your wallet so you can access it later! A good way to do this is to save it in your password manager, such as [Bitwarden](https://bitwarden.com/).
### 2. Activate extensions
The extension **LNURLp** is needed for Lightning Addresses to work.
Go to *Extensions* in the toolbar and activate LNURLp.
### 3. Creating your pay link
Go to the LNURLp extension and click on *New Pay Link*.
Choose the wallet you have created.
For the *Item Description*, you can enter whatever you want.
Choose a your Lightning Address username. Your Lightning Address will look like username@bitcointxoko.com.
Uncheck *Fixed Amount* and change the *Min* value to 1 and *Max* value to 500000.
⚠️ You can also change the *Max* value to something higher, but larger payments are more likely to fail due to the limited inbound channel capacity of the Bitcoin Txoko Lightning node. So we recommend keeping it at 500000 sats.
Now open *Advanced Options* and check *Enable nostr zaps* at the bottom, so that you can use your Lightning Address to receive zaps.
The other *Advanced options* are optional, you can configure them if you want, or leave them blank.
[In the end it should look something like this. ]
When you've checked everything is correct, go ahead and click on *Create Pay Link*.
### Testing
You can test if your new Lightning Address works by going to another wallet, going to *Send* and typing in your Lightning Address as the destination, then send yourself a few sats.
Go back to your Bitcoin Txoko wallet and check if you've received your own payment. You might need to refresh the page.
If everything worked correctly, congratulations! 🥳
If not, let us know. We are always here to help.
### Next steps
#### Nostr zaps
You can add your Bitcoin Txoko Lightning Address to your nostr profile and use it to receive zaps. On most clients this is done by going to *Profile* -> *Edit* -> *Lightning Address* and changing the Lightning Address.
#### LNDhub
You can import your LNbits wallet as a LNDhub onto your phone using an app like [Zeus](https://zeusln.app/) or [BlueWallet](https://bluewallet.io/), instead of visiting the wallet link every time you want to check your balance or make a payment. Check out our [guide] on how to do this.
#### QR code
You can also share or print your LNURLp QR code so people can easily scan it with their phones. Very useful if you're onboarding your favourite local merchant so that they can receive Lightning tips!
Simply share the link to your *Sharable Page*,
or print the QR code as a PDF by going to *View Link* -> *Print*.
en/How to make a BoltCard.md
+50
View File
@@ -0,0 +1,50 @@
### What is a BoltCard?
A BoltCard is a NFC card with a LNURLw record. You can top it up with sats and use it as a debit card to pay merchants and other users who support this technology.
![This is how it works behind the scenes. ](https://boltcard.org/img/Boltcard-flow.jpg)This is how it works behind the scenes.
### What do I need?
- A NTAG424 DNA NFC card
- Here are some vendors who sell them online, some of these offer customisable designs:
- [NFC cards](https://nfc.cards/en/white-cards/46-nfc-card-ntag424-dna.html)
- [NFC-tag-shop](https://www.nfc-tag-shop.de/en/NFC-Card-PVC-85-6-x-54-mm-NTAG-424-DNA-416-Byte-white/69079)
- [Lasereyes](https://lasereyes.cards/buy-now/)
- [PlebTag](https://plebtag.com/)
- [Bolt Ring](https://bitcoin-ring.com/)
- A mobile phone with NFC capabilities
- LNbits wallet
### 1. Enable BoltCard extension
On your phone with NFC capabilities, go to your LNbits wallet link -> Extensions and enable *Bolt Cards*.
### 2. Create a new card record
- Open the *Bolt Cards* extension and press the + button to create a new card.
- Choose the wallet it will be connected to. This is the wallet from which funds will be spent.
- You can set up limits for *Max transaction* and *Daily Limit* as a protective measure against malicious merchants draining your card.
- Name your card.
- Press the NFC button then bring your NFC card up to your phone to import the UID from your card.
- Click *create card*.
### 3. Write the NFC record to the card
- For this step you will need an app to write the NFC record to your card. I used the official [BoltCard] app.
- On LNbits, show *Card Key Credentials* and then scan the QR code from the BoltCard app or click *Create Link* and paste the auth URL into the BoltCard app.
- On the BoltCard app, click *Write Card Now* and bring the NFC card towards the phone and hold it there until the NFC record has been written onto the card.
That's all! If everything went smoothly, you should have a working BoltCard. You can test it by tapping it against your phone and opening the LNURLw link.
⚠️ Carrying your BoltCard with you means you are carrying real money with you. Someone who steals your card can withdraw all of the sats from your wallet. Practice precaution and keep only a small amount of sats on your BoltCard wallet for daily spending. Always check the merchant is requesting the correct price. Keep your card in a RFID protected sleeve if possible.
### Next steps
#### BoltCard enabled PoS
A number of wallets and point-of-sales (PoS) systems are compatible with the BoltCard. Here is a list of them:
- [BoltCard PoS](https://github.com/boltcard/bolt-card-pos)
- [Breez](https://breez.technology/)
- [BTCpayserver](https://btcpayserver.org/)
- [LNbits TPOS](https://github.com/lnbits/tpos) - yes, you can turn your LNbits wallet into a PoS by enabling the TPOS extension!
- [VoltPay](https://voltpay.app/)
- [lipa](https://lipa.swiss/)
- [Blink](https://www.blink.sv/)
- [Wallet of Satoshi](https://www.walletofsatoshi.com/)
- [Blixt Wallet](https://blixtwallet.github.io/)
#### Support BoltCard
You can also support their effort to create an open source library for programming the cards on [Geyser Fund](https://geyser.fund/project/boltcard).
#### NFC gift cards
We have covered how to create a Lightning debit card in this guide, but what if you want to gift someone sats that they can withdraw to their own wallet whenever they want? Well, this is also possible with NFC cards and LNURLw. We will cover this in a future guide.
#### Not just cards!
You can also write NFC records onto any NFC tag that supports it. An example is the [Bolt Ring](https://bitcoin-ring.com/) which offers a NFC-enabled ring.