com.safenetinc.luna.provider.keygen

Class LunaKeyPairDerivationBIP32Master

java.lang.Object

java.security.KeyPairGeneratorSpi

com.safenetinc.luna.provider.keygen.LunaKeyPairDerivationBIP32Master

public class LunaKeyPairDerivationBIP32Master
extends java.security.KeyPairGeneratorSpi

Specify the mechanism and operations to derive a Hierarchical Deterministic master KeyPair.

Field Summary

Fields

Modifier and Type	Field and Description
protected LunaPkcs11Attributes	attributes
protected LunaKey	baseKey Base key from which to derive a KeyPair.
protected static java.util.logging.Logger	LOGGER
protected LunaNamedCurve	mCurve Bip32 curve is "secp256k1"
protected long	mechType Specifies either master or child KeyPair to be derived.
protected int[]	path An integer array containing the key derivation path elements.

Constructor Summary

Constructors

Constructor and Description
LunaKeyPairDerivationBIP32Master()

Method Summary

Methods

Modifier and Type	Method and Description
protected int[]	convertPath(java.lang.String pathStr) Convert the BIP32 key path to an integer array for passing to the HSM.
java.security.KeyPair	generateKeyPair() Derive the KeyPair.
void	initialize(java.security.spec.AlgorithmParameterSpec params, java.security.SecureRandom random) Initialize the BIP32 key derivation operation based on the supplied LunaBIP32ParameterSpec.
void	initialize(int i, java.security.SecureRandom secureRandom) Not implemented.

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

protected static final java.util.logging.Logger LOGGER

mCurve

protected LunaNamedCurve mCurve

Bip32 curve is "secp256k1"

mechType

protected long mechType

Specifies either master or child KeyPair to be derived.

baseKey

protected LunaKey baseKey

Base key from which to derive a KeyPair. Can be a seed from which to derive the master KeyPair or a public or private key from which to derive a child KeyPair.

path

protected int[] path

An integer array containing the key derivation path elements. Bits to specify hardened or normal keys will be enabled.

attributes

protected LunaPkcs11Attributes attributes

Constructor Detail

LunaKeyPairDerivationBIP32Master

public LunaKeyPairDerivationBIP32Master()

Method Detail

convertPath

protected int[] convertPath(java.lang.String pathStr)

Convert the BIP32 key path to an integer array for passing to the HSM.

Note: The path MUST be specified using the notation in the BIP44 specification: https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki#path-levels

Example: "m/12'/34'/56/78"

Observe:

Path elements ending with an apostrophe "'" will be created as hardened keys. A leading "m" is decorative only.

Parameters:

pathStr - the string representation of the path

Returns:

an array containing the integer values for each path element

initialize

public void initialize(java.security.spec.AlgorithmParameterSpec params,
              java.security.SecureRandom random)
                throws java.security.InvalidAlgorithmParameterException

Initialize the BIP32 key derivation operation based on the supplied LunaBIP32ParameterSpec.

Overrides:

initialize in class java.security.KeyPairGeneratorSpi

Parameters:

params - an instance of a LunaBIP32ParameterSpec

random - unused

Throws:

java.security.InvalidAlgorithmParameterException - If the parameterspec is not a LunaBIP32ParameterSpec

java.security.InvalidParameterException - If base key is unspecified

initialize

public void initialize(int i,
              java.security.SecureRandom secureRandom)

Not implemented.

Specified by:

initialize in class java.security.KeyPairGeneratorSpi

generateKeyPair

public java.security.KeyPair generateKeyPair()

Derive the KeyPair.

Specified by:

generateKeyPair in class java.security.KeyPairGeneratorSpi

Returns:

A KeyPair object containing the public and private keys.