Skip to content

lightningd: default public htlc_maximum_msat to 25% of channel capacity#9311

Open
nGoline wants to merge 2 commits into
ElementsProject:masterfrom
nGoline:htlc-max-public-quarter-capacity
Open

lightningd: default public htlc_maximum_msat to 25% of channel capacity#9311
nGoline wants to merge 2 commits into
ElementsProject:masterfrom
nGoline:htlc-max-public-quarter-capacity

Conversation

@nGoline

@nGoline nGoline commented Jul 13, 2026

Copy link
Copy Markdown
Collaborator

Implements the "Oakland" privacy proposal from the Lightning Dev Summit (reaffirmed at the Vienna summit): for publicly announced channels, default the advertised htlc_maximum_msat to 25% of channel capacity (capped by what we can actually send) when the operator has not set --htlc-maximum-msat. A maximum well below the publicly-known capacity makes probing for where payments flow significantly harder.

Scope:

  • Only public (announced) channels are affected; private channels, whose capacity is not public, keep the full spendable default.
  • Only newly created channels: existing channels keep their stored value.
  • Operators can still raise it to the full spendable amount via --htlc-maximum-msat or setchannel.

Closes #9173

nGoline added 2 commits July 13, 2026 14:36
… capacity

The Oakland privacy proposal (Lightning Dev Summit) observes that probing
for where payments went is much harder when the htlc maximum is well below
the publicly-known channel capacity. Default public channels to 25% of
capacity; update the setchannel test to expect this, xfail until the next
commit implements it.

Changelog-None
For publicly announced channels, when --htlc-maximum-msat is not set,
advertise 25% of the channel capacity (capped by what we can actually
send) rather than the full capacity: a maximum well below the publicly
known capacity makes probing for where payments flow much harder. Private
channels, whose capacity is not public, keep the full default.

Changelog-Changed: Config: public channels now default `htlc-maximum-msat` to 25% of capacity (was full capacity), for better payment privacy.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Reduce the default htlc_maximum_msat to 25% of channel capacity

1 participant