BIP Draft: Output Script Descriptor Annotations #2099

pull craigraw wants to merge 3 commits into bitcoin:master from craigraw:descriptorannotations changing 2 files +134 −0
  1. craigraw commented at 11:15 am on February 11, 2026: contributor

    This BIP proposal follows from the discussion for BIP392 (#2047) in which it emerged that due to the resource-intensive scanning requirements of the protocol some metadata (for example the birthday block height) may be practically required for efficient recovery of wallet funds. However, this metadata is not technically required to determine the output scripts, and therefore deemed unsuitable for direct inclusion in an output descriptor. This may lead to a situation in future where a wallet backup consisting of a valid output descriptor may not practically be complete enough to recover all the funds in a wallet.

    This BIP proposal provides a solution in the form of annotations - key/value pairs appended to a descriptor expression using URL-like query string delimiters. Annotations provide a compact way to include such metadata directly in a descriptor string, using characters already present in the BIP380 checksum character set.

    Note that annotations are not intended for general wallet backup, which may include other data such as labels. They are strictly scoped to convey operational metadata to aid recovery of funds without altering the scripts produced by the descriptor.

    cc: @achow101 as author of most Descriptor BIPs.

  2. Initial draft of Descriptor Annotations BIP 025b945cbf
  3. Improve scope definition, tighten specification and clarify semantics 91a1efb3f3
  4. Add link to mailing list discussion 236b83c057
  5. murchandamus renamed this:
    Output Script Descriptor Annotations
    BIP Draft: Output Script Descriptor Annotations
    on Feb 13, 2026
  6. murchandamus added the label New BIP on Feb 13, 2026
  7. murchandamus commented at 7:13 pm on February 13, 2026: member
    Looks great for a first showing. No comments from an editorial perspective. I plan on letting this mature a bit in hope of seeing more discussion on the ML and review on the document.

github-metadata-mirror

This is a metadata mirror of the GitHub repository bitcoin/bips. This site is not affiliated with GitHub. Content is generated from a GitHub metadata backup.
generated: 2026-02-17 00:10 UTC

This site is hosted by @0xB10C
More mirrored repositories can be found on mirror.b10c.me