com.klaytn.caver.wallet.keyring

Class MultipleKeyring

java.lang.Object

com.klaytn.caver.wallet.keyring.AbstractKeyring

com.klaytn.caver.wallet.keyring.MultipleKeyring

public class MultipleKeyring
extends AbstractKeyring

Representing a Keyring which includes "address" and "private keys array"

Constructor Summary

Constructors

Constructor and Description
MultipleKeyring(java.lang.String address, PrivateKey[] keys) Creates a MultipleKeyring instance.

Method Summary

Modifier and Type	Method and Description
AbstractKeyring	copy() Returns a copied MultipleKeyring instance.
KeyStore	encrypt(java.lang.String password, KeyStoreOption options) Encrypts a keyring and returns a KeyStore.(according to KeyStore V4)
PrivateKey[]	getKeyByRole(int role) Returns keys by role.
PrivateKey[]	getKeys() Getter function of keys
java.lang.String[]	getPublicKey() Returns a public key strings.
java.lang.String[]	getPublicKey(boolean compressed) Returns a public key strings.
java.util.List<SignatureData>	sign(java.lang.String txHash, int chainId, int role) Signs a transaction hash with all keys in specific role group and return signature list.
SignatureData	sign(java.lang.String txHash, int chainId, int role, int index) Signs a transaction hash with key in specific role group and return signature.
MessageSigned	signMessage(java.lang.String message, int role) Signs a hashed data with all key in specific role group and return MessageSigned instance.
MessageSigned	signMessage(java.lang.String message, int role, int index) Signs a hashed data with key in specific role group and return MessageSigned instance.
Account	toAccount() Returns an instance of Account
Account	toAccount(WeightedMultiSigOptions options) Returns an instance of Account

Methods inherited from class com.klaytn.caver.wallet.keyring.AbstractKeyring

encrypt, encryptV3, encryptV3, getAddress, getKlaytnWalletKey, isDecoupled, sign, sign

Methods inherited from class java.lang.Object

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

Constructor Detail

MultipleKeyring

public MultipleKeyring(java.lang.String address,
                       PrivateKey[] keys)

Creates a MultipleKeyring instance.

Parameters:

address - The address of keyring.

keys - The keys to use in MultipleKeyring.

Method Detail

sign

public java.util.List<SignatureData> sign(java.lang.String txHash,
                                          int chainId,
                                          int role)

Signs a transaction hash with all keys in specific role group and return signature list.

Specified by:

sign in class AbstractKeyring

Parameters:

txHash - The hash of transaction.

chainId - The chainId specific to the network.

role - A number indicating the role of the key.

Returns:

List

sign

public SignatureData sign(java.lang.String txHash,
                          int chainId,
                          int role,
                          int index)

Signs a transaction hash with key in specific role group and return signature.

Specified by:

sign in class AbstractKeyring

Parameters:

txHash - The hash of transaction.

chainId - The chainId specific to the network.

role - A number indicating the role of the key.

index - The index of the key to be used in the specific role group.

Returns:

SignatureData

signMessage

public MessageSigned signMessage(java.lang.String message,
                                 int role)

Signs a hashed data with all key in specific role group and return MessageSigned instance.

Specified by:

signMessage in class AbstractKeyring

Parameters:

message - The data string to sign

role - A number indicating the role of the key

Returns:

MessageSigned

signMessage

public MessageSigned signMessage(java.lang.String message,
                                 int role,
                                 int index)

Signs a hashed data with key in specific role group and return MessageSigned instance.

Specified by:

signMessage in class AbstractKeyring

Parameters:

message - The data string to sign

role - A number indicating the role of the key

index - The index of the key to be used in the specific role group

Returns:

MessageSigned

encrypt

public KeyStore encrypt(java.lang.String password,
                        KeyStoreOption options)
                 throws org.web3j.crypto.CipherException

Encrypts a keyring and returns a KeyStore.(according to KeyStore V4)

Specified by:

encrypt in class AbstractKeyring

Parameters:

password - The password to be used for encryption. The encrypted in KeyStore can be decrypted with this password.

options - The options to use when encrypt a keyring.

Returns:

KeyStore

Throws:

org.web3j.crypto.CipherException

copy

public AbstractKeyring copy()

Returns a copied MultipleKeyring instance.

Specified by:

copy in class AbstractKeyring

Returns:

Keyring

getPublicKey

public java.lang.String[] getPublicKey()

Returns a public key strings.

It returns a public key as a uncompressed format.

Returns:

String array

getPublicKey

public java.lang.String[] getPublicKey(boolean compressed)

Returns a public key strings.

Parameters:

compressed - Whether in compressed format or not.

Returns:

String array

getKeyByRole

public PrivateKey[] getKeyByRole(int role)

Returns keys by role. If the key of the role passed as parameter is empty, the default key is returned.

Parameters:

role - A number indicating the role of the key. You can use `AccountRoleBased.RoleGroup`.

Returns:

PrivateKey Array

toAccount

public Account toAccount()

Returns an instance of Account

Returns:

Account

toAccount

public Account toAccount(WeightedMultiSigOptions options)

Returns an instance of Account

Parameters:

options - The options that includes 'threshold' and 'weight'. This is only necessary when keyring use multiple private keys.

Returns:

Account

getKeys

public PrivateKey[] getKeys()

Getter function of keys

Returns:

PrivateKey Array