org.bouncycastle.crypto.signers.lms

Class LMSContext

java.lang.Object

org.bouncycastle.crypto.signers.lms.LMSContext

All Implemented Interfaces:

Digest

public class LMSContext
extends java.lang.Object
implements Digest

The digest an LMS or HSS message is absorbed into before it is signed or verified, carrying the one-time key or signature the operation will use. Obtain one from LMSContextBasedSigner.generateLMSContext() or LMSContextBasedVerifier.generateLMSContext(byte[]), feed it the message through the Digest methods, then hand it back to the key. Its contents are read by LMSEngine only.

Method Summary

Modifier and Type	Method and Description
int	doFinal(byte[] out, int outOff) close the digest, producing the final digest value.
java.lang.String	getAlgorithmName() return the algorithm name
int	getDigestSize() return the size, in bytes, of the digest produced by this message digest.
int	outputQ(byte[] output, int outOff) Write Q, the message hash, to the given buffer.
void	reset() reset the digest back to it's initial state.
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

Method Detail

outputQ

public int outputQ(byte[] output,
                   int outOff)

Write Q, the message hash, to the given buffer. The context cannot be used afterwards.

A caller that goes on to append the LM-OTS checksum needs two bytes beyond the value written here.

Parameters:

output - the byte array Q is to be copied into.

outOff - the offset into the byte array Q is to start at.

Returns:

the number of bytes written.

getAlgorithmName

public java.lang.String getAlgorithmName()

Description copied from interface: Digest

return the algorithm name

Specified by:

getAlgorithmName in interface Digest

Returns:

the algorithm name

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.

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.

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.

reset

public void reset()

Description copied from interface: Digest

reset the digest back to it's initial state.

Specified by:

reset in interface Digest