2021-06-28 00:49:37 +02:00
|
|
|
<pre>
|
|
|
|
|
BIP: 381
|
|
|
|
|
Layer: Applications
|
|
|
|
|
Title: Non-Segwit Output Script Descriptors
|
|
|
|
|
Author: Pieter Wuille <pieter@wuille.net>
|
2023-12-13 17:12:08 +01:00
|
|
|
Ava Chow <me@achow101.com>
|
2021-06-28 00:49:37 +02:00
|
|
|
Comments-Summary: No comments yet.
|
|
|
|
|
Comments-URI: https://github.com/bitcoin/bips/wiki/Comments:BIP-0381
|
2024-07-11 01:02:19 +02:00
|
|
|
Status: Final
|
2021-06-28 00:49:37 +02:00
|
|
|
Type: Informational
|
|
|
|
|
Created: 2021-06-27
|
|
|
|
|
License: BSD-2-Clause
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
==Abstract==
|
|
|
|
|
|
|
|
|
|
This document specifies <tt>pk()</tt>, <tt>pkh()</tt>, and <tt>sh()</tt> output script descriptors.
|
|
|
|
|
<tt>pk()</tt> descriptors take a key and produces a P2PK output script.
|
|
|
|
|
<tt>pkh()</tt> descriptors take a key and produces a P2PKH output script.
|
|
|
|
|
<tt>sh()</tt> descriptors take a script and produces a P2SH output script.
|
|
|
|
|
|
|
|
|
|
==Copyright==
|
|
|
|
|
|
|
|
|
|
This BIP is licensed under the BSD 2-clause license.
|
|
|
|
|
|
|
|
|
|
==Motivation==
|
|
|
|
|
|
|
|
|
|
Prior to the activation of Segregated Witness, there were 3 main standard output script formats: P2PK, P2PKH, and P2SH.
|
|
|
|
|
These expressions allow specifying those formats as a descriptor.
|
|
|
|
|
|
|
|
|
|
==Specification==
|
|
|
|
|
|
|
|
|
|
Three new script expressions are defined: <tt>pk()</tt>, <tt>pkh()</tt>, and <tt>sh()</tt>.
|
|
|
|
|
|
|
|
|
|
===<tt>pk()</tt>===
|
|
|
|
|
|
|
|
|
|
The <tt>pk(KEY)</tt> expression can be used in any context or level of a descriptor.
|
|
|
|
|
It takes a single key expression as an argument and produces a P2PK output script.
|
|
|
|
|
Depending on the higher level descriptors, there may be restrictions on the type of public keys that can be included.
|
|
|
|
|
Such restrictions will be specified by those descriptors.
|
|
|
|
|
|
|
|
|
|
The output script produced is:
|
|
|
|
|
<pre>
|
|
|
|
|
<KEY> OP_CHECKSIG
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
===<tt>pkh()</tt>===
|
|
|
|
|
|
2021-06-28 01:35:45 +02:00
|
|
|
The <tt>pkh(KEY)</tt> expression can be used as a top level expression, or inside of either a <tt>sh()</tt> or <tt>wsh()</tt> descriptor.
|
2021-06-28 00:49:37 +02:00
|
|
|
It takes a single key expression as an argument and produces a P2PKH output script.
|
|
|
|
|
Depending on the higher level descriptors, there may be restrictions on the type of public keys that can be included.
|
|
|
|
|
Such restrictions will be specified by those descriptors.
|
|
|
|
|
|
|
|
|
|
The output script produced is:
|
|
|
|
|
<pre>
|
|
|
|
|
OP_DUP OP_HASH160 <KEY_hash160> OP_EQUALVERIFY OP_CHECKSIG
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
===<tt>sh()</tt>===
|
|
|
|
|
|
|
|
|
|
The <tt>sh(SCRIPT)</tt> expression can only be used as a top level expression.
|
|
|
|
|
It takes a single script expression as an argument and produces a P2SH output script.
|
|
|
|
|
<tt>sh()</tt> expressions also create a redeemScript 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>sh()</tt>.
|
|
|
|
|
|
|
|
|
|
The output script produced is:
|
|
|
|
|
<pre>
|
|
|
|
|
OP_HASH160 <SCRIPT_hash160> OP_EQUAL
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
==Test Vectors==
|
|
|
|
|
|
2023-06-29 22:15:14 +02:00
|
|
|
Valid descriptors followed by the scripts they produce. Descriptors involving derived child keys will have the 0th, 1st, and 2nd scripts listed.
|
|
|
|
|
|
|
|
|
|
* <tt>pk(L4rK1yDtCWekvXuE6oXD9jCYfFNV2cWRpVuPLBcCU2z8TrisoyY1)</tt>
|
|
|
|
|
** <tt>2103a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bdac</tt>
|
|
|
|
|
* <tt>pk(03a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd)</tt>
|
|
|
|
|
** <tt>2103a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bdac</tt>
|
|
|
|
|
* <tt>pkh([deadbeef/1/2'/3/4']L4rK1yDtCWekvXuE6oXD9jCYfFNV2cWRpVuPLBcCU2z8TrisoyY1)</tt>
|
|
|
|
|
** <tt>76a9149a1c78a507689f6f54b847ad1cef1e614ee23f1e88ac</tt>
|
|
|
|
|
* <tt>pkh([deadbeef/1/2'/3/4']03a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd)</tt>
|
|
|
|
|
** <tt>76a9149a1c78a507689f6f54b847ad1cef1e614ee23f1e88ac</tt>
|
|
|
|
|
* <tt>pkh([deadbeef/1/2h/3/4h]03a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd)</tt>
|
|
|
|
|
** <tt>76a9149a1c78a507689f6f54b847ad1cef1e614ee23f1e88ac</tt>
|
|
|
|
|
* <tt>pk(5KYZdUEo39z3FPrtuX2QbbwGnNP5zTd7yyr2SC1j299sBCnWjss)</tt>
|
|
|
|
|
** <tt>4104a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd5b8dec5235a0fa8722476c7709c02559e3aa73aa03918ba2d492eea75abea235ac</tt>
|
|
|
|
|
* <tt>pk(04a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd5b8dec5235a0fa8722476c7709c02559e3aa73aa03918ba2d492eea75abea235)</tt>
|
|
|
|
|
** <tt>4104a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd5b8dec5235a0fa8722476c7709c02559e3aa73aa03918ba2d492eea75abea235ac</tt>
|
|
|
|
|
* <tt>pkh(5KYZdUEo39z3FPrtuX2QbbwGnNP5zTd7yyr2SC1j299sBCnWjss)</tt>
|
|
|
|
|
** <tt>76a914b5bd079c4d57cc7fc28ecf8213a6b791625b818388ac</tt>
|
|
|
|
|
* <tt>pkh(04a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd5b8dec5235a0fa8722476c7709c02559e3aa73aa03918ba2d492eea75abea235)</tt>
|
|
|
|
|
** <tt>76a914b5bd079c4d57cc7fc28ecf8213a6b791625b818388ac</tt>
|
|
|
|
|
* <tt>sh(pk(L4rK1yDtCWekvXuE6oXD9jCYfFNV2cWRpVuPLBcCU2z8TrisoyY1))</tt>
|
|
|
|
|
** <tt>a9141857af51a5e516552b3086430fd8ce55f7c1a52487</tt>
|
|
|
|
|
* <tt>sh(pk(03a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd))</tt>
|
|
|
|
|
** <tt>a9141857af51a5e516552b3086430fd8ce55f7c1a52487</tt>
|
|
|
|
|
* <tt>sh(pkh(L4rK1yDtCWekvXuE6oXD9jCYfFNV2cWRpVuPLBcCU2z8TrisoyY1))</tt>
|
|
|
|
|
** <tt>a9141a31ad23bf49c247dd531a623c2ef57da3c400c587</tt>
|
|
|
|
|
* <tt>sh(pkh(03a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd))</tt>
|
|
|
|
|
** <tt>a9141a31ad23bf49c247dd531a623c2ef57da3c400c587</tt>
|
|
|
|
|
* <tt>pkh(xprv9s21ZrQH143K31xYSDQpPDxsXRTUcvj2iNHm5NUtrGiGG5e2DtALGdso3pGz6ssrdK4PFmM8NSpSBHNqPqm55Qn3LqFtT2emdEXVYsCzC2U/2147483647'/0)</tt>
|
|
|
|
|
** <tt>76a914ebdc90806a9c4356c1c88e42216611e1cb4c1c1788ac</tt>
|
|
|
|
|
* <tt>pkh([bd16bee5/2147483647h]xpub69H7F5dQzmVd3vPuLKtcXJziMEQByuDidnX3YdwgtNsecY5HRGtAAQC5mXTt4dsv9RzyjgDjAQs9VGVV6ydYCHnprc9vvaA5YtqWyL6hyds/0)</tt>
|
|
|
|
|
** <tt>76a914ebdc90806a9c4356c1c88e42216611e1cb4c1c1788ac</tt>
|
|
|
|
|
* <tt>pk(xprv9uPDJpEQgRQfDcW7BkF7eTya6RPxXeJCqCJGHuCJ4GiRVLzkTXBAJMu2qaMWPrS7AANYqdq6vcBcBUdJCVVFceUvJFjaPdGZ2y9WACViL4L/0)</tt>
|
|
|
|
|
** <tt>210379e45b3cf75f9c5f9befd8e9506fb962f6a9d185ac87001ec44a8d3df8d4a9e3ac</tt>
|
|
|
|
|
* <tt>pk(xpub68NZiKmJWnxxS6aaHmn81bvJeTESw724CRDs6HbuccFQN9Ku14VQrADWgqbhhTHBaohPX4CjNLf9fq9MYo6oDaPPLPxSb7gwQN3ih19Zm4Y/0)</tt>
|
|
|
|
|
** <tt>210379e45b3cf75f9c5f9befd8e9506fb962f6a9d185ac87001ec44a8d3df8d4a9e3ac</tt>
|
|
|
|
|
|
|
|
|
|
Invalid descriptors
|
|
|
|
|
|
|
|
|
|
* <tt>pk()</tt> only accepts key expressions: <tt>pk(pk(03a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd))</tt>
|
|
|
|
|
* <tt>pkh()</tt> only accepts key expressions: <tt>pkh(pk(03a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd))</tt>
|
|
|
|
|
* <tt>sh()</tt> only acceps script expressions: <tt>sh(03a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd)</tt>
|
|
|
|
|
* <tt>sh()</tt> is top level only: <tt>sh(sh(pkh(03a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd)))</tt>
|
2021-06-28 00:49:37 +02:00
|
|
|
|
|
|
|
|
==Backwards Compatibility==
|
|
|
|
|
|
|
|
|
|
<tt>pk()</tt>, <tt>pkh()</tt>, and <tt>sh()</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.
|
|
|
|
|
|
2021-09-15 14:21:09 +02:00
|
|
|
==Reference Implementation==
|
2021-06-28 00:49:37 +02:00
|
|
|
|
|
|
|
|
<tt>pk()</tt>, <tt>pkh()</tt>, and <tt>sh()</tt> descriptors have been implemented in Bitcoin Core since version 0.17.
|
