BuildRequestor (Javadocs [I2P+ 2.13.0+]

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

```
public abstract class BuildRequestor
extends Object
```
Utility class for creating and dispatching tunnel build request messages.
This class handles:
- Preparation of tunnel hop IDs
- Selection of paired or exploratory tunnels for replies
- Construction of TunnelBuildMessage, including legacy and new-style (Short/Variable) formats
- Garlic encryption for inbound builds
- Timeout and failure handling
Paired tunnels are always used (as of 0.9.50+) to improve client isolation and prevent correlation across tunnel pools.

Field Summary

Fields
Modifier and Type	Field and Description
`(package private) static String`	`PROP_AVAIL_BW` Proposal 168 available bandwidth property key
`(package private) static String`	`PROP_MAX_BW` Proposal 168 maximum bandwidth property key
`(package private) static String`	`PROP_MIN_BW` Proposal 168 minimum bandwidth property key
`(package private) static String`	`PROP_REQ_BW` Proposal 168 required bandwidth property key

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static int`	`getFirstHopTimeout(RouterContext ctx)` How long the OutNetMessage for the first hop gets before TunnelBuildFirstHopFailJob fires.
`(package private) static int`	`getMaxConsecutiveClientBuildFails(RouterContext ctx)` Maximum consecutive client build timeouts before forcing exploratory tunnel for replies.
`static int`	`getRequestTimeout(RouterContext ctx)` How long we wait for a reply before trying a different pool/peers.
`static boolean`	`request(RouterContext ctx, PooledTunnelCreatorConfig cfg, BuildExecutor exec, long firstHopTimeout)` Initiates a tunnel build request.

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

- Field Detail
  - PROP_AVAIL_BW
```
static final String PROP_AVAIL_BW
```
    Proposal 168 available bandwidth property key
    See Also:
    Constant Field Values
  - PROP_MAX_BW
```
static final String PROP_MAX_BW
```
    Proposal 168 maximum bandwidth property key
    See Also:
    Constant Field Values
  - PROP_MIN_BW
```
static final String PROP_MIN_BW
```
    Proposal 168 minimum bandwidth property key
    See Also:
    Constant Field Values
  - PROP_REQ_BW
```
static final String PROP_REQ_BW
```
    Proposal 168 required bandwidth property key
    See Also:
    Constant Field Values
- Method Detail
  - getFirstHopTimeout
```
public static int getFirstHopTimeout(RouterContext ctx)
```
    How long the OutNetMessage for the first hop gets before TunnelBuildFirstHopFailJob fires. Shorter than request timeout so first-hop failure is detected before the full build timeout.
    Parameters:
    ctx - the router context
    Returns:
    first hop timeout in ms
  - getMaxConsecutiveClientBuildFails
```
static int getMaxConsecutiveClientBuildFails(RouterContext ctx)
```
    Maximum consecutive client build timeouts before forcing exploratory tunnel for replies. Tunable via i2p.tunnel.buildRequest.maxConsecutiveFails (default: 3)
    Parameters:
    ctx - the router context
    Returns:
    max consecutive failures
  - getRequestTimeout
```
public static int getRequestTimeout(RouterContext ctx)
```
    How long we wait for a reply before trying a different pool/peers. Adaptive mechanism in BuildExecutor adjusts this upward when success rates are low or timeout rates are high. Default: 13s (normal), 18s (slow systems).
    Parameters:
    ctx - the router context
    Returns:
    request timeout in ms
  - request
```
public static boolean request(RouterContext ctx,
                              PooledTunnelCreatorConfig cfg,
                              BuildExecutor exec,
                              long firstHopTimeout)
```
    Initiates a tunnel build request.
    Parameters:
    ctx - router context
    cfg - tunnel configuration (must have ReplyMessageId set)
    exec - executor to notify on completion
    firstHopTimeout - adaptive first-hop timeout ms (from BuildExecutor stats)
    Returns:
    true if request was successfully dispatched

Class BuildRequestor

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

PROP_AVAIL_BW

PROP_MAX_BW

PROP_MIN_BW

PROP_REQ_BW

Method Detail

getFirstHopTimeout

getMaxConsecutiveClientBuildFails

getRequestTimeout

request