NAME
Bitcoin::Crypto::Key::ExtPublic - class for Bitcoin extended public keys
SYNOPSIS
use Bitcoin::Crypto::Key::ExtPrivate;
my $mnemonic = Bitcoin::Crypto::Key::ExtPrivate->generate_mnemonic;
my $key = Bitcoin::Crypto::Key::ExtPrivate->from_mnemonic($mnemonic);
# derive child public key
my $path = "M/0";
my $child_key = $key->derive_key($path);
my $ser_child_key = $child_key->to_serialized_base58;
print "Your exported $path child key is: $ser_child_key";
# create basic public key
my $basic_public = $child_key->get_basic_key;DESCRIPTION
This class allows you to create an extended public key instance.
You can use an extended public key to:
derive extended keys using a path (only public keys)
restore keys from serialized base58 format
see Bitcoin::Crypto::Network if you want to work with other networks than Bitcoin Mainnet.
METHODS
to_serialized
sig: to_serialized($self)Returns the key serialized in format specified in BIP32 as byte string.
to_serialized_base58
sig: to_serialized_base58($self)Behaves the same as to_serialized(), but performs Base58Check encoding on the resulting byte string.
from_serialized
sig: from_serialized($class, $serialized, $network = undef)Tries to unserialize byte string $serialized with format specified in BIP32.
Dies on errors. If multiple networks match serialized data specify $network manually (id of the network) to avoid exception.
from_serialized_base58
sig: from_serialized_base58($class, $base58, $network = undef)Same as from_serialized, but performs Base58Check decoding on $base58 argument.
set_network
sig: set_network($self, $val)Change key's network state to $val. It can be either network name present in Bitcoin::Crypto::Network package or an instance of this class.
Returns current key instance.
get_basic_key
sig: get_basic_key($self)Returns the key in basic format: Bitcoin::Crypto::Key::Public
derive_key
sig: derive_key($self, $path)Performs extended key deriviation as specified in BIP32 on the current key with $path. Dies on error.
See BIP32 document for details on deriviation paths and methods.
Note that public keys cannot derive private keys and your deriviation path must start with M (capital m).
Returns a new extended key instance - result of a deriviation.
get_fingerprint
sig: get_fingerprint($self, $len = 4)Returns a fingerprint of the extended key of $len length (byte string)
EXCEPTIONS
This module throws an instance of Bitcoin::Crypto::Exception if it encounters an error. It can produce the following error types from the Bitcoin::Crypto::Exception namespace:
KeyDerive - key couldn't be derived correctly
KeyCreate - key couldn't be created correctly
NetworkConfig - incomplete or corrupted network configuration