GITBOOK-504: change request with no subject merged in GitBook

Author: Leo Weese

SUMMARY.md

@@ -21,21 +21,21 @@
 * [Making Payments](the-lightning-network/multihop-payments/README.md)
   * [The Payment Cycle](the-lightning-network/multihop-payments/the-payment-cycle.md)
   * [Timelocks](the-lightning-network/multihop-payments/timelocks.md)
-  * [⭐ Hashed Timelock Contract (HTLC)](the-lightning-network/multihop-payments/hash-time-lock-contract-htlc.md)
+  * [Hashed Timelock Contract (HTLC)](the-lightning-network/multihop-payments/hash-time-lock-contract-htlc.md)
   * [Payment Etymology](the-lightning-network/multihop-payments/etymology.md)
-  * [⭐ What Makes a Good Routing Node](the-lightning-network/multihop-payments/what-makes-a-good-routing-node.md)
+  * [What Makes a Good Routing Node](the-lightning-network/multihop-payments/what-makes-a-good-routing-node.md)
   * [Understanding Submarine Swaps](the-lightning-network/multihop-payments/understanding-submarine-swaps.md)
   * [Instant Submarine Swaps](the-lightning-network/multihop-payments/instant-submarine-swaps.md)
 * [Liquidity](the-lightning-network/liquidity/README.md)
-  * [⭐ Understanding Liquidity](the-lightning-network/liquidity/understanding-liquidity.md)
+  * [Understanding Liquidity](the-lightning-network/liquidity/understanding-liquidity.md)
   * [Managing Liquidity on the Lightning Network](the-lightning-network/liquidity/manage-liquidity.md)
   * [Liquidity Management for Lightning Merchants](the-lightning-network/liquidity/liquidity-management-for-lightning-merchants.md)
   * [How to Get Inbound Capacity on the Lightning Network](the-lightning-network/liquidity/how-to-get-inbound-capacity-on-the-lightning-network.md)
   * [Lightning Service Provider](the-lightning-network/liquidity/lightning-service-provider.md)
 * [L402: Lightning HTTP 402 Protocol](the-lightning-network/l402/README.md)
   * [Macaroons](the-lightning-network/l402/macaroons.md)
   * [L402](the-lightning-network/l402/l402.md)
-  * [📋 Protocol Specification](the-lightning-network/l402/protocol-specification.md)
+  * [Protocol Specification](the-lightning-network/l402/protocol-specification.md)
   * [Implementations and Links](the-lightning-network/l402/implementations-and-links.md)
 * [Taproot Assets](the-lightning-network/taproot-assets/README.md)
   * [Taproot Assets Protocol](the-lightning-network/taproot-assets/taproot-assets-protocol.md)
@@ -48,7 +48,7 @@
 ## Lightning Network Tools
 
 * [LND](lightning-network-tools/lnd/README.md)
-  * [🛠️ Get Started](lightning-network-tools/lnd/run-lnd.md)
+  * [Get Started](lightning-network-tools/lnd/run-lnd.md)
   * [lnd.conf](lightning-network-tools/lnd/lnd.conf.md)
   * [First Steps With LND](lightning-network-tools/lnd/first-steps-with-lnd.md)
   * [Wallet Management](docs/lnd/wallet.md)
@@ -85,7 +85,7 @@
   * [Contribute to LND](lightning-network-tools/lnd/contribute-to-lnd.md)
 * [Lightning Terminal](lightning-network-tools/lightning-terminal/README.md)
   * [What is Lightning Terminal?](lightning-network-tools/lightning-terminal/introduction.md)
-  * [🛠️ Get litd](lightning-network-tools/lightning-terminal/get-lit.md)
+  * [Get litd](lightning-network-tools/lightning-terminal/get-lit.md)
   * [Run litd](lightning-network-tools/lightning-terminal/run-litd.md)
   * [Integrating litd](lightning-network-tools/lightning-terminal/integrating-litd.md)
   * [Demo: Litd Speed Run](lightning-network-tools/lightning-terminal/speedrun.md)
@@ -111,7 +111,7 @@
   * [Privacy Policy](lightning-network-tools/lightning-terminal/privacy.md)
   * [Terms of Use](lightning-network-tools/lightning-terminal/tos.md)
 * [Loop](lightning-network-tools/loop/README.md)
-  * [🛠️ Get Started](lightning-network-tools/loop/get-started.md)
+  * [Get Started](lightning-network-tools/loop/get-started.md)
   * [The Loop CLI](lightning-network-tools/loop/the-loop-cli.md)
   * [Autoloop](lightning-network-tools/loop/autoloop.md)
   * [Static Loop In Addresses](lightning-network-tools/loop/static-loop-in-addresses.md)
@@ -121,7 +121,7 @@
 * [Pool](lightning-network-tools/pool/README.md)
   * [Overview](lightning-network-tools/pool/overview.md)
   * [Quickstart](lightning-network-tools/pool/quickstart.md)
-  * [🛠️ Installation](lightning-network-tools/pool/install.md)
+  * [Installation](lightning-network-tools/pool/install.md)
   * [First Steps](lightning-network-tools/pool/first-steps.md)
   * [Accounts](lightning-network-tools/pool/accounts.md)
   * [Orders and Asks](lightning-network-tools/pool/orders.md)
@@ -142,19 +142,20 @@
   * [Collectibles](lightning-network-tools/taproot-assets/collectibles.md)
   * [Universes](lightning-network-tools/taproot-assets/universes.md)
   * [Asset Loop](lightning-network-tools/taproot-assets/asset-loop.md)
+  * [Tips and Tricks](lightning-network-tools/taproot-assets/tips-and-tricks.md)
   * [Debugging Tapd](lightning-network-tools/taproot-assets/debugging-tapd.md)
   * [Multisignature](lightning-network-tools/taproot-assets/multisignature.md)
   * [Minting Assets With an External Signer](lightning-network-tools/taproot-assets/minting-assets-with-an-external-signer.md)
   * [Lightning Polar](lightning-network-tools/taproot-assets/polar.md)
   * [Operational Safety Guidelines](lightning-network-tools/taproot-assets/operational-safety-guidelines.md)
   * [Taproot Assets API Documentation](https://lightning.engineering/api-docs/api/taproot-assets/)
 * [Aperture](lightning-network-tools/aperture/README.md)
-  * [⚒️ Get Aperture](lightning-network-tools/aperture/get-aperture.md)
+  * [Get Aperture](lightning-network-tools/aperture/get-aperture.md)
   * [LNC Backend](lightning-network-tools/aperture/lnc-backend.md)
   * [LNC Mailbox](lightning-network-tools/aperture/mailbox.md)
   * [Pricing](lightning-network-tools/aperture/pricing.md)
 * [Faraday](lightning-network-tools/faraday/README.md)
-  * [🛠️ Get Started](lightning-network-tools/faraday/get-started.md)
+  * [Get Started](lightning-network-tools/faraday/get-started.md)
   * [The Faraday CLI](lightning-network-tools/faraday/the-faraday-cli.md)
   * [Faraday API Documentation](https://lightning.engineering/api-docs/api/faraday/)
 

lightning-network-tools/taproot-assets/first-steps.md

@@ -199,7 +199,7 @@ Upon successful sync, information about existing assets should be retrieved, alo
 
 ## Generating Taproot Assets addresses <a href="#docs-internal-guid-b63629f3-7fff-ba71-770c-b7d5f5eac736" id="docs-internal-guid-b63629f3-7fff-ba71-770c-b7d5f5eac736"></a>
 
-As soon as your minted assets have one confirmation on the blockchain, you are able to send them. To send assets, you will need the recipient’s Taproot Assets address. This Taproot Assets address is specific to an asset and amount, so to generate an address, the recipient needs to know an asset’s asset\_id, as well as be synced to the issuer’s universe. Taproot Assets address reuse should be avoided.
+As soon as your minted assets have one confirmation on the blockchain, you are able to send them. To send assets, you will need the recipient’s Taproot Assets address. This Taproot Assets address is specific to an asset and amount, so to generate an address, the recipient needs to know an asset’s `asset_id`, as well as be synced to the issuer’s universe. Taproot Assets address reuse should be avoided.
 
 When generating a Taproot Assets address, the receiver will create their expected Merkle trees, and tweak a Taproot key with it. The resulting key is converted to a Taproot address, where the receiver waits for an incoming transaction.
 

lightning-network-tools/taproot-assets/tips-and-tricks.md

@@ -0,0 +1,30 @@
+---
+description: >-
+  Taproot Assets on the Lightning Network allow you to pay any Lightning
+  invoice, and get paid from any Lightning wallet. Consult this document when
+  running into issues.
+---
+
+# Tips and Tricks
+
+## Incorrect payment details <a href="#docs-internal-guid-093c427d-7fff-af5a-175d-4b4b644efb50" id="docs-internal-guid-093c427d-7fff-af5a-175d-4b4b644efb50"></a>
+
+`FAILURE_REASON_INCORRECT_PAYMENT_DETAILS`
+
+When generating an invoice for Taproot Assets, the receiving node expects the payment to come through a channel that holds this specific asset. Such channels are not announced and cannot be found in the graph.
+
+Instead, they are added as hop hints to the invoice. Not every sender might honor these hop hints, and they may try to pay through any existing public channel instead, if they exist. When paying to the wrong channel, the sender will see the “incorrect payment details” error.
+
+They can instead try again or force the payment to go through the hop hint by passing the `--last_hop` when paying the invoice.
+
+## No route found
+
+`FAILURE_REASON_NO_ROUTE`
+
+When a channel along the route is disabled or doesn’t have liquidity, the sender might see the “no route” error. It might make sense to check if your local channels are active and have enough capacity. It is important to check not only for sufficient Taproot Assets capacity, but also satoshi capacity, as every HTLC that passes through a Taproot Asset channel still requires some satoshis.
+
+A typical Taproot Asset channel has a capacity of 100,000 satoshis, of which 1,000 are unspendable on each side as the channel reserve. Each open HTLC requires a balance of 345 satoshis, so at least 2035 satoshis are required as inbound capacity to have three pending incoming HTLCs. The 345 satoshis do not change owners once the HTLC settles.
+
+## Satoshi denomination
+
+At the LND level, all transactions remain denominated in satoshis. At this point, the output of many RPC commands such as `lncli listinvoices` or `lncli fwdinghistory` shows only satoshi amounts for Taproot Asset events.