Class ChaCha20Poly1305Spec

java.lang.Object

zeroecho.core.alg.chacha.ChaCha20Poly1305Spec

All Implemented Interfaces:

ChaChaBaseSpec, Describable, ContextSpec

public final class ChaCha20Poly1305Spec
extends Object
implements ChaChaBaseSpec, Describable

ChaCha20-Poly1305 algorithm specification

Immutable parameters for configuring a ChaCha20-Poly1305 operation. Optionally carries a SymmetricHeaderCodec to prepend/parse per-stream headers (e.g., nonce and AAD hash) during encryption/decryption.

Notes

• If header() is null, no header is written or read; callers must exchange the nonce/AAD out-of-band via the context.
• The effective authentication tag size is 128 bits.

Example

ChaCha20Poly1305Spec spec = ChaCha20Poly1305Spec.builder()
    .header(new ChaCha20Poly1305HeaderCodec())
    .build();

Since:

1.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	ChaCha20Poly1305Spec.Builder	Fluent builder for ChaCha20Poly1305Spec.

Method Summary

Modifier and Type	Method	Description
static ChaCha20Poly1305Spec.Builder	builder()	Returns a new builder for ChaCha20Poly1305Spec.
String	description()	Human-readable description of this spec.
SymmetricHeaderCodec	header()	Returns the optional header codec.
static ChaCha20Poly1305Spec	withHeader(SymmetricHeaderCodec header)	Convenience factory that returns a spec with the provided header codec.

Methods inherited from class Object

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

Method Details

builder

public static ChaCha20Poly1305Spec.Builder builder()

Returns a new builder for ChaCha20Poly1305Spec.

Returns:

a fresh ChaCha20Poly1305Spec.Builder

withHeader

public static ChaCha20Poly1305Spec withHeader(SymmetricHeaderCodec header)

Convenience factory that returns a spec with the provided header codec.

Parameters:

header - optional header codec; may be null

Returns:

a new ChaCha20Poly1305Spec configured with header

header

public SymmetricHeaderCodec header()

Returns the optional header codec.

Specified by:

header in interface ChaChaBaseSpec

Returns:

header codec or null if none

description

public String description()

Human-readable description of this spec.

Specified by:

description in interface Describable

Returns:

"ChaCha20-Poly1305(tag=128)"