doc: recommend script_flags instead of deployments.taproot #35183

pull Sjors wants to merge 1 commits into bitcoin:master from Sjors:2026/04/doc-26201-addendum changing 1 files +6 −1
  1. Sjors commented at 5:53 PM on April 30, 2026: member

    #26201 removed taproot from getdeploymentinfo (not yet in a release, slated for v32), which it turns out Lnd relies on: https://github.com/lightningnetwork/lnd/pull/10683

    Expand the release doc note to recommend the same solution they used: check for TAPROOT in the script_flags array. This was added in v31.

  2. DrahtBot added the label Docs on Apr 30, 2026
  3. DrahtBot commented at 5:53 PM on April 30, 2026: contributor

    <!--e57a25ab6845829454e8d69fc972939a-->

    The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.

    <!--006a51241073e994b41acfe9ec718e94-->

    Code Coverage & Benchmarks

    For details see: https://corecheck.dev/bitcoin/bitcoin/pulls/35183.

    <!--021abf342d371248e50ceaed478a90ca-->

    Reviews

    See the guideline for information on the review process.

    Type Reviewers
    ACK maflcko, sedited
    Stale ACK ferminquant

    If your review is incorrectly listed, please copy-paste <code>&lt;!--meta-tag:bot-skip--&gt;</code> into the comment that the bot should ignore.

    <!--5faf32d7da4f0f540f40219e4f7537a3-->

  4. Sjors force-pushed on Apr 30, 2026
  5. DrahtBot added the label CI failed on Apr 30, 2026
  6. Sjors commented at 6:05 PM on April 30, 2026: member

    We only added the script_flags array in v31.0, so it may be a bit annoying for RPC clients to have to use getdeploymentinfo for v30 and older. Since #26201 isn't in a release yet, we could temporarily put "taproot" back under deployments with a deprecation notice. Perhaps that's useful if Lnd is not the only client with this issue (since they've already dealt with it).

  7. Sjors force-pushed on Apr 30, 2026
  8. DrahtBot removed the label CI failed on Apr 30, 2026
  9. maflcko commented at 6:38 AM on May 6, 2026: member

    script_flags was indeed added in 4577fb2b1e098c3f560b1ff50a37ebfef2af5f32 v31

    However, I don't understand why any client would need to check for taproot. Our own wallet and mempool assumes that it is active since genesis, so what is different about lightning wallets that they'd assume otherwise?

  10. ferminquant commented at 5:35 PM on May 8, 2026: none

    ACK 3a3623a111a6b66faeab6d6544ff860e1434e31f

    Reviewed the release note change and checked the linked context. script_flags was added in v31, #26201 is targeted for v32, and the linked LND change uses script_flags as the compatibility path for the removed deployments.taproot field. Also ran git diff --check and the markdown/trailing/doc lints.

  11. maflcko commented at 5:54 AM on May 9, 2026: member

    So I tend toward Approach NACK, per my previous comment. It should say that the deployment is buried and can be assumed to be active on main.

  12. Sjors commented at 5:01 PM on May 9, 2026: member

    @maflcko I don't think we should force downstream projects to follow our convention. And it could be good to encourage usage of this new RPC for whatever softfork is next.

  13. in doc/release-notes-26201.md:7 in 3a3623a111
       0 | @@ -1,4 +1,8 @@
       1 |  RPC
       2 |  ---
       3 |  
       4 | -- 'taproot' has been removed from 'getdeploymentinfo' because its historical activation height is no longer used anywhere in the codebase. (#26201)
       5 | +- 'taproot' has been removed from 'getdeploymentinfo' because its historical
       6 | +  activation height is no longer used anywhere in the codebase.
       7 | +  Applications that rely on `deployments.taproot` to detect Taproot support
       8 | +  should instead check for `TAPROOT` in the `script_flags` array returned by
    


    maflcko commented at 8:31 AM on May 11, 2026:
      should either assume Taproot to be always active (since Bitcoin Core v24.0), or check for `TAPROOT` in the `script_flags` array returned by
    

    Sjors commented at 9:09 AM on May 11, 2026:

    Took this suggestion.

  14. maflcko commented at 8:33 AM on May 11, 2026: member

    I don't think docs can "force" anyone. If they did, then you are "forcing" them to use the script_flags array.

  15. Sjors force-pushed on May 11, 2026
  16. in doc/release-notes-26201.md:9 in 90fe223a92
       5 | +- 'taproot' has been removed from 'getdeploymentinfo' because its historical
       6 | +  activation height is no longer used anywhere in the codebase.
       7 | +  Applications that rely on `deployments.taproot` to detect Taproot support
       8 | +  should either assume Taproot to be always active (since Bitcoin Core v24.0),
       9 | +  or check for `TAPROOT` in the `script_flags` array returned by
      10 | +  `getdeploymentinfo`. This is available since Bitcoin Core v31. (#26201)
    


    maflcko commented at 9:18 AM on May 11, 2026:
      `getdeploymentinfo` (since Bitcoin Core v31.0). (#26201)
    

    nit: Either replace This with The array, or inline the condition right after?


    Sjors commented at 9:30 AM on May 11, 2026:

    Thanks, that's indeed more clear now that there's two suggestions.

  17. maflcko approved
  18. maflcko commented at 9:23 AM on May 11, 2026: member

    production-ready enterprise-grade lgtm

  19. doc: recommend script_flags instead of deployments.taproot
    Co-authored-by: maflcko <6399679+maflcko@users.noreply.github.com>
    f24a7b5f75
  20. Sjors force-pushed on May 11, 2026
  21. Sjors commented at 9:31 AM on May 11, 2026: member

    production-ready enterprise-grade lgtm

    Should be good for Microsoft certification now.

  22. DrahtBot added the label CI failed on May 11, 2026
  23. maflcko commented at 9:41 AM on May 11, 2026: member

    Stakeholder-aligned SLA-compliant production-ready enterprise-grade lgtm ACK f24a7b5f759920f62db1a131a9a9d31408edd0b2

  24. sedited approved
  25. sedited commented at 9:45 AM on May 11, 2026: contributor

    ACK f24a7b5f759920f62db1a131a9a9d31408edd0b2

  26. fanquake added this to the milestone 32.0 on May 11, 2026
  27. sedited merged this on May 11, 2026
  28. sedited closed this on May 11, 2026

  29. Sjors deleted the branch on May 11, 2026

github-metadata-mirror

This is a metadata mirror of the GitHub repository bitcoin/bitcoin. This site is not affiliated with GitHub. Content is generated from a GitHub metadata backup.
generated: 2026-05-19 06:51 UTC