org.bouncycastle.crypto.digests

Class KeccakDigest

java.lang.Object

org.bouncycastle.crypto.digests.KeccakDigest

All Implemented Interfaces:

Digest, ExtendedDigest

Direct Known Subclasses:

SHA3Digest, SHAKEDigest

public class KeccakDigest
extends Object
implements ExtendedDigest

implementation of Keccak based on following KeccakNISTInterface.c from https://keccak.noekeon.org/

Following the naming conventions used in the C source code to enable easy review of the implementation.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	bitsInQueue
protected byte[]	dataQueue
protected int	fixedOutputLength
protected CryptoServicePurpose	purpose
protected int	rate
protected boolean	squeezing
protected long[]	state

Constructor Summary

Constructors

Constructor and Description
KeccakDigest()
KeccakDigest(CryptoServicePurpose purpose)
KeccakDigest(int bitLength)
KeccakDigest(int bitLength, CryptoServicePurpose purpose)
KeccakDigest(KeccakDigest source)

Method Summary

Modifier and Type	Method and Description
protected void	absorb(byte data)
protected void	absorb(byte[] data, int off, int len)
protected void	absorbBits(int data, int bits)
protected CryptoServiceProperties	cryptoServiceProperties()
int	doFinal(byte[] out, int outOff) close the digest, producing the final digest value.
protected int	doFinal(byte[] out, int outOff, byte partialByte, int partialBits)
String	getAlgorithmName() return the algorithm name
int	getByteLength() Return the size of block that the compression function is applied to in bytes.
int	getDigestSize() return the size, in bytes, of the digest produced by this message digest.
void	reset() reset the digest back to it's initial state.
protected void	squeeze(byte[] output, int offset, long outputLength)
void	update(byte in) update the message digest with a single byte.
void	update(byte[] in, int inOff, int len) update the message digest with a block of bytes.

Methods inherited from class java.lang.Object

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

Field Detail

bitsInQueue

protected int bitsInQueue

dataQueue

protected byte[] dataQueue

fixedOutputLength

protected int fixedOutputLength

purpose

protected final CryptoServicePurpose purpose

rate

protected int rate

squeezing

protected boolean squeezing

state

protected long[] state

Constructor Detail

KeccakDigest

public KeccakDigest()

KeccakDigest

public KeccakDigest(CryptoServicePurpose purpose)

KeccakDigest

public KeccakDigest(int bitLength)

KeccakDigest

public KeccakDigest(int bitLength,
                    CryptoServicePurpose purpose)

KeccakDigest

public KeccakDigest(KeccakDigest source)

Method Detail

absorb

protected void absorb(byte data)

absorb

protected void absorb(byte[] data,
                      int off,
                      int len)

absorbBits

protected void absorbBits(int data,
                          int bits)

cryptoServiceProperties

protected CryptoServiceProperties cryptoServiceProperties()

doFinal

public int doFinal(byte[] out,
                   int outOff)

Description copied from interface: Digest

close the digest, producing the final digest value. The doFinal call leaves the digest reset.

Specified by:

doFinal in interface Digest

Parameters:

out - the array the digest is to be copied into.

outOff - the offset into the out array the digest is to start at.

doFinal

protected int doFinal(byte[] out,
                      int outOff,
                      byte partialByte,
                      int partialBits)

getAlgorithmName

public String getAlgorithmName()

Description copied from interface: Digest

return the algorithm name

Specified by:

getAlgorithmName in interface Digest

Returns:

the algorithm name

getByteLength

public int getByteLength()

Return the size of block that the compression function is applied to in bytes.

Specified by:

getByteLength in interface ExtendedDigest

Returns:

internal byte length of a block.

getDigestSize

public int getDigestSize()

Description copied from interface: Digest

return the size, in bytes, of the digest produced by this message digest.

Specified by:

getDigestSize in interface Digest

Returns:

the size, in bytes, of the digest produced by this message digest.

reset

public void reset()

Description copied from interface: Digest

reset the digest back to it's initial state.

Specified by:

reset in interface Digest

squeeze

protected void squeeze(byte[] output,
                       int offset,
                       long outputLength)

update

public void update(byte in)

Description copied from interface: Digest

update the message digest with a single byte.

Specified by:

update in interface Digest

Parameters:

in - the input byte to be entered.

update

public void update(byte[] in,
                   int inOff,
                   int len)

Description copied from interface: Digest

update the message digest with a block of bytes.

Specified by:

update in interface Digest

Parameters:

in - the byte array containing the data.

inOff - the offset into the byte array where the data starts.

len - the length of the data.