Skip to content

Commit f724479

Browse files
Merge pull request #904 from lightninglabs/docs-lnd
Update lnd documentation
2 parents 0b7287c + 9c74904 commit f724479

File tree

2 files changed

+29
-0
lines changed

2 files changed

+29
-0
lines changed

docs/lnd/gossip_rate_limiting.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,25 @@ Large routing nodes handling many simultaneous peer connections might benefit
6262
from increasing this value to 10 or 15, while resource-constrained nodes should
6363
keep it at the default or even reduce it slightly.
6464

65+
### Preventing Spam: gossip.ban-threshold
66+
67+
To protect your node from spam and misbehaving peers, LND uses a ban score
68+
system controlled by `gossip.ban-threshold`. Each time a peer sends a gossip
69+
message that is considered invalid, its ban score is incremented. Once the score
70+
reaches this threshold, the peer is banned for a default of 48 hours, and your
71+
node will no longer process gossip messages from them.
72+
73+
A gossip message can be considered invalid for several reasons, including:
74+
- Invalid signature on the announcement.
75+
- Stale timestamp, older than what we already have.
76+
- Too many channel updates for the same channel in a short period.
77+
- Announcing a channel that is not found on-chain.
78+
- Announcing a channel that has already been closed.
79+
- Announcing a channel with an invalid proof.
80+
81+
The default value is 100. Setting this value to 0 disables banning completely,
82+
which is not recommended for most operators.
83+
6584
### Understanding Connection Limits: num-restricted-slots
6685

6786
The `num-restricted-slots` configuration deserves special attention because it

docs/lnd/release-notes/release-notes-0.20.0.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,10 @@
3838
messages in the dynamic commitment set.
3939

4040

41+
- [Fixed](https://github.com/lightningnetwork/lnd/pull/10102) a case that we may
42+
send unnecessary `channel_announcement` and `node_announcement` messages when
43+
replying to a `gossip_timestamp_filter` query.
44+
4145
# New Features
4246

4347
* Use persisted [nodeannouncement](https://github.com/lightningnetwork/lnd/pull/8825)
@@ -95,6 +99,12 @@ circuit. The indices are only available for forwarding events saved after v0.20.
9599
a canceled invoice. Supports deleting a canceled invoice by providing its
96100
payment hash.
97101

102+
* A [new config](https://github.com/lightningnetwork/lnd/pull/10102)
103+
`gossip.ban-threshold` is added to allow users to configure the ban score
104+
threshold for peers. When a peer's ban score exceeds this value, they will be
105+
disconnected and banned. Setting the value to 0 effectively disables banning
106+
by setting the threshold to the maximum possible value.
107+
98108
## lncli Additions
99109

100110
* [`lncli sendpayment` and `lncli queryroutes` now support the

0 commit comments

Comments
 (0)