Enum DescriptorPublicKey

pub enum DescriptorPublicKey {
    Single(SinglePub),
    XPub(DescriptorXKey<Xpub>),
    MultiXPub(DescriptorMultiXKey<Xpub>),
}

The descriptor pubkey, either a single pubkey or an xpub.

Variants

Single(SinglePub)

Single public key.

XPub(DescriptorXKey<Xpub>)

Extended public key (xpub).

MultiXPub(DescriptorMultiXKey<Xpub>)

Multiple extended public keys.

Implementations

impl DescriptorPublicKey

pub fn master_fingerprint(&self) -> Fingerprint

The fingerprint of the master key associated with this key, 0x00000000 if none.

pub fn full_derivation_path(&self) -> Option<DerivationPath>

Full path, from the master key

For wildcard keys this will return the path up to the wildcard, so you can get full paths by appending one additional derivation step, according to the wildcard type (hardened or normal).

For multipath extended keys, this returns None.

pub fn full_derivation_paths(&self) -> Vec<DerivationPath>

Returns a vector containing the full derivation paths from the master key. The vector will contain just one element for single keys, and multiple elements for multipath extended keys.

For wildcard keys this will return the path up to the wildcard, so you can get full paths by appending one additional derivation step, according to the wildcard type (hardened or normal).

pub fn is_deriveable(&self) -> bool

👎Deprecated: use has_wildcard instead

Whether or not the key has a wildcard

pub fn has_wildcard(&self) -> bool

Whether or not the key has a wildcard

pub fn derive( self, index: u32, ) -> Result<DefiniteDescriptorKey, ConversionError>

👎Deprecated: use at_derivation_index instead

Deprecated name for Self::at_derivation_index.

pub fn at_derivation_index( self, index: u32, ) -> Result<DefiniteDescriptorKey, ConversionError>

Replaces any wildcard (i.e. /*) in the key with a particular derivation index, turning it into a definite key (i.e. one where all the derivation paths are set).

Returns

• If this key is not an xpub, returns self.
• If this key is an xpub but does not have a wildcard, returns self.
• Otherwise, returns the xpub at derivation index (removing the wildcard).

Errors

• If index is hardened.

pub fn is_multipath(&self) -> bool

Whether or not this key has multiple derivation paths.

pub fn into_single_keys(self) -> Vec<DescriptorPublicKey>

Get as many keys as derivation paths in this key.

For raw public key and single-path extended keys it will return the key itself. For multipath extended keys it will return a single-path extended key per derivation path.

Trait Implementations

impl Clone for DescriptorPublicKey

fn clone(&self) -> DescriptorPublicKey

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DescriptorPublicKey

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DescriptorPublicKey

fn deserialize<D>( deserializer: D, ) -> Result<DescriptorPublicKey, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for DescriptorPublicKey

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl From<DefiniteDescriptorKey> for DescriptorPublicKey

fn from(d: DefiniteDescriptorKey) -> DescriptorPublicKey

Converts to this type from the input type.

impl FromStr for DescriptorPublicKey

type Err = DescriptorKeyParseError

The associated error which can be returned from parsing.

fn from_str( s: &str, ) -> Result<DescriptorPublicKey, <DescriptorPublicKey as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for DescriptorPublicKey

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IntoAssets for DescriptorPublicKey

fn into_assets(self) -> Assets

Convert self into a Assets struct

impl<Ctx: ScriptContext> IntoDescriptorKey<Ctx> for DescriptorPublicKey

fn into_descriptor_key(self) -> Result<DescriptorKey<Ctx>, KeyError>

Turn the key into a DescriptorKey within the requested ScriptContext

impl MiniscriptKey for DescriptorPublicKey

type Sha256 = Hash

The associated [bitcoin::hashes::sha256::Hash] for this [MiniscriptKey], used in the sha256 fragment.

type Hash256 = Hash

The associated [miniscript::hash256::Hash] for this [MiniscriptKey], used in the hash256 fragment.

type Ripemd160 = Hash

The associated [bitcoin::hashes::ripemd160::Hash] for this [MiniscriptKey] type, used in the ripemd160 fragment.

type Hash160 = Hash

The associated [bitcoin::hashes::hash160::Hash] for this [MiniscriptKey] type, used in the hash160 fragment.

fn is_uncompressed(&self) -> bool

Returns true if the pubkey is uncompressed. Defaults to false.

fn is_x_only_key(&self) -> bool

Returns true if the pubkey is an x-only pubkey. Defaults to false.

fn num_der_paths(&self) -> usize

Returns the number of different derivation paths in this key. Only >1 for keys in BIP389 multipath descriptors.

impl Ord for DescriptorPublicKey

fn cmp(&self, other: &DescriptorPublicKey) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for DescriptorPublicKey

fn eq(&self, other: &DescriptorPublicKey) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for DescriptorPublicKey

fn partial_cmp(&self, other: &DescriptorPublicKey) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for DescriptorPublicKey

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for DescriptorPublicKey

impl StructuralPartialEq for DescriptorPublicKey