mirror of
https://github.com/bitcoin/bitcoin.git
synced 2025-02-10 10:52:31 -05:00
59 lines
3 KiB
C++
59 lines
3 KiB
C++
// Copyright (c) 2016-2020 The Bitcoin Core developers
|
|
// Distributed under the MIT software license, see the accompanying
|
|
// file COPYING or http://www.opensource.org/licenses/mit-license.php.
|
|
|
|
#ifndef BITCOIN_POLICY_RBF_H
|
|
#define BITCOIN_POLICY_RBF_H
|
|
|
|
#include <txmempool.h>
|
|
|
|
/** Maximum number of transactions that can be replaced by BIP125 RBF (Rule #5). This includes all
|
|
* mempool conflicts and their descendants. */
|
|
static constexpr uint32_t MAX_BIP125_REPLACEMENT_CANDIDATES{100};
|
|
|
|
/** The rbf state of unconfirmed transactions */
|
|
enum class RBFTransactionState {
|
|
/** Unconfirmed tx that does not signal rbf and is not in the mempool */
|
|
UNKNOWN,
|
|
/** Either this tx or a mempool ancestor signals rbf */
|
|
REPLACEABLE_BIP125,
|
|
/** Neither this tx nor a mempool ancestor signals rbf */
|
|
FINAL,
|
|
};
|
|
|
|
/**
|
|
* Determine whether an unconfirmed transaction is signaling opt-in to RBF
|
|
* according to BIP 125
|
|
* This involves checking sequence numbers of the transaction, as well
|
|
* as the sequence numbers of all in-mempool ancestors.
|
|
*
|
|
* @param tx The unconfirmed transaction
|
|
* @param pool The mempool, which may contain the tx
|
|
*
|
|
* @return The rbf state
|
|
*/
|
|
RBFTransactionState IsRBFOptIn(const CTransaction& tx, const CTxMemPool& pool) EXCLUSIVE_LOCKS_REQUIRED(pool.cs);
|
|
RBFTransactionState IsRBFOptInEmptyMempool(const CTransaction& tx);
|
|
|
|
/** Get all descendants of setIterConflicting. Also enforce BIP125 Rule #5, "The number of original
|
|
* transactions to be replaced and their descendant transactions which will be evicted from the
|
|
* mempool must not exceed a total of 100 transactions." Quit as early as possible. There cannot be
|
|
* more than MAX_BIP125_REPLACEMENT_CANDIDATES potential entries.
|
|
* @param[in] setIterConflicting The set of iterators to mempool entries.
|
|
* @param[out] allConflicting Populated with all the mempool entries that would be replaced,
|
|
* which includes descendants of setIterConflicting. Not cleared at
|
|
* the start; any existing mempool entries will remain in the set.
|
|
* @returns an error message if Rule #5 is broken, otherwise a std::nullopt.
|
|
*/
|
|
std::optional<std::string> GetEntriesForConflicts(const CTransaction& tx, CTxMemPool& m_pool,
|
|
const CTxMemPool::setEntries& setIterConflicting,
|
|
CTxMemPool::setEntries& allConflicting)
|
|
EXCLUSIVE_LOCKS_REQUIRED(m_pool.cs);
|
|
|
|
/** BIP125 Rule #2: "The replacement transaction may only include an unconfirmed input if that input
|
|
* was included in one of the original transactions."
|
|
* @returns error message if Rule #2 is broken, otherwise std::nullopt. */
|
|
std::optional<std::string> HasNoNewUnconfirmed(const CTransaction& tx, const CTxMemPool& m_pool,
|
|
const CTxMemPool::setEntries& setIterConflicting)
|
|
EXCLUSIVE_LOCKS_REQUIRED(m_pool.cs);
|
|
#endif // BITCOIN_POLICY_RBF_H
|