Skip to content

Commit 7c46ba1

Browse files
committed
docs: update gossip rate limiting doc
1 parent fc11e48 commit 7c46ba1

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

docs/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

0 commit comments

Comments
 (0)