org.iota.jota.utils

Class Signing

java.lang.Object

org.iota.jota.utils.Signing

public class Signing
extends Object

Constructor Summary

Constructors

Constructor and Description
Signing(ICurl curl)

Method Summary

Modifier and Type	Method and Description
int[]	address(int[] digests) Address generates the address trits from the given digests.
int[]	digest(int[] normalizedBundleFragment, int[] signatureFragment)
int[]	digests(int[] key) Digests hashes each segment of each key fragment 26 times and returns them.
int[]	key(int[] inSeed, int index) Generates the key which is needed as a part of address generation.
int[]	key(int[] inSeed, int index, int security) Generates the key which is needed as a part of address generation.
int[]	normalizedBundle(String bundleHash) Normalizes the given bundle hash, with resulting digits summing to zero.
int[]	signatureFragment(int[] normalizedBundleFragment, int[] keyFragment)
int[]	subseed(int[] inSeed, int index) Returns the sub-seed trits given a seed and an index
Boolean	validateSignatures(Bundle signedBundle, String inputAddress)
Boolean	validateSignatures(String expectedAddress, String[] signatureFragments, String bundleHash)

Methods inherited from class java.lang.Object

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

Constructor Detail

Signing

public Signing(ICurl curl)

Method Detail

subseed

public int[] subseed(int[] inSeed,
                     int index)
              throws ArgumentException

Returns the sub-seed trits given a seed and an index

Parameters:

inSeed - the seed

index - the index

Returns:

the sub-seed

Throws:

ArgumentException

key

public int[] key(int[] inSeed,
                 int index)
          throws ArgumentException

Generates the key which is needed as a part of address generation. Used in digests(int[]) Calculates security based on inSeed length / key length

Parameters:

inSeed - Tryte-encoded seed. It should be noted that this seed is not transferred.

index - Key index for the address

Returns:

The key

Throws:

ArgumentException - is thrown when the specified security level is not valid

ArgumentException - is thrown when inSeed length is not dividable by 3

ArgumentException - is thrown when index is below 1

key

public int[] key(int[] inSeed,
                 int index,
                 int security)
          throws ArgumentException

Generates the key which is needed as a part of address generation. Used in digests(int[])

Parameters:

inSeed - Tryte-encoded seed. It should be noted that this seed is not transferred.

index - Key index for the address

security - Security level to be used for the private key / address. Can be 1, 2 or 3.

Returns:

The key

Throws:

ArgumentException - is thrown when the specified security level is not valid

ArgumentException - is thrown when inSeed length is not dividable by 3

ArgumentException - is thrown when index is below 1

address

public int[] address(int[] digests)

Address generates the address trits from the given digests.

Parameters:

digests - the digests

Returns:

the address trits

digests

public int[] digests(int[] key)
              throws ArgumentException

Digests hashes each segment of each key fragment 26 times and returns them.

Parameters:

key - the key trits

Returns:

the digests

Throws:

ArgumentException - if the security level is invalid

digest

public int[] digest(int[] normalizedBundleFragment,
                    int[] signatureFragment)

Parameters:

normalizedBundleFragment -

signatureFragment -

Returns:

The digest

signatureFragment

public int[] signatureFragment(int[] normalizedBundleFragment,
                               int[] keyFragment)

validateSignatures

public Boolean validateSignatures(Bundle signedBundle,
                                  String inputAddress)

validateSignatures

public Boolean validateSignatures(String expectedAddress,
                                  String[] signatureFragments,
                                  String bundleHash)

normalizedBundle

public int[] normalizedBundle(String bundleHash)

Normalizes the given bundle hash, with resulting digits summing to zero. It returns a slice with the tryte decimal representation without any 13/M values.

Parameters:

bundleHash - the bundle hash

Returns:

the normalized bundle hash in trits