PeerStateDestroyed (Javadocs [I2P+ 2.13.0+]

java.lang.Object
- net.i2p.router.transport.udp.PeerStateDestroyed

All Implemented Interfaces:
SSU2Payload.PayloadCallback, SSU2Sender
```
class PeerStateDestroyed
extends Object
implements SSU2Payload.PayloadCallback, SSU2Sender
```
Small, stub version of PeerState2, for handling destroy acks with possible tokens in them. This is the "closing state" as defined in QUIC RFC-9000 section 10.2.1. Unlike in QUIC, we do increment the packet number for every sent destroy packet. Also, we retain the header and body decryption keys, and we do process any tokens received. We only respond when receiving data or a termination with a non-ack reason. Does not extend PeerState2 or PeerState.

Field Summary
Fields
Modifier and Type Field and Description
protected long _wantACKSendSince
_wantACKSendSince.

Fields
Modifier and Type	Field and Description
`protected long`	`_wantACKSendSince` _wantACKSendSince.

Constructor Summary

Constructors
Constructor and Description
`PeerStateDestroyed(RouterContext ctx, UDPTransport transport, PeerState2 peer)` This must be called after the first termination or termination ack was sent from PeerState2, so the next packet number is correct.
`PeerStateDestroyed(RouterContext ctx, UDPTransport transport, RemoteHostId id, long sendID, long rcvID, CipherState sendCha, CipherState rcvCha, byte[] sendKey1, byte[] sendKey2, byte[] rcvKey2, int reason)` Direct from IES2, there was never a PS2.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`fragmentsSent(long pktNum, int length, List<PacketBuilder.Fragment> fragments)` fragmentsSent.
`SSU2Bitfield`	`getAckedMessages()`
`byte`	`getFlags()`
`int`	`getMTU()`
`long`	`getNextPacketNumber()`
`(package private) long`	`getRcvConnID()`
`SSU2Bitfield`	`getReceivedMessages()`
`RemoteHostId`	`getRemoteHostId()`
`InetAddress`	`getRemoteIPAddress()`
`int`	`getRemotePort()`
`CipherState`	`getSendCipher()`
`long`	`getSendConnID()`
`byte[]`	`getSendHeaderEncryptKey1()`
`byte[]`	`getSendHeaderEncryptKey2()`
`void`	`gotACK(long ackThru, int acks, byte[] ranges)` gotACK.
`void`	`gotAddress(byte[] ip, int port)` gotAddress.
`void`	`gotDateTime(long time)` gotDateTime.
`void`	`gotFragment(byte[] data, int off, int len, long messageId, int frag, boolean isLast)` gotFragment.
`void`	`gotI2NP(I2NPMessage msg)` gotI2NP.
`void`	`gotOptions(byte[] options, boolean isHandshake)` gotOptions.
`void`	`gotPathChallenge(RemoteHostId from, byte[] data)` gotPathChallenge.
`void`	`gotPathResponse(RemoteHostId from, byte[] data)` gotPathResponse.
`void`	`gotPeerTest(int msg, int status, Hash h, byte[] data)` gotPeerTest.
`void`	`gotRelayIntro(Hash aliceHash, byte[] data)` gotRelayIntro.
`void`	`gotRelayRequest(byte[] data)` gotRelayRequest.
`void`	`gotRelayResponse(int status, byte[] data)` gotRelayResponse.
`void`	`gotRelayTag(long tag)` gotRelayTag.
`void`	`gotRelayTagRequest()` gotRelayTagRequest.
`void`	`gotRI(RouterInfo ri, boolean isHandshake, boolean flood)` gotRI.
`void`	`gotRIFragment(byte[] data, boolean isHandshake, boolean flood, boolean isGzipped, int frag, int totalFrags)` gotRIFragment.
`void`	`gotTermination(int reason, long count)` gotTermination.
`void`	`gotToken(long token, long expires)` gotToken.
`boolean`	`isIPv6()`
`void`	`kill()` Call at transport shutdown or cache eviction
`(package private) void`	`receivePacket(RemoteHostId from, UDPPacket packet)`
`(package private) void`	`receivePacket(UDPPacket packet)`
`void`	`setDestroyReason(int reason)` setDestroyReason.
`String`	`toString()` toString.

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

- Field Detail
  - _wantACKSendSince
```
protected volatile long _wantACKSendSince
```
    _wantACKSendSince.
- Constructor Detail
  - PeerStateDestroyed
```
public PeerStateDestroyed(RouterContext ctx,
                          UDPTransport transport,
                          PeerState2 peer)
```
    This must be called after the first termination or termination ack was sent from PeerState2, so the next packet number is correct.
    Parameters:
    peer - that just sent (or received and sent) a termination
  - PeerStateDestroyed
```
public PeerStateDestroyed(RouterContext ctx,
                          UDPTransport transport,
                          RemoteHostId id,
                          long sendID,
                          long rcvID,
                          CipherState sendCha,
                          CipherState rcvCha,
                          byte[] sendKey1,
                          byte[] sendKey2,
                          byte[] rcvKey2,
                          int reason)
```
    Direct from IES2, there was never a PS2. Caller must send termination after creating.
- Method Detail
  - fragmentsSent
```
public void fragmentsSent(long pktNum,
                          int length,
                          List<PacketBuilder.Fragment> fragments)
```
    fragmentsSent.
    Specified by:
    fragmentsSent in interface SSU2Sender
    Parameters:
    pktNum - packet number, @param length fragment length, @param fragments fragment list
  - getAckedMessages
```
public SSU2Bitfield getAckedMessages()
```
    Specified by:
    getAckedMessages in interface SSU2Sender
    Returns:
    null always, we don't care what was acked
  - getFlags
```
public byte getFlags()
```
    Specified by:
    getFlags in interface SSU2Sender
    Returns:
    the flags
  - getMTU
```
public int getMTU()
```
    Specified by:
    getMTU in interface SSU2Sender
    Returns:
    the m t u
  - getNextPacketNumber
```
public long getNextPacketNumber()
```
    Specified by:
    getNextPacketNumber in interface SSU2Sender
    Returns:
    the next packet number
  - getRcvConnID
```
long getRcvConnID()
```
  - getReceivedMessages
```
public SSU2Bitfield getReceivedMessages()
```
    Specified by:
    getReceivedMessages in interface SSU2Sender
    Returns:
    the received messages
  - getRemoteHostId
```
public RemoteHostId getRemoteHostId()
```
    Specified by:
    getRemoteHostId in interface SSU2Sender
    Returns:
    the remote host id
  - getRemoteIPAddress
```
public InetAddress getRemoteIPAddress()
```
    Specified by:
    getRemoteIPAddress in interface SSU2Sender
    Returns:
    the remote i p address
  - getRemotePort
```
public int getRemotePort()
```
    Specified by:
    getRemotePort in interface SSU2Sender
    Returns:
    the remote port
  - getSendCipher
```
public CipherState getSendCipher()
```
    Specified by:
    getSendCipher in interface SSU2Sender
    Returns:
    the send cipher
  - getSendConnID
```
public long getSendConnID()
```
    Specified by:
    getSendConnID in interface SSU2Sender
    Returns:
    the send conn i d
  - getSendHeaderEncryptKey1
```
public byte[] getSendHeaderEncryptKey1()
```
    Specified by:
    getSendHeaderEncryptKey1 in interface SSU2Sender
    Returns:
    the send header encrypt key1
  - getSendHeaderEncryptKey2
```
public byte[] getSendHeaderEncryptKey2()
```
    Specified by:
    getSendHeaderEncryptKey2 in interface SSU2Sender
    Returns:
    the send header encrypt key2
  - gotACK
```
public void gotACK(long ackThru,
                   int acks,
                   byte[] ranges)
```
    gotACK.
    Specified by:
    gotACK in interface SSU2Payload.PayloadCallback
    Parameters:
    ackThru - highest contiguous sequence number acknowledged
    acks - number of additional acknowledgments beyond ackThru
    ranges - null if none
  - gotAddress
```
public void gotAddress(byte[] ip,
                       int port)
```
    gotAddress.
    Specified by:
    gotAddress in interface SSU2Payload.PayloadCallback
    Parameters:
    ip - IP address bytes
    port - port number
  - gotDateTime
```
public void gotDateTime(long time)
```
    gotDateTime.
    Specified by:
    gotDateTime in interface SSU2Payload.PayloadCallback
    Parameters:
    time - time in milliseconds since epoch
  - gotFragment
```
public void gotFragment(byte[] data,
                        int off,
                        int len,
                        long messageId,
                        int frag,
                        boolean isLast)
```
    gotFragment.
    Specified by:
    gotFragment in interface SSU2Payload.PayloadCallback
    Parameters:
    data - buffer containing fragment data
    off - offset in data
    len - length of data to copy
    messageId - unique message identifier
    frag - fragment number (0-based)
    isLast - whether this is the last fragment
  - gotI2NP
```
public void gotI2NP(I2NPMessage msg)
```
    gotI2NP.
    Specified by:
    gotI2NP in interface SSU2Payload.PayloadCallback
    Parameters:
    msg - the parsed I2NP message
  - gotOptions
```
public void gotOptions(byte[] options,
                       boolean isHandshake)
```
    gotOptions.
    Specified by:
    gotOptions in interface SSU2Payload.PayloadCallback
    Parameters:
    options - the option data
    isHandshake - true only for message 3 part 2
  - gotPathChallenge
```
public void gotPathChallenge(RemoteHostId from,
                             byte[] data)
```
    gotPathChallenge.
    Specified by:
    gotPathChallenge in interface SSU2Payload.PayloadCallback
    Parameters:
    from - null if unknown
  - gotPathResponse
```
public void gotPathResponse(RemoteHostId from,
                            byte[] data)
```
    gotPathResponse.
    Specified by:
    gotPathResponse in interface SSU2Payload.PayloadCallback
    Parameters:
    from - null if unknown
  - gotPeerTest
```
public void gotPeerTest(int msg,
                        int status,
                        Hash h,
                        byte[] data)
```
    gotPeerTest.
    Specified by:
    gotPeerTest in interface SSU2Payload.PayloadCallback
    Parameters:
    msg - 1-7
    status - 0 = accept, 1-255 = reject
    h - Alice or Charlie hash for msg 2 and 4, null for msg 1, 3, 5-7
    data - excludes flag, includes signature
  - gotRelayIntro
```
public void gotRelayIntro(Hash aliceHash,
                          byte[] data)
```
    gotRelayIntro.
    Specified by:
    gotRelayIntro in interface SSU2Payload.PayloadCallback
    Parameters:
    aliceHash - hash of the introducer
    data - excludes flag, includes signature
  - gotRelayRequest
```
public void gotRelayRequest(byte[] data)
```
    gotRelayRequest.
    Specified by:
    gotRelayRequest in interface SSU2Payload.PayloadCallback
    Parameters:
    data - excludes flag, includes signature
  - gotRelayResponse
```
public void gotRelayResponse(int status,
                             byte[] data)
```
    gotRelayResponse.
    Specified by:
    gotRelayResponse in interface SSU2Payload.PayloadCallback
    Parameters:
    status - 0 = accept, 1-255 = reject
    data - excludes flag, includes signature
  - gotRelayTag
```
public void gotRelayTag(long tag)
```
    gotRelayTag.
    Specified by:
    gotRelayTag in interface SSU2Payload.PayloadCallback
    Parameters:
    tag - the relay tag
  - gotRelayTagRequest
```
public void gotRelayTagRequest()
```
    gotRelayTagRequest.
    Specified by:
    gotRelayTagRequest in interface SSU2Payload.PayloadCallback
  - gotRI
```
public void gotRI(RouterInfo ri,
                  boolean isHandshake,
                  boolean flood)
```
    gotRI.
    Specified by:
    gotRI in interface SSU2Payload.PayloadCallback
    Parameters:
    ri - will already be validated
    isHandshake - true only for message 3 part 2
    flood - true if this is a floodfill router
  - gotRIFragment
```
public void gotRIFragment(byte[] data,
                          boolean isHandshake,
                          boolean flood,
                          boolean isGzipped,
                          int frag,
                          int totalFrags)
```
    gotRIFragment.
    Specified by:
    gotRIFragment in interface SSU2Payload.PayloadCallback
    Parameters:
    data - is first gzipped and then fragmented
    isHandshake - true only for message 3 part 2
    flood - true if this is a floodfill router
    isGzipped - true if the data is gzipped
    frag - fragment number (0-based)
    totalFrags - total number of fragments
  - gotTermination
```
public void gotTermination(int reason,
                           long count)
```
    gotTermination.
    Specified by:
    gotTermination in interface SSU2Payload.PayloadCallback
    Parameters:
    reason - termination reason code
    count - in theory could wrap around to negative, but very unlikely
  - gotToken
```
public void gotToken(long token,
                     long expires)
```
    gotToken.
    Specified by:
    gotToken in interface SSU2Payload.PayloadCallback
    Parameters:
    token - the token value
    expires - token expiration time in milliseconds
  - isIPv6
```
public boolean isIPv6()
```
    Specified by:
    isIPv6 in interface SSU2Sender
    Returns:
    whether i pv6
  - kill
```
public void kill()
```
    Call at transport shutdown or cache eviction
  - receivePacket
```
void receivePacket(RemoteHostId from,
                   UDPPacket packet)
```
    Parameters:
    from - source address
    packet - fully encrypted, header and body decryption will be done here
  - receivePacket
```
void receivePacket(UDPPacket packet)
```
    Parameters:
    packet - fully encrypted, header and body decryption will be done here
  - setDestroyReason
```
public void setDestroyReason(int reason)
```
    setDestroyReason.
    Specified by:
    setDestroyReason in interface SSU2Sender
    Parameters:
    reason - destroy reason
  - toString
```
public String toString()
```
    toString.
    Overrides:
    toString in class Object

Class PeerStateDestroyed

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

_wantACKSendSince

Constructor Detail

PeerStateDestroyed

PeerStateDestroyed

Method Detail

fragmentsSent

getAckedMessages

getFlags

getMTU

getNextPacketNumber

getRcvConnID

getReceivedMessages

getRemoteHostId

getRemoteIPAddress

getRemotePort

getSendCipher

getSendConnID

getSendHeaderEncryptKey1

getSendHeaderEncryptKey2

gotACK

gotAddress

gotDateTime

gotFragment

gotI2NP

gotOptions

gotPathChallenge

gotPathResponse

gotPeerTest

gotRelayIntro

gotRelayRequest

gotRelayResponse

gotRelayTag

gotRelayTagRequest

gotRI

gotRIFragment

gotTermination

gotToken

isIPv6

kill

receivePacket

receivePacket

setDestroyReason

toString