Bitcoin Core  27.99.0
P2P Digital Currency
Classes | Public Member Functions | Private Attributes | List of all members
TxRequestTracker Class Reference

Data structure to keep track of, and schedule, transaction downloads from peers. More...

#include <txrequest.h>

Classes

class  Impl
 Actual implementation for TxRequestTracker's data structure. More...
 

Public Member Functions

 TxRequestTracker (bool deterministic=false)
 Construct a TxRequestTracker. More...
 
 ~TxRequestTracker ()
 
void ReceivedInv (NodeId peer, const GenTxid &gtxid, bool preferred, std::chrono::microseconds reqtime)
 Adds a new CANDIDATE announcement. More...
 
void DisconnectedPeer (NodeId peer)
 Deletes all announcements for a given peer. More...
 
void ForgetTxHash (const uint256 &txhash)
 Deletes all announcements for a given txhash (both txid and wtxid ones). More...
 
std::vector< GenTxidGetRequestable (NodeId peer, std::chrono::microseconds now, std::vector< std::pair< NodeId, GenTxid >> *expired=nullptr)
 Find the txids to request now from peer. More...
 
void RequestedTx (NodeId peer, const uint256 &txhash, std::chrono::microseconds expiry)
 Marks a transaction as requested, with a specified expiry. More...
 
void ReceivedResponse (NodeId peer, const uint256 &txhash)
 Converts a CANDIDATE or REQUESTED announcement to a COMPLETED one. More...
 
size_t CountInFlight (NodeId peer) const
 Count how many REQUESTED announcements a peer has. More...
 
size_t CountCandidates (NodeId peer) const
 Count how many CANDIDATE announcements a peer has. More...
 
size_t Count (NodeId peer) const
 Count how many announcements a peer has (REQUESTED, CANDIDATE, and COMPLETED combined). More...
 
size_t Size () const
 Count how many announcements are being tracked in total across all peers and transaction hashes. More...
 
uint64_t ComputePriority (const uint256 &txhash, NodeId peer, bool preferred) const
 Access to the internal priority computation (testing only) More...
 
void SanityCheck () const
 Run internal consistency check (testing only). More...
 
void PostGetRequestableSanityCheck (std::chrono::microseconds now) const
 Run a time-dependent internal consistency check (testing only). More...
 

Private Attributes

const std::unique_ptr< Implm_impl
 

Detailed Description

Data structure to keep track of, and schedule, transaction downloads from peers.

=== Specification ===

We keep track of which peers have announced which transactions, and use that to determine which requests should go to which peer, when, and in what order.

The following information is tracked per peer/tx combination ("announcement"):

Transaction requests are then assigned to peers, following these rules:

Together these rules strike a balance between being fast in non-adverserial conditions and minimizing susceptibility to censorship attacks. An attacker that races the network:

Complexity:

Definition at line 96 of file txrequest.h.

Constructor & Destructor Documentation

◆ TxRequestTracker()

TxRequestTracker::TxRequestTracker ( bool  deterministic = false)
explicit

Construct a TxRequestTracker.

Definition at line 710 of file txrequest.cpp.

◆ ~TxRequestTracker()

TxRequestTracker::~TxRequestTracker ( )
default

Member Function Documentation

◆ ComputePriority()

uint64_t TxRequestTracker::ComputePriority ( const uint256 txhash,
NodeId  peer,
bool  preferred 
) const

Access to the internal priority computation (testing only)

Definition at line 750 of file txrequest.cpp.

◆ Count()

size_t TxRequestTracker::Count ( NodeId  peer) const

Count how many announcements a peer has (REQUESTED, CANDIDATE, and COMPLETED combined).

Definition at line 719 of file txrequest.cpp.

◆ CountCandidates()

size_t TxRequestTracker::CountCandidates ( NodeId  peer) const

Count how many CANDIDATE announcements a peer has.

Definition at line 718 of file txrequest.cpp.

◆ CountInFlight()

size_t TxRequestTracker::CountInFlight ( NodeId  peer) const

Count how many REQUESTED announcements a peer has.

Definition at line 717 of file txrequest.cpp.

◆ DisconnectedPeer()

void TxRequestTracker::DisconnectedPeer ( NodeId  peer)

Deletes all announcements for a given peer.

It should be called when a peer goes offline.

Definition at line 716 of file txrequest.cpp.

◆ ForgetTxHash()

void TxRequestTracker::ForgetTxHash ( const uint256 txhash)

Deletes all announcements for a given txhash (both txid and wtxid ones).

This should be called when a transaction is no longer needed. The caller should ensure that new announcements for the same txhash will not trigger new ReceivedInv calls, at least in the short term after this call.

Definition at line 715 of file txrequest.cpp.

◆ GetRequestable()

std::vector< GenTxid > TxRequestTracker::GetRequestable ( NodeId  peer,
std::chrono::microseconds  now,
std::vector< std::pair< NodeId, GenTxid >> *  expired = nullptr 
)

Find the txids to request now from peer.

It does the following:

  • Convert all REQUESTED announcements (for all txhashes/peers) with (expiry <= now) to COMPLETED ones. These are returned in expired, if non-nullptr.
  • Requestable announcements are selected: CANDIDATE announcements from the specified peer with (reqtime <= now) for which no existing REQUESTED announcement with the same txhash from a different peer exists, and for which the specified peer is the best choice among all (reqtime <= now) CANDIDATE announcements with the same txhash (subject to preferredness rules, and tiebreaking using a deterministic salted hash of peer and txhash).
  • The selected announcements are converted to GenTxids using their is_wtxid flag, and returned in announcement order (even if multiple were added at the same time, or when the clock went backwards while they were being added). This is done to minimize disruption from dependent transactions being requested out of order: if multiple dependent transactions are announced simultaneously by one peer, and end up being requested from them, the requests will happen in announcement order.

Definition at line 744 of file txrequest.cpp.

◆ PostGetRequestableSanityCheck()

void TxRequestTracker::PostGetRequestableSanityCheck ( std::chrono::microseconds  now) const

Run a time-dependent internal consistency check (testing only).

This can only be called immediately after GetRequestable, with the same 'now' parameter.

Definition at line 723 of file txrequest.cpp.

◆ ReceivedInv()

void TxRequestTracker::ReceivedInv ( NodeId  peer,
const GenTxid gtxid,
bool  preferred,
std::chrono::microseconds  reqtime 
)

Adds a new CANDIDATE announcement.

Does nothing if one already exists for that (txhash, peer) combination (whether it's CANDIDATE, REQUESTED, or COMPLETED). Note that the txid/wtxid property is ignored for determining uniqueness, so if an announcement is added for a wtxid H, while one for txid H from the same peer already exists, it will be ignored. This is harmless as the txhashes being equal implies it is a non-segwit transaction, so it doesn't matter how it is fetched. The new announcement is given the specified preferred and reqtime values, and takes its is_wtxid from the specified gtxid.

Definition at line 728 of file txrequest.cpp.

◆ ReceivedResponse()

void TxRequestTracker::ReceivedResponse ( NodeId  peer,
const uint256 txhash 
)

Converts a CANDIDATE or REQUESTED announcement to a COMPLETED one.

If no such announcement exists for the provided peer and txhash, nothing happens.

It should be called whenever a transaction or NOTFOUND was received from a peer. When the transaction is not needed entirely anymore, ForgetTxhash should be called instead of, or in addition to, this call.

Definition at line 739 of file txrequest.cpp.

◆ RequestedTx()

void TxRequestTracker::RequestedTx ( NodeId  peer,
const uint256 txhash,
std::chrono::microseconds  expiry 
)

Marks a transaction as requested, with a specified expiry.

If no CANDIDATE announcement for the provided peer and txhash exists, this call has no effect. Otherwise:

  • That announcement is converted to REQUESTED.
  • If any other REQUESTED announcement for the same txhash already existed, it means an unexpected request was made (GetRequestable will never advise doing so). In this case it is converted to COMPLETED, as we're no longer waiting for a response to it.

Definition at line 734 of file txrequest.cpp.

◆ SanityCheck()

void TxRequestTracker::SanityCheck ( ) const

Run internal consistency check (testing only).

Definition at line 721 of file txrequest.cpp.

◆ Size()

size_t TxRequestTracker::Size ( ) const

Count how many announcements are being tracked in total across all peers and transaction hashes.

Definition at line 720 of file txrequest.cpp.

Member Data Documentation

◆ m_impl

const std::unique_ptr<Impl> TxRequestTracker::m_impl
private

Definition at line 99 of file txrequest.h.


The documentation for this class was generated from the following files: