io.digitalbits.sdk

Class KeyPair

java.lang.Object

io.digitalbits.sdk.KeyPair

public class KeyPair
extends java.lang.Object

Holds a DigitalBits keypair.

Constructor Summary

Constructors

Constructor and Description
KeyPair(EdDSAPublicKey publicKey) Creates a new KeyPair without a private key.
KeyPair(EdDSAPublicKey publicKey, EdDSAPrivateKey privateKey) Creates a new KeyPair from the given public and private keys.

Method Summary

Modifier and Type	Method and Description
boolean	canSign() Returns true if this Keypair is capable of signing
boolean	equals(java.lang.Object obj)
static KeyPair	fromAccountId(java.lang.String accountId) Creates a new DigitalBits KeyPair from a strkey encoded DigitalBits account ID.
static KeyPair	fromPublicKey(byte[] publicKey) Creates a new DigitalBits keypair from a 32 byte address.
static KeyPair	fromSecretSeed(byte[] seed) Creates a new DigitalBits keypair from a raw 32 byte secret seed.
static KeyPair	fromSecretSeed(char[] seed) Creates a new DigitalBits KeyPair from a strkey encoded DigitalBits secret seed.
static KeyPair	fromSecretSeed(java.lang.String seed) Insecure Creates a new DigitalBits KeyPair from a strkey encoded DigitalBits secret seed.
static KeyPair	fromXdrPublicKey(io.digitalbits.sdk.xdr.PublicKey key)
static KeyPair	fromXdrSignerKey(io.digitalbits.sdk.xdr.SignerKey key)
java.lang.String	getAccountId() Returns the human readable account ID encoded in strkey.
byte[]	getPublicKey()
char[]	getSecretSeed() Returns the human readable secret seed encoded in strkey.
io.digitalbits.sdk.xdr.SignatureHint	getSignatureHint()
io.digitalbits.sdk.xdr.PublicKey	getXdrPublicKey()
io.digitalbits.sdk.xdr.SignerKey	getXdrSignerKey()
static KeyPair	random() Generates a random DigitalBits keypair.
byte[]	sign(byte[] data) Sign the provided data with the keypair's private key.
io.digitalbits.sdk.xdr.DecoratedSignature	signDecorated(byte[] data) Sign the provided data with the keypair's private key and returns DecoratedSignature.
boolean	verify(byte[] data, byte[] signature) Verify the provided data and signature match this keypair's public key.

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

KeyPair

public KeyPair(EdDSAPublicKey publicKey)

Creates a new KeyPair without a private key. Useful to simply verify a signature from a given public address.

Parameters:

publicKey -

KeyPair

public KeyPair(EdDSAPublicKey publicKey,
               EdDSAPrivateKey privateKey)

Creates a new KeyPair from the given public and private keys.

Parameters:

publicKey -

privateKey -

Method Detail

canSign

public boolean canSign()

Returns true if this Keypair is capable of signing

fromSecretSeed

public static KeyPair fromSecretSeed(char[] seed)

Creates a new DigitalBits KeyPair from a strkey encoded DigitalBits secret seed.

Parameters:

seed - Char array containing strkey encoded DigitalBits secret seed.

Returns:

KeyPair

fromSecretSeed

public static KeyPair fromSecretSeed(java.lang.String seed)

Insecure Creates a new DigitalBits KeyPair from a strkey encoded DigitalBits secret seed. This method is insecure. Use only if you are aware of security implications.

Parameters:

seed - The strkey encoded DigitalBits secret seed.

Returns:

KeyPair

See Also:

Using Password-Based Encryption

fromSecretSeed

public static KeyPair fromSecretSeed(byte[] seed)

Creates a new DigitalBits keypair from a raw 32 byte secret seed.

Parameters:

seed - The 32 byte secret seed.

Returns:

KeyPair

fromAccountId

public static KeyPair fromAccountId(java.lang.String accountId)

Creates a new DigitalBits KeyPair from a strkey encoded DigitalBits account ID.

Parameters:

accountId - The strkey encoded DigitalBits account ID.

Returns:

KeyPair

fromPublicKey

public static KeyPair fromPublicKey(byte[] publicKey)

Creates a new DigitalBits keypair from a 32 byte address.

Parameters:

publicKey - The 32 byte public key.

Returns:

KeyPair

random

public static KeyPair random()

Generates a random DigitalBits keypair.

Returns:

a random DigitalBits keypair.

getAccountId

public java.lang.String getAccountId()

Returns the human readable account ID encoded in strkey.

getSecretSeed

public char[] getSecretSeed()

Returns the human readable secret seed encoded in strkey.

getPublicKey

public byte[] getPublicKey()

getSignatureHint

public io.digitalbits.sdk.xdr.SignatureHint getSignatureHint()

getXdrPublicKey

public io.digitalbits.sdk.xdr.PublicKey getXdrPublicKey()

getXdrSignerKey

public io.digitalbits.sdk.xdr.SignerKey getXdrSignerKey()

fromXdrPublicKey

public static KeyPair fromXdrPublicKey(io.digitalbits.sdk.xdr.PublicKey key)

fromXdrSignerKey

public static KeyPair fromXdrSignerKey(io.digitalbits.sdk.xdr.SignerKey key)

sign

public byte[] sign(byte[] data)

Sign the provided data with the keypair's private key.

Parameters:

data - The data to sign.

Returns:

signed bytes, null if the private key for this keypair is null.

signDecorated

public io.digitalbits.sdk.xdr.DecoratedSignature signDecorated(byte[] data)

Sign the provided data with the keypair's private key and returns DecoratedSignature.

Parameters:

data -

verify

public boolean verify(byte[] data,
                      byte[] signature)

Verify the provided data and signature match this keypair's public key.

Parameters:

data - The data that was signed.

signature - The signature.

Returns:

True if they match, false otherwise.

Throws:

java.lang.RuntimeException

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object