ParticipatingThrottler (Javadocs [I2P+ 2.13.0+]

java.lang.Object
- net.i2p.router.tunnel.pool.ParticipatingThrottler

```
public class ParticipatingThrottler
extends Object
```
Count how often we have accepted a tunnel with the peer as the previous or next hop. We limit each peer to a percentage of all participating tunnels, subject to minimum and maximum values for the limit. This offers basic protection against simple attacks but is not a complete solution, as by design, we don't know the originator of a tunnel request. This also effectively limits the number of tunnels between any given pair of routers, which probably isn't a bad thing.

Nested Class Summary
Nested Classes
Modifier and Type Class and Description
static class ParticipatingThrottler.Result
Result of throttling decision for tunnel participation requests.

Nested Classes
Modifier and Type	Class and Description
`static class`	`ParticipatingThrottler.Result` Result of throttling decision for tunnel participation requests.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`_loadWeight` Load weight: how much load inflates effective ratio (0-300%, default 100%).
`static int`	`_maxLimit` Max tunnels per peer before throttling.
`static int`	`_minLimit` Min tunnels per peer before throttling.
`static int`	`_percentLimit` Max pct of participating tunnels per peer.
`static int`	`_rejectSteepness` Rejection steepness: 100=linear ramp, 200=quadratic, higher=faster escalation.
`static int`	`_rejectThreshold` Rejection threshold: start rejecting at count/limit ratio this high (30-100, default 70%).

Constructor Summary
Constructors
Constructor and Description
ParticipatingThrottler(RouterContext ctx)
Participating throttler

Constructors
Constructor and Description
`ParticipatingThrottler(RouterContext ctx)` Participating throttler

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`(package private) static float`	`calculateLoadScore(RouterContext context)` Computes a 0.0–1.0 load score from job queue lag, CPU load, system load, and bandwidth queue pressure.
`static int`	`getLoadWeight()` The load weight.
`static int`	`getParticipatingMaxLimit()` The participating maximum limit.
`static int`	`getParticipatingMinLimit()` The participating minimum limit.
`static int`	`getParticipatingPctLimit()` The participating percent limit.
`static int`	`getRejectSteepness()` The rejection steepness.
`static int`	`getRejectThreshold()` The rejection threshold.
`static void`	`setLoadWeight(int val)` The load weight.
`static void`	`setParticipatingMaxLimit(int val)` The participating maximum limit.
`static void`	`setParticipatingMinLimit(int val)` The participating minimum limit.
`static void`	`setParticipatingPctLimit(int val)` The participating percent limit.
`static void`	`setRejectSteepness(int val)` The rejection steepness.
`static void`	`setRejectThreshold(int val)` The rejection threshold.
`(package private) ParticipatingThrottler.Result`	`shouldThrottle(Hash h)` Determines whether to throttle tunnel participation for the given router, counting the request against the peer's limit.
`(package private) ParticipatingThrottler.Result`	`shouldThrottle(Hash h, boolean countRequest)` Determines whether to throttle tunnel participation for the given router.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - _loadWeight
```
public static volatile int _loadWeight
```
    Load weight: how much load inflates effective ratio (0-300%, default 100%).
  - _maxLimit
```
public static volatile int _maxLimit
```
    Max tunnels per peer before throttling.
  - _minLimit
```
public static volatile int _minLimit
```
    Min tunnels per peer before throttling.
  - _percentLimit
```
public static volatile int _percentLimit
```
    Max pct of participating tunnels per peer.
  - _rejectSteepness
```
public static volatile int _rejectSteepness
```
    Rejection steepness: 100=linear ramp, 200=quadratic, higher=faster escalation.
  - _rejectThreshold
```
public static volatile int _rejectThreshold
```
    Rejection threshold: start rejecting at count/limit ratio this high (30-100, default 70%).
- Constructor Detail
  - ParticipatingThrottler
```
ParticipatingThrottler(RouterContext ctx)
```
    Participating throttler
- Method Detail
  - calculateLoadScore
```
static float calculateLoadScore(RouterContext context)
```
    Computes a 0.0–1.0 load score from job queue lag, CPU load, system load, and bandwidth queue pressure. Used to shift the rejection probability curve left when the router is under load. Shared by ParticipatingThrottler and RequestThrottler; the RateStat handle is cached per context.
  - getLoadWeight
```
public static int getLoadWeight()
```
    The load weight.
    Returns:
    load weight
  - getParticipatingMaxLimit
```
public static int getParticipatingMaxLimit()
```
    The participating maximum limit.
    Returns:
    max limit
  - getParticipatingMinLimit
```
public static int getParticipatingMinLimit()
```
    The participating minimum limit.
    Returns:
    min limit
  - getParticipatingPctLimit
```
public static int getParticipatingPctLimit()
```
    The participating percent limit.
    Returns:
    pct limit
  - getRejectSteepness
```
public static int getRejectSteepness()
```
    The rejection steepness.
    Returns:
    reject steepness
  - getRejectThreshold
```
public static int getRejectThreshold()
```
    The rejection threshold.
    Returns:
    reject threshold
  - setLoadWeight
```
public static void setLoadWeight(int val)
```
    The load weight.
    Parameters:
    val - load weight
  - setParticipatingMaxLimit
```
public static void setParticipatingMaxLimit(int val)
```
    The participating maximum limit.
    Parameters:
    val - max limit
  - setParticipatingMinLimit
```
public static void setParticipatingMinLimit(int val)
```
    The participating minimum limit.
    Parameters:
    val - min limit
  - setParticipatingPctLimit
```
public static void setParticipatingPctLimit(int val)
```
    The participating percent limit.
    Parameters:
    val - pct limit
  - setRejectSteepness
```
public static void setRejectSteepness(int val)
```
    The rejection steepness.
    Parameters:
    val - reject steepness
  - setRejectThreshold
```
public static void setRejectThreshold(int val)
```
    The rejection threshold.
    Parameters:
    val - reject threshold
  - shouldThrottle
```
ParticipatingThrottler.Result shouldThrottle(Hash h)
```
    Determines whether to throttle tunnel participation for the given router, counting the request against the peer's limit.
    Parameters:
    h - the hash of the router to check
    Returns:
    the throttling Result (ACCEPT, REJECT, or DROP)
  - shouldThrottle
```
ParticipatingThrottler.Result shouldThrottle(Hash h,
                                             boolean countRequest)
```
    Determines whether to throttle tunnel participation for the given router. When countRequest is set the request increments the peer's counter; consult-only checks read the current count without advancing it, and never DROP or ban on it: a count this request did not contribute to must not silently kill it, and mid-chain hops would otherwise accumulate roughly twice per tunnel via both their prev-hop and next-hop roles.
    Parameters:
    h - the hash of the router to check
    countRequest - true to increment the peer's counter
    Returns:
    the throttling Result (ACCEPT, REJECT, or DROP)

Class ParticipatingThrottler

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

_loadWeight

_maxLimit

_minLimit

_percentLimit

_rejectSteepness

_rejectThreshold

Constructor Detail

ParticipatingThrottler

Method Detail

calculateLoadScore

getLoadWeight

getParticipatingMaxLimit

getParticipatingMinLimit

getParticipatingPctLimit

getRejectSteepness

getRejectThreshold

setLoadWeight

setParticipatingMaxLimit

setParticipatingMinLimit

setParticipatingPctLimit

setRejectSteepness

setRejectThreshold

shouldThrottle

shouldThrottle