Class ChaChaKeyImportSpec

java.lang.Object

zeroecho.core.alg.chacha.ChaChaKeyImportSpec

All Implemented Interfaces:

Destroyable, AlgorithmKeySpec

public final class ChaChaKeyImportSpec
extends Object
implements AlgorithmKeySpec, Destroyable

ChaCha20 key import specification

Wraps a raw ChaCha20 key for import into the ZeroEcho framework. Keys must be exactly 32 bytes (256 bits).

Construction

• fromRaw(byte[]) - construct from a raw byte array.
• fromHex(String) - construct from a hexadecimal string.
• fromBase64(String) - construct from a Base64 string.

Marshalling

Keys can be serialized/deserialized using PairSeq:

• marshal(ChaChaKeyImportSpec) encodes the key as Base64.
• unmarshal(PairSeq) accepts fields k.b64, k.hex, or k.raw (ISO-8859-1) to restore a spec.

Usage

// Import from raw key bytes
ChaChaKeyImportSpec spec = ChaChaKeyImportSpec.fromRaw(keyBytes);
SecretKey key = cryptoAlgorithm.symmetricKeyImporter(ChaChaKeyImportSpec.class).importSecret(spec);

// Serialize to PairSeq
PairSeq seq = ChaChaKeyImportSpec.marshal(spec);

// Deserialize back
ChaChaKeyImportSpec restored = ChaChaKeyImportSpec.unmarshal(seq);

Since:

1.0

Method Summary

Modifier and Type	Method	Description
void	destroy()
static ChaChaKeyImportSpec	fromBase64(String b64)	Creates a spec from a Base64 string.
static ChaChaKeyImportSpec	fromHex(String hex)	Creates a spec from a hexadecimal string.
static ChaChaKeyImportSpec	fromRaw(byte[] key)	Creates a spec from a raw byte array.
boolean	isDestroyed()
byte[]	key()	Returns a defensive copy of the raw key.
static PairSeq	marshal(ChaChaKeyImportSpec spec)	Serializes this spec into a PairSeq, storing the key as Base64.
static ChaChaKeyImportSpec	unmarshal(PairSeq p)	Restores a spec from a serialized PairSeq.

Methods inherited from class Object

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

Method Details

fromRaw

public static ChaChaKeyImportSpec fromRaw(byte[] key)

Creates a spec from a raw byte array.

Parameters:

key - 32-byte raw key

Returns:

spec wrapping the key

fromHex

public static ChaChaKeyImportSpec fromHex(String hex)

Creates a spec from a hexadecimal string.

Parameters:

hex - hex-encoded key

Returns:

spec wrapping the decoded key

fromBase64

public static ChaChaKeyImportSpec fromBase64(String b64)

Creates a spec from a Base64 string.

Parameters:

b64 - base64-encoded key

Returns:

spec wrapping the decoded key

key

public byte[] key()

Returns a defensive copy of the raw key.

Returns:

32-byte key array

marshal

public static PairSeq marshal(ChaChaKeyImportSpec spec)

Serializes this spec into a PairSeq, storing the key as Base64.

Parameters:

spec - spec to serialize

Returns:

serialized key representation

unmarshal

public static ChaChaKeyImportSpec unmarshal(PairSeq p)

Restores a spec from a serialized PairSeq.

Recognized fields:

• k.b64 - Base64 encoding
• k.hex - hexadecimal string
• k.raw - raw ISO-8859-1 string

Parameters:

p - serialized key representation

Returns:

reconstructed spec

Throws:

IllegalArgumentException - if none of the recognized fields are present

destroy

public void destroy()

Specified by:

destroy in interface Destroyable

isDestroyed

public boolean isDestroyed()

Specified by:

isDestroyed in interface Destroyable