Bitcoin Core 28.99.0
P2P Digital Currency
txdownloadman_impl.cpp
Go to the documentation of this file.
1// Copyright (c) 2024
2// Distributed under the MIT software license, see the accompanying
3// file COPYING or http://www.opensource.org/licenses/mit-license.php.
4
7
8#include <chain.h>
10#include <logging.h>
11#include <txmempool.h>
12#include <validation.h>
13#include <validationinterface.h>
14
15namespace node {
16// TxDownloadManager wrappers
18 m_impl{std::make_unique<TxDownloadManagerImpl>(options)}
19{}
21
23{
24 m_impl->ActiveTipChange();
25}
26void TxDownloadManager::BlockConnected(const std::shared_ptr<const CBlock>& pblock)
27{
28 m_impl->BlockConnected(pblock);
29}
31{
32 m_impl->BlockDisconnected();
33}
35{
36 m_impl->ConnectedPeer(nodeid, info);
37}
39{
40 m_impl->DisconnectedPeer(nodeid);
41}
42bool TxDownloadManager::AddTxAnnouncement(NodeId peer, const GenTxid& gtxid, std::chrono::microseconds now)
43{
44 return m_impl->AddTxAnnouncement(peer, gtxid, now);
45}
46std::vector<GenTxid> TxDownloadManager::GetRequestsToSend(NodeId nodeid, std::chrono::microseconds current_time)
47{
48 return m_impl->GetRequestsToSend(nodeid, current_time);
49}
50void TxDownloadManager::ReceivedNotFound(NodeId nodeid, const std::vector<uint256>& txhashes)
51{
52 m_impl->ReceivedNotFound(nodeid, txhashes);
53}
55{
56 m_impl->MempoolAcceptedTx(tx);
57}
58RejectedTxTodo TxDownloadManager::MempoolRejectedTx(const CTransactionRef& ptx, const TxValidationState& state, NodeId nodeid, bool first_time_failure)
59{
60 return m_impl->MempoolRejectedTx(ptx, state, nodeid, first_time_failure);
61}
63{
64 m_impl->MempoolRejectedPackage(package);
65}
66std::pair<bool, std::optional<PackageToValidate>> TxDownloadManager::ReceivedTx(NodeId nodeid, const CTransactionRef& ptx)
67{
68 return m_impl->ReceivedTx(nodeid, ptx);
69}
71{
72 return m_impl->HaveMoreWork(nodeid);
73}
75{
76 return m_impl->GetTxToReconsider(nodeid);
77}
79{
80 m_impl->CheckIsEmpty();
81}
83{
84 m_impl->CheckIsEmpty(nodeid);
85}
86std::vector<TxOrphanage::OrphanTxBase> TxDownloadManager::GetOrphanTransactions() const
87{
88 return m_impl->GetOrphanTransactions();
89}
90
91// TxDownloadManagerImpl
93{
96}
97
98void TxDownloadManagerImpl::BlockConnected(const std::shared_ptr<const CBlock>& pblock)
99{
100 m_orphanage.EraseForBlock(*pblock);
101
102 for (const auto& ptx : pblock->vtx) {
103 RecentConfirmedTransactionsFilter().insert(ptx->GetHash().ToUint256());
104 if (ptx->HasWitness()) {
105 RecentConfirmedTransactionsFilter().insert(ptx->GetWitnessHash().ToUint256());
106 }
107 m_txrequest.ForgetTxHash(ptx->GetHash());
108 m_txrequest.ForgetTxHash(ptx->GetWitnessHash());
109 }
110}
111
113{
114 // To avoid relay problems with transactions that were previously
115 // confirmed, clear our filter of recently confirmed transactions whenever
116 // there's a reorg.
117 // This means that in a 1-block reorg (where 1 block is disconnected and
118 // then another block reconnected), our filter will drop to having only one
119 // block's worth of transactions in it, but that should be fine, since
120 // presumably the most common case of relaying a confirmed transaction
121 // should be just after a new block containing it is found.
123}
124
125bool TxDownloadManagerImpl::AlreadyHaveTx(const GenTxid& gtxid, bool include_reconsiderable)
126{
127 const uint256& hash = gtxid.GetHash();
128
129 if (gtxid.IsWtxid()) {
130 // Normal query by wtxid.
131 if (m_orphanage.HaveTx(Wtxid::FromUint256(hash))) return true;
132 } else {
133 // Never query by txid: it is possible that the transaction in the orphanage has the same
134 // txid but a different witness, which would give us a false positive result. If we decided
135 // not to request the transaction based on this result, an attacker could prevent us from
136 // downloading a transaction by intentionally creating a malleated version of it. While
137 // only one (or none!) of these transactions can ultimately be confirmed, we have no way of
138 // discerning which one that is, so the orphanage can store multiple transactions with the
139 // same txid.
140 //
141 // While we won't query by txid, we can try to "guess" what the wtxid is based on the txid.
142 // A non-segwit transaction's txid == wtxid. Query this txid "casted" to a wtxid. This will
143 // help us find non-segwit transactions, saving bandwidth, and should have no false positives.
144 if (m_orphanage.HaveTx(Wtxid::FromUint256(hash))) return true;
145 }
146
147 if (include_reconsiderable && RecentRejectsReconsiderableFilter().contains(hash)) return true;
148
149 if (RecentConfirmedTransactionsFilter().contains(hash)) return true;
150
151 return RecentRejectsFilter().contains(hash) || m_opts.m_mempool.exists(gtxid);
152}
153
155{
156 // If already connected (shouldn't happen in practice), exit early.
157 if (m_peer_info.contains(nodeid)) return;
158
159 m_peer_info.try_emplace(nodeid, info);
160 if (info.m_wtxid_relay) m_num_wtxid_peers += 1;
161}
162
164{
167
168 if (auto it = m_peer_info.find(nodeid); it != m_peer_info.end()) {
169 if (it->second.m_connection_info.m_wtxid_relay) m_num_wtxid_peers -= 1;
170 m_peer_info.erase(it);
171 }
172
173}
174
175bool TxDownloadManagerImpl::AddTxAnnouncement(NodeId peer, const GenTxid& gtxid, std::chrono::microseconds now)
176{
177 // If this is an orphan we are trying to resolve, consider this peer as a orphan resolution candidate instead.
178 // - is wtxid matching something in orphanage
179 // - exists in orphanage
180 // - peer can be an orphan resolution candidate
181 if (gtxid.IsWtxid()) {
182 if (auto orphan_tx{m_orphanage.GetTx(Wtxid::FromUint256(gtxid.GetHash()))}) {
183 auto unique_parents{GetUniqueParents(*orphan_tx)};
184 std::erase_if(unique_parents, [&](const auto& txid){
185 return AlreadyHaveTx(GenTxid::Txid(txid), /*include_reconsiderable=*/false);
186 });
187
188 if (unique_parents.empty()) return true;
189
190 if (auto delay{OrphanResolutionCandidate(peer, Wtxid::FromUint256(gtxid.GetHash()), unique_parents.size())}) {
192
193 const auto& info = m_peer_info.at(peer).m_connection_info;
194 for (const auto& parent_txid : unique_parents) {
195 m_txrequest.ReceivedInv(peer, GenTxid::Txid(parent_txid), info.m_preferred, now + *delay);
196 }
197
198 LogDebug(BCLog::TXPACKAGES, "added peer=%d as a candidate for resolving orphan %s\n", peer, gtxid.GetHash().ToString());
199 }
200
201 // Return even if the peer isn't an orphan resolution candidate. This would be caught by AlreadyHaveTx.
202 return true;
203 }
204 }
205
206 // If this is an inv received from a peer and we already have it, we can drop it.
207 if (AlreadyHaveTx(gtxid, /*include_reconsiderable=*/true)) return true;
208
209 auto it = m_peer_info.find(peer);
210 if (it == m_peer_info.end()) return false;
211 const auto& info = it->second.m_connection_info;
212 if (!info.m_relay_permissions && m_txrequest.Count(peer) >= MAX_PEER_TX_ANNOUNCEMENTS) {
213 // Too many queued announcements for this peer
214 return false;
215 }
216 // Decide the TxRequestTracker parameters for this announcement:
217 // - "preferred": if fPreferredDownload is set (= outbound, or NetPermissionFlags::NoBan permission)
218 // - "reqtime": current time plus delays for:
219 // - NONPREF_PEER_TX_DELAY for announcements from non-preferred connections
220 // - TXID_RELAY_DELAY for txid announcements while wtxid peers are available
221 // - OVERLOADED_PEER_TX_DELAY for announcements from peers which have at least
222 // MAX_PEER_TX_REQUEST_IN_FLIGHT requests in flight (and don't have NetPermissionFlags::Relay).
223 auto delay{0us};
224 if (!info.m_preferred) delay += NONPREF_PEER_TX_DELAY;
225 if (!gtxid.IsWtxid() && m_num_wtxid_peers > 0) delay += TXID_RELAY_DELAY;
226 const bool overloaded = !info.m_relay_permissions && m_txrequest.CountInFlight(peer) >= MAX_PEER_TX_REQUEST_IN_FLIGHT;
227 if (overloaded) delay += OVERLOADED_PEER_TX_DELAY;
228
229 m_txrequest.ReceivedInv(peer, gtxid, info.m_preferred, now + delay);
230
231 return false;
232}
233
234std::optional<std::chrono::seconds> TxDownloadManagerImpl::OrphanResolutionCandidate(NodeId nodeid, const Wtxid& orphan_wtxid, size_t num_parents)
235{
236 if (m_peer_info.count(nodeid) == 0) return std::nullopt;
237 if (m_orphanage.HaveTxFromPeer(orphan_wtxid, nodeid)) return std::nullopt;
238
239 const auto& peer_entry = m_peer_info.at(nodeid);
240 const auto& info = peer_entry.m_connection_info;
241 // TODO: add delays and limits based on the amount of orphan resolution we are already doing
242 // with this peer, how much they are using the orphanage, etc.
243 if (!info.m_relay_permissions) {
244 // This mirrors the delaying and dropping behavior in AddTxAnnouncement in order to preserve
245 // existing behavior: drop if we are tracking too many invs for this peer already. Each
246 // orphan resolution involves at least 1 transaction request which may or may not be
247 // currently tracked in m_txrequest, so we include that in the count.
248 if (m_txrequest.Count(nodeid) + num_parents > MAX_PEER_TX_ANNOUNCEMENTS) return std::nullopt;
249 }
250
251 std::chrono::seconds delay{0s};
252 if (!info.m_preferred) delay += NONPREF_PEER_TX_DELAY;
253 // The orphan wtxid is used, but resolution entails requesting the parents by txid. Sometimes
254 // parent and child are announced and thus requested around the same time, and we happen to
255 // receive child sooner. Waiting a few seconds may allow us to cancel the orphan resolution
256 // request if the parent arrives in that time.
257 if (m_num_wtxid_peers > 0) delay += TXID_RELAY_DELAY;
258 const bool overloaded = !info.m_relay_permissions && m_txrequest.CountInFlight(nodeid) >= MAX_PEER_TX_REQUEST_IN_FLIGHT;
259 if (overloaded) delay += OVERLOADED_PEER_TX_DELAY;
260
261 return delay;
262}
263
264std::vector<GenTxid> TxDownloadManagerImpl::GetRequestsToSend(NodeId nodeid, std::chrono::microseconds current_time)
265{
266 std::vector<GenTxid> requests;
267 std::vector<std::pair<NodeId, GenTxid>> expired;
268 auto requestable = m_txrequest.GetRequestable(nodeid, current_time, &expired);
269 for (const auto& entry : expired) {
270 LogDebug(BCLog::NET, "timeout of inflight %s %s from peer=%d\n", entry.second.IsWtxid() ? "wtx" : "tx",
271 entry.second.GetHash().ToString(), entry.first);
272 }
273 for (const GenTxid& gtxid : requestable) {
274 if (!AlreadyHaveTx(gtxid, /*include_reconsiderable=*/false)) {
275 LogDebug(BCLog::NET, "Requesting %s %s peer=%d\n", gtxid.IsWtxid() ? "wtx" : "tx",
276 gtxid.GetHash().ToString(), nodeid);
277 requests.emplace_back(gtxid);
278 m_txrequest.RequestedTx(nodeid, gtxid.GetHash(), current_time + GETDATA_TX_INTERVAL);
279 } else {
280 // We have already seen this transaction, no need to download. This is just a belt-and-suspenders, as
281 // this should already be called whenever a transaction becomes AlreadyHaveTx().
282 m_txrequest.ForgetTxHash(gtxid.GetHash());
283 }
284 }
285 return requests;
286}
287
288void TxDownloadManagerImpl::ReceivedNotFound(NodeId nodeid, const std::vector<uint256>& txhashes)
289{
290 for (const auto& txhash : txhashes) {
291 // If we receive a NOTFOUND message for a tx we requested, mark the announcement for it as
292 // completed in TxRequestTracker.
293 m_txrequest.ReceivedResponse(nodeid, txhash);
294 }
295}
296
297std::optional<PackageToValidate> TxDownloadManagerImpl::Find1P1CPackage(const CTransactionRef& ptx, NodeId nodeid)
298{
299 const auto& parent_wtxid{ptx->GetWitnessHash()};
300
301 Assume(RecentRejectsReconsiderableFilter().contains(parent_wtxid.ToUint256()));
302
303 // Only consider children from this peer. This helps prevent censorship attempts in which an attacker
304 // sends lots of fake children for the parent, and we (unluckily) keep selecting the fake
305 // children instead of the real one provided by the honest peer. Since we track all announcers
306 // of an orphan, this does not exclude parent + orphan pairs that we happened to request from
307 // different peers.
308 const auto cpfp_candidates_same_peer{m_orphanage.GetChildrenFromSamePeer(ptx, nodeid)};
309
310 // These children should be sorted from newest to oldest. In the (probably uncommon) case
311 // of children that replace each other, this helps us accept the highest feerate (probably the
312 // most recent) one efficiently.
313 for (const auto& child : cpfp_candidates_same_peer) {
314 Package maybe_cpfp_package{ptx, child};
315 if (!RecentRejectsReconsiderableFilter().contains(GetPackageHash(maybe_cpfp_package)) &&
316 !RecentRejectsFilter().contains(child->GetHash().ToUint256())) {
317 return PackageToValidate{ptx, child, nodeid, nodeid};
318 }
319 }
320 return std::nullopt;
321}
322
324{
325 // As this version of the transaction was acceptable, we can forget about any requests for it.
326 // No-op if the tx is not in txrequest.
327 m_txrequest.ForgetTxHash(tx->GetHash());
328 m_txrequest.ForgetTxHash(tx->GetWitnessHash());
329
331 // If it came from the orphanage, remove it. No-op if the tx is not in txorphanage.
332 m_orphanage.EraseTx(tx->GetWitnessHash());
333}
334
336{
337 std::vector<Txid> unique_parents;
338 unique_parents.reserve(tx.vin.size());
339 for (const CTxIn& txin : tx.vin) {
340 // We start with all parents, and then remove duplicates below.
341 unique_parents.push_back(txin.prevout.hash);
342 }
343
344 std::sort(unique_parents.begin(), unique_parents.end());
345 unique_parents.erase(std::unique(unique_parents.begin(), unique_parents.end()), unique_parents.end());
346
347 return unique_parents;
348}
349
351{
352 const CTransaction& tx{*ptx};
353 // Results returned to caller
354 // Whether we should call AddToCompactExtraTransactions at the end
355 bool add_extra_compact_tx{first_time_failure};
356 // Hashes to pass to AddKnownTx later
357 std::vector<Txid> unique_parents;
358 // Populated if failure is reconsiderable and eligible package is found.
359 std::optional<node::PackageToValidate> package_to_validate;
360
362 // Only process a new orphan if this is a first time failure, as otherwise it must be either
363 // already in orphanage or from 1p1c processing.
364 if (first_time_failure && !RecentRejectsFilter().contains(ptx->GetWitnessHash().ToUint256())) {
365 bool fRejectedParents = false; // It may be the case that the orphans parents have all been rejected
366
367 // Deduplicate parent txids, so that we don't have to loop over
368 // the same parent txid more than once down below.
369 unique_parents = GetUniqueParents(tx);
370
371 // Distinguish between parents in m_lazy_recent_rejects and m_lazy_recent_rejects_reconsiderable.
372 // We can tolerate having up to 1 parent in m_lazy_recent_rejects_reconsiderable since we
373 // submit 1p1c packages. However, fail immediately if any are in m_lazy_recent_rejects.
374 std::optional<uint256> rejected_parent_reconsiderable;
375 for (const uint256& parent_txid : unique_parents) {
376 if (RecentRejectsFilter().contains(parent_txid)) {
377 fRejectedParents = true;
378 break;
379 } else if (RecentRejectsReconsiderableFilter().contains(parent_txid) &&
380 !m_opts.m_mempool.exists(GenTxid::Txid(parent_txid))) {
381 // More than 1 parent in m_lazy_recent_rejects_reconsiderable: 1p1c will not be
382 // sufficient to accept this package, so just give up here.
383 if (rejected_parent_reconsiderable.has_value()) {
384 fRejectedParents = true;
385 break;
386 }
387 rejected_parent_reconsiderable = parent_txid;
388 }
389 }
390 if (!fRejectedParents) {
391 // Filter parents that we already have.
392 // Exclude m_lazy_recent_rejects_reconsiderable: the missing parent may have been
393 // previously rejected for being too low feerate. This orphan might CPFP it.
394 std::erase_if(unique_parents, [&](const auto& txid){
395 return AlreadyHaveTx(GenTxid::Txid(txid), /*include_reconsiderable=*/false);
396 });
397 const auto now{GetTime<std::chrono::microseconds>()};
398 const auto& wtxid = ptx->GetWitnessHash();
399 // Potentially flip add_extra_compact_tx to false if tx is already in orphanage, which
400 // means it was already added to vExtraTxnForCompact.
401 add_extra_compact_tx &= !m_orphanage.HaveTx(wtxid);
402
403 auto add_orphan_reso_candidate = [&](const CTransactionRef& orphan_tx, const std::vector<Txid>& unique_parents, NodeId nodeid, std::chrono::microseconds now) {
404 const auto& wtxid = orphan_tx->GetWitnessHash();
405 if (auto delay{OrphanResolutionCandidate(nodeid, wtxid, unique_parents.size())}) {
406 const auto& info = m_peer_info.at(nodeid).m_connection_info;
407 m_orphanage.AddTx(orphan_tx, nodeid);
408
409 // Treat finding orphan resolution candidate as equivalent to the peer announcing all missing parents
410 // In the future, orphan resolution may include more explicit steps
411 for (const auto& parent_txid : unique_parents) {
412 m_txrequest.ReceivedInv(nodeid, GenTxid::Txid(parent_txid), info.m_preferred, now + *delay);
413 }
414 LogDebug(BCLog::TXPACKAGES, "added peer=%d as a candidate for resolving orphan %s\n", nodeid, wtxid.ToString());
415 }
416 };
417
418 // If there is no candidate for orphan resolution, AddTx will not be called. This means
419 // that if a peer is overloading us with invs and orphans, they will eventually not be
420 // able to add any more transactions to the orphanage.
421 add_orphan_reso_candidate(ptx, unique_parents, nodeid, now);
422 for (const auto& candidate : m_txrequest.GetCandidatePeers(ptx)) {
423 add_orphan_reso_candidate(ptx, unique_parents, candidate, now);
424 }
425
426 // Once added to the orphan pool, a tx is considered AlreadyHave, and we shouldn't request it anymore.
427 m_txrequest.ForgetTxHash(tx.GetHash());
428 m_txrequest.ForgetTxHash(tx.GetWitnessHash());
429
430 // DoS prevention: do not allow m_orphanage to grow unbounded (see CVE-2012-3789)
431 // Note that, if the orphanage reaches capacity, it's possible that we immediately evict
432 // the transaction we just added.
434 } else {
435 unique_parents.clear();
436 LogDebug(BCLog::MEMPOOL, "not keeping orphan with rejected parents %s (wtxid=%s)\n",
437 tx.GetHash().ToString(),
438 tx.GetWitnessHash().ToString());
439 // We will continue to reject this tx since it has rejected
440 // parents so avoid re-requesting it from other peers.
441 // Here we add both the txid and the wtxid, as we know that
442 // regardless of what witness is provided, we will not accept
443 // this, so we don't need to allow for redownload of this txid
444 // from any of our non-wtxidrelay peers.
445 RecentRejectsFilter().insert(tx.GetHash().ToUint256());
446 RecentRejectsFilter().insert(tx.GetWitnessHash().ToUint256());
447 m_txrequest.ForgetTxHash(tx.GetHash());
448 m_txrequest.ForgetTxHash(tx.GetWitnessHash());
449 }
450 }
452 add_extra_compact_tx = false;
453 } else {
454 // We can add the wtxid of this transaction to our reject filter.
455 // Do not add txids of witness transactions or witness-stripped
456 // transactions to the filter, as they can have been malleated;
457 // adding such txids to the reject filter would potentially
458 // interfere with relay of valid transactions from peers that
459 // do not support wtxid-based relay. See
460 // https://github.com/bitcoin/bitcoin/issues/8279 for details.
461 // We can remove this restriction (and always add wtxids to
462 // the filter even for witness stripped transactions) once
463 // wtxid-based relay is broadly deployed.
464 // See also comments in https://github.com/bitcoin/bitcoin/pull/18044#discussion_r443419034
465 // for concerns around weakening security of unupgraded nodes
466 // if we start doing this too early.
468 // If the result is TX_RECONSIDERABLE, add it to m_lazy_recent_rejects_reconsiderable
469 // because we should not download or submit this transaction by itself again, but may
470 // submit it as part of a package later.
471 RecentRejectsReconsiderableFilter().insert(ptx->GetWitnessHash().ToUint256());
472
473 if (first_time_failure) {
474 // When a transaction fails for TX_RECONSIDERABLE, look for a matching child in the
475 // orphanage, as it is possible that they succeed as a package.
476 LogDebug(BCLog::TXPACKAGES, "tx %s (wtxid=%s) failed but reconsiderable, looking for child in orphanage\n",
477 ptx->GetHash().ToString(), ptx->GetWitnessHash().ToString());
478 package_to_validate = Find1P1CPackage(ptx, nodeid);
479 }
480 } else {
481 RecentRejectsFilter().insert(ptx->GetWitnessHash().ToUint256());
482 }
483 m_txrequest.ForgetTxHash(ptx->GetWitnessHash());
484 // If the transaction failed for TX_INPUTS_NOT_STANDARD,
485 // then we know that the witness was irrelevant to the policy
486 // failure, since this check depends only on the txid
487 // (the scriptPubKey being spent is covered by the txid).
488 // Add the txid to the reject filter to prevent repeated
489 // processing of this transaction in the event that child
490 // transactions are later received (resulting in
491 // parent-fetching by txid via the orphan-handling logic).
492 // We only add the txid if it differs from the wtxid, to avoid wasting entries in the
493 // rolling bloom filter.
494 if (state.GetResult() == TxValidationResult::TX_INPUTS_NOT_STANDARD && ptx->HasWitness()) {
495 RecentRejectsFilter().insert(ptx->GetHash().ToUint256());
496 m_txrequest.ForgetTxHash(ptx->GetHash());
497 }
498 }
499
500 // If the tx failed in ProcessOrphanTx, it should be removed from the orphanage unless the
501 // tx was still missing inputs. If the tx was not in the orphanage, EraseTx does nothing and returns 0.
502 if (state.GetResult() != TxValidationResult::TX_MISSING_INPUTS && m_orphanage.EraseTx(ptx->GetWitnessHash()) > 0) {
503 LogDebug(BCLog::TXPACKAGES, " removed orphan tx %s (wtxid=%s)\n", ptx->GetHash().ToString(), ptx->GetWitnessHash().ToString());
504 }
505
506 return RejectedTxTodo{
507 .m_should_add_extra_compact_tx = add_extra_compact_tx,
508 .m_unique_parents = std::move(unique_parents),
509 .m_package_to_validate = std::move(package_to_validate)
510 };
511}
512
514{
516}
517
518std::pair<bool, std::optional<PackageToValidate>> TxDownloadManagerImpl::ReceivedTx(NodeId nodeid, const CTransactionRef& ptx)
519{
520 const uint256& txid = ptx->GetHash();
521 const uint256& wtxid = ptx->GetWitnessHash();
522
523 // Mark that we have received a response
524 m_txrequest.ReceivedResponse(nodeid, txid);
525 if (ptx->HasWitness()) m_txrequest.ReceivedResponse(nodeid, wtxid);
526
527 // First check if we should drop this tx.
528 // We do the AlreadyHaveTx() check using wtxid, rather than txid - in the
529 // absence of witness malleation, this is strictly better, because the
530 // recent rejects filter may contain the wtxid but rarely contains
531 // the txid of a segwit transaction that has been rejected.
532 // In the presence of witness malleation, it's possible that by only
533 // doing the check with wtxid, we could overlook a transaction which
534 // was confirmed with a different witness, or exists in our mempool
535 // with a different witness, but this has limited downside:
536 // mempool validation does its own lookup of whether we have the txid
537 // already; and an adversary can already relay us old transactions
538 // (older than our recency filter) if trying to DoS us, without any need
539 // for witness malleation.
540 if (AlreadyHaveTx(GenTxid::Wtxid(wtxid), /*include_reconsiderable=*/false)) {
541 // If a tx is detected by m_lazy_recent_rejects it is ignored. Because we haven't
542 // submitted the tx to our mempool, we won't have computed a DoS
543 // score for it or determined exactly why we consider it invalid.
544 //
545 // This means we won't penalize any peer subsequently relaying a DoSy
546 // tx (even if we penalized the first peer who gave it to us) because
547 // we have to account for m_lazy_recent_rejects showing false positives. In
548 // other words, we shouldn't penalize a peer if we aren't *sure* they
549 // submitted a DoSy tx.
550 //
551 // Note that m_lazy_recent_rejects doesn't just record DoSy or invalid
552 // transactions, but any tx not accepted by the mempool, which may be
553 // due to node policy (vs. consensus). So we can't blanket penalize a
554 // peer simply for relaying a tx that our m_lazy_recent_rejects has caught,
555 // regardless of false positives.
556 return {false, std::nullopt};
557 } else if (RecentRejectsReconsiderableFilter().contains(wtxid)) {
558 // When a transaction is already in m_lazy_recent_rejects_reconsiderable, we shouldn't submit
559 // it by itself again. However, look for a matching child in the orphanage, as it is
560 // possible that they succeed as a package.
561 LogDebug(BCLog::TXPACKAGES, "found tx %s (wtxid=%s) in reconsiderable rejects, looking for child in orphanage\n",
562 txid.ToString(), wtxid.ToString());
563 return {false, Find1P1CPackage(ptx, nodeid)};
564 }
565
566
567 return {true, std::nullopt};
568}
569
571{
572 return m_orphanage.HaveTxToReconsider(nodeid);
573}
574
576{
577 return m_orphanage.GetTxToReconsider(nodeid);
578}
579
581{
582 assert(m_txrequest.Count(nodeid) == 0);
583}
585{
586 assert(m_orphanage.Size() == 0);
587 assert(m_txrequest.Size() == 0);
589}
590std::vector<TxOrphanage::OrphanTxBase> TxDownloadManagerImpl::GetOrphanTransactions() const
591{
593}
594} // namespace node
#define Assume(val)
Assume is the identity function.
Definition: check.h:97
Txid hash
Definition: transaction.h:31
bool contains(Span< const unsigned char > vKey) const
Definition: bloom.cpp:226
void insert(Span< const unsigned char > vKey)
Definition: bloom.cpp:195
The basic transaction that is broadcasted on the network and contained in blocks.
Definition: transaction.h:296
const std::vector< CTxIn > vin
Definition: transaction.h:306
An input of a transaction.
Definition: transaction.h:67
COutPoint prevout
Definition: transaction.h:69
bool exists(const GenTxid &gtxid) const
Definition: txmempool.h:647
A generic txid reference (txid or wtxid).
Definition: transaction.h:428
bool IsWtxid() const
Definition: transaction.h:436
static GenTxid Wtxid(const uint256 &hash)
Definition: transaction.h:435
const uint256 & GetHash() const LIFETIMEBOUND
Definition: transaction.h:437
static GenTxid Txid(const uint256 &hash)
Definition: transaction.h:434
bool AddTx(const CTransactionRef &tx, NodeId peer)
Add a new orphan transaction.
Definition: txorphanage.cpp:15
void EraseForPeer(NodeId peer)
Maybe erase all orphans announced by a peer (eg, after that peer disconnects).
void AddChildrenToWorkSet(const CTransaction &tx)
Add any orphans that list a particular tx as a parent into the from peer's work set.
std::vector< OrphanTxBase > GetOrphanTransactions() const
void LimitOrphans(unsigned int max_orphans, FastRandomContext &rng)
Limit the orphanage to the given maximum.
int EraseTx(const Wtxid &wtxid)
Erase an orphan by wtxid.
Definition: txorphanage.cpp:65
void EraseForBlock(const CBlock &block)
Erase all orphans included in or invalidated by a new block.
size_t Size() const
Return how many entries exist in the orphange.
Definition: txorphanage.h:75
CTransactionRef GetTx(const Wtxid &wtxid) const
bool AddAnnouncer(const Wtxid &wtxid, NodeId peer)
Add an additional announcer to an orphan if it exists.
Definition: txorphanage.cpp:51
std::vector< CTransactionRef > GetChildrenFromSamePeer(const CTransactionRef &parent, NodeId nodeid) const
Get all children that spend from this tx and were received from nodeid.
bool HaveTx(const Wtxid &wtxid) const
Check if we already have an orphan transaction (by wtxid only)
bool HaveTxToReconsider(NodeId peer)
Does this peer have any work to do?
CTransactionRef GetTxToReconsider(NodeId peer)
Extract a transaction from a peer's work set Returns nullptr if there are no transactions to work on.
bool HaveTxFromPeer(const Wtxid &wtxid, NodeId peer) const
Check if a {tx, peer} exists in the orphanage.
void ReceivedInv(NodeId peer, const GenTxid &gtxid, bool preferred, std::chrono::microseconds reqtime)
Adds a new CANDIDATE announcement.
Definition: txrequest.cpp:749
size_t CountInFlight(NodeId peer) const
Count how many REQUESTED announcements a peer has.
Definition: txrequest.cpp:737
void DisconnectedPeer(NodeId peer)
Deletes all announcements for a given peer.
Definition: txrequest.cpp:736
void ReceivedResponse(NodeId peer, const uint256 &txhash)
Converts a CANDIDATE or REQUESTED announcement to a COMPLETED one.
Definition: txrequest.cpp:760
void RequestedTx(NodeId peer, const uint256 &txhash, std::chrono::microseconds expiry)
Marks a transaction as requested, with a specified expiry.
Definition: txrequest.cpp:755
size_t Count(NodeId peer) const
Count how many announcements a peer has (REQUESTED, CANDIDATE, and COMPLETED combined).
Definition: txrequest.cpp:739
size_t Size() const
Count how many announcements are being tracked in total across all peers and transaction hashes.
Definition: txrequest.cpp:740
std::vector< GenTxid > GetRequestable(NodeId peer, std::chrono::microseconds now, std::vector< std::pair< NodeId, GenTxid > > *expired=nullptr)
Find the txids to request now from peer.
Definition: txrequest.cpp:765
void ForgetTxHash(const uint256 &txhash)
Deletes all announcements for a given txhash (both txid and wtxid ones).
Definition: txrequest.cpp:735
std::vector< NodeId > GetCandidatePeers(const CTransactionRef &tx) const
For some tx return all peers with non-COMPLETED announcements for its txid or wtxid.
Definition: txrequest.cpp:741
Result GetResult() const
Definition: validation.h:109
std::string ToString() const
Definition: uint256.cpp:47
std::vector< TxOrphanage::OrphanTxBase > GetOrphanTransactions() const
Wrapper for TxOrphanage::GetOrphanTransactions.
const std::unique_ptr< TxDownloadManagerImpl > m_impl
std::vector< GenTxid > GetRequestsToSend(NodeId nodeid, std::chrono::microseconds current_time)
Get getdata requests to send.
std::pair< bool, std::optional< PackageToValidate > > ReceivedTx(NodeId nodeid, const CTransactionRef &ptx)
Marks a tx as ReceivedResponse in txrequest and checks whether AlreadyHaveTx.
bool AddTxAnnouncement(NodeId peer, const GenTxid &gtxid, std::chrono::microseconds now)
Consider adding this tx hash to txrequest.
void BlockConnected(const std::shared_ptr< const CBlock > &pblock)
CTransactionRef GetTxToReconsider(NodeId nodeid)
Returns next orphan tx to consider, or nullptr if none exist.
void CheckIsEmpty() const
Check that all data structures are empty.
void MempoolAcceptedTx(const CTransactionRef &tx)
Respond to successful transaction submission to mempool.
void ConnectedPeer(NodeId nodeid, const TxDownloadConnectionInfo &info)
Creates a new PeerInfo.
void MempoolRejectedPackage(const Package &package)
Respond to package rejected from mempool.
void DisconnectedPeer(NodeId nodeid)
Deletes all txrequest announcements and orphans for a given peer.
RejectedTxTodo MempoolRejectedTx(const CTransactionRef &ptx, const TxValidationState &state, NodeId nodeid, bool first_time_failure)
Respond to transaction rejected from mempool.
TxDownloadManager(const TxDownloadOptions &options)
void ReceivedNotFound(NodeId nodeid, const std::vector< uint256 > &txhashes)
Should be called when a notfound for a tx has been received.
bool HaveMoreWork(NodeId nodeid) const
Whether there are any orphans to reconsider for this peer.
std::optional< PackageToValidate > Find1P1CPackage(const CTransactionRef &ptx, NodeId nodeid)
Look for a child of this transaction in the orphanage to form a 1-parent-1-child package,...
bool AddTxAnnouncement(NodeId peer, const GenTxid &gtxid, std::chrono::microseconds now)
Consider adding this tx hash to txrequest.
CRollingBloomFilter & RecentConfirmedTransactionsFilter()
void ReceivedNotFound(NodeId nodeid, const std::vector< uint256 > &txhashes)
Marks a tx as ReceivedResponse in txrequest.
void DisconnectedPeer(NodeId nodeid)
std::optional< std::chrono::seconds > OrphanResolutionCandidate(NodeId nodeid, const Wtxid &orphan_wtxid, size_t num_parents)
Determine candidacy (and delay) for potential orphan resolution candidate.
TxRequestTracker m_txrequest
Tracks candidates for requesting and downloading transaction data.
std::pair< bool, std::optional< PackageToValidate > > ReceivedTx(NodeId nodeid, const CTransactionRef &ptx)
void MempoolAcceptedTx(const CTransactionRef &tx)
CRollingBloomFilter & RecentRejectsReconsiderableFilter()
RejectedTxTodo MempoolRejectedTx(const CTransactionRef &ptx, const TxValidationState &state, NodeId nodeid, bool first_time_failure)
std::vector< TxOrphanage::OrphanTxBase > GetOrphanTransactions() const
uint32_t m_num_wtxid_peers
Number of wtxid relay peers we have in m_peer_info.
void ConnectedPeer(NodeId nodeid, const TxDownloadConnectionInfo &info)
bool AlreadyHaveTx(const GenTxid &gtxid, bool include_reconsiderable)
Check whether we already have this gtxid in:
std::map< NodeId, PeerInfo > m_peer_info
Information for all of the peers we may download transactions from.
TxOrphanage m_orphanage
Manages unvalidated tx data (orphan transactions for which we are downloading ancestors).
std::vector< GenTxid > GetRequestsToSend(NodeId nodeid, std::chrono::microseconds current_time)
Get getdata requests to send.
std::vector< Txid > GetUniqueParents(const CTransaction &tx)
Helper for getting deduplicated vector of Txids in vin.
void BlockConnected(const std::shared_ptr< const CBlock > &pblock)
CTransactionRef GetTxToReconsider(NodeId nodeid)
CRollingBloomFilter & RecentRejectsFilter()
void MempoolRejectedPackage(const Package &package)
transaction_identifier represents the two canonical transaction identifier types (txid,...
static constexpr auto size()
static transaction_identifier FromUint256(const uint256 &id)
256-bit opaque blob.
Definition: uint256.h:201
@ TX_MISSING_INPUTS
transaction was missing some of its inputs
@ TX_INPUTS_NOT_STANDARD
inputs (covered by txid) failed policy rules
@ TX_WITNESS_STRIPPED
Transaction is missing a witness.
@ TX_RECONSIDERABLE
fails some policy, but might be acceptable if submitted in a (different) package
#define LogDebug(category,...)
Definition: logging.h:280
@ TXPACKAGES
Definition: logging.h:73
@ MEMPOOL
Definition: logging.h:45
@ NET
Definition: logging.h:43
Definition: messages.h:20
static constexpr auto GETDATA_TX_INTERVAL
How long to wait before downloading a transaction from an additional peer.
Definition: txdownloadman.h:38
static constexpr int32_t MAX_PEER_TX_ANNOUNCEMENTS
Maximum number of transactions to consider for requesting, per peer.
Definition: txdownloadman.h:30
static constexpr int32_t MAX_PEER_TX_REQUEST_IN_FLIGHT
Maximum number of in-flight transaction requests from a peer.
Definition: txdownloadman.h:25
static constexpr auto TXID_RELAY_DELAY
How long to delay requesting transactions via txids, if we have wtxid-relaying peers.
Definition: txdownloadman.h:32
static constexpr auto OVERLOADED_PEER_TX_DELAY
How long to delay requesting transactions from overloaded peers (see MAX_PEER_TX_REQUEST_IN_FLIGHT).
Definition: txdownloadman.h:36
static constexpr auto NONPREF_PEER_TX_DELAY
How long to delay requesting transactions from non-preferred peers.
Definition: txdownloadman.h:34
int64_t NodeId
Definition: net.h:97
uint256 GetPackageHash(const std::vector< CTransactionRef > &transactions)
Get the hash of the concatenated wtxids of transactions, with wtxids treated as a little-endian numbe...
Definition: packages.cpp:151
std::vector< CTransactionRef > Package
A package is an ordered list of transactions.
Definition: packages.h:50
std::shared_ptr< const CTransaction > CTransactionRef
Definition: transaction.h:423
bool m_should_add_extra_compact_tx
Definition: txdownloadman.h:94
const bool m_wtxid_relay
Whether this peer supports wtxid relay.
Definition: txdownloadman.h:55
FastRandomContext & m_rng
RNG provided by caller.
Definition: txdownloadman.h:43
const uint32_t m_max_orphan_txs
Maximum number of transactions allowed in orphanage.
Definition: txdownloadman.h:45
const CTxMemPool & m_mempool
Read-only reference to mempool.
Definition: txdownloadman.h:41
assert(!tx.IsCoinBase())