Cluster mempool followups #33591

pull sdaftuar wants to merge 88 commits into bitcoin:master from sdaftuar:2025-10-rebase-cluster-mempool changing 69 files +2119 −3474
  1. sdaftuar commented at 7:06 pm on October 9, 2025: member

    As suggested in the main cluster mempool PR (https://github.com/bitcoin/bitcoin/pull/28676#pullrequestreview-3177119367), I’ve pulled out some of the non-essential optimizations and cleanups into this separate PR.

    Will continue to add more commits here to address non-blocking suggestions/improvements as they come up.

  2. DrahtBot commented at 7:06 pm on October 9, 2025: contributor

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

    Code Coverage & Benchmarks

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

    Reviews

    See the guideline for information on the review process. A summary of reviews will appear here.

    Conflicts

    Reviewers, this pull request conflicts with the following ones:

    • #33725 (ci, iwyu: Treat warnings as errors for src/init and src/policy by hebasto)
    • #33724 (refactor: Return uint64_t from GetSerializeSize by maflcko)
    • #33616 (policy: don’t CheckEphemeralSpends on reorg by instagibbs)
    • #33421 (node: add BlockTemplateCache by ismaelsadeeq)
    • #33214 (rpc: require integer verbosity; remove boolean ‘verbose’ by fqlx)
    • #32587 (test: Fix reorg patterns in tests to use proper fork-based approach by yuvicc)
    • #31974 (Drop testnet3 by Sjors)
    • #31682 ([IBD] specialize CheckBlock’s input & coinbase checks by l0rinc)
    • #31382 (kernel: Flush in ChainstateManager destructor by TheCharlatan)
    • #30342 (kernel, logging: Pass Logger instances to kernel objects by ryanofsky)
    • #30277 ([DO NOT MERGE] Erlay: bandwidth-efficient transaction relay protocol (Full implementation) by sr-gi)
    • #29641 (scripted-diff: Use LogInfo over LogPrintf [WIP, NOMERGE, DRAFT] by maflcko)
    • #28690 (build: Introduce internal kernel library by TheCharlatan)
    • #17783 (common: Disallow calling IsArgSet() on ALLOW_LIST options by ryanofsky)
    • #17581 (refactor: Remove settings merge reverse precedence code by ryanofsky)
    • #17580 (refactor: Add ALLOW_LIST flags and enforce usage in CheckArgFlags by ryanofsky)
    • #17493 (util: Forbid ambiguous multiple assignments in config file by ryanofsky)

    If you consider this pull request important, please also help to review the conflicting pull requests. Ideally, start with the one that should be merged first.

    LLM Linter (✨ experimental)

    Possible typos and grammar issues:

    • to to -> to [duplicate word; makes the sentence read “to to have” which is incorrect]
    • 101kvB -> 101 k vB (or “101 kVBytes”) [unit is written without spacing/standard form and is confusing; add spacing or use a standard unit]
    • rule 5). -> rule 5) [stray/full stop after a parenthesis; “rule 5).” is awkward/confusing — use “rule 5)”]

    drahtbot_id_5_m

  3. glozow added the label Mempool on Oct 9, 2025
  4. DrahtBot added the label Needs rebase on Oct 14, 2025
  5. Allow moving an Epoch::Marker 51430680ec
  6. mempool: Store iterators into mapTx in mapNextTx
    This takes the same amount of space as CTransaction pointers, and saves a map
    lookup in many common uses.
    6c73e47448
  7. sdaftuar force-pushed on Oct 14, 2025
  8. DrahtBot removed the label Needs rebase on Oct 14, 2025
  9. sdaftuar force-pushed on Oct 16, 2025
  10. sdaftuar force-pushed on Oct 31, 2025
  11. Allow moving CTxMemPoolEntry objects, disallow copying 92b0079fe3
  12. Make CTxMemPoolEntry derive from TxGraph::Ref 29a94d5b2f
  13. Create a txgraph inside CTxMemPool c18c68a950
  14. Add sigops adjusted weight calculator 1bf3b51396
  15. Add accessor for sigops-adjusted weight d5ed9cb3eb
  16. Add transactions to txgraph, but without cluster dependencies
    Effectively this is treating all transactions in txgraph as being in a cluster
    of size 1.
    9de3c6dd7a
  17. squashme: fix locking so that mempool lock is held through subpackage destruction bbbd090f74
  18. Add new (unused) limits for cluster size/count fee962dbde
  19. test: update feature_rbf.py replacement test
    Preparatory commit to the rbf functional test, before changes are made to the
    rbf rules as part of cluster mempool.
    3cc32ea55d
  20. [test] rework/delete feature_rbf tests requiring large clusters 7bc8bdb723
  21. Do not allow mempool clusters to exceed configured limits
    Include an adjustment to mempool_tests.cpp due to the additional memory used by
    txgraph.
    
    Includes a temporary change to the mempool_ephemeral_dust.py functional test,
    due to validation checks being reordered. This change will revert once the RBF
    rules are changed in a later commit.
    e6591f3ed1
  22. Check cluster limits when using -walletrejectlongchains 52e1f6ff04
  23. Rework miner_tests to not require large cluster limit 34e50870d8
  24. Limit mempool size based on chunk feerate
    Rather than evicting the transactions with the lowest descendant feerate,
    instead evict transactions that have the lowest chunk feerate.
    
    Once mining is implemented based on choosing transactions with highest chunk
    feerate (see next commit), mining and eviction will be opposites, so that we
    will evict the transactions that would be mined last.
    eccaf11c14
  25. bench: rewrite ComplexMemPool to not create oversized clusters 637425b45b
  26. Select transactions for blocks based on chunk feerate
    Co-Authored-By: Gregory Sanders <gsanders87@gmail.com>
    7738334272
  27. test: rewrite PopulateMempool to not violate mempool policy (cluster size) limits 83ee706ee2
  28. policy: Remove CPFP carveout rule
    The addition of a cluster size limit makes the CPFP carveout rule useless,
    because carveout cannot be used to bypass the cluster size limit. Remove this
    policy rule and update tests to no longer rely on the behavior.
    95b1ad3905
  29. Implement new RBF logic for cluster mempool
    With a total ordering on mempool transactions, we are now able to calculate a
    transaction's mining score at all times. Use this to improve the RBF logic:
    
    - we no longer enforce a "no new unconfirmed parents" rule
    
    - we now require that the mempool's feerate diagram must improve in order
      to accept a replacement
    
    - the topology restrictions for conflicts in the package rbf setting have been
      eliminated
    
    Revert the temporary change to mempool_ephemeral_dust.py that were previously
    made due to RBF validation checks being reordered.
    
    Co-authored-by: Gregory Sanders <gsanders87@gmail.com>, glozow <gloriajzhao@gmail.com>
    4c224d1198
  30. Remove the ancestor and descendant indices from the mempool edfd95dfdf
  31. Use cluster linearization for transaction relay sort order
    Previously, transaction batches were first sorted by ancestor count and then
    feerate, to ensure transactions are announced in a topologically valid order,
    while prioritizing higher feerate transactions. Ancestor count is a crude
    topological sort criteria, so replace this with linearization order so that the
    highest feerate transactions (as would be observed by the mining algorithm) are
    relayed before lower feerate ones, in a topologically valid way.
    
    This also fixes a test that only worked due to the ancestor-count-based sort
    order.
    d0622ae20c
  32. Remove CTxMemPool::GetSortedDepthAndScore
    The mempool clusters and linearization permit sorting the mempool topologically
    without making use of ancestor counts (as long as the graph is not oversized).
    
    Co-authored-by: Pieter Wuille <pieter@wuille.net>
    3dc8abcc41
  33. Reimplement GetTransactionAncestry() to not rely on cached data
    In preparation for removing ancestor data from CTxMemPoolEntry, recalculate the
    ancestor statistics on demand wherever needed.
    3efc77e011
  34. [squashme] Use outputs and structured bindings for CalculateAncestorData() cea1269b71
  35. rpc: Calculate ancestor data from scratch for mempool rpc calls 4a275d1864
  36. Remove dependency on cached ancestor data in mini-miner 86441349e2
  37. Stop enforcing ancestor size/count limits
    The cluster limits should be sufficient.
    
    Co-Authored-By: Gregory Sanders <gsanders87@gmail.com>
    984ca038fc
  38. Add test case for cluster size limits to TRUC logic a2339e3a67
  39. Use mempool/txgraph to determine if a tx has descendants
    Remove a reference to GetCountWithDescendants() in preparation for removing
    this function and the associated cached state from the mempool.
    dcf6f0331a
  40. Calculate descendant information for mempool RPC output on-the-fly
    This is in preparation for removing the cached descendant state from the
    mempool.
    87153063f7
  41. test: remove rbf carveout test from mempool_limit.py cefe7d3999
  42. Stop enforcing descendant size/count limits
    Cluster size limits should be enough.
    91a44988a1
  43. Eliminate RBF workaround for CPFP carveout transactions
    The new cluster mempool RBF rules take into account clusters sizes exactly, so
    with the removal of descendant count enforcement this idea is obsolete.
    e0284f3dc2
  44. wallet: Replace max descendantsize with cluster_count
    With the descendant size limits removed, replace the concept of "max number of
    descendants of any ancestor of a given tx" with the cluster count of the cluster
    that the transaction belongs to.
    ff98ad9fd7
  45. mempool: Remove unused function CalculateDescendantMaximum 101deffb8a
  46. Eliminate use of cached ancestor data in miniminer_tests and truc_policy 2cac0b210f
  47. mempool: eliminate accessors to mempool entry ancestor/descendant cached state 8254d5be92
  48. Remove unused members from CTxMemPoolEntry 4d548627b7
  49. Remove mempool logic designed to maintain ancestor/descendant state da37ae62b5
  50. mempool: addUnchecked no longer needs ancestors 49f5b86e48
  51. Remove unused limits from CalculateMemPoolAncestors 6328631980
  52. Make removeConflicts private 089be84916
  53. Simplify ancestor calculation functions
    Now that ancestor calculation never fails (due to ancestor/descendant limits
    being eliminated), we can eliminate the error handling from
    CalculateMemPoolAncestors.
    473500d51b
  54. Use txgraph to calculate ancestors 42f6bd08aa
  55. Use txgraph to calculate descendants f57fbe6949
  56. Rework truc_policy to use descendants, not children 4aeba80743
  57. Rework RBF and TRUC validation
    Calculating mempool ancestors for a new transaction should not be done until
    after cluster size limits have been enforced, to limit CPU DoS potential.
    
    Achieve this by reworking TRUC and RBF validation logic:
    
    - TRUC policy enforcement is now done using only mempool parents of
      new transactions, not all mempool ancestors (note that it's fine to calculate
      ancestors of in-mempool transactions, if the number of such calls is
      reasonably bounded).
    - RBF replacement checks are performed earlier (which allows for checking
      cluster size limits earlier, because cluster size checks cannot happen until
      after all conflicts are staged for removal).
    - Verifying that a new transaction doesn't conflict with an ancestor now
      happens later, in AcceptSingleTransaction() rather than in PreChecks(). This
      means that the test is not performed at all in AcceptMultipleTransactions(),
      but in package acceptance we already disallow RBF in situations where a
      package transaction has in-mempool parents.
    
    Also to ensure that all RBF validation logic is applied in both the single
    transaction and multiple transaction cases, remove the optimization that skips
    the PackageMempoolChecks() in the case of a single transaction being validated
    in AcceptMultipleTransactions().
    831c3c968f
  58. Make getting parents/children a function of the mempool, not a mempool entry d95ff4d364
  59. Eliminate CheckPackageLimits, which no longer does anything 1272865851
  60. Fix miniminer_tests to work with cluster limits 4c3bff43a3
  61. Rewrite GatherClusters to use the txgraph implementation 2bbbaf40f8
  62. Stop tracking parents/children outside of txgraph 7ea16761fa
  63. Avoid violating mempool policy limits in tests
    Changes AddToMempool() helper to only apply changes if the mempool limits are
    respected.
    
    Fix package_rbf fuzz target to handle mempool policy violations
    7fe121df32
  64. bench: add more mempool benchmarks
    Add benchmarks for:
    
      - adding a transaction
      - calculating mempool ancestors/descendants
    6c73882452
  65. fuzz: try to add more code coverage for mempool fuzzing
    Including test coverage for mempool eviction and expiry
    8a34846a6b
  66. Expose cluster information via rpc
    Co-authored-by: glozow <gloriajzhao@gmail.com>
    ca18549ee7
  67. doc: Update mempool_replacements.md to reflect feerate diagram checks 5e8283bd48
  68. test: add functional test for new cluster mempool RPCs
    Co-authored-by: glozow <gloriajzhao@gmail.com>
    aa4fc82dc6
  69. fuzz: remove comparison between mini_miner block construction and miner
    After cluster mempool, the mini_miner will no longer match the miner's block
    construction. Eventually mini_miner should be reworked to directly use
    linearizations done in the mempool.
    d9d2a6acf6
  70. Invoke TxGraph::DoWork() at appropriate times 4be8a7aa80
  71. Update comments for CTxMemPool class 2b107f7690
  72. Add check that GetSortedScoreWithTopology() agrees with CompareMiningScoreWithTopology()
    We use CompareMiningScoreWithTopology() for sorting transaction announcements
    during tx relay, and we use GetSortedScoreWithTopology() in
    CTxMemPool::check().
    f47f964b6f
  73. doc: update policy/packages.md for new package acceptance logic 85a0dd2152
  74. test: extend package rbf functional test to larger clusters
    Co-Authored-By: Gregory Sanders <gsanders87@gmail.com>
    2b7f14cefe
  75. Sanity check `GetFeerateDiagram()` in CTxMemPool::check() a6c9f19c7d
  76. ==== FOLLOWUPS ==== f35ea5b2f0
  77. Remove unused variable (cacheMap) in mempool 7498ecc6db
  78. Remove unused argument to RemoveStaged e4eaa6807f
  79. Simplify removeRecursive 8b71fe4a9a
  80. scripted-diff: rename AddToMempool -> TryAddToMempool
    -BEGIN VERIFY SCRIPT-
    find src/test -type f -exec sed -i 's/AddToMempool/TryAddToMempool/g' {} +
    find src/bench -type f -exec sed -i 's/AddToMempool/TryAddToMempool/g' {} +
    -END VERIFY SCRIPT-
    bb59a808f1
  81. Rewrite removeForReorg to avoid using sets 4f1359a7b0
  82. Rewrite GetChildren without sets 905f079f53
  83. Invoke removeUnchecked() directly in removeForBlock() d7831e58bb
  84. Warn user if using -limitancestorsize/-limitdescendantsize that the options have no effect 98902cdc9d
  85. Use cluster limit rather than descendant limit to sanity check mempool max size 097403e809
  86. Remove ancestor and descendant vsize limits from MemPoolLimits 144d004786
  87. Use cluster limits instead of ancestor/descendant limits when sanity checking package policy limits 5c9bf736db
  88. Use cluster size limit instead of ancestor/descendant size limits when sanity checking TRUC policy limits d360e041d5
  89. Use cluster size limit instead of ancestor size limit in txpackage unit test 2ef8969eaf
  90. Remove unused DEFAULT_ANCESTOR_SIZE_LIMIT_KVB and DEFAULT_DESCENDANT_SIZE_LIMIT_KVB d09141a62e
  91. Add a GetFeePerVSize() accessor to CFeeRate, and use it in the BlockAssembler a07e36b541
  92. miner: replace "package" with "chunk"
    This makes the terminology consistent with other parts of the codebase, as part
    of the cluster mempool implementation.
    ac950a97a8
  93. doc: Update mempool-limits.md for cluster mempool 9e782af5e9
  94. doc: add design notes for cluster mempool
    For now, just link to the long writeups on delvingbitcoin.org
    fc748e5fdd
  95. doc: add release notes snippet for cluster mempool cd640638a2
  96. Avoid using mapTx.modify() to update modified fees
    Now that the mempool no longer keeps any feerate-based indices, we can modify
    feerates in mempool entries directly.
    7e715bc274
  97. sdaftuar force-pushed on Nov 10, 2025

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: 2025-11-12 12:13 UTC

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