From 5e2dae7ae88dcbba253dd5c8878f69aca1de4811 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 484a019da5b..7c7b6439468 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 f0446c8d20ca4c3c89337e0ecbdb5159bb4c6ae1 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 2d40781a322..ce29aa45abd 100644 --- a/docs/release-notes/release-notes-0.20.1.md +++ b/docs/release-notes/release-notes-0.20.1.md @@ -94,6 +94,12 @@ channels scale proportionally using the standard 0.16 BTC threshold (matching funding confirmation scaling). +* [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