Class LMSContext

java.lang.Object
org.bouncycastle.crypto.signers.lms.LMSContext
All Implemented Interfaces:
Digest

public class LMSContext extends 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
    Description
    int
    doFinal(byte[] out, int outOff)
    close the digest, producing the final digest value.
    return the algorithm name
    int
    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 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 Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Method Details

    • 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 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