Skip to content

Commit 109765b

Browse files
committed
f Discount unendorsed HTLCs to incentivise endorsement
1 parent 6e221f8 commit 109765b

File tree

1 file changed

+21
-7
lines changed

1 file changed

+21
-7
lines changed

04-onion-routing.md

Lines changed: 21 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1479,7 +1479,7 @@ are calculated as follows:
14791479
- `effective_fees` = `fees` - `opportunity_cost`
14801480
- otherwise:
14811481
- if successfully resolved AND `resolution_time` <= `resolution_period`
1482-
- `effective_fees` = `fees`
1482+
- `effective_fees` = `fees` * 0.5
14831483
- otherwise:
14841484
- `effective_fees` = 0
14851485

@@ -1512,12 +1512,26 @@ A peer is classified as having "good" local reputation iff `reputation_revenue`
15121512
otherwise the peer's reputation is classified as "neutral".
15131513

15141514
### Rationale
1515-
If a HTLC is endorsed by a peer they have signaled that they expect the HTLC
1516-
to resolve honestly, so will be held accountable for the manner in which they
1517-
resolve. By contrast, if a HTLC was not endorsed by the upstream peer, it
1518-
should not have a negative impact on reputation. In the case where one of
1519-
these "unknown" HTLCs succeeds within the reasonable resolution threshold, the
1520-
peer is still credited with fees because the HTLC resolved desirably.
1515+
1516+
A jamming attack can only be achieved with good reputation, as the resources
1517+
available to neutral reputation nodes are limited by resource bucketing. If a
1518+
node is attacked, it is guaranteed to have been paid at least its
1519+
`routing_revenue` over the previous `reputation_window`.
1520+
1521+
Reputation is only negatively affected if a HTLC was endorsed to help protect
1522+
the network's ability to forward "unknown" HTLCs - those from low-activity or
1523+
new entrants that may very well be honest, but have not build up good
1524+
reputation through a history of consistent, good behavior.
1525+
1526+
Intuitively if a HTLC is endorsed by a peer they have signaled that they expect
1527+
the HTLC to resolve honestly, they should be held accountable for that signal.
1528+
By contrast, if a HTLC was not endorsed by the upstream peer, it should not
1529+
have a negative impact on reputation. In the case where one of these
1530+
"unknown" HTLCs succeeds within the reasonable resolution threshold, the
1531+
peer is still credited with fees because the HTLC resolved desirably. This
1532+
allows new, unendorsed entrants to slowly build reputation over time. The fee
1533+
contribution of unendorsed HTLCs is discounted by 50% to incentivise nodes to
1534+
endorse HTLCs.
15211535

15221536
# Test Vector
15231537

0 commit comments

Comments
 (0)