Struct Descriptor 

pub struct Descriptor {
    pub n: u8,
    pub path_decl: PathDecl,
    pub use_site_path: UseSitePath,
    pub tree: Node,
    pub tlv: TlvSection,
}

Top-level descriptor parsed/built from a v0.30 wire payload.

Each field corresponds to a spec section: Header (§3.2), origin PathDecl (§3.3), use-site UseSitePath (§3.4), descriptor tree (§3.5–3.6), and trailing tlv section (§3.7).

Fields

n: u8

Number of placeholders (1-indexed key universe size).

path_decl: PathDecl

Origin path declaration (single or per-@N divergent).

use_site_path: UseSitePath

Use-site (post-key) path applied to every key by default.

tree: Node

Descriptor tree root node.

tlv: TlvSection

Trailing TLV section (overrides, fingerprints, etc.).

Implementations

impl Descriptor

pub fn derive_address( &self, chain: u32, index: u32, network: Network, ) -> Result<Address<NetworkUnchecked>, Error>

Derive the address at (chain, index) for this descriptor on network.

chain selects the use-site multipath alternative (e.g. 0 = receive, 1 = change for the standard <0;1>/* form). index is the trailing wildcard child number.

Returns an Address<NetworkUnchecked>; callers can .assume_checked() (when they trust the network parameter) or .require_network(network) to lock it down.

Errors

• Error::MissingPubkey when any @N lacks an xpub.
• Error::InvalidXpubBytes when an xpub’s 33-byte pubkey field doesn’t parse as a valid secp256k1 point.
• Error::ChainIndexOutOfRange when chain is out of range for the use-site multipath.
• Error::HardenedPublicDerivation when the use-site path requires a hardened derivation step.
• Error::MissingExplicitOrigin propagated from crate::canonicalize::expand_per_at_n.
• Error::AddressDerivationFailed for any miniscript-layer failure (type check, context error, unsupported fragment).

impl Descriptor

pub fn key_index_width(&self) -> u8

Bit width for placeholder-index encoding: ⌈log₂(n)⌉ per SPEC v0.30 §7.

Index range is 0..n. The NUMS H-point is signalled by an explicit is_nums bit on Body::Tr (SPEC §7), not by a reserved sentinel. MUST stay in lockstep with decode::decode_payload’s independent computation; a stale formula would silently desync the bitstream.

pub fn is_wallet_policy(&self) -> bool

Returns true iff this descriptor is in wallet-policy mode per SPEC §3.3: the Pubkeys TLV is present and contains at least one entry. Template-only mode (no Pubkeys TLV at all, or Pubkeys = Some(vec![]) after sparse-decode) returns false.

The check is a post-TLV-decode predicate; mode dispatch never reads a header bit.

Trait Implementations

impl Clone for Descriptor

fn clone(&self) -> Descriptor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Descriptor

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

Formats the value using the given formatter.

impl PartialEq for Descriptor

fn eq(&self, other: &Descriptor) -> 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 Eq for Descriptor

impl StructuralPartialEq for Descriptor