TunnelCreatorConfig (I2P Anonymous Network - Java Documentation

java.lang.Object
- net.i2p.router.tunnel.TunnelCreatorConfig

All Implemented Interfaces:

TunnelInfo

Direct Known Subclasses:

PooledTunnelCreatorConfig, TCConfig
```
public abstract class TunnelCreatorConfig
extends Object
implements TunnelInfo
```
Coordinate the info that the tunnel creator keeps track of, including what peers are in the tunnel and what their configuration is See PooledTunnelCreatorConfig for the non-abstract class

Field Summary

Fields
Modifier and Type Field and Description

protected RouterContext _context

static int REPLY_IV_LENGTH
IV length for getAESReplyIV(int)

Fields
Modifier and Type	Field and Description
`protected RouterContext`	`_context`
`static int`	`REPLY_IV_LENGTH` IV length for `getAESReplyIV(int)`

Constructor Summary

Constructors
Constructor and Description
`TunnelCreatorConfig(RouterContext ctx, int length, boolean isInbound)` For exploratory only (null destination)
`TunnelCreatorConfig(RouterContext ctx, int length, boolean isInbound, net.i2p.data.Hash destination)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`byte[]`	`getAESReplyIV(int hop)` IV used to encrypt the reply sent for the tunnel creation crypto.
`net.i2p.data.SessionKey`	`getAESReplyKey(int hop)` Key to encrypt the reply sent for the tunnel creation crypto.
`net.i2p.data.Hash`	`getBlankHash()` Checksum for blank record
`byte[]`	`getChaChaReplyAD(int hop)` Get ECIES reply AD
`net.i2p.data.SessionKey`	`getChaChaReplyKey(int hop)` Get ECIES reply key
`HopConfig`	`getConfig(int hop)` retrieve the config for the given hop.
`net.i2p.data.Hash`	`getDestination()` If this is a client tunnel, what destination is it for?
`net.i2p.data.Hash`	`getEndpoint()` For convenience
`long`	`getExpiration()`
`net.i2p.data.Hash`	`getFarEnd()` For convenience
`net.i2p.data.Hash`	`getGateway()` For convenience
`int`	`getLength()` How many hops are there in the tunnel? INCLUDING US.
`Properties`	`getOptions()`
`net.i2p.data.Hash`	`getPeer(int hop)` retrieve the peer at the given hop.
`int`	`getPriority()` Outbound message priority - for outbound tunnels only
`int`	`getProcessedMessagesCount()`
`net.i2p.data.TunnelId`	`getReceiveTunnelId(int hop)` retrieve the tunnelId that the given hop receives messages on.
`long`	`getReplyMessageId()` new style reply message id
`List<Integer>`	`getReplyOrder()` component ordering in the new style request
`net.i2p.data.TunnelId`	`getSendTunnelId(int hop)` retrieve the tunnelId that the given hop sends messages on.
`boolean`	`getTunnelFailed()`
`int`	`getTunnelFailures()`
`long`	`getVerifiedBytesTransferred()` we know for sure that this many bytes travelled through the tunnel in its lifetime
`void`	`incrementProcessedMessages()` take note of a message being pumped through this tunnel
`void`	`incrementVerifiedBytesTransferred(int bytes)` This calls profile manager tunnelDataPushed1m() for each peer
`boolean`	`isEC(int hop)` Is it an ECIES hop?
`boolean`	`isInbound()` is this an inbound tunnel?
`void`	`setAESReplyKeys(int hop, net.i2p.data.SessionKey key, byte[] iv)` Key and IV to encrypt the reply sent for the tunnel creation crypto.
`void`	`setBlankHash(net.i2p.data.Hash h)` Checksum for blank record
`void`	`setChaChaReplyKeys(int hop, net.i2p.data.SessionKey key, byte[] ad)` Set ECIES reply key and IV
`void`	`setExpiration(long when)`
`void`	`setPeer(int hop, net.i2p.data.Hash peer)`
`void`	`setPriority(int priority)` Outbound message priority - for outbound tunnels only
`void`	`setReplyMessageId(long id)`
`void`	`setReplyOrder(List<Integer> order)`
`void`	`setReused()` Note that we reused this tunnel
`void`	`testSuccessful(int ms)` take note that the tunnel was able to measurably Do Good in the given time
`String`	`toString()`
`boolean`	`tunnelFailed()` The tunnel failed a test, so (maybe) stop using it
`boolean`	`wasReused()` Did we reuse this tunnel?

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

- Field Detail
  - _context
```
protected final RouterContext _context
```
  - REPLY_IV_LENGTH
```
public static final int REPLY_IV_LENGTH
```
    IV length for getAESReplyIV(int)
    
    Since:
    
    0.9.48 moved from HopConfig
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - TunnelCreatorConfig
```
public TunnelCreatorConfig(RouterContext ctx,
                           int length,
                           boolean isInbound)
```
    For exploratory only (null destination)
    
    Parameters:
    
    length - 1 minimum (0 hop is length 1)
  - TunnelCreatorConfig
```
public TunnelCreatorConfig(RouterContext ctx,
                           int length,
                           boolean isInbound,
                           net.i2p.data.Hash destination)
```
    Parameters:
    
    length - 1 minimum (0 hop is length 1)
    
    destination - null for exploratory
- Method Detail
  - getLength
```
public int getLength()
```
    How many hops are there in the tunnel? INCLUDING US. i.e. one more than the TunnelCreatorConfig length.
    
    Specified by:
    
    getLength in interface TunnelInfo
  - getOptions
```
public Properties getOptions()
```
  - getConfig
```
public HopConfig getConfig(int hop)
```
    retrieve the config for the given hop. the gateway is hop 0.
  - getReceiveTunnelId
```
public net.i2p.data.TunnelId getReceiveTunnelId(int hop)
```
    retrieve the tunnelId that the given hop receives messages on. the gateway is hop 0.
    
    Specified by:
    
    getReceiveTunnelId in interface TunnelInfo
  - getSendTunnelId
```
public net.i2p.data.TunnelId getSendTunnelId(int hop)
```
    retrieve the tunnelId that the given hop sends messages on. the gateway is hop 0.
    
    Specified by:
    
    getSendTunnelId in interface TunnelInfo
  - getPeer
```
public net.i2p.data.Hash getPeer(int hop)
```
    retrieve the peer at the given hop. the gateway is hop 0
    
    Specified by:
    
    getPeer in interface TunnelInfo
  - setPeer
```
public void setPeer(int hop,
                    net.i2p.data.Hash peer)
```
  - getGateway
```
public net.i2p.data.Hash getGateway()
```
    For convenience
    
    Specified by:
    
    getGateway in interface TunnelInfo
    
    Returns:
    
    getPeer(0)
    
    Since:
    
    0.8.9
  - getEndpoint
```
public net.i2p.data.Hash getEndpoint()
```
    For convenience
    
    Specified by:
    
    getEndpoint in interface TunnelInfo
    
    Returns:
    
    getPeer(getLength() - 1)
    
    Since:
    
    0.8.9
  - getFarEnd
```
public net.i2p.data.Hash getFarEnd()
```
    For convenience
    
    Specified by:
    
    getFarEnd in interface TunnelInfo
    
    Returns:
    
    isInbound() ? getGateway() : getEndpoint()
    
    Since:
    
    0.8.9
  - isInbound
```
public boolean isInbound()
```
    is this an inbound tunnel?
    
    Specified by:
    
    isInbound in interface TunnelInfo
  - getDestination
```
public net.i2p.data.Hash getDestination()
```
    If this is a client tunnel, what destination is it for?
    
    Specified by:
    
    getDestination in interface TunnelInfo
    
    Returns:
    
    null for exploratory
  - getExpiration
```
public long getExpiration()
```
    Specified by:
    
    getExpiration in interface TunnelInfo
  - setExpiration
```
public void setExpiration(long when)
```
  - getReplyOrder
```
public List<Integer> getReplyOrder()
```
    component ordering in the new style request
  - setReplyOrder
```
public void setReplyOrder(List<Integer> order)
```
  - getReplyMessageId
```
public long getReplyMessageId()
```
    new style reply message id
  - setReplyMessageId
```
public void setReplyMessageId(long id)
```
  - incrementProcessedMessages
```
public void incrementProcessedMessages()
```
    take note of a message being pumped through this tunnel
  - getProcessedMessagesCount
```
public int getProcessedMessagesCount()
```
    Specified by:
    
    getProcessedMessagesCount in interface TunnelInfo
  - incrementVerifiedBytesTransferred
```
public void incrementVerifiedBytesTransferred(int bytes)
```
    This calls profile manager tunnelDataPushed1m() for each peer
    
    Specified by:
    
    incrementVerifiedBytesTransferred in interface TunnelInfo
  - getVerifiedBytesTransferred
```
public long getVerifiedBytesTransferred()
```
    Description copied from interface: TunnelInfo
    
    we know for sure that this many bytes travelled through the tunnel in its lifetime
    
    Specified by:
    
    getVerifiedBytesTransferred in interface TunnelInfo
  - tunnelFailed
```
public boolean tunnelFailed()
```
    The tunnel failed a test, so (maybe) stop using it
  - getTunnelFailed
```
public boolean getTunnelFailed()
```
  - getTunnelFailures
```
public int getTunnelFailures()
```
  - testSuccessful
```
public void testSuccessful(int ms)
```
    Description copied from interface: TunnelInfo
    
    take note that the tunnel was able to measurably Do Good in the given time
    
    Specified by:
    
    testSuccessful in interface TunnelInfo
  - wasReused
```
public boolean wasReused()
```
    Did we reuse this tunnel?
    
    Specified by:
    
    wasReused in interface TunnelInfo
    
    Since:
    
    0.8.11
  - setReused
```
public void setReused()
```
    Note that we reused this tunnel
    
    Specified by:
    
    setReused in interface TunnelInfo
    
    Since:
    
    0.8.11
  - getPriority
```
public int getPriority()
```
    Outbound message priority - for outbound tunnels only
    
    Returns:
    
    -25 to +25, default 0
    
    Since:
    
    0.9.4
  - setPriority
```
public void setPriority(int priority)
```
    Outbound message priority - for outbound tunnels only
    
    Parameters:
    
    priority - -25 to +25, default 0
    
    Since:
    
    0.9.4
  - setAESReplyKeys
```
public void setAESReplyKeys(int hop,
                            net.i2p.data.SessionKey key,
                            byte[] iv)
```
    Key and IV to encrypt the reply sent for the tunnel creation crypto.
    
    Throws:
    
    IllegalArgumentException - if iv not 16 bytes
    
    Since:
    
    0.9.48 moved from HopConfig
  - getAESReplyKey
```
public net.i2p.data.SessionKey getAESReplyKey(int hop)
```
    Key to encrypt the reply sent for the tunnel creation crypto.
    
    Returns:
    
    key or null
    
    Throws:
    
    IllegalArgumentException - if iv not 16 bytes
    
    Since:
    
    0.9.48 moved from HopConfig
  - getAESReplyIV
```
public byte[] getAESReplyIV(int hop)
```
    IV used to encrypt the reply sent for the tunnel creation crypto.
    
    Returns:
    
    16 bytes or null
    
    Since:
    
    0.9.48 moved from HopConfig
  - getBlankHash
```
public net.i2p.data.Hash getBlankHash()
```
    Checksum for blank record
    
    Since:
    
    0.9.48
  - setBlankHash
```
public void setBlankHash(net.i2p.data.Hash h)
```
    Checksum for blank record
    
    Since:
    
    0.9.48
  - setChaChaReplyKeys
```
public void setChaChaReplyKeys(int hop,
                               net.i2p.data.SessionKey key,
                               byte[] ad)
```
    Set ECIES reply key and IV
    
    Since:
    
    0.9.48
  - isEC
```
public boolean isEC(int hop)
```
    Is it an ECIES hop?
    
    Since:
    
    0.9.48
  - getChaChaReplyKey
```
public net.i2p.data.SessionKey getChaChaReplyKey(int hop)
```
    Get ECIES reply key
    
    Since:
    
    0.9.48
  - getChaChaReplyAD
```
public byte[] getChaChaReplyAD(int hop)
```
    Get ECIES reply AD
    
    Since:
    
    0.9.48
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class TunnelCreatorConfig

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

_context

REPLY_IV_LENGTH

Constructor Detail

TunnelCreatorConfig

TunnelCreatorConfig

Method Detail

getLength

getOptions

getConfig

getReceiveTunnelId

getSendTunnelId

getPeer

setPeer

getGateway

getEndpoint

getFarEnd

isInbound

getDestination

getExpiration

setExpiration

getReplyOrder

setReplyOrder

getReplyMessageId

setReplyMessageId

incrementProcessedMessages

getProcessedMessagesCount

incrementVerifiedBytesTransferred

getVerifiedBytesTransferred

tunnelFailed

getTunnelFailed

getTunnelFailures

testSuccessful

wasReused

setReused

getPriority

setPriority

setAESReplyKeys

getAESReplyKey

getAESReplyIV

getBlankHash

setBlankHash

setChaChaReplyKeys

isEC

getChaChaReplyKey

getChaChaReplyAD

toString