LCOV - code coverage report
Current view: top level - src - txorphanage.cpp (source / functions) Hit Total Coverage
Test: fuzz_coverage.info Lines: 3 149 2.0 %
Date: 2023-11-10 23:46:46 Functions: 0 13 0.0 %
Branches: 3 252 1.2 %

           Branch data     Line data    Source code
       1                 :            : // Copyright (c) 2021-2022 The Bitcoin Core developers
       2                 :            : // Distributed under the MIT software license, see the accompanying
       3                 :            : // file COPYING or http://www.opensource.org/licenses/mit-license.php.
       4                 :            : 
       5                 :            : #include <txorphanage.h>
       6                 :            : 
       7                 :            : #include <consensus/validation.h>
       8                 :            : #include <logging.h>
       9                 :            : #include <policy/policy.h>
      10                 :            : #include <primitives/transaction.h>
      11                 :            : 
      12                 :            : #include <cassert>
      13                 :            : 
      14                 :            : /** Expiration time for orphan transactions in seconds */
      15                 :            : static constexpr int64_t ORPHAN_TX_EXPIRE_TIME = 20 * 60;
      16                 :            : /** Minimum time between orphan transactions expire time checks in seconds */
      17         [ +  - ]:          2 : static constexpr int64_t ORPHAN_TX_EXPIRE_INTERVAL = 5 * 60;
      18         [ +  - ]:          2 : 
      19                 :            : 
      20                 :          0 : bool TxOrphanage::AddTx(const CTransactionRef& tx, NodeId peer)
      21                 :            : {
      22                 :          0 :     LOCK(m_mutex);
      23                 :            : 
      24         [ #  # ]:          0 :     const Txid& hash = tx->GetHash();
      25         [ #  # ]:          0 :     const Wtxid& wtxid = tx->GetWitnessHash();
      26 [ #  # ][ #  # ]:          0 :     if (m_orphans.count(hash))
      27                 :          0 :         return false;
      28                 :            : 
      29                 :            :     // Ignore big transactions, to avoid a
      30                 :            :     // send-big-orphans memory exhaustion attack. If a peer has a legitimate
      31                 :            :     // large transaction with a missing parent then we assume
      32                 :            :     // it will rebroadcast it later, after the parent transaction(s)
      33                 :            :     // have been mined or received.
      34                 :            :     // 100 orphans, each of which is at most 100,000 bytes big is
      35                 :            :     // at most 10 megabytes of orphans and somewhat more byprev index (in the worst case):
      36         [ #  # ]:          0 :     unsigned int sz = GetTransactionWeight(*tx);
      37         [ #  # ]:          0 :     if (sz > MAX_STANDARD_TX_WEIGHT)
      38                 :            :     {
      39 [ #  # ][ #  # ]:          0 :         LogPrint(BCLog::TXPACKAGES, "ignoring large orphan tx (size: %u, txid: %s, wtxid: %s)\n", sz, hash.ToString(), wtxid.ToString());
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
                 [ #  # ]
      40                 :          0 :         return false;
      41                 :            :     }
      42                 :            : 
      43 [ #  # ][ #  # ]:          0 :     auto ret = m_orphans.emplace(hash, OrphanTx{tx, peer, GetTime() + ORPHAN_TX_EXPIRE_TIME, m_orphan_list.size()});
      44         [ #  # ]:          0 :     assert(ret.second);
      45         [ #  # ]:          0 :     m_orphan_list.push_back(ret.first);
      46                 :            :     // Allow for lookups in the orphan pool by wtxid, as well as txid
      47 [ #  # ][ #  # ]:          0 :     m_wtxid_to_orphan_it.emplace(tx->GetWitnessHash(), ret.first);
      48         [ #  # ]:          0 :     for (const CTxIn& txin : tx->vin) {
      49 [ #  # ][ #  # ]:          0 :         m_outpoint_to_orphan_it[txin.prevout].insert(ret.first);
      50                 :            :     }
      51                 :            : 
      52 [ #  # ][ #  # ]:          0 :     LogPrint(BCLog::TXPACKAGES, "stored orphan tx %s (wtxid=%s) (mapsz %u outsz %u)\n", hash.ToString(), wtxid.ToString(),
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
                 [ #  # ]
      53                 :            :              m_orphans.size(), m_outpoint_to_orphan_it.size());
      54                 :          0 :     return true;
      55                 :          0 : }
      56                 :            : 
      57                 :          0 : int TxOrphanage::EraseTx(const Txid& txid)
      58                 :            : {
      59                 :          0 :     LOCK(m_mutex);
      60         [ #  # ]:          0 :     return EraseTxNoLock(txid);
      61                 :          0 : }
      62                 :            : 
      63                 :          0 : int TxOrphanage::EraseTxNoLock(const Txid& txid)
      64                 :            : {
      65                 :          0 :     AssertLockHeld(m_mutex);
      66                 :          0 :     std::map<Txid, OrphanTx>::iterator it = m_orphans.find(txid);
      67         [ #  # ]:          0 :     if (it == m_orphans.end())
      68                 :          0 :         return 0;
      69         [ #  # ]:          0 :     for (const CTxIn& txin : it->second.tx->vin)
      70                 :            :     {
      71                 :          0 :         auto itPrev = m_outpoint_to_orphan_it.find(txin.prevout);
      72         [ #  # ]:          0 :         if (itPrev == m_outpoint_to_orphan_it.end())
      73                 :          0 :             continue;
      74                 :          0 :         itPrev->second.erase(it);
      75         [ #  # ]:          0 :         if (itPrev->second.empty())
      76                 :          0 :             m_outpoint_to_orphan_it.erase(itPrev);
      77                 :            :     }
      78                 :            : 
      79                 :          0 :     size_t old_pos = it->second.list_pos;
      80         [ #  # ]:          0 :     assert(m_orphan_list[old_pos] == it);
      81         [ #  # ]:          0 :     if (old_pos + 1 != m_orphan_list.size()) {
      82                 :            :         // Unless we're deleting the last entry in m_orphan_list, move the last
      83         [ +  - ]:          2 :         // entry to the position we're deleting.
      84                 :          0 :         auto it_last = m_orphan_list.back();
      85                 :          0 :         m_orphan_list[old_pos] = it_last;
      86                 :          0 :         it_last->second.list_pos = old_pos;
      87                 :          0 :     }
      88                 :          0 :     const auto& wtxid = it->second.tx->GetWitnessHash();
      89 [ #  # ][ #  # ]:          0 :     LogPrint(BCLog::TXPACKAGES, "   removed orphan tx %s (wtxid=%s)\n", txid.ToString(), wtxid.ToString());
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
      90                 :          0 :     m_orphan_list.pop_back();
      91                 :          0 :     m_wtxid_to_orphan_it.erase(it->second.tx->GetWitnessHash());
      92                 :            : 
      93                 :          0 :     m_orphans.erase(it);
      94                 :          0 :     return 1;
      95                 :          0 : }
      96                 :            : 
      97                 :          0 : void TxOrphanage::EraseForPeer(NodeId peer)
      98                 :            : {
      99                 :          0 :     LOCK(m_mutex);
     100                 :            : 
     101         [ #  # ]:          0 :     m_peer_work_set.erase(peer);
     102                 :            : 
     103                 :          0 :     int nErased = 0;
     104                 :          0 :     std::map<Txid, OrphanTx>::iterator iter = m_orphans.begin();
     105         [ #  # ]:          0 :     while (iter != m_orphans.end())
     106                 :            :     {
     107                 :          0 :         std::map<Txid, OrphanTx>::iterator maybeErase = iter++; // increment to avoid iterator becoming invalid
     108         [ #  # ]:          0 :         if (maybeErase->second.fromPeer == peer)
     109                 :            :         {
     110 [ #  # ][ #  # ]:          0 :             nErased += EraseTxNoLock(maybeErase->second.tx->GetHash());
     111                 :          0 :         }
     112                 :            :     }
     113 [ #  # ][ #  # ]:          0 :     if (nErased > 0) LogPrint(BCLog::TXPACKAGES, "Erased %d orphan tx from peer=%d\n", nErased, peer);
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
     114                 :          0 : }
     115                 :            : 
     116                 :          0 : void TxOrphanage::LimitOrphans(unsigned int max_orphans)
     117                 :            : {
     118                 :          0 :     LOCK(m_mutex);
     119                 :            : 
     120                 :          0 :     unsigned int nEvicted = 0;
     121                 :            :     static int64_t nNextSweep;
     122         [ #  # ]:          0 :     int64_t nNow = GetTime();
     123         [ #  # ]:          0 :     if (nNextSweep <= nNow) {
     124                 :            :         // Sweep out expired orphan pool entries:
     125                 :          0 :         int nErased = 0;
     126                 :          0 :         int64_t nMinExpTime = nNow + ORPHAN_TX_EXPIRE_TIME - ORPHAN_TX_EXPIRE_INTERVAL;
     127                 :          0 :         std::map<Txid, OrphanTx>::iterator iter = m_orphans.begin();
     128         [ #  # ]:          0 :         while (iter != m_orphans.end())
     129                 :            :         {
     130                 :          0 :             std::map<Txid, OrphanTx>::iterator maybeErase = iter++;
     131         [ #  # ]:          0 :             if (maybeErase->second.nTimeExpire <= nNow) {
     132 [ #  # ][ #  # ]:          0 :                 nErased += EraseTxNoLock(maybeErase->second.tx->GetHash());
     133                 :          0 :             } else {
     134         [ #  # ]:          0 :                 nMinExpTime = std::min(maybeErase->second.nTimeExpire, nMinExpTime);
     135                 :            :             }
     136                 :            :         }
     137                 :            :         // Sweep again 5 minutes after the next entry that expires in order to batch the linear scan.
     138                 :          0 :         nNextSweep = nMinExpTime + ORPHAN_TX_EXPIRE_INTERVAL;
     139 [ #  # ][ #  # ]:          0 :         if (nErased > 0) LogPrint(BCLog::TXPACKAGES, "Erased %d orphan tx due to expiration\n", nErased);
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
     140                 :          0 :     }
     141                 :          0 :     FastRandomContext rng;
     142         [ #  # ]:          0 :     while (m_orphans.size() > max_orphans)
     143                 :            :     {
     144                 :            :         // Evict a random orphan:
     145                 :          0 :         size_t randompos = rng.randrange(m_orphan_list.size());
     146         [ #  # ]:          0 :         EraseTxNoLock(m_orphan_list[randompos]->first);
     147                 :          0 :         ++nEvicted;
     148                 :            :     }
     149 [ #  # ][ #  # ]:          0 :     if (nEvicted > 0) LogPrint(BCLog::TXPACKAGES, "orphanage overflow, removed %u tx\n", nEvicted);
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
     150                 :          0 : }
     151                 :            : 
     152                 :          0 : void TxOrphanage::AddChildrenToWorkSet(const CTransaction& tx)
     153                 :            : {
     154                 :          0 :     LOCK(m_mutex);
     155                 :            : 
     156                 :            : 
     157         [ #  # ]:          0 :     for (unsigned int i = 0; i < tx.vout.size(); i++) {
     158 [ #  # ][ #  # ]:          0 :         const auto it_by_prev = m_outpoint_to_orphan_it.find(COutPoint(tx.GetHash(), i));
         [ #  # ][ #  # ]
     159         [ #  # ]:          0 :         if (it_by_prev != m_outpoint_to_orphan_it.end()) {
     160         [ #  # ]:          0 :             for (const auto& elem : it_by_prev->second) {
     161                 :            :                 // Get this source peer's work set, emplacing an empty set if it didn't exist
     162                 :            :                 // (note: if this peer wasn't still connected, we would have removed the orphan tx already)
     163         [ #  # ]:          0 :                 std::set<Txid>& orphan_work_set = m_peer_work_set.try_emplace(elem->second.fromPeer).first->second;
     164                 :            :                 // Add this tx to the work set
     165         [ #  # ]:          0 :                 orphan_work_set.insert(elem->first);
     166 [ #  # ][ #  # ]:          0 :                 LogPrint(BCLog::TXPACKAGES, "added %s (wtxid=%s) to peer %d workset\n",
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
         [ #  # ][ #  # ]
                 [ #  # ]
     167                 :            :                          tx.GetHash().ToString(), tx.GetWitnessHash().ToString(), elem->second.fromPeer);
     168                 :            :             }
     169                 :          0 :         }
     170                 :          0 :     }
     171                 :          0 : }
     172                 :            : 
     173                 :          0 : bool TxOrphanage::HaveTx(const GenTxid& gtxid) const
     174                 :            : {
     175                 :          0 :     LOCK(m_mutex);
     176 [ #  # ][ #  # ]:          0 :     if (gtxid.IsWtxid()) {
     177 [ #  # ][ #  # ]:          0 :         return m_wtxid_to_orphan_it.count(Wtxid::FromUint256(gtxid.GetHash()));
                 [ #  # ]
     178                 :            :     } else {
     179 [ #  # ][ #  # ]:          0 :         return m_orphans.count(Txid::FromUint256(gtxid.GetHash()));
                 [ #  # ]
     180                 :            :     }
     181                 :          0 : }
     182                 :            : 
     183                 :          0 : CTransactionRef TxOrphanage::GetTxToReconsider(NodeId peer)
     184                 :            : {
     185                 :          0 :     LOCK(m_mutex);
     186                 :            : 
     187         [ #  # ]:          0 :     auto work_set_it = m_peer_work_set.find(peer);
     188         [ #  # ]:          0 :     if (work_set_it != m_peer_work_set.end()) {
     189                 :          0 :         auto& work_set = work_set_it->second;
     190         [ #  # ]:          0 :         while (!work_set.empty()) {
     191                 :          0 :             Txid txid = *work_set.begin();
     192         [ #  # ]:          0 :             work_set.erase(work_set.begin());
     193                 :            : 
     194         [ #  # ]:          0 :             const auto orphan_it = m_orphans.find(txid);
     195         [ #  # ]:          0 :             if (orphan_it != m_orphans.end()) {
     196                 :          0 :                 return orphan_it->second.tx;
     197                 :            :             }
     198                 :            :         }
     199                 :          0 :     }
     200                 :          0 :     return nullptr;
     201                 :          0 : }
     202                 :            : 
     203                 :          0 : bool TxOrphanage::HaveTxToReconsider(NodeId peer)
     204                 :            : {
     205                 :          0 :     LOCK(m_mutex);
     206                 :            : 
     207         [ #  # ]:          0 :     auto work_set_it = m_peer_work_set.find(peer);
     208         [ #  # ]:          0 :     if (work_set_it != m_peer_work_set.end()) {
     209                 :          0 :         auto& work_set = work_set_it->second;
     210                 :          0 :         return !work_set.empty();
     211                 :            :     }
     212                 :          0 :     return false;
     213                 :          0 : }
     214                 :            : 
     215                 :          0 : void TxOrphanage::EraseForBlock(const CBlock& block)
     216                 :            : {
     217                 :          0 :     LOCK(m_mutex);
     218                 :            : 
     219                 :          0 :     std::vector<Txid> vOrphanErase;
     220                 :            : 
     221         [ #  # ]:          0 :     for (const CTransactionRef& ptx : block.vtx) {
     222                 :          0 :         const CTransaction& tx = *ptx;
     223                 :            : 
     224                 :            :         // Which orphan pool entries must we evict?
     225         [ #  # ]:          0 :         for (const auto& txin : tx.vin) {
     226         [ #  # ]:          0 :             auto itByPrev = m_outpoint_to_orphan_it.find(txin.prevout);
     227         [ #  # ]:          0 :             if (itByPrev == m_outpoint_to_orphan_it.end()) continue;
     228         [ #  # ]:          0 :             for (auto mi = itByPrev->second.begin(); mi != itByPrev->second.end(); ++mi) {
     229                 :          0 :                 const CTransaction& orphanTx = *(*mi)->second.tx;
     230         [ #  # ]:          0 :                 const auto& orphanHash = orphanTx.GetHash();
     231         [ #  # ]:          0 :                 vOrphanErase.push_back(orphanHash);
     232                 :          0 :             }
     233                 :            :         }
     234                 :            :     }
     235                 :            : 
     236                 :            :     // Erase orphan transactions included or precluded by this block
     237         [ #  # ]:          0 :     if (vOrphanErase.size()) {
     238                 :          0 :         int nErased = 0;
     239         [ #  # ]:          0 :         for (const auto& orphanHash : vOrphanErase) {
     240         [ #  # ]:          0 :             nErased += EraseTxNoLock(orphanHash);
     241                 :            :         }
     242 [ #  # ][ #  # ]:          0 :         LogPrint(BCLog::TXPACKAGES, "Erased %d orphan tx included or conflicted by block\n", nErased);
         [ #  # ][ #  # ]
                 [ #  # ]
     243                 :          0 :     }
     244                 :          0 : }

Generated by: LCOV version 1.14