public class SparkleEngine
extends java.lang.Object
Modifier and Type | Class and Description |
---|---|
protected static class |
AEADBufferBaseEngine.State |
static class |
SparkleEngine.SparkleParameters |
Modifier and Type | Field and Description |
---|---|
protected int |
AADBufferSize |
protected boolean |
aadFinished |
protected java.lang.String |
algorithmName |
protected int |
BlockSize |
protected boolean |
forEncryption |
protected byte[] |
initialAssociatedText |
protected boolean |
initialised |
protected int |
IV_SIZE |
protected int |
KEY_SIZE |
protected byte[] |
m_aad |
protected int |
m_aadPos |
protected byte[] |
m_buf |
protected int |
m_bufPos |
protected AEADBufferBaseEngine.State |
m_state |
protected byte[] |
mac |
protected int |
MAC_SIZE |
Constructor and Description |
---|
SparkleEngine(SparkleEngine.SparkleParameters sparkleParameters) |
Modifier and Type | Method and Description |
---|---|
protected void |
bufferReset() |
protected void |
checkAAD() |
protected boolean |
checkData() |
int |
doFinal(byte[] output,
int outOff)
Finish the operation either appending or verifying the MAC at the end of the data.
|
java.lang.String |
getAlgorithmName()
Return the name of the algorithm.
|
int |
getBlockSize() |
int |
getIVBytesSize() |
int |
getKeyBytesSize() |
byte[] |
getMac()
Return the value of the MAC associated with the last stream processed.
|
int |
getOutputSize(int len)
return the size of the output buffer required for a processBytes plus a
doFinal with an input of len bytes.
|
int |
getUpdateOutputSize(int len)
return the size of the output buffer required for a processBytes
an input of len bytes.
|
void |
init(boolean forEncryption,
CipherParameters params)
initialise the underlying cipher.
|
protected void |
init(byte[] key,
byte[] iv) |
void |
processAADByte(byte input)
Add a single byte to the associated data check.
|
void |
processAADBytes(byte[] input,
int inOff,
int len)
Add a sequence of bytes to the associated data check.
|
protected void |
processBuffer(byte[] input,
int inOff,
byte[] output,
int outOff) |
protected void |
processBufferAAD(byte[] buffer,
int bufOff) |
int |
processByte(byte in,
byte[] out,
int outOff)
encrypt/decrypt a single byte.
|
int |
processBytes(byte[] input,
int inOff,
int len,
byte[] output,
int outOff)
process a block of bytes from in putting the result into out.
|
protected void |
processFinalAAD() |
protected void |
processFinalBlock(byte[] output,
int outOff) |
void |
reset()
Reset the cipher.
|
protected void |
reset(boolean clearMac) |
static void |
sparkle_opt12(SparkleDigest.Friend friend,
int[] state,
int steps) |
static void |
sparkle_opt16(SparkleDigest.Friend friend,
int[] state,
int steps) |
protected void |
validateAndProcessBuffer(byte[] input,
int inOff,
byte[] output,
int outOff) |
protected byte[] m_buf
protected byte[] m_aad
protected int m_bufPos
protected int m_aadPos
protected boolean aadFinished
protected boolean initialised
protected int AADBufferSize
protected int BlockSize
protected AEADBufferBaseEngine.State m_state
protected boolean forEncryption
protected java.lang.String algorithmName
protected int KEY_SIZE
protected int IV_SIZE
protected int MAC_SIZE
protected byte[] initialAssociatedText
protected byte[] mac
public SparkleEngine(SparkleEngine.SparkleParameters sparkleParameters)
protected void init(byte[] key, byte[] iv) throws java.lang.IllegalArgumentException
java.lang.IllegalArgumentException
protected void processFinalBlock(byte[] output, int outOff)
protected void processBufferAAD(byte[] buffer, int bufOff)
protected void processBuffer(byte[] input, int inOff, byte[] output, int outOff)
protected void processFinalAAD()
protected void reset(boolean clearMac)
public static void sparkle_opt12(SparkleDigest.Friend friend, int[] state, int steps)
public static void sparkle_opt16(SparkleDigest.Friend friend, int[] state, int steps)
public void processAADByte(byte input)
AEADCipher
input
- the byte to be processed.public void processAADBytes(byte[] input, int inOff, int len)
AEADCipher
input
- the input byte array.inOff
- the offset into the in array where the data to be processed starts.len
- the number of bytes to be processed.public int processBytes(byte[] input, int inOff, int len, byte[] output, int outOff) throws DataLengthException
AEADCipher
input
- the input byte array.inOff
- the offset into the in array where the data to be processed starts.len
- the number of bytes to be processed.output
- the output buffer the processed bytes go into.outOff
- the offset into the output byte array the processed data starts at.DataLengthException
- if the output buffer is too small.public int doFinal(byte[] output, int outOff) throws java.lang.IllegalStateException, InvalidCipherTextException
AEADCipher
output
- space for any resulting output data.outOff
- offset into out to start copying the data at.java.lang.IllegalStateException
- if the cipher is in an inappropriate state.InvalidCipherTextException
- if the MAC fails to match.public int getBlockSize()
public int getUpdateOutputSize(int len)
AEADCipher
The returned size may be dependent on the initialisation of this cipher and may not be accurate once subsequent input data is processed - this method should be invoked immediately prior to input data being processed.
len
- the length of the input.public int getOutputSize(int len)
AEADCipher
The returned size may be dependent on the initialisation of this cipher
and may not be accurate once subsequent input data is processed - this method
should be invoked immediately prior to a call to final processing of input data
and a call to AEADCipher.doFinal(byte[], int)
.
len
- the length of the input.protected void checkAAD()
protected boolean checkData()
protected void bufferReset()
protected void validateAndProcessBuffer(byte[] input, int inOff, byte[] output, int outOff)
public java.lang.String getAlgorithmName()
AEADCipher
getAlgorithmName
in interface AEADCipher
public int getKeyBytesSize()
public int getIVBytesSize()
public byte[] getMac()
AEADCipher
getMac
in interface AEADCipher
public void reset()
AEADCipher
reset
in interface AEADCipher
public int processByte(byte in, byte[] out, int outOff) throws DataLengthException
AEADCipher
processByte
in interface AEADCipher
in
- the byte to be processed.out
- the output buffer the processed byte goes into.outOff
- the offset into the output byte array the processed data starts at.DataLengthException
- if the output buffer is too small.public void init(boolean forEncryption, CipherParameters params)
AEADCipher
init
in interface AEADCipher
forEncryption
- true if we are setting up for encryption, false otherwise.params
- the necessary parameters for the underlying cipher to be initialised.