Bitcoin Core 31.99.0
P2P Digital Currency
private_broadcast.cpp
Go to the documentation of this file.
1// Copyright (c) 2023-present The Bitcoin Core developers
2// Distributed under the MIT software license, see the accompanying
3// file COPYING or https://opensource.org/license/mit/.
4
5#include <private_broadcast.h>
6#include <util/check.h>
7
8#include <algorithm>
9
10
13{
14 LOCK(m_mutex);
15 const bool inserted{m_transactions.try_emplace(tx).second};
16 return inserted;
17}
18
19std::optional<size_t> PrivateBroadcast::Remove(const CTransactionRef& tx)
21{
22 LOCK(m_mutex);
23 const auto handle{m_transactions.extract(tx)};
24 if (handle) {
25 const auto p{DerivePriority(handle.mapped().send_statuses)};
26 return p.num_confirmed;
27 }
28 return std::nullopt;
29}
30
31std::optional<CTransactionRef> PrivateBroadcast::PickTxForSend(const NodeId& will_send_to_nodeid, const CService& will_send_to_address)
33{
34 LOCK(m_mutex);
35
36 const auto it{std::ranges::max_element(
37 m_transactions,
38 [](const auto& a, const auto& b) { return a < b; },
39 [](const auto& el) { return DerivePriority(el.second.send_statuses); })};
40
41 if (it != m_transactions.end()) {
42 auto& [tx, state]{*it};
43 state.send_statuses.emplace_back(will_send_to_nodeid, will_send_to_address, NodeClock::now());
44 return tx;
45 }
46
47 return std::nullopt;
48}
49
50std::optional<CTransactionRef> PrivateBroadcast::GetTxForNode(const NodeId& nodeid)
52{
53 LOCK(m_mutex);
54 const auto tx_and_status{GetSendStatusByNode(nodeid)};
55 if (tx_and_status.has_value()) {
56 return tx_and_status.value().tx;
57 }
58 return std::nullopt;
59}
60
63{
64 LOCK(m_mutex);
65 const auto tx_and_status{GetSendStatusByNode(nodeid)};
66 if (tx_and_status.has_value()) {
67 tx_and_status.value().send_status.confirmed = NodeClock::now();
68 }
69}
70
73{
74 LOCK(m_mutex);
75 const auto tx_and_status{GetSendStatusByNode(nodeid)};
76 if (tx_and_status.has_value()) {
77 return tx_and_status.value().send_status.confirmed.has_value();
78 }
79 return false;
80}
81
84{
86 return !m_transactions.empty();
87}
88
89std::vector<CTransactionRef> PrivateBroadcast::GetStale() const
91{
93 const auto now{NodeClock::now()};
94 std::vector<CTransactionRef> stale;
95 for (const auto& [tx, state] : m_transactions) {
96 const Priority p{DerivePriority(state.send_statuses)};
97 if (p.num_confirmed == 0) {
98 if (state.time_added < now - INITIAL_STALE_DURATION) stale.push_back(tx);
99 } else {
100 if (p.last_confirmed < now - STALE_DURATION) stale.push_back(tx);
101 }
102 }
103 return stale;
104}
105
106std::vector<PrivateBroadcast::TxBroadcastInfo> PrivateBroadcast::GetBroadcastInfo() const
108{
109 LOCK(m_mutex);
110 std::vector<TxBroadcastInfo> entries;
111 entries.reserve(m_transactions.size());
112
113 for (const auto& [tx, state] : m_transactions) {
114 std::vector<PeerSendInfo> peers;
115 peers.reserve(state.send_statuses.size());
116 for (const auto& status : state.send_statuses) {
117 peers.emplace_back(PeerSendInfo{.address = status.address, .sent = status.picked, .received = status.confirmed});
118 }
119 entries.emplace_back(TxBroadcastInfo{.tx = tx, .time_added = state.time_added, .peers = std::move(peers)});
120 }
121
122 return entries;
123}
124
126{
127 Priority p;
128 p.num_picked = sent_to.size();
129 for (const auto& send_status : sent_to) {
130 p.last_picked = std::max(p.last_picked, send_status.picked);
131 if (send_status.confirmed.has_value()) {
132 ++p.num_confirmed;
133 p.last_confirmed = std::max(p.last_confirmed, send_status.confirmed.value());
134 }
135 }
136 return p;
137}
138
139std::optional<PrivateBroadcast::TxAndSendStatusForNode> PrivateBroadcast::GetSendStatusByNode(const NodeId& nodeid)
141{
142 AssertLockHeld(m_mutex);
143 for (auto& [tx, state] : m_transactions) {
144 for (auto& send_status : state.send_statuses) {
145 if (send_status.nodeid == nodeid) {
146 return TxAndSendStatusForNode{.tx = tx, .send_status = send_status};
147 }
148 }
149 }
150 return std::nullopt;
151}
A combination of a network address (CNetAddr) and a (TCP) port.
Definition: netaddress.h:530
static Priority DerivePriority(const std::vector< SendStatus > &sent_to)
Derive the sending priority of a transaction.
void NodeConfirmedReception(const NodeId &nodeid) EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Mark that the node has confirmed reception of the transaction we sent it by responding with PONG to o...
std::vector< TxBroadcastInfo > GetBroadcastInfo() const EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Get stats about all transactions currently being privately broadcast.
bool HavePendingTransactions() EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Check if there are transactions that need to be broadcast.
bool DidNodeConfirmReception(const NodeId &nodeid) EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Check if the node has confirmed reception of the transaction.
static constexpr auto STALE_DURATION
If a transaction is not received back from the network for this duration after it is broadcast,...
std::optional< size_t > Remove(const CTransactionRef &tx) EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Forget a transaction.
std::optional< CTransactionRef > PickTxForSend(const NodeId &will_send_to_nodeid, const CService &will_send_to_address) EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Pick the transaction with the fewest send attempts, and confirmations, and oldest send/confirm times.
std::optional< TxAndSendStatusForNode > GetSendStatusByNode(const NodeId &nodeid) EXCLUSIVE_LOCKS_REQUIRED(m_mutex)
Find which transaction we sent to a given node (marked by PickTxForSend()).
std::optional< CTransactionRef > GetTxForNode(const NodeId &nodeid) EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Get the transaction that was picked for sending to a given node by PickTxForSend().
bool Add(const CTransactionRef &tx) EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Add a transaction to the storage.
std::vector< CTransactionRef > GetStale() const EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Get the transactions that have not been broadcast recently.
static constexpr auto INITIAL_STALE_DURATION
If a transaction is not sent to any peer for this duration, then we consider it stale / for rebroadca...
int64_t NodeId
Definition: net.h:103
std::shared_ptr< const CTransaction > CTransactionRef
Definition: transaction.h:403
static time_point now() noexcept
Return current system time or mocked time, if set.
Definition: time.cpp:36
Cumulative stats from all the send attempts for a transaction. Used to prioritize transactions.
size_t num_picked
Number of times the transaction was picked for sending.
NodeClock::time_point last_confirmed
The most recent time when the transaction was confirmed.
size_t num_confirmed
Number of nodes that have confirmed reception of a transaction (by PONG).
NodeClock::time_point last_picked
The most recent time when the transaction was picked for sending.
A pair of a transaction and a sent status for a given node. Convenience return type of GetSendStatusB...
#define LOCK(cs)
Definition: sync.h:268
#define EXCLUSIVE_LOCKS_REQUIRED(...)
Definition: threadsafety.h:49
AssertLockHeld(pool.cs)