Package zeroecho.core.alg.chacha

Class ChaChaKeyImportSpec

java.lang.Object

zeroecho.core.alg.chacha.ChaChaKeyImportSpec

All Implemented Interfaces:

AlgorithmKeySpec

public final class ChaChaKeyImportSpec
extends Object
implements AlgorithmKeySpec

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.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
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.
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 java.lang.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