Skip to content

Commit 52e3e3f

Browse files
Leo Weesegitbook-bot
Leo Weese
authored andcommitted
GITBOOK-454: change request with no subject merged in GitBook
1 parent d6fda06 commit 52e3e3f

File tree

8 files changed

+36
-43
lines changed

8 files changed

+36
-43
lines changed

community-resources/glossary.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Anchor channels include up to two special outputs called anchors which are used
1818

1919
## Aperture
2020

21-
Aperture is an implementation of a [LSAT](glossary.md#lsat) proxy server developed by [Lightning Labs](glossary.md#lightning-labs).
21+
Aperture is an implementation of a L402 proxy server developed by [Lightning Labs](glossary.md#lightning-labs).
2222

2323
## Asset merge <a href="#docs-internal-guid-8c122d13-7fff-d2e4-025f-f17b4d82dff3" id="docs-internal-guid-8c122d13-7fff-d2e4-025f-f17b4d82dff3"></a>
2424

@@ -344,11 +344,11 @@ Loop In is the process of sending on-chain bitcoin and receiving the equivalent
344344

345345
Loop Out is the process of making a Lightning payment and receiving an equivalent amount (minus fees) in your [on-chain](glossary.md#on-chain) Bitcoin wallet using [Lightning Loop](glossary.md#loop).
346346

347-
## LSAT
347+
## L402
348348

349-
The Lightning Service Authentication Token (LSAT) combines [Macaroons](glossary.md#macaroon) with [preimages](glossary.md#preimage) as proof of payment to create tickets for paid APIs or other services that require authentication and payment.
349+
The L402 protocol combines [Macaroons](glossary.md#macaroon) with [preimages](glossary.md#preimage) as proof of payment to create tickets for paid APIs or other services that require authentication and payment. It is named after the HTTP 402 error code.
350350

351-
[Read more: LSAT](../the-lightning-network/l402/)
351+
[Read more: L402](../the-lightning-network/l402/l402.md)
352352

353353
## Macaroon
354354

@@ -402,7 +402,7 @@ Neutrino is a technology that allows a [LND](glossary.md#the-lightning-network-d
402402

403403
Noise is the encryption protocol used to establish and authenticate communications between Lightning nodes.
404404

405-
[Further reading: Noise protocol](http://noiseprotocol.org/)
405+
[Further reading: Noise protocol](https://noiseprotocol.org/)
406406

407407
## np2wkh
408408

@@ -422,7 +422,7 @@ An onion address is an identifier, similar to a url, pointing to a -> onion serv
422422

423423
## Onion routing
424424

425-
Onion routing describes the methodology of encrypting messages inside of encrypted messages, which are passed from hop to hop. Each hop is only able to decipher messages intended for itself, not any predecessor or successor. Onion routing is used to transfer data in the [Tor Network](glossary.md#tor) as well as to pass on payments and messages in the Lightning Network using [Sphinx](glossary.md#sphinx).
425+
Onion routing describes the methodology of encrypting messages inside of encrypted messages, which are passed from hop to hop. Each hop is only able to decipher messages intended for itself, not any predecessor or successor. Onion routing is used to transfer data in the [Tor Network](glossary.md#tor) as well as to pass on payments and messages in the Lightning Network using Sphinx.
426426

427427
## Onion Service
428428

community-resources/lightning-bulb.md

+12-12
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ We are here to help. If you have questions or need to bounce ideas around, feel
1717
**A native interface to Lightning on the web**
1818

1919
* New Lightning browser extensions like [Joule](https://lightningjoule.com/) and the [Lightning Browser Extension](https://github.com/bumi/lightning-browser-extension) built on the [WebLN](https://webln.dev/#/) standard.
20-
* Suggestion: extending [WebLN](https://webln.dev/#/) to encompass liquidity APIs [Loop](https://lightning.engineering/loop) and [Pool](https://lightning.engineering/pool) as well as any other Lightning APIs.
20+
* Suggestion: extending [WebLN](https://webln.dev/#/) to encompass liquidity APIs [Loop](../lightning-network-tools/loop/) and [Pool](../lightning-network-tools/pool/) as well as any other Lightning APIs.
2121

2222
**Streaming payments on social platforms**
2323

@@ -26,7 +26,7 @@ We are here to help. If you have questions or need to bounce ideas around, feel
2626

2727
**Distributed compute with Lightning**
2828

29-
* Use [LSATs](https://lsat.tech) for a decentralized metered container execution service (like [Travis CI](https://travis-ci.org/)). Will have with the potential to reach a more global audience without the requirement of credit cards.&#x20;
29+
* Use [L402s](https://l402.org/) for a decentralized metered container execution service (like [Travis CI](https://travis-ci.org/)). Will have with the potential to reach a more global audience without the requirement of credit cards.&#x20;
3030
* Suggestion: think serverless microVMs like [Firecracker VM](https://firecracker-microvm.github.io/) as a starting point, will likely need a small overlay layer to let people find other nodes.
3131

3232
**Lightning Paywall Plugin**
@@ -36,33 +36,33 @@ We are here to help. If you have questions or need to bounce ideas around, feel
3636

3737
**Pay-per-use Lightning API calls**
3838

39-
* Create APIs where all requests and responses are made with Lightning push payments with [Keysend](https://wiki.ion.radar.tech/tech/research/sphinx-send), instead of requiring an invoice
39+
* Create APIs where all requests and responses are made with Lightning push payments with [Keysend](../lightning-network-tools/lnd/send-messages-with-keysend.md), instead of requiring an invoice
4040
* Suggestions: a Keysend Services Directory, ability to sell Mission Control data to a peer in need of updated routing data, etc.
4141

42-
## LSAT implementation ideas
42+
## L402 implementation ideas
4343

44-
Lightning Service Authentication Tokens (LSATs) allow for paid APIs in distributed systems. LSATs are built on top of Macaroons -- they can carry caveats, attenuations, can be delegated and further restricted by the bearer.
44+
L402s allow for paid APIs in distributed systems. L402s are built on top of Macaroons -- they can carry caveats, be attenuated, can be delegated and further restricted by the bearer.
4545

46-
Implementing LSATs is most attractive in services that require metered or paid access together with granular access control. A key advantage of LSATs is that the logic of collecting payments can be separate from verifying access, often without the need to maintain customer records or expose them to the open internet.
46+
Implementing L402s is most attractive in services that require metered or paid access together with granular access control. A key advantage of L402s is that the logic of collecting payments can be separate from verifying access, often without the need to maintain customer records or expose them to the open internet.
4747

48-
Here are just some initial ideas for potential LSAT powered products:
48+
Here are just some initial ideas for potential L402 powered products:
4949

5050
* Bitcoin price API
5151

52-
There are many APIs for obtaining Bitcoin prices, some paid, others free. A Bitcoin price API built with LSATs may issue a macaroon to each new user, allowing for some free usage. Upon hitting a daily or total limit, the API can issue an LSAT together with a Lightning invoice. There could be separate pricing for surge traffic or historic data. One idea is to issue LSATs that include a “delay” as a caveat. Free access requests are served after a few seconds, while paid access is served immediately.
52+
There are many APIs for obtaining Bitcoin prices, some paid, others free. A Bitcoin price API built with L402s may issue a macaroon to each new user, allowing for some free usage. Upon hitting a daily or total limit, the API can issue an L402 together with a Lightning invoice. There could be separate pricing for surge traffic or historic data. One idea is to issue L402s that include a “delay” as a caveat. Free access requests are served after a few seconds, while paid access is served immediately.
5353

5454
* Virtual Private Network
5555

56-
A VPN provider can use LSATs to sell bandwidth, adjusting their rates by location and speed. This makes it easy to integrate the VPN service into other products, resell bandwidth or share bandwidth between users or applications.
56+
A VPN provider can use L402s to sell bandwidth, adjusting their rates by location and speed. This makes it easy to integrate the VPN service into other products, resell bandwidth or share bandwidth between users or applications.
5757

5858
* Voice over IP gateway
5959

60-
There are plenty of low-fee VoIP gateways, troubled by high payment costs. A VoIP gateway using LSATs could quickly become attractive for other applications to integrate once pay-as-you-go plans over Lightning become available. LSATs could be obtained for a set amount of minutes, a monthly plan or for each call separately, turning every Lightning wallet also into a phone, fax or SMS application.
60+
There are plenty of low-fee VoIP gateways, troubled by high payment costs. A VoIP gateway using L402s could quickly become attractive for other applications to integrate once pay-as-you-go plans over Lightning become available. L402s could be obtained for a set amount of minutes, a monthly plan or for each call separately, turning every Lightning wallet also into a phone, fax or SMS application.
6161

6262
* Podcasts and movies
6363

64-
Podcasts could become available with advertisements to the general public, and without ads to paying subscribers. LSATs issued to the subscriber define which episodes and versions are available. The paying subscriber can also share an attenuated LSAT with their friends that lets them listen to a single episode without having to pay for it. This can be implemented into existing infrastructure without breaking backwards compatibility.
64+
Podcasts could become available with advertisements to the general public, and without ads to paying subscribers. L402s issued to the subscriber define which episodes and versions are available. The paying subscriber can also share an attenuated L402 with their friends that lets them listen to a single episode without having to pay for it. This can be implemented into existing infrastructure without breaking backwards compatibility.
6565

6666
* Cloud storage (differentiated by speed, per bandwidth or by storage, delegate access)
6767

68-
A cloud storage provider can sell their space and bandwidth and use LSATs to track payments and organize access control. A user can attenuate their LSATs and share them among their separate devices or even specific files with friends.
68+
A cloud storage provider can sell their space and bandwidth and use L402s to track payments and organize access control. A user can attenuate their L402s and share them among their separate devices or even specific files with friends.

community-resources/resource-list.md

+4-18
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,6 @@ description: >-
2222
* [Blixt Wallet](https://blixtwallet.github.io) ([Github](https://github.com/hsjoberg/blixt-wallet)) - available in Google Play and for iOS
2323
* [Breez](https://breez.technology) ([Github](https://github.com/breez/breezmobile)) - available in Google Play and for iOS
2424
* [Electrum](https://electrum.org) ([Github](https://github.com/spesmilo/electrum)) - available for Linux, OSX, Windows and Android
25-
* [Mash](https://app.mash.com/wallet) - available for all browsers
2625
* [Mutiny](https://app.mutinywallet.com/) ([Github](https://github.com/MutinyWallet/)) - available for all browsers
2726
* [Muun](https://muun.com) ([Github](https://github.com/muun)) - available on Google Play and the Apple AppStore
2827
* [Open Bitcoin Wallet](https://f-droid.org/en/packages/wtf.nbd.obw/) ([Github](https://github.com/nbd-wtf/obw)) - available in F-Droid
@@ -37,7 +36,6 @@ description: >-
3736
* [Strike](https://strike.me) - available in Google Play, the Apple AppStore and Chrome
3837
* [Wallet of Satoshi](https://walletofsatoshi.com) - available in Google Play and the Apple AppStore
3938
* [Bottlepay](https://bottlepay.com) - available in Google Play and the Apple AppStore
40-
* [Mash](https://getmash.com/wallet) - lightning wallet that integrates directly into sites, apps and launching shortly in browser extension, mobile app form.
4139
* [Alby](https://getalby.com/) ([Github](https://github.com/getAlby/lightning-browser-extension)) - connect various wallet interfaces to this browser extension for web-native payments. And login with lightning. Available for Firefox, Chrome, Brave and others
4240

4341
### Lightning node interfaces
@@ -48,7 +46,6 @@ description: >-
4846
## Explorers <a href="#docs-internal-guid-c8a6648f-7fff-39eb-c8cc-47fadeadad71" id="docs-internal-guid-c8a6648f-7fff-39eb-c8cc-47fadeadad71"></a>
4947

5048
* [1ML](https://1ml.com) - Lightning network and node statistics
51-
* [ACINQ](https://explorer.acinq.co) - Geographical distribution of Lightning nodes
5249
* [Amboss](https://amboss.space) - Detailed information on channels and fee rates
5350
* [Cheese Robot](https://t.me/cheeserobot) - Telegram bot with Lightning Network explorer capabilities
5451
* [Lightning Terminal](https://terminal.lightning.engineering) - Evaluating channels and peers
@@ -66,8 +63,6 @@ description: >-
6663
* [Sphinx Relay](https://github.com/stakwork/sphinx-relay) - e2e encrypted group chat enabled by a Node.js wrapper around lnd
6764
* [Thunderhub](https://github.com/apotdevin/thunderhub) - node management via a NextJS server handling a backend Graphql server and frontend React App
6865
* [TLV shop](https://github.com/joostjager/tlvshop.com) - webshop with no browser, shopping cart, checkout page, nor credit card required
69-
* [LightningStamp](https://lightningstamp.bitcoinproof.org) - create timestamped proofs of existence for your files (OpentimeStamps or Chainpoint)
70-
* [Mash](https://getmash.com) - monetize your apps by integrating an open consumer lightning wallet, paywalls, and payment faciliation mechanisms with a few snippets of code
7166
* [sms4sats](https://sms4sats.com) - send text messages and receive sms for online services on the web and via API
7267
* [lightsats](https://lightsats.com) - Onboard newbies with lightning tips
7368
* [LNURL Auth For WordPress](https://wordpress.org/plugins/lnurl-auth/) - Login to WordPress with Bitcoin Lightning
@@ -86,17 +81,15 @@ description: >-
8681
* [ln-service](https://github.com/alexbosworth/ln-service) - Node.js REST interface to lnd
8782
* [LNbits](https://github.com/lnbits/lnbits) - Simple Python server that provides an account system, extension framework, and more on top of lnd
8883
* [lndhub](https://github.com/BlueWallet/LndHub) - Wrapper for lnd that provides separate accounts for users sharing a node
89-
* [lsat-js](https://github.com/Tierion/lsat-js) - A javascript library for working with LSATs
84+
* [lsat-js](https://github.com/Tierion/lsat-js) - A javascript library for working with L402s
9085
* [Polar](https://github.com/jamaljsr/polar) - One-click Bitcoin Lightning networks for local app development and testing
9186
* [WebLN](https://webln.dev/#/) - A library for secure communication between Lightning apps and user nodes
92-
* [Dazaar](https://dazaar.com) - A library to sell data over a P2P network.
9387
* [rebalance-lnd](https://github.com/C-Otto/rebalance-lnd) Python script for circular rebalancing in LND
9488
* [Faraday](https://github.com/lightninglabs/faraday) - A suite of tools built to help node operators and businesses run lnd, the leading implementation of the Lightning Network
9589

9690
## Wikis, Guides & Resources <a href="#docs-internal-guid-8bae6cd2-7fff-ce99-f185-1c89fff98fef" id="docs-internal-guid-8bae6cd2-7fff-ce99-f185-1c89fff98fef"></a>
9791

9892
* Alby's [WebLN Guide](https://www.webln.guide/introduction/welcome)
99-
* Lightning Network Wiki [ION](https://wiki.ion.radar.tech)
10093
* Ben Congdon's[ Awesome Lightning Network](https://github.com/bcongdon/awesome-lightning-network)
10194
* Electric Capital's[ Lightning Ecosystem Repository](https://github.com/electric-capital/crypto-ecosystems/blob/master/data/ecosystems/l/lightning.toml)
10295
* Jameson Lopp's[ Lightning Network Resources](https://www.lopp.net/lightning-information.html)
@@ -106,8 +99,6 @@ description: >-
10699

107100
* [Bitfinex Pay](https://pay.bitfinex.com)
108101
* [Coingate](https://coingate.com)
109-
* [Globee](https://globee.com)
110-
* [LNPay](https://lnpay.co)
111102
* [OpenNode](https://www.opennode.com)
112103
* [BTCPayServer](https://docs.btcpayserver.org)
113104
* [LNBits](https://lnbits.com/)
@@ -116,26 +107,21 @@ description: >-
116107
## Exchanges & Brokerages <a href="#docs-internal-guid-61dc5aac-7fff-f33d-b971-9056f5f24364" id="docs-internal-guid-61dc5aac-7fff-f33d-b971-9056f5f24364"></a>
117108

118109
* [Azteco](https://azte.co)
110+
* [Binance](https://www.binance.com)
119111
* [Bipa](https://bipa.app)
120112
* [Bitaroo](https://www.bitaroo.com.au)
121113
* [Bitfinex](https://www.bitfinex.com)
122114
* [Boltz](https://boltz.exchange)
123-
* [Buda](https://www.buda.com)
115+
* [Coinbase](https://www.coinbase.com)
124116
* [Coincorner](https://www.coincorner.com)
125-
* [Fastbitcoins](https://fastbitcoins.com)
126117
* [FixedFloat](https://fixedfloat.com)
127-
* [Kollider](https://kollider.xyz)
128118
* [Kraken](https://www.kraken.com/)
129119
* [LNMarkets](https://lnmarkets.com)
130120
* [LOFT](https://loft.trade)
131121
* [Mt Pelerin](https://www.mtpelerin.com/buy-bitcoin-lightning)
132122
* [NiceHash](https://www.nicehash.com)
133-
* [OKCoin](https://www.okcoin.com)
134-
* [OKEX](https://www.okex.com)
123+
* [OKX](https://www.okx.com/)
135124
* [River Financial](https://river.com)
136-
* [The Rock Trading](https://www.therocktrading.com)
137125
* [Strike](https://strike.me)
138126
* [Southxchange](https://main.southxchange.com)
139127
* [VBTC](https://vbtc.exchange)
140-
141-
[Something missing? Fill out this form to let us know or have your project included!](https://docs.google.com/forms/d/e/1FAIpQLSdT6kP3oUzd6xWytkDcflU9byHcp8nP9IyYntm\_6wa9Cw6qqg/viewform)

lightning-network-tools/lightning-terminal/introduction.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ By bringing Terminal to the web, we can deliver some of the familiar features of
1414

1515
### Easy to run
1616

17-
To make use of Terminal, you will need to run `litd` together with `lnd`, either on the same or separate machines. After browsing to [terminal.lightning.engineering](http://terminal.lightning.engineering) and [initializing your session](connect.md) with Lightning Node Connect, you can enjoy all features of Terminal and interact with your node from your browser.&#x20;
17+
To make use of Terminal, you will need to run `litd` together with `lnd`, either on the same or separate machines. After browsing to t[erminal.lightning.engineering](https://terminal.lightning.engineering) and [initializing your session](connect.md) with Lightning Node Connect, you can enjoy all features of Terminal and interact with your node from your browser.&#x20;
1818

1919
### Top performing nodes
2020

lightning-network-tools/lnd/htlc-interceptor.md

+9-2
Original file line numberDiff line numberDiff line change
@@ -294,14 +294,14 @@ func (i *interceptor) htlcReceiveLoop(ctx context.Context,
294294

295295
### lndclient: <a href="#docs-internal-guid-2da6c1a6-7fff-42f2-0550-ed59e63444dd" id="docs-internal-guid-2da6c1a6-7fff-42f2-0550-ed59e63444dd"></a>
296296

297-
[https://github.com/lightninglabs/lndclient/blob/master/router\_client.go#L58](https://github.com/lightninglabs/lndclient/blob/master/router\_client.go#L58)
297+
[https://github.com/lightninglabs/lndclient/blob/master/router\_client.go#L58](https://github.com/lightninglabs/lndclient/blob/fb7026e398a92971a829c4a48adbafa2bb3b964c/router\_client.go#L289C1-L357C2)
298298

299299
```go
300300
// InterceptedHtlc contains information about a htlc that was intercepted in
301301
// lnd's switch.
302302
type InterceptedHtlc struct {
303303
// IncomingCircuitKey is lnd's unique identfier for the incoming htlc.
304-
IncomingCircuitKey channeldb.CircuitKey
304+
IncomingCircuitKey invpkg.CircuitKey
305305

306306
// Hash is the payment hash for the htlc. This may not be unique for
307307
// MPP htlcs.
@@ -323,6 +323,13 @@ type InterceptedHtlc struct {
323323
// Since lnd has non-strict forwarding, this may not be the channel that
324324
// the htlc ends up being forwarded on.
325325
OutgoingChannelID lnwire.ShortChannelID
326+
327+
// CustomRecords holds the custom TLV records that were added to the
328+
// payment.
329+
CustomRecords map[uint64][]byte
330+
331+
// OnionBlob is the onion blob for the next hop.
332+
OnionBlob []byte
326333
}
327334

328335
// HtlcInterceptHandler is a function signature for handling code for htlc

lightning-network-tools/lnd/recovery-planning-for-failure.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -60,4 +60,4 @@ Generally, if we have a channel with a peer that we don’t expect to come back
6060

6161
## Be #craeful not #reckless
6262

63-
The Lightning Network offers a multitude of options to recover from failure. LND continues to improve and eliminate bugs that might lead to a fatal node failure. If you encounter a bug, [file an issue](https://github.com/lightningnetwork/lnd/issues/) or contact us through[ Slack](https://lightning.engineering/slack.html),[ Discord](https://discord.gg/9u83Jxeu), and[ Twitter](http://twitter.com/lightning)!
63+
The Lightning Network offers a multitude of options to recover from failure. LND continues to improve and eliminate bugs that might lead to a fatal node failure. If you encounter a bug, [file an issue](https://github.com/lightningnetwork/lnd/issues/) or contact us through[ Slack](https://lightning.engineering/slack.html),[ Discord](https://discord.gg/9u83Jxeu), and [Twitter](https://x.com/lightning/)!

0 commit comments

Comments
 (0)