mirror of
https://github.com/bitcoin/bips.git
synced 2025-10-27 14:09:10 +00:00
77 lines
3.1 KiB
Plaintext
77 lines
3.1 KiB
Plaintext
<pre>
|
|
BIP: 385
|
|
Layer: Applications
|
|
Title: raw() and addr() Output Script Descriptors
|
|
Author: Pieter Wuille <pieter@wuille.net>
|
|
Ava Chow <me@achow101.com>
|
|
Comments-Summary: No comments yet.
|
|
Comments-URI: https://github.com/bitcoin/bips/wiki/Comments:BIP-0385
|
|
Status: Final
|
|
Type: Informational
|
|
Created: 2021-06-27
|
|
License: BSD-2-Clause
|
|
Requires: 380
|
|
</pre>
|
|
|
|
==Abstract==
|
|
|
|
This document specifies <tt>raw()</tt> and <tt>addr()</tt> output script descriptors.
|
|
<tt>raw()</tt> encapsulates a raw script as a descriptor.
|
|
<tt>addr()</tt> encapsulates an address as a descriptor.
|
|
|
|
==Copyright==
|
|
|
|
This BIP is licensed under the BSD 2-clause license.
|
|
|
|
==Motivation==
|
|
|
|
In order to make descriptors maximally compatible with scripts in use today, it is useful to be able to wrap any arbitrary output script or an address into a descriptor.
|
|
|
|
==Specification==
|
|
|
|
Two new script expressions are defined: <tt>raw()</tt> and <tt>addr()</tt>.
|
|
|
|
===<tt>raw()</tt>===
|
|
|
|
The <tt>raw(HEX)</tt> expression can only be used as a top level descriptor.
|
|
As the argument, it takes a hex string representing a Bitcoin script.
|
|
The output script produced by this descriptor is the script represented by <tt>HEX</tt>.
|
|
|
|
===<tt>addr()</tt>===
|
|
|
|
The <tt>addr(ADDR)</tt> expression can only be used as a top level descriptor.
|
|
It takes an address as its single argument.
|
|
The output script produced by this descriptor is the output script produced by the address <tt>ADDR</tt>.
|
|
|
|
==Test Vectors==
|
|
|
|
Valid descriptors followed by the scripts they produce.
|
|
|
|
* <tt>raw(deadbeef)</tt>
|
|
** <tt>deadbeef</tt>
|
|
* <tt>raw(512103a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd4104a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd5b8dec5235a0fa8722476c7709c02559e3aa73aa03918ba2d492eea75abea23552ae)</tt>
|
|
** <tt>512103a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd4104a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd5b8dec5235a0fa8722476c7709c02559e3aa73aa03918ba2d492eea75abea23552ae</tt>
|
|
* <tt>raw(a9149a4d9901d6af519b2a23d4a2f51650fcba87ce7b87)</tt>
|
|
** <tt>a9149a4d9901d6af519b2a23d4a2f51650fcba87ce7b87</tt>
|
|
* <tt>addr(3PUNyaW7M55oKWJ3kDukwk9bsKvryra15j)</tt>
|
|
** <tt>a914eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee87</tt>
|
|
|
|
Invalid descriptors
|
|
|
|
* Non-hex script: <tt>raw(asdf)</tt>
|
|
* Invalid address: <tt>addr(asdf)</tt>
|
|
* <tt>raw</tt> nested in <tt>sh</tt>: <tt>sh(raw(deadbeef))</tt>
|
|
* <tt>raw</tt> nested in <tt>wsh</tt>: <tt>wsh(raw(deadbeef))</tt>
|
|
* <tt>addr</tt> nested in <tt>sh</tt>: <tt>sh(addr(3PUNyaW7M55oKWJ3kDukwk9bsKvryra15j))</tt>
|
|
* <tt>addr</tt> nested in <tt>wsh</tt>: <tt>wsh(addr(3PUNyaW7M55oKWJ3kDukwk9bsKvryra15j))</tt>
|
|
|
|
==Backwards Compatibility==
|
|
|
|
<tt>raw()</tt> and <tt>addr()</tt> 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.
|
|
The reuse of existing Bitcoin addresses allows for this to be more easily implemented.
|
|
|
|
==Reference Implementation==
|
|
|
|
<tt>raw()</tt> and <tt>addr()</tt> descriptors have been implemented in Bitcoin Core since version 0.17.
|