diff --git a/README.mediawiki b/README.mediawiki index c6a275ec..f5c35dd5 100644 --- a/README.mediawiki +++ b/README.mediawiki @@ -1078,6 +1078,13 @@ Those proposing changes should consider that ultimately consent may rest with th | Pieter Wuille, Andrew Chow | Informational | Draft +|- +| [[bip-0384.mediawiki|384]] +| Applications +| combo() Output Script Descriptors +| Pieter Wuille, Andrew Chow +| Informational +| Draft |} diff --git a/bip-0380.mediawiki b/bip-0380.mediawiki index 76fb721c..3e483272 100644 --- a/bip-0380.mediawiki +++ b/bip-0380.mediawiki @@ -258,4 +258,7 @@ This Table lists all available Script expressions and the BIPs specifying them. |- | sortedmulti(NUM, KEY, ..., KEY) | [[bip-0383.mediawiki|383]] +|- +| combo(KEY) +| [[bip-0384.mediawiki|384]] |} diff --git a/bip-0384.mediawiki b/bip-0384.mediawiki new file mode 100644 index 00000000..da7cb236 --- /dev/null +++ b/bip-0384.mediawiki @@ -0,0 +1,48 @@ +
+ BIP: 384 + Layer: Applications + Title: combo() Output Script Descriptors + Author: Pieter Wuille+ +==Abstract== + +This document specifies combo() output script descriptors. +These take a key and produce P2PK, P2PKH, P2WPKH, and P2SH-P2WPKH output scripts if applicable to the key. + +==Copyright== + +This BIP is licensed under the BSD 2-clause license. + +==Motivation== + +In order to make the transition from traditional key based wallets to descriptor based wallets easier, it is useful to be able to take a key and produce the scripts which have traditionally been produced by wallet software. + +==Specification== + +A new top level script expression is defined: combo(KEY). +This expression can only be used as a top level expression. +It takes a single key expression as an argument and produces either 2 or 4 output scripts, depending on the key. +A combo() expression always produces a P2PK and P2PKH script, the same as putting the key in both a pk() and a pkh() expression. +If the key is/has a compressed public key, then P2WPKH and P2SH-P2WPKH scripts are also produced, the same as putting the key in both a wpkh() and sh(wpkh()) expression. + +==Test Vectors== + +TBD + +==Backwards Compatibility== + +combo() descriptors use the format and general operation specified in [[bip-0380.mediawiki|380]]. +As this is a wholly new descriptor, it is not compatible with any implementation. +However the scripts produced are standard scripts so existing software are likely to be familiar with them. + +==Reference Implemntation== + +combo descriptors have been implemented in Bitcoin Core since version 0.17.+ Andrew Chow + Comments-Summary: No comments yet. + Comments-URI: https://github.com/bitcoin/bips/wiki/Comments:BIP-0384 + Status: Draft + Type: Informational + Created: 2021-06-27 + License: BSD-2-Clause +