com.guardtime.ksi.blocksigner

Interface BlockSigner<T>

Type Parameters:

T - type of the created signatures.

All Known Implementing Classes:

KsiBlockSigner

public interface BlockSigner<T>

Provides the means to create multiple signatures with one signing request.

Methods add(DataHash, long, IdentityMetadata), add(DataHash, long, IdentityMetadata) and/or add(DataHash) can be used to add new input hash to the block signer. Method sign() must be called to get the final signatures.

Method Summary

Modifier and Type	Method and Description
boolean	add(DataHash dataHash) Adds a new hash to the signer.
boolean	add(DataHash dataHash, IdentityMetadata metadata) Adds a new hash and metadata to the signer.
boolean	add(DataHash dataHash, long level, IdentityMetadata metadata) Adds a new hash, level, and metadata to the signer.
T	sign() Creates a block of multiple signatures.

Method Detail

add

boolean add(DataHash dataHash)
     throws KSIException

Adds a new hash to the signer.

Parameters:

dataHash - data hash to be added.

Returns:

True, if the hash was added as a result of the call. If adding given hash exceeds the allowed tree height, no hash is added to signer.

Throws:

KSIException

add

boolean add(DataHash dataHash,
            IdentityMetadata metadata)
     throws KSIException

Adds a new hash and metadata to the signer.

Parameters:

dataHash - data to be added.

metadata - metadata to be added.

Returns:

True, if the hash and metadata were added as a result of the call. If adding given hash and metadata exceeds the allowed tree height, no hash and no metadata is added to signer.

Throws:

KSIException

add

boolean add(DataHash dataHash,
            long level,
            IdentityMetadata metadata)
     throws KSIException

Adds a new hash, level, and metadata to the signer.

Parameters:

dataHash - data hash to be added.

level - level to be added.

metadata - metadata to be added.

Returns:

True, if the hash, level, and metadata were added as a result of the call. If adding given hash and metadata exceeds the allowed tree height, non of the parameters is added to signer.

Throws:

KSIException

sign

T sign()
throws KSIException

Creates a block of multiple signatures. All of the block signer inputs are locally aggregated and aggregation root is signed in GW. For each signer input a signature is created from root signature, and also a hash tree for specific input from locally aggregated hash tree.

Returns:

The block of multiple signatures.

Throws:

KSIException