-
Notifications
You must be signed in to change notification settings - Fork 5.8k
Add P2A BIP #1982
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Add P2A BIP #1982
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,76 @@ | ||
<pre> | ||
BIP: ? | ||
Layer: Applications | ||
Title: Pay To Anchor (P2A) | ||
Author: Gregory Sanders <gsanders87@gmail.com> | ||
Comments-URI: https://github.com/bitcoin/bips/wiki/Comments:BIP-? | ||
Status: Draft | ||
Type: Informational | ||
Created: 2025-09-23 | ||
License: BSD-3-Clause | ||
Post-History: 2024-06-27: https://github.com/bitcoin/bitcoin/pull/30352 Github PR | ||
2024-10-10: https://bitcoinops.org/en/bitcoin-core-28-wallet-integration-guide/ wallet integration guide | ||
</pre> | ||
|
||
==Abstract== | ||
|
||
This document describes a new standard output script called PayToAnchor (P2A) and prescribes making spending of this output type standard. | ||
|
||
This output is "keyless" meaning no signature or witness data at all are required to spend this output typea. | ||
|
||
==Motivation== | ||
|
||
The "anchor" output type is a commonly used pattern in Bitcoin layer 2 systems such as Lightning Network and beyond. This pattern allows transactions which are presigned far in advance to leave a "hook" for CPFP fee bumping later, when prevailing feerates for block inclusion are better known. | ||
|
||
When the wallet user is unconcerned by *who* is able to bump the transaction fees as long as someone does, this output type may confer a couple of advantages: | ||
|
||
1. Using an output type with minimal output and spending input footprint saves fees on average | ||
2. Keyless operation aids in interoperability of services like watchtowers as there is no privileged key material for bumping | ||
|
||
with the drawback that selection of this output type could result in griefing if anti-pinning measures are not taken. If unsure, use in conjunction with [https://github.com/bitcoin/bips/blob/master/bip-0431.mediawiki TRUC transactions]. | ||
|
||
===Specification=== | ||
|
||
A P2A output is defined as one with the exact witness output script | ||
|
||
<code>OP_1 <0x4e73></code><ref>To be segwit it needs to be a witness version + witness program. This conforms to the smallest witness program size of two. The specific bytes cannot be zeros so they are chosen to spell "fees" in bech32m format.</ref> | ||
|
||
corresponding to the addresses <code>bc1pfeessrawgf</code> on Bitcoin mainnet, <code><tb1pfees9rn5nz</code> on public testnets, and <code>bcrt1pfeesnyr2tx</code> on regtest. | ||
|
||
P2A inputs are considered standard for spending if no witness data is attached. This avoids meaningless witness padding. Consensus meaning is unchanged. | ||
|
||
====Implementation==== | ||
|
||
* https://github.com/bitcoin/bitcoin/pull/30352 | ||
|
||
====Related Work==== | ||
|
||
There are a number of related but separate historical concepts: | ||
|
||
[https://github.com/bitcoin/bitcoin/pull/30239 Ephemeral Dust]: Relay policies allowing a single dust output as long as it is spent in a transaction package. As an implementation detail, dust threshold for P2A is set at 240 satoshis by default, other dust levels remain unchanged, and the dust-having transaction must be zero fee. Any output script type may have down to 0-value outputs. | ||
|
||
[https://bitcoinops.org/en/topics/ephemeral-anchors/ Ephemeral Anchors]: Historically the union of P2A output type and ephemeral dust. Keyed anchors along with ephemeral dust are also an accepted pattern and as such they remain separate concepts. | ||
|
||
[https://github.com/bitcoin/bips/blob/master/bip-0431.mediawiki TRUC transactions]: TRUC transactions bound the topology including child transaction size, which aids in anti-pinning for the P2A output, as anyone can attach a child transaction including an oversized, low feerate one. There is no ineherent dependency on this concept and P2A. | ||
|
||
====Backward Compatibility==== | ||
|
||
Creation of P2A outputs has been considered standard since the deployment of Segwit softfork on the network. | ||
|
||
Transactions with P2A inputs were previously nonstandard, reserved as an upgrade hook. | ||
|
||
There are no known conflicts with previous usage. | ||
|
||
==Acknowledgements== | ||
|
||
Thanks to collaborators who helped focus the historical ideas into deployed ones: | ||
Suhas Daftuar, | ||
Gloria Zhao, | ||
Pieter Wuille, | ||
Jeremy Rubin, | ||
and Bastien Teinturier. | ||
|
||
==References and Rationale== | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. TBD, or remove this header? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. one is added, leaving There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Should link to the bitcoind PR that implemented this. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Was in "Implementation" section |
||
|
||
<references/> | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe link here to the SegWit BIP section making them standard.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
the BIPs aren't standardness BIPs, so I'm not sure that helps.