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

Update lnurlp.md

Browse Source
This commit is contained in:
Bitcoin Txoko
2024-09-19 09:52:14 +02:00
committed by GitHub
parent 019c28acf9
commit 7d9afd01c4
1 changed files with 9 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
en/lnurlp.md
+9 -11
View File
@@ -7,14 +7,14 @@ Pretty cool, no?
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.
![Here's a simple diagram of what is happening in the background](https://blob.satellite.earth/908a8572fe3ec8c5b17bcbae1065b69af15b39958401c87128723f3250122cec)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.
Many Lightning Address implementations are custodial (although not all), because a domain and a node that is always online are 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.
@@ -24,14 +24,13 @@ Bitcoin Txoko offers a simple Lightning Address solution backed by [LNbits](http
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.
If you haven't done so already, go to https://bitcointxoko.com and create a 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.
The extension `Pay Links` is needed for Lightning Addresses to work.
Go to `Extensions` in the toolbar and activate LNURLp.
Go to `Extensions` in the toolbar and activate `Pay Links`.
### 3. Creating your pay link
Go to the LNURLp extension and click on `New Pay Link`.
@@ -40,11 +39,11 @@ 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.
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.
⚠️ 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](https://amboss.space/node/03fb64900a7647b4499a88a6c30976333074dad3bb7702d0219bd84dc4ac4a241e). So we recommend keeping it at 500000 sats.
Now open `Advanced Options` and change the `Comment maximum characters` to 799. This step is not required but allows more functionalities later on.
@@ -53,7 +52,6 @@ Check `Enable nostr zaps` at the bottom, so that you can use your Lightning Addr
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. ](https://raw.githubusercontent.com/bitcointxoko/guides/main/images/lnurlp/lnurlp-config.png)
In the end it should look something like this.
When you've checked everything is correct, go ahead and click on `Create Pay Link`.
@@ -69,9 +67,9 @@ 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.
You can add your Bitcoin Txoko Lightning Address to your nostr profile and use it to receive zaps. Usually 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.
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 nostr:naddr1qvzqqqr4gupzqkvlvlma7a55ccp6d5rrdc27h3ssmdmael286mjaq5uxmqslk04fqqxnzd3exuerqdfkxccnyv3cs0uvul 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!