Changeset View
Changeset View
Standalone View
Standalone View
src/script/descriptor.h
| Show All 16 Lines | |||||
| // Descriptors may be ranged, which occurs when the public keys inside are | // Descriptors may be ranged, which occurs when the public keys inside are | ||||
| // specified in the form of HD chains (xpubs). | // specified in the form of HD chains (xpubs). | ||||
| // | // | ||||
| // Descriptors always represent public information - public keys and scripts - | // Descriptors always represent public information - public keys and scripts - | ||||
| // but in cases where private keys need to be conveyed along with a descriptor, | // but in cases where private keys need to be conveyed along with a descriptor, | ||||
| // they can be included inside by changing public keys to private keys (WIF | // they can be included inside by changing public keys to private keys (WIF | ||||
| // format), and changing xpubs by xprvs. | // format), and changing xpubs by xprvs. | ||||
| // | // | ||||
| // 1. Examples | // Reference documentation about the descriptor language can be found in | ||||
| // | // doc/descriptors.md. | ||||
| // A P2PK descriptor with a fixed public key: | |||||
| // - pk(0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798) | |||||
| // | |||||
| // A P2SH-P2PKH descriptor with a fixed public key: | |||||
| // - | |||||
| // sh(pkh(02e493dbf1c10d80f3581e4904930b1404cc6c13900ee0758474fa94abe8c4cd13)) | |||||
| // | |||||
| // A bare 1-of-2 multisig descriptor: | |||||
| // - | |||||
| // multi(1,022f8bde4d1a07209355b4a7250a5c5128e88b84bddc619ab7cba8d569b240efe4,025cbdf0646e5db4eaa398f365f2ea7a0e3d419b7e0330e39ce92bddedcac4f9bc) | |||||
| // | |||||
| // A chain of P2PKH outputs (this needs the corresponding private key to | |||||
| // derive): | |||||
| // - | |||||
| // pkh(xpub68Gmy5EdvgibQVfPdqkBBCHxA5htiqg55crXYuXoQRKfDBFA1WEjWgP6LHhwBZeNK1VTsfTFUHCdrfp1bgwQ9xv5ski8PX9rL2dZXvgGDnw/1'/2/*) | |||||
| // | |||||
| // 2. Grammar description: | |||||
| // | |||||
| // X: xpub or xprv encoded extended key | |||||
| // I: decimal encoded integer | |||||
| // H: Hex encoded byte array | |||||
| // A: Address in P2PKH, or P2SH encoding | |||||
| // | |||||
| // S (Scripts): | |||||
| // * pk(P): Pay-to-pubkey (P2PK) output for public key P. | |||||
| // * pkh(P): Pay-to-pubkey-hash (P2PKH) output for public key P. | |||||
| // * sh(S): Pay-to-script-hash (P2SH) output for script S | |||||
| // * combo(P): combination of P2PK, P2PKH for public key P. | |||||
| // * multi(I,L): k-of-n multisig for given public keys | |||||
| // * addr(A): Output to address | |||||
| // * raw(H): scriptPubKey with raw bytes | |||||
| // | |||||
| // P (Public keys): | |||||
| // * H: fixed public key (or WIF-encoded private key) | |||||
| // * E: extended public key | |||||
| // * E/*: (ranged) all unhardened direct children of an extended public key | |||||
| // * E/*': (ranged) all hardened direct children of an extended public key | |||||
| // | |||||
| // L (Comma-separated lists of public keys): | |||||
| // * P | |||||
| // * L,P | |||||
| // | |||||
| // E (Extended public keys): | |||||
| // * X | |||||
| // * E/I: unhardened child | |||||
| // * E/I': hardened child | |||||
| // * E/Ih: hardened child (alternative notation) | |||||
| // | |||||
| // The top level is S. | |||||
| /** Interface for parsed descriptor objects. */ | /** Interface for parsed descriptor objects. */ | ||||
| struct Descriptor { | struct Descriptor { | ||||
| virtual ~Descriptor() = default; | virtual ~Descriptor() = default; | ||||
| /** Whether the expansion of this descriptor depends on the position. */ | /** Whether the expansion of this descriptor depends on the position. */ | ||||
| virtual bool IsRange() const = 0; | virtual bool IsRange() const = 0; | ||||
| Show All 34 Lines | |||||