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
`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.

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
  - 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. Increments the participation count for the router and evaluates conditions including router version, capabilities, and request count limits to decide if the tunnel request should be accepted, rejected, or dropped.
    Parameters:
    h - the hash of the router to check
    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

getLoadWeight

getParticipatingMaxLimit

getParticipatingMinLimit

getParticipatingPctLimit

getRejectSteepness

getRejectThreshold

setLoadWeight

setParticipatingMaxLimit

setParticipatingMinLimit

setParticipatingPctLimit

setRejectSteepness

setRejectThreshold

shouldThrottle