BIP 0382 - Revision history

934: Update BIP text with latest version from https://github.com/bitcoin/bips/blob/ac062dc76d046591/bip-0382.mediawiki

2024-04-22T23:02:12Z

Update BIP text with latest version from https://github.com/bitcoin/bips/blob/ac062dc76d046591/bip-0382.mediawiki

← Older revision		Revision as of 23:02, 22 April 2024
Line 77:		Line 77:
	** <tt>a914bed59fc0024fae941d6e20a3b44a109ae740129287</tt>		** <tt>a914bed59fc0024fae941d6e20a3b44a109ae740129287</tt>
	** <tt>a9148483aa1116eb9c05c482a72bada4b1db24af654387</tt>		** <tt>a9148483aa1116eb9c05c482a72bada4b1db24af654387</tt>
	* <tt>sh(wpkh(~~xpub661MyMwAqRbcFtXgS5sYJABqqG9YLmC4Q1Rdap9gSE8NqtwybGhePY2gZ29ESFjqJoCu1Rupje8YtGqsefD265TMg7usUDFdp6W1EGMcet8~~/10/20/30/40/*h))</tt>		* <tt>sh(wpkh(xprv9s21ZrQH143K3QTDL4LXw2F7HEK3wJUD2nW2nRk4stbPy6cq3jPPqjiChkVvvNKmPGJxWUtg6LnF5kejMRNNU3TGtRBeJgk33yuGBxrMPHi/10/20/30/40/*h))</tt>
	** <tt>a9149a4d9901d6af519b2a23d4a2f51650fcba87ce7b87</tt>		** <tt>a9149a4d9901d6af519b2a23d4a2f51650fcba87ce7b87</tt>
	** <tt>a914bed59fc0024fae941d6e20a3b44a109ae740129287</tt>		** <tt>a914bed59fc0024fae941d6e20a3b44a109ae740129287</tt>

934: Update BIP text with latest version from https://github.com/bitcoin/bips/blob/9692c70eadc193d8/bip-0382.mediawiki

2023-12-14T05:18:31Z

Update BIP text with latest version from https://github.com/bitcoin/bips/blob/9692c70eadc193d8/bip-0382.mediawiki

← Older revision		Revision as of 05:18, 14 December 2023
Line 7:		Line 7:
	Title: Segwit Output Script Descriptors		Title: Segwit Output Script Descriptors
	Author: Pieter Wuille <pieter@wuille.net>		Author: Pieter Wuille <pieter@wuille.net>
	~~Andrew~~ Chow <~~andrew~~@achow101.com>		Ava Chow <me@achow101.com>
	Comments-Summary: No comments yet.		Comments-Summary: No comments yet.
	Comments-URI: https://github.com/bitcoin/bips/wiki/Comments:BIP-0382		Comments-URI: https://github.com/bitcoin/bips/wiki/Comments:BIP-0382

934: Update BIP text with latest version from https://github.com/bitcoin/bips/blob/16707080a55dfd74/bip-0382.mediawiki

2023-06-30T03:17:08Z

Update BIP text with latest version from https://github.com/bitcoin/bips/blob/16707080a55dfd74/bip-0382.mediawiki

@@ Line 61: / Line 61: @@
 ==Test Vectors==
-TBD
+Valid descriptors followed by the scripts they produce. Descriptors involving derived child keys will have the 0th, 1st, and 2nd scripts listed.
 ==Backwards Compatibility==

934: Update BIP text with latest version from https://github.com/bitcoin/bips/blob/4c6389f8431f6778/bip-0382.mediawiki

2021-12-26T13:42:14Z

Update BIP text with latest version from https://github.com/bitcoin/bips/blob/4c6389f8431f6778/bip-0382.mediawiki

← Older revision		Revision as of 13:42, 26 December 2021
Line 69:		Line 69:
	However the scripts produced are standard scripts so existing software are likely to be familiar with them.		However the scripts produced are standard scripts so existing software are likely to be familiar with them.

	==Reference ~~Implemntation~~==		==Reference Implementation==

	<tt>wpkh()</tt>, and <tt>wsh()</tt> descriptors have been implemented in Bitcoin Core since version 0.17.		<tt>wpkh()</tt>, and <tt>wsh()</tt> descriptors have been implemented in Bitcoin Core since version 0.17.

934: Update BIP text with latest version from https://github.com/bitcoin/bips/blob/edffe529056f6dfd/bip-0382.mediawiki

2021-12-15T15:47:29Z

Update BIP text with latest version from https://github.com/bitcoin/bips/blob/edffe529056f6dfd/bip-0382.mediawiki

New page

{{bip}}
{{BipMoved|bip-0382.mediawiki}}

<pre>
BIP: 382
Layer: Applications
Title: Segwit Output Script Descriptors
Author: Pieter Wuille <pieter@wuille.net>
Andrew Chow <andrew@achow101.com>
Comments-Summary: No comments yet.
Comments-URI: https://github.com/bitcoin/bips/wiki/Comments:BIP-0382
Status: Draft
Type: Informational
Created: 2021-06-27
License: BSD-2-Clause
</pre>

==Abstract==

This document specifies <tt>wpkh()</tt>, and <tt>wsh()</tt> output script descriptors.
<tt>wpkh()</tt> descriptors take a key and produces a P2WPKH output script.
<tt>wsh()</tt> descriptors take a script and produces a P2WSH output script.

==Copyright==

This BIP is licensed under the BSD 2-clause license.

==Motivation==

Segregated Witness added 2 additional standard output script formats: P2WPKH and P2WSH.
These expressions allow specifying those formats as a descriptor.

==Specification==

Two new script expressions are defined: <tt>wpkh()</tt>, and <tt>wsh()</tt>.

===<tt>wpkh()</tt>===

The <tt>wpkh(KEY)</tt> expression can be used as a top level expression, or inside of a <tt>sh()</tt> descriptor.
It takes a single key expression as an argument and produces a P2WPKH output script.
Only keys which are/has compressed public keys can be contained in a <tt>wpkh()</tt> expression.

The output script produced is:
<pre>
OP_0 <KEY_hash160>
</pre>

===<tt>wsh()</tt>===

The <tt>wsh(SCRIPT)</tt> expression can be used as a top level expression, or inside of a <tt>sh()</tt> descriptor.
It takes a single script expression as an argument and produces a P2WSH output script.
<tt>wsh()</tt> expressions also create a witnessScript which is required in order to spend outputs which use its output script.
This redeemScript is the output script produced by the <tt>SCRIPT</tt> argument to <tt>wsh()</tt>.
Any key expression found in any script expression contained by a <tt>wsh()</tt> expression must only produce compressed public keys.

The output script produced is:
<pre>
OP_0 <SCRIPT_sha256>
</pre>

==Test Vectors==

TBD

==Backwards Compatibility==

<tt>wpkh()</tt>, and <tt>wsh()</tt> descriptors use the format and general operation specified in [[bip-0380.mediawiki|380]].
As these are a wholly new descriptors, they are not compatible with any implementation.
However the scripts produced are standard scripts so existing software are likely to be familiar with them.

==Reference Implemntation==

<tt>wpkh()</tt>, and <tt>wsh()</tt> descriptors have been implemented in Bitcoin Core since version 0.17.