Skip to content

Commit 2eb9cba

Browse files
committed
docs: Add a simple FaQ entry about fee budgets
1 parent 914308a commit 2eb9cba

File tree

1 file changed

+30
-0
lines changed

1 file changed

+30
-0
lines changed

docs/src/about/faq.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,3 +67,33 @@ not require a client certificate, thus avoiding these connectivity
6767
issues.
6868

6969
[grpc-web]: https://github.com/grpc/grpc-web
70+
71+
72+
## Payments
73+
74+
### Why am I getting a warning about fee budgets?
75+
76+
When you make a payment on the Lightning Network using Greenlight, the
77+
payment often needs to be routed through several other nodes in the
78+
network to reach the recipient. These intermediate nodes facilitating
79+
the payment charge a small fee for their service.
80+
81+
Lightning Network fees consist of two parts:
82+
83+
- A base fee: A small fixed amount charged per forwarded payment.
84+
- A proportional fee: A percentage of the payment amount.
85+
86+
These fees are added on top of the amount you wish to send. If the
87+
value of your payment is very close to your total available balance in
88+
your Greenlight node, there might not be enough remaining funds to
89+
cover the fees charged by all the nodes along the payment path. In
90+
such cases, even though Greenlight will attempt to send the payment,
91+
it is highly likely to fail because the total amount required
92+
(payment + fees) exceeds your available funds.
93+
94+
For situations where you need to move your entire balance, dedicated
95+
draining mechanisms exist, such as swapping funds out to an on-chain
96+
Bitcoin wallet. These methods are designed to transfer the entire
97+
available amount and handle the associated fees differently, typically
98+
deducting them from the total amount being moved rather than requiring
99+
them to be available beforehand as an extra buffer.

0 commit comments

Comments
 (0)