Package net.i2p.router.crypto.ratchet

Class RatchetPayload

java.lang.Object

net.i2p.router.crypto.ratchet.RatchetPayload

class RatchetPayload
extends Object

Ratchet payload generation and parsing

Since:

0.9.44 adapted from NTCP2Payload

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	RatchetPayload.Block	Base class for blocks to be transmitted.
static class	RatchetPayload.DateTimeBlock
static class	RatchetPayload.GarlicBlock
static class	RatchetPayload.NextKeyBlock
static class	RatchetPayload.OptionsBlock
static class	RatchetPayload.PaddingBlock
static interface	RatchetPayload.PayloadCallback	For all callbacks, recommend throwing exceptions only from the handshake.
static class	RatchetPayload.TerminationBlock

Field Summary

Fields

Modifier and Type	Field	Description
static int	BLOCK_HEADER_SIZE

Constructor Summary

Constructors

Constructor	Description
RatchetPayload()

Method Summary

Modifier and Type	Method	Description
(package private) static long	fromLong8(byte[] src, int offset)	Big endian.
static int	processPayload(I2PAppContext ctx, RatchetPayload.PayloadCallback cb, byte[] payload, int off, int length, boolean isHandshake)	Incoming payload.
(package private) static void	toLong8(byte[] target, int offset, long value)	Big endian.
static int	writePayload(byte[] payload, int off, List<RatchetPayload.Block> blocks)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

BLOCK_HEADER_SIZE

public static final int BLOCK_HEADER_SIZE

See Also:

Constant Field Values

Constructor Detail

RatchetPayload

RatchetPayload()

Method Detail

processPayload

public static int processPayload(I2PAppContext ctx,
                                 RatchetPayload.PayloadCallback cb,
                                 byte[] payload,
                                 int off,
                                 int length,
                                 boolean isHandshake)
                          throws IOException,
                                 DataFormatException,
                                 I2NPMessageException

Incoming payload. Calls the callback for each received block.

Returns:

number of blocks processed

Throws:

IOException - on major errors

DataFormatException - on parsing of individual blocks

I2NPMessageException - on parsing of I2NP block

writePayload

public static int writePayload(byte[] payload,
                               int off,
                               List<RatchetPayload.Block> blocks)

Parameters:

payload - writes to it starting at off

Returns:

the new offset

fromLong8

static long fromLong8(byte[] src,
                      int offset)

Big endian. Same as DataHelper.fromLong(src, offset, 8) but allows negative result

Throws:

ArrayIndexOutOfBoundsException

toLong8

static void toLong8(byte[] target,
                    int offset,
                    long value)

Big endian. Same as DataHelper.toLong(target, offset, 8, value) but allows negative value

Throws:

ArrayIndexOutOfBoundsException