LCOV - code coverage report
Current view: top level - src - blockencodings.cpp (source / functions) Coverage Total Hit
Test: fuzz_coverage.info Lines: 93.5 % 107 100
Test Date: 2024-12-02 12:23:29 Functions: 100.0 % 6 6
Branches: 61.0 % 154 94

             Branch data     Line data    Source code
       1                 :             : // Copyright (c) 2016-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 <blockencodings.h>
       6                 :             : #include <chainparams.h>
       7                 :             : #include <common/system.h>
       8                 :             : #include <consensus/consensus.h>
       9                 :             : #include <consensus/validation.h>
      10                 :             : #include <crypto/sha256.h>
      11                 :             : #include <crypto/siphash.h>
      12                 :             : #include <logging.h>
      13                 :             : #include <random.h>
      14                 :             : #include <streams.h>
      15                 :             : #include <txmempool.h>
      16                 :             : #include <validation.h>
      17                 :             : 
      18                 :             : #include <unordered_map>
      19                 :             : 
      20                 :        4201 : CBlockHeaderAndShortTxIDs::CBlockHeaderAndShortTxIDs(const CBlock& block, const uint64_t nonce) :
      21                 :        4201 :         nonce(nonce),
      22         [ +  - ]:        4201 :         shorttxids(block.vtx.size() - 1), prefilledtxn(1), header(block) {
      23         [ +  - ]:        4201 :     FillShortTxIDSelector();
      24                 :             :     //TODO: Use our mempool prior to block acceptance to predictively fill more than just the coinbase
      25         [ -  + ]:        4201 :     prefilledtxn[0] = {0, block.vtx[0]};
      26         [ +  + ]:      528001 :     for (size_t i = 1; i < block.vtx.size(); i++) {
      27         [ +  - ]:      523800 :         const CTransaction& tx = *block.vtx[i];
      28         [ +  - ]:      523800 :         shorttxids[i - 1] = GetShortID(tx.GetWitnessHash());
      29                 :             :     }
      30         [ +  - ]:       12603 : }
      31                 :             : 
      32                 :        9365 : void CBlockHeaderAndShortTxIDs::FillShortTxIDSelector() const {
      33                 :        9365 :     DataStream stream{};
      34   [ +  -  +  - ]:        9365 :     stream << header << nonce;
      35         [ +  - ]:        9365 :     CSHA256 hasher;
      36         [ +  - ]:        9365 :     hasher.Write((unsigned char*)&(*stream.begin()), stream.end() - stream.begin());
      37                 :        9365 :     uint256 shorttxidhash;
      38         [ +  - ]:        9365 :     hasher.Finalize(shorttxidhash.begin());
      39                 :        9365 :     shorttxidk0 = shorttxidhash.GetUint64(0);
      40                 :        9365 :     shorttxidk1 = shorttxidhash.GetUint64(1);
      41                 :        9365 : }
      42                 :             : 
      43                 :      530563 : uint64_t CBlockHeaderAndShortTxIDs::GetShortID(const Wtxid& wtxid) const {
      44                 :      530563 :     static_assert(SHORTTXIDS_LENGTH == 6, "shorttxids calculation assumes 6-byte shorttxids");
      45                 :      530563 :     return SipHashUint256(shorttxidk0, shorttxidk1, wtxid) & 0xffffffffffffL;
      46                 :             : }
      47                 :             : 
      48                 :             : 
      49                 :             : 
      50                 :         596 : ReadStatus PartiallyDownloadedBlock::InitData(const CBlockHeaderAndShortTxIDs& cmpctblock, const std::vector<CTransactionRef>& extra_txn) {
      51   [ +  +  +  +  :         596 :     if (cmpctblock.header.IsNull() || (cmpctblock.shorttxids.empty() && cmpctblock.prefilledtxn.empty()))
                   +  + ]
      52                 :             :         return READ_STATUS_INVALID;
      53         [ +  - ]:         564 :     if (cmpctblock.shorttxids.size() + cmpctblock.prefilledtxn.size() > MAX_BLOCK_WEIGHT / MIN_SERIALIZABLE_TRANSACTION_WEIGHT)
      54                 :             :         return READ_STATUS_INVALID;
      55                 :             : 
      56   [ +  -  +  - ]:         564 :     if (!header.IsNull() || !txn_available.empty()) return READ_STATUS_INVALID;
      57                 :             : 
      58                 :         564 :     header = cmpctblock.header;
      59                 :         564 :     txn_available.resize(cmpctblock.BlockTxCount());
      60                 :             : 
      61                 :         564 :     int32_t lastprefilledindex = -1;
      62         [ +  + ]:        1033 :     for (size_t i = 0; i < cmpctblock.prefilledtxn.size(); i++) {
      63         [ +  + ]:         601 :         if (cmpctblock.prefilledtxn[i].tx->IsNull())
      64                 :             :             return READ_STATUS_INVALID;
      65                 :             : 
      66                 :         470 :         lastprefilledindex += cmpctblock.prefilledtxn[i].index + 1; //index is a uint16_t, so can't overflow here
      67         [ +  - ]:         470 :         if (lastprefilledindex > std::numeric_limits<uint16_t>::max())
      68                 :             :             return READ_STATUS_INVALID;
      69         [ +  + ]:         470 :         if ((uint32_t)lastprefilledindex > cmpctblock.shorttxids.size() + i) {
      70                 :             :             // If we are inserting a tx at an index greater than our full list of shorttxids
      71                 :             :             // plus the number of prefilled txn we've inserted, then we have txn for which we
      72                 :             :             // have neither a prefilled txn or a shorttxid!
      73                 :             :             return READ_STATUS_INVALID;
      74                 :             :         }
      75                 :         469 :         txn_available[lastprefilledindex] = cmpctblock.prefilledtxn[i].tx;
      76                 :             :     }
      77                 :         432 :     prefilled_count = cmpctblock.prefilledtxn.size();
      78                 :             : 
      79                 :             :     // Calculate map of txids -> positions and check mempool to see what we have (or don't)
      80                 :             :     // Because well-formed cmpctblock messages will have a (relatively) uniform distribution
      81                 :             :     // of short IDs, any highly-uneven distribution of elements can be safely treated as a
      82                 :             :     // READ_STATUS_FAILED.
      83                 :         432 :     std::unordered_map<uint64_t, uint16_t> shorttxids(cmpctblock.shorttxids.size());
      84                 :             :     uint16_t index_offset = 0;
      85         [ +  + ]:      454302 :     for (size_t i = 0; i < cmpctblock.shorttxids.size(); i++) {
      86         [ +  + ]:      454304 :         while (txn_available[i + index_offset])
      87                 :         431 :             index_offset++;
      88         [ +  - ]:      453873 :         shorttxids[cmpctblock.shorttxids[i]] = i + index_offset;
      89                 :             :         // To determine the chance that the number of entries in a bucket exceeds N,
      90                 :             :         // we use the fact that the number of elements in a single bucket is
      91                 :             :         // binomially distributed (with n = the number of shorttxids S, and p =
      92                 :             :         // 1 / the number of buckets), that in the worst case the number of buckets is
      93                 :             :         // equal to S (due to std::unordered_map having a default load factor of 1.0),
      94                 :             :         // and that the chance for any bucket to exceed N elements is at most
      95                 :             :         // buckets * (the chance that any given bucket is above N elements).
      96                 :             :         // Thus: P(max_elements_per_bucket > N) <= S * (1 - cdf(binomial(n=S,p=1/S), N)).
      97                 :             :         // If we assume blocks of up to 16000, allowing 12 elements per bucket should
      98                 :             :         // only fail once per ~1 million block transfers (per peer and connection).
      99         [ +  + ]:      453873 :         if (shorttxids.bucket_size(shorttxids.bucket(cmpctblock.shorttxids[i])) > 12)
     100                 :             :             return READ_STATUS_FAILED;
     101                 :             :     }
     102                 :             :     // TODO: in the shortid-collision case, we should instead request both transactions
     103                 :             :     // which collided. Falling back to full-block-request here is overkill.
     104         [ +  + ]:         429 :     if (shorttxids.size() != cmpctblock.shorttxids.size())
     105                 :             :         return READ_STATUS_FAILED; // Short ID collision
     106                 :             : 
     107   [ +  -  +  - ]:         210 :     std::vector<bool> have_txn(txn_available.size());
     108                 :         105 :     {
     109         [ +  - ]:         105 :     LOCK(pool->cs);
     110         [ +  + ]:        2999 :     for (const auto& tx : pool->txns_randomized) {
     111         [ +  - ]:        2907 :         uint64_t shortid = cmpctblock.GetShortID(tx->GetWitnessHash());
     112                 :        2907 :         std::unordered_map<uint64_t, uint16_t>::iterator idit = shorttxids.find(shortid);
     113         [ +  - ]:        2907 :         if (idit != shorttxids.end()) {
     114         [ +  - ]:        2907 :             if (!have_txn[idit->second]) {
     115                 :        2907 :                 txn_available[idit->second] = tx;
     116                 :        2907 :                 have_txn[idit->second]  = true;
     117                 :        2907 :                 mempool_count++;
     118                 :             :             } else {
     119                 :             :                 // If we find two mempool txn that match the short id, just request it.
     120                 :             :                 // This should be rare enough that the extra bandwidth doesn't matter,
     121                 :             :                 // but eating a round-trip due to FillBlock failure would be annoying
     122         [ #  # ]:           0 :                 if (txn_available[idit->second]) {
     123                 :           0 :                     txn_available[idit->second].reset();
     124                 :           0 :                     mempool_count--;
     125                 :             :                 }
     126                 :             :             }
     127                 :             :         }
     128                 :             :         // Though ideally we'd continue scanning for the two-txn-match-shortid case,
     129                 :             :         // the performance win of an early exit here is too good to pass up and worth
     130                 :             :         // the extra risk.
     131         [ +  + ]:        2907 :         if (mempool_count == shorttxids.size())
     132                 :             :             break;
     133                 :             :     }
     134                 :           0 :     }
     135                 :             : 
     136         [ +  + ]:        3976 :     for (size_t i = 0; i < extra_txn.size(); i++) {
     137         [ +  + ]:        3894 :         if (extra_txn[i] == nullptr) {
     138                 :          38 :             continue;
     139                 :             :         }
     140         [ +  - ]:        3856 :         uint64_t shortid = cmpctblock.GetShortID(extra_txn[i]->GetWitnessHash());
     141                 :        3856 :         std::unordered_map<uint64_t, uint16_t>::iterator idit = shorttxids.find(shortid);
     142         [ +  + ]:        3856 :         if (idit != shorttxids.end()) {
     143         [ +  + ]:        2694 :             if (!have_txn[idit->second]) {
     144                 :         334 :                 txn_available[idit->second] = extra_txn[i];
     145                 :         334 :                 have_txn[idit->second]  = true;
     146                 :         334 :                 mempool_count++;
     147                 :         334 :                 extra_count++;
     148                 :             :             } else {
     149                 :             :                 // If we find two mempool/extra txn that match the short id, just
     150                 :             :                 // request it.
     151                 :             :                 // This should be rare enough that the extra bandwidth doesn't matter,
     152                 :             :                 // but eating a round-trip due to FillBlock failure would be annoying
     153                 :             :                 // Note that we don't want duplication between extra_txn and mempool to
     154                 :             :                 // trigger this case, so we compare witness hashes first
     155   [ +  -  -  + ]:        2360 :                 if (txn_available[idit->second] &&
     156   [ +  -  -  + ]:        2360 :                         txn_available[idit->second]->GetWitnessHash() != extra_txn[i]->GetWitnessHash()) {
     157                 :           0 :                     txn_available[idit->second].reset();
     158                 :           0 :                     mempool_count--;
     159                 :           0 :                     extra_count--;
     160                 :             :                 }
     161                 :             :             }
     162                 :             :         }
     163                 :             :         // Though ideally we'd continue scanning for the two-txn-match-shortid case,
     164                 :             :         // the performance win of an early exit here is too good to pass up and worth
     165                 :             :         // the extra risk.
     166         [ +  + ]:        3856 :         if (mempool_count == shorttxids.size())
     167                 :             :             break;
     168                 :             :     }
     169                 :             : 
     170   [ +  -  -  +  :         105 :     LogDebug(BCLog::CMPCTBLOCK, "Initialized PartiallyDownloadedBlock for block %s using a cmpctblock of size %lu\n", cmpctblock.header.GetHash().ToString(), GetSerializeSize(cmpctblock));
          -  -  -  -  -  
                -  -  - ]
     171                 :             : 
     172                 :         105 :     return READ_STATUS_OK;
     173                 :         537 : }
     174                 :             : 
     175                 :     1053132 : bool PartiallyDownloadedBlock::IsTxAvailable(size_t index) const
     176                 :             : {
     177         [ +  + ]:     1053132 :     if (header.IsNull()) return false;
     178                 :             : 
     179         [ -  + ]:     1048748 :     assert(index < txn_available.size());
     180                 :     1048748 :     return txn_available[index] != nullptr;
     181                 :             : }
     182                 :             : 
     183                 :         564 : ReadStatus PartiallyDownloadedBlock::FillBlock(CBlock& block, const std::vector<CTransactionRef>& vtx_missing)
     184                 :             : {
     185         [ +  + ]:         564 :     if (header.IsNull()) return READ_STATUS_INVALID;
     186                 :             : 
     187                 :         534 :     uint256 hash = header.GetHash();
     188                 :         534 :     block = header;
     189                 :         534 :     block.vtx.resize(txn_available.size());
     190                 :             : 
     191                 :         534 :     size_t tx_missing_offset = 0;
     192         [ +  + ]:      392640 :     for (size_t i = 0; i < txn_available.size(); i++) {
     193         [ +  + ]:      392453 :         if (!txn_available[i]) {
     194         [ +  + ]:      390020 :             if (vtx_missing.size() <= tx_missing_offset)
     195                 :             :                 return READ_STATUS_INVALID;
     196                 :      389673 :             block.vtx[i] = vtx_missing[tx_missing_offset++];
     197                 :             :         } else
     198                 :        2433 :             block.vtx[i] = std::move(txn_available[i]);
     199                 :             :     }
     200                 :             : 
     201                 :             :     // Make sure we can't call FillBlock again.
     202                 :         187 :     header.SetNull();
     203                 :         187 :     txn_available.clear();
     204                 :             : 
     205         [ +  - ]:         187 :     if (vtx_missing.size() != tx_missing_offset)
     206                 :             :         return READ_STATUS_INVALID;
     207                 :             : 
     208         [ +  - ]:         187 :     BlockValidationState state;
     209   [ +  -  +  - ]:         187 :     CheckBlockFn check_block = m_check_block_mock ? m_check_block_mock : CheckBlock;
     210   [ +  -  +  -  :         187 :     if (!check_block(block, state, Params().GetConsensus(), /*fCheckPoW=*/true, /*fCheckMerkleRoot=*/true)) {
                   +  + ]
     211                 :             :         // TODO: We really want to just check merkle tree manually here,
     212                 :             :         // but that is expensive, and CheckBlock caches a block's
     213                 :             :         // "checked-status" (in the CBlock?). CBlock should be able to
     214                 :             :         // check its own merkle root and cache that check.
     215         [ +  + ]:          18 :         if (state.GetResult() == BlockValidationResult::BLOCK_MUTATED)
     216                 :             :             return READ_STATUS_FAILED; // Possible Short ID collision
     217                 :          17 :         return READ_STATUS_CHECKBLOCK_FAILED;
     218                 :             :     }
     219                 :             : 
     220   [ +  -  -  +  :         169 :     LogDebug(BCLog::CMPCTBLOCK, "Successfully reconstructed block %s with %lu txn prefilled, %lu txn from mempool (incl at least %lu from extra pool) and %lu txn requested\n", hash.ToString(), prefilled_count, mempool_count, extra_count, vtx_missing.size());
             -  -  -  - ]
     221         [ +  + ]:         169 :     if (vtx_missing.size() < 5) {
     222         [ +  + ]:         172 :         for (const auto& tx : vtx_missing) {
     223   [ +  -  -  +  :         111 :             LogDebug(BCLog::CMPCTBLOCK, "Reconstructed block %s required tx %s\n", hash.ToString(), tx->GetHash().ToString());
          -  -  -  -  -  
                      - ]
     224                 :             :         }
     225                 :             :     }
     226                 :             : 
     227                 :             :     return READ_STATUS_OK;
     228                 :         374 : }
        

Generated by: LCOV version 2.0-1