[bitcoin-dev] Proposal: Package Mempool Accept and Package RBF
gloriajzhao at gmail.com
Thu Sep 16 07:51:25 UTC 2021
I'm writing to propose a set of mempool policy changes to enable package
validation (in preparation for package relay) in Bitcoin Core. These would
be consensus or P2P protocol changes. However, since mempool policy
significantly affects transaction propagation, I believe this is relevant
the mailing list.
My proposal enables packages consisting of multiple parents and 1 child. If
develop software that relies on specific transaction relay assumptions
are interested in using package relay in the future, I'm very interested to
your feedback on the utility or restrictiveness of these package policies
your use cases.
A draft implementation of this proposal can be found in [Bitcoin Core
An illustrated version of this post can be found at
I have also linked the images below.
Feel free to skip this section if you are already familiar with mempool
and package relay terminology.
### Terminology Clarifications
* Package = an ordered list of related transactions, representable by a
* Package Feerate = the total modified fees divided by the total virtual
all transactions in the package.
- Modified fees = a transaction's base fees + fee delta applied by the
with `prioritisetransaction`. As such, we expect this to vary across
- Virtual Size = the maximum of virtual sizes calculated using [BIP141
virtual size] and sigop weight. [Implemented here in Bitcoin
- Note that feerate is not necessarily based on the base fees and
* Fee-Bumping = user/wallet actions that take advantage of miner incentives
boost a transaction's candidacy for inclusion in a block, including Child
for Parent (CPFP) and [BIP125] Replace-by-Fee (RBF). Our intention in
mempool policy is to recognize when the new transaction is more economical
mine than the original one(s) but not open DoS vectors, so there are some
The purpose of the mempool is to store the best (to be most
with miners, highest feerate) candidates for inclusion in a block. Miners
the mempool to build block templates. The mempool is also useful as a cache
boosting block relay and validation performance, aiding transaction relay,
generating feerate estimations.
Ideally, all consensus-valid transactions paying reasonable fees should
to miners through normal transaction relay, without any special
relationships with miners. On the other hand, nodes do not have unlimited
resources, and a P2P network designed to let any honest node broadcast their
transactions also exposes the transaction validation engine to DoS attacks
As such, for unconfirmed transactions we are considering for our mempool, we
apply a set of validation rules in addition to consensus, primarily to
us from resource exhaustion and aid our efforts to keep the highest fee
transactions. We call this mempool _policy_: a set of (configurable,
node-specific) rules that transactions must abide by in order to be accepted
into our mempool. Transaction "Standardness" rules and mempool restrictions
as "too-long-mempool-chain" are both examples of policy.
### Package Relay and Package Mempool Accept
In transaction relay, we currently consider transactions one at a time for
submission to the mempool. This creates a limitation in the node's ability
determine which transactions have the highest feerates, since we cannot take
into account descendants (i.e. cannot use CPFP) until all the transactions
in the mempool. Similarly, we cannot use a transaction's descendants when
considering it for RBF. When an individual transaction does not meet the
minimum feerate and the user isn't able to create a replacement transaction
directly, it will not be accepted by mempools.
This limitation presents a security issue for applications and users
time-sensitive transactions. For example, Lightning and other protocols
UTXOs with multiple spending paths, where one counterparty's spending path
up after a timelock, and users are protected from cheating scenarios as
they redeem on-chain in time. A key security assumption is that all parties'
transactions will propagate and confirm in a timely manner. This assumption
be broken if fee-bumping does not work as intended.
The end goal for Package Relay is to consider multiple transactions at the
time, e.g. a transaction with its high-fee child. This may help us better
determine whether transactions should be accepted to our mempool,
they don't meet fee requirements individually or are better RBF candidates
package. A combination of changes to mempool validation logic, policy, and
transaction relay allows us to better propagate the transactions with the
highest package feerates to miners, and makes fee-bumping tools more
The "relay" part of Package Relay suggests P2P messaging changes, but a
part of the changes are in the mempool's package validation logic. We call
*Package Mempool Accept*.
### Previous Work
* Given that mempool validation is DoS-sensitive and complex, it would be
dangerous to haphazardly tack on package validation logic. Many efforts
been made to make mempool validation less opaque (see [#16400],
* [#20833] Added basic capabilities for package validation, test accepts
(no submission to mempool).
* [#21800] Implemented package ancestor/descendant limit checks for
packages. Still test accepts only.
* Previous package relay proposals (see [#16401], [#19621]).
### Existing Package Rules
These are in master as introduced in [#20833] and [#21800]. I'll
them as "given" in the rest of this document, though they can be changed,
package validation is test-accept only right now.
1. A package cannot exceed `MAX_PACKAGE_COUNT=25` count and
`MAX_PACKAGE_SIZE=101KvB` total size 
*Rationale*: This is already enforced as mempool ancestor/descendant
Presumably, transactions in a package are all related, so exceeding this
would mean that the package can either be split up or it wouldn't pass this
2. Packages must be topologically sorted: if any dependencies exist between
transactions, parents must appear somewhere before children. 
3. A package cannot have conflicting transactions, i.e. none of them can
the same inputs. This also means there cannot be duplicate transactions. 
4. When packages are evaluated against ancestor/descendant limits in a test
accept, the union of all of their descendants and ancestors is considered.
is essentially a "worst case" heuristic where every transaction in the
is treated as each other's ancestor and descendant. 
Packages for which ancestor/descendant limits are accurately captured by
There are also limitations such as the fact that CPFP carve out is not
to package transactions. #20833 also disables RBF in package validation;
proposal overrides that to allow packages to use RBF.
## Proposed Changes
The next step in the Package Mempool Accept project is to implement
to mempool, initially through RPC only. This allows us to test the
logic before exposing it on P2P.
- Packages may contain already-in-mempool transactions.
- Packages are 2 generations, Multi-Parent-1-Child.
- Fee-related checks use the package feerate. This means that wallets can
create a package that utilizes CPFP.
- Parents are allowed to RBF mempool transactions with a set of rules
to BIP125. This enables a combination of CPFP and RBF, where a
transaction's descendant fees pay for replacing mempool conflicts.
There is a draft implementation in [#22290]. It is WIP, but feedback is
#### Packages May Contain Already-in-Mempool Transactions
A package may contain transactions that are already in the mempool. We
("deduplicate") those transactions from the package for the purposes of
mempool acceptance. If a package is empty after deduplication, we do
*Rationale*: Mempools vary across the network. It's possible for a parent
accepted to the mempool of a peer on its own due to differences in policy
fee market fluctuations. We should not reject or penalize the entire
an individual transaction as that could be a censorship vector.
#### Packages Are Multi-Parent-1-Child
Only packages of a specific topology are permitted. Namely, a package is
1 child with all of its unconfirmed parents. After deduplication, the
may be exactly the same, empty, 1 child, 1 child with just some of its
unconfirmed parents, etc. Note that it's possible for the parents to be
descendants/ancestors of one another, or for parent and child to share a
so we cannot make any other topology assumptions.
*Rationale*: This allows for fee-bumping by CPFP. Allowing multiple parents
makes it possible to fee-bump a batch of transactions. Restricting packages
defined topology is also easier to reason about and simplifies the
logic greatly. Multi-parent-1-child allows us to think of the package as
- Inputs = all the inputs of parents + inputs of the child that come from
- Outputs = all the outputs of the child + all outputs of the parents that
aren't spent by other transactions in the package
Examples of packages that follow this rule (variations of example A show
possibilities after deduplication): ![image]
#### Fee-Related Checks Use Package Feerate
Package Feerate = the total modified fees divided by the total virtual size
all transactions in the package.
To meet the two feerate requirements of a mempool, i.e., the pre-configured
minimum relay feerate (`minRelayTxFee`) and dynamic mempool minimum
total package feerate is used instead of the individual feerate. The
transactions are allowed to be below feerate requirements if the package
the feerate requirements. For example, the parent(s) in the package can
fees but be paid for by the child.
*Rationale*: This can be thought of as "CPFP within a package," solving the
issue of a parent not meeting minimum fees on its own. This allows L2
applications to adjust their fees at broadcast time instead of overshooting
risking getting stuck/pinned.
We use the package feerate of the package *after deduplication*.
*Rationale*: It would be incorrect to use the fees of transactions that are
already in the mempool, as we do not want a transaction's fees to be
double-counted for both its individual RBF and package RBF.
Examples F and G  show the same package, but P1 is submitted
the package in example G. In example F, we can see that the 300vB package
an additional 200sat in fees, which is not enough to pay for its own
(BIP125#4). In example G, we can see that P1 pays enough to replace M1, but
using P1's fees again during package submission would make it look like a
increase for a 200vB package. Even including its fees and size would not be
sufficient in this example, since the 300sat looks like enough for the 300vB
package. The calculcation after deduplication is 100sat increase for a
of size 200vB, which correctly fails BIP125#4. Assume all transactions have
size of 100vB.
#### Package RBF
If a package meets feerate requirements as a package, the parents in the
transaction are allowed to replace-by-fee mempool transactions. The child
replace mempool transactions. Multiple transactions can replace the same
transaction, but in order to be valid, none of the transactions can try to
replace an ancestor of another transaction in the same package (which would
make its inputs unavailable).
*Rationale*: Even if we are using package feerate, a package will not
as intended if RBF still requires each individual transaction to meet the
We use a set of rules slightly modified from BIP125 as follows:
##### Signaling (Rule #1)
All mempool transactions to be replaced must signal replaceability.
*Rationale*: Package RBF signaling logic should be the same for package RBF
single transaction acceptance. This would be updated if single transaction
validation moves to full RBF.
##### New Unconfirmed Inputs (Rule #2)
A package may include new unconfirmed inputs, but the ancestor feerate of
child must be at least as high as the ancestor feerates of every transaction
being replaced. This is contrary to BIP125#2, which states "The replacement
transaction may only include an unconfirmed input if that input was
one of the original transactions. (An unconfirmed input spends an output
*Rationale*: The purpose of BIP125#2 is to ensure that the replacement
transaction has a higher ancestor score than the original transaction(s)
[comment]). Example H  shows how adding a new unconfirmed input can
ancestor score of the replacement transaction. P1 is trying to replace M1,
spends an unconfirmed output of M2. P1 pays 800sat, M1 pays 600sat, and M2
100sat. Assume all transactions have a size of 100vB. While, in isolation,
looks like a better mining candidate than M1, it must be mined with M2, so
ancestor feerate is actually 4.5sat/vB. This is lower than M1's ancestor
feerate, which is 6sat/vB.
In package RBF, the rule analogous to BIP125#2 would be "none of the
transactions in the package can spend new unconfirmed inputs." Example J
why, if any of the package transactions have ancestors, package feerate is
longer accurate. Even though M2 and M3 are not ancestors of P1 (which is the
replacement transaction in an RBF), we're actually interested in the entire
package. A miner should mine M1 which is 5sat/vB instead of M2, M3, P1, P2,
P3, which is only 4sat/vB. The Package RBF rule cannot be loosened to only
the child to have new unconfirmed inputs, either, because it can still
to overestimate the package's ancestor score.
However, enforcing a rule analogous to BIP125#2 would not only make Package
less useful, but would also break Package RBF for packages with parents
in the mempool: if a package parent has already been submitted, it would
like the child is spending a "new" unconfirmed input. In example K ,
looking to replace M1 with the entire package including P1, P2, and P3. We
consider the case where one of the parents is already in the mempool (in
case, P2), which means we must allow P3 to have new unconfirmed inputs.
M2 lowers the ancestor score of P3 to 4.3sat/vB, so we should not replace M1
with this package.
Thus, the package RBF rule regarding new unconfirmed inputs is less strict
BIP125#2. However, we still achieve the same goal of requiring the
transactions to have a ancestor score at least as high as the original
a result, the entire package is required to be a higher feerate mining
than each of the replaced transactions.
Another note: the [comment] above the BIP125#2 code in the original RBF
implementation suggests that the rule was intended to be temporary.
##### Absolute Fee (Rule #3)
The package must increase the absolute fee of the mempool, i.e. the total
of the package must be higher than the absolute fees of the mempool
it replaces. Combined with the CPFP rule above, this differs from BIP125
- an individual transaction in the package may have lower fees than the
transaction(s) it is replacing. In fact, it may have 0 fees, and the child
pays for RBF.
##### Feerate (Rule #4)
The package must pay for its own bandwidth; the package feerate must be
than the replaced transactions by at least minimum relay feerate
(`incrementalRelayFee`). Combined with the CPFP rule above, this differs
BIP125 Rule #4 - an individual transaction in the package can have a lower
feerate than the transaction(s) it is replacing. In fact, it may have 0
and the child pays for RBF.
##### Total Number of Replaced Transactions (Rule #5)
The package cannot replace more than 100 mempool transactions. This is
to BIP125 Rule #5.
### Expected FAQs
1. Is it possible for only some of the package to make it into the mempool?
Yes, it is. However, since we evict transactions from the mempool by
descendant score and the package child is supposed to be sponsoring the
its parents, the most common scenario would be all-or-nothing. This is
incentive-compatible. In fact, to be conservative, package validation should
begin by trying to submit all of the transactions individually, and only
package mempool acceptance logic if the parents fail due to low feerate.
2. Should we allow packages to contain already-confirmed transactions?
No, for practical reasons. In mempool validation, we actually aren't
tell with 100% confidence if we are looking at a transaction that has
confirmed, because we look up inputs using a UTXO set. If we have historical
block data, it's possible to look for it, but this is inefficient, not
possible for pruning nodes, and unnecessary because we're not going to do
anything with the transaction anyway. As such, we already have the
that transaction relay is somewhat "stateful" i.e. nobody should be relaying
transactions that have already been confirmed. Similarly, we shouldn't be
relaying packages that contain already-confirmed transactions.
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the bitcoin-dev