Package org.bouncycastle.pqc.jcajce.interfaces

Interface StateAwareSignature

All Known Implementing Classes:

XMSSMTSignatureSpi, XMSSMTSignatureSpi.generic, XMSSMTSignatureSpi.withSha256, XMSSMTSignatureSpi.withSha256andPrehash, XMSSMTSignatureSpi.withSha512, XMSSMTSignatureSpi.withSha512andPrehash, XMSSMTSignatureSpi.withShake128, XMSSMTSignatureSpi.withShake128_512andPrehash, XMSSMTSignatureSpi.withShake128andPrehash, XMSSMTSignatureSpi.withShake256, XMSSMTSignatureSpi.withShake256_1024andPrehash, XMSSMTSignatureSpi.withShake256andPrehash, XMSSSignatureSpi, XMSSSignatureSpi.generic, XMSSSignatureSpi.withSha256, XMSSSignatureSpi.withSha256andPrehash, XMSSSignatureSpi.withSha512, XMSSSignatureSpi.withSha512andPrehash, XMSSSignatureSpi.withShake128, XMSSSignatureSpi.withShake128_512andPrehash, XMSSSignatureSpi.withShake128andPrehash, XMSSSignatureSpi.withShake256, XMSSSignatureSpi.withShake256_1024andPrehash, XMSSSignatureSpi.withShake256andPrehash

public interface StateAwareSignature

Deprecated.

it's better to avoid this and use extractKeyShard methods where possible.

This interface is implemented by Signature classes returned by the PQC provider where the signature algorithm is one where the private key is updated for each signature generated. Examples of these are algorithms such as GMSS, XMSS, and XMSS^MT.

Method Summary

Modifier and Type	Method	Description
String	getAlgorithm()	Deprecated.
PrivateKey	getUpdatedPrivateKey()	Deprecated. Return the current version of the private key with the updated state.
void	initSign(PrivateKey privateKey)	Deprecated.
void	initSign(PrivateKey privateKey, SecureRandom random)	Deprecated.
void	initVerify(Certificate certificate)	Deprecated.
void	initVerify(PublicKey publicKey)	Deprecated.
boolean	isSigningCapable()	Deprecated. Return true if this Signature object can be used for signing.
byte[]	sign()	Deprecated.
int	sign(byte[] outbuf, int offset, int len)	Deprecated.
void	update(byte b)	Deprecated.
void	update(byte[] data)	Deprecated.
void	update(byte[] data, int off, int len)	Deprecated.
void	update(ByteBuffer data)	Deprecated.
boolean	verify(byte[] signature)	Deprecated.
boolean	verify(byte[] signature, int offset, int length)	Deprecated.

Method Details

initVerify

void initVerify(PublicKey publicKey)
         throws InvalidKeyException

Deprecated.

Throws:

InvalidKeyException

initVerify

void initVerify(Certificate certificate)
         throws InvalidKeyException

Deprecated.

Throws:

InvalidKeyException

initSign

void initSign(PrivateKey privateKey)
       throws InvalidKeyException

Deprecated.

Throws:

InvalidKeyException

initSign

void initSign(PrivateKey privateKey,
 SecureRandom random)
       throws InvalidKeyException

Deprecated.

Throws:

InvalidKeyException

sign

byte[] sign()
     throws SignatureException

Deprecated.

Throws:

SignatureException

sign

int sign(byte[] outbuf,
 int offset,
 int len)
  throws SignatureException

Deprecated.

Throws:

SignatureException

verify

boolean verify(byte[] signature)
        throws SignatureException

Deprecated.

Throws:

SignatureException

verify

boolean verify(byte[] signature,
 int offset,
 int length)
        throws SignatureException

Deprecated.

Throws:

SignatureException

update

void update(byte b)
     throws SignatureException

Deprecated.

Throws:

SignatureException

update

void update(byte[] data)
     throws SignatureException

Deprecated.

Throws:

SignatureException

update

void update(byte[] data,
 int off,
 int len)
     throws SignatureException

Deprecated.

Throws:

SignatureException

update

void update(ByteBuffer data)
     throws SignatureException

Deprecated.

Throws:

SignatureException

getAlgorithm

String getAlgorithm()

Deprecated.

isSigningCapable

boolean isSigningCapable()

Deprecated.

Return true if this Signature object can be used for signing. False otherwise.

Returns:

true if we are capable of making signatures.

getUpdatedPrivateKey

PrivateKey getUpdatedPrivateKey()

Deprecated.

Return the current version of the private key with the updated state.

Note: calling this method will effectively disable the Signature object from being used for further signature generation without another call to initSign().

Returns:

an updated private key object, which can be used for later signature generation.