From abadfda144c4bb0d83ab3213b91ef65381fb7ebf Mon Sep 17 00:00:00 2001 From: Eduardo Bravo Date: Tue, 24 Feb 2026 17:20:18 -0400 Subject: [PATCH 1/2] lnwallet: improve ErrBelowChanReserve error message This commit modifies the ErrBelowChanReserve error to provide more context to the user. It explicitly states that the lack of spendable balance is due to the channel reserve constraint. Fixes issue #8957 --- lnwallet/channel.go | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/lnwallet/channel.go b/lnwallet/channel.go index 02f5f9ccff..8ce9cebdcc 100644 --- a/lnwallet/channel.go +++ b/lnwallet/channel.go @@ -64,8 +64,8 @@ var ( // ErrBelowChanReserve is returned when a proposed HTLC would cause // one of the peer's funds to dip below the channel reserve limit. - ErrBelowChanReserve = fmt.Errorf("commitment transaction dips peer " + - "below chan reserve") + ErrBelowChanReserve = fmt.Errorf("transaction rejected: " + + "peer must preserve its minimum safety balance") // ErrBelowMinHTLC is returned when a proposed HTLC has a value that // is below the minimum HTLC value constraint for either us or our From f19cea4f83d6173f3853904ce2f96765868a5b59 Mon Sep 17 00:00:00 2001 From: Eduardo Bravo Date: Wed, 4 Mar 2026 18:14:55 -0400 Subject: [PATCH 2/2] docs: add release-notes --- docs/release-notes/release-notes-0.20.1.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/release-notes/release-notes-0.20.1.md b/docs/release-notes/release-notes-0.20.1.md index 81b9ed3887..a65c031db9 100644 --- a/docs/release-notes/release-notes-0.20.1.md +++ b/docs/release-notes/release-notes-0.20.1.md @@ -87,6 +87,12 @@ ensures dependencies are properly freed and logs the panic trace for debugging. +* [Improved error message clarity](https://github.com/lightningnetwork/lnd/pull/10607) + when a transaction would cause a peer's balance to fall below the channel + reserve. The error message has been updated to be more user-friendly, + notifying that the transaction was rejected because the minimum safety + balance must be preserved. + ## RPC Updates * The `EstimateRouteFee` RPC now implements an [LSP detection