Bitcoin Core  31.0.0
P2P Digital Currency
txindex.cpp
Go to the documentation of this file.
1 // Copyright (c) 2017-present 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 <index/txindex.h>
6 
7 #include <common/args.h>
8 #include <dbwrapper.h>
9 #include <flatfile.h>
10 #include <index/base.h>
11 #include <index/disktxpos.h>
12 #include <interfaces/chain.h>
13 #include <node/blockstorage.h>
14 #include <primitives/block.h>
15 #include <primitives/transaction.h>
16 #include <serialize.h>
17 #include <streams.h>
18 #include <uint256.h>
19 #include <util/fs.h>
20 #include <util/log.h>
21 #include <validation.h>
22 
23 #include <cassert>
24 #include <cstdint>
25 #include <cstdio>
26 #include <exception>
27 #include <span>
28 #include <string>
29 #include <utility>
30 #include <vector>
31 
32 constexpr uint8_t DB_TXINDEX{'t'};
33 
34 std::unique_ptr<TxIndex> g_txindex;
35 
36 
38 class TxIndex::DB : public BaseIndex::DB
39 {
40 public:
41  explicit DB(size_t n_cache_size, bool f_memory = false, bool f_wipe = false);
42 
45  bool ReadTxPos(const Txid& txid, CDiskTxPos& pos) const;
46 
48  void WriteTxs(const std::vector<std::pair<Txid, CDiskTxPos>>& v_pos);
49 };
50 
51 TxIndex::DB::DB(size_t n_cache_size, bool f_memory, bool f_wipe) :
52  BaseIndex::DB(gArgs.GetDataDirNet() / "indexes" / "txindex", n_cache_size, f_memory, f_wipe)
53 {}
54 
55 bool TxIndex::DB::ReadTxPos(const Txid& txid, CDiskTxPos& pos) const
56 {
57  return Read(std::make_pair(DB_TXINDEX, txid.ToUint256()), pos);
58 }
59 
60 void TxIndex::DB::WriteTxs(const std::vector<std::pair<Txid, CDiskTxPos>>& v_pos)
61 {
62  CDBBatch batch(*this);
63  for (const auto& [txid, pos] : v_pos) {
64  batch.Write(std::make_pair(DB_TXINDEX, txid.ToUint256()), pos);
65  }
66  WriteBatch(batch);
67 }
68 
69 TxIndex::TxIndex(std::unique_ptr<interfaces::Chain> chain, size_t n_cache_size, bool f_memory, bool f_wipe)
70  : BaseIndex(std::move(chain), "txindex"), m_db(std::make_unique<TxIndex::DB>(n_cache_size, f_memory, f_wipe))
71 {}
72 
73 TxIndex::~TxIndex() = default;
74 
76 {
77  // Exclude genesis block transaction because outputs are not spendable.
78  if (block.height == 0) return true;
79 
80  assert(block.data);
81  CDiskTxPos pos({block.file_number, block.data_pos}, GetSizeOfCompactSize(block.data->vtx.size()));
82  std::vector<std::pair<Txid, CDiskTxPos>> vPos;
83  vPos.reserve(block.data->vtx.size());
84  for (const auto& tx : block.data->vtx) {
85  vPos.emplace_back(tx->GetHash(), pos);
87  }
88  m_db->WriteTxs(vPos);
89  return true;
90 }
91 
92 BaseIndex::DB& TxIndex::GetDB() const { return *m_db; }
93 
94 bool TxIndex::FindTx(const Txid& tx_hash, uint256& block_hash, CTransactionRef& tx) const
95 {
96  CDiskTxPos postx;
97  if (!m_db->ReadTxPos(tx_hash, postx)) {
98  return false;
99  }
100 
101  AutoFile file{m_chainstate->m_blockman.OpenBlockFile(postx, true)};
102  if (file.IsNull()) {
103  LogError("OpenBlockFile failed");
104  return false;
105  }
106  CBlockHeader header;
107  try {
108  file >> header;
109  file.seek(postx.nTxOffset, SEEK_CUR);
110  file >> TX_WITH_WITNESS(tx);
111  } catch (const std::exception& e) {
112  LogError("Deserialize or I/O error - %s", e.what());
113  return false;
114  }
115  if (tx->GetHash() != tx_hash) {
116  LogError("txid mismatch");
117  return false;
118  }
119  block_hash = header.GetHash();
120  return true;
121 }
std::shared_ptr< const CTransaction > CTransactionRef
Definition: transaction.h:403
constexpr uint8_t DB_TXINDEX
Definition: txindex.cpp:32
assert(!tx.IsCoinBase())
Batch of changes queued to be written to a CDBWrapper.
Definition: dbwrapper.h:71
node::BlockManager & m_blockman
Reference to a BlockManager instance which itself is shared across all Chainstate instances...
Definition: validation.h:573
Definition: common.h:29
bool IsBlockPruned(const CBlockIndex &block) const EXCLUSIVE_LOCKS_REQUIRED(void UpdatePruneLock(const std::string &name, const PruneLockInfo &lock_info) EXCLUSIVE_LOCKS_REQUIRED(AutoFile OpenBlockFile(const FlatFilePos &pos, bool fReadOnly) const
Check whether the block associated with this index entry is pruned or not.
Definition: blockstorage.h:459
const std::unique_ptr< DB > m_db
Definition: txindex.h:29
Non-refcounted RAII wrapper for FILE*.
Definition: streams.h:372
Access to the txindex database (indexes/txindex/)
Definition: txindex.cpp:38
The database stores a block locator of the chain the database is synced to so that the index can effi...
Definition: base.h:64
unsigned data_pos
Definition: chain.h:24
Block data sent with blockConnected, blockDisconnected notifications.
Definition: chain.h:19
Base class for indices of blockchain data.
Definition: base.h:54
const CBlock * data
Definition: chain.h:25
bool ReadTxPos(const Txid &txid, CDiskTxPos &pos) const
Read the disk location of the transaction data with the given hash.
Definition: txindex.cpp:55
uint32_t nTxOffset
Definition: disktxpos.h:13
std::unique_ptr< TxIndex > g_txindex
The global transaction index, used in GetTransaction. May be null.
Definition: txindex.cpp:34
uint64_t GetSerializeSize(const T &t)
Definition: serialize.h:1095
void Write(const K &key, const V &value)
Definition: dbwrapper.h:96
BaseIndex::DB & GetDB() const override
Definition: txindex.cpp:92
ArgsManager gArgs
Definition: args.cpp:40
uint256 GetHash() const
Definition: block.cpp:15
virtual ~TxIndex() override
256-bit opaque blob.
Definition: uint256.h:195
std::vector< CTransactionRef > vtx
Definition: block.h:77
bool CustomAppend(const interfaces::BlockInfo &block) override
Write update index entries for a newly connected block.
Definition: txindex.cpp:75
bool FindTx(const Txid &tx_hash, uint256 &block_hash, CTransactionRef &tx) const
Look up a transaction by hash.
Definition: txindex.cpp:94
Chainstate * m_chainstate
Definition: base.h:118
DB(size_t n_cache_size, bool f_memory=false, bool f_wipe=false)
Definition: txindex.cpp:51
TxIndex(std::unique_ptr< interfaces::Chain > chain, size_t n_cache_size, bool f_memory=false, bool f_wipe=false)
Constructs the index, which becomes available to be queried.
Definition: txindex.cpp:69
void WriteTxs(const std::vector< std::pair< Txid, CDiskTxPos >> &v_pos)
Write a batch of transaction positions to the DB.
Definition: txindex.cpp:60
const uint256 & ToUint256() const LIFETIMEBOUND
constexpr unsigned int GetSizeOfCompactSize(uint64_t nSize)
Compact Size size < 253 – 1 byte size <= USHRT_MAX – 3 bytes (253 + 2 bytes) size <= UINT_MAX – 5 ...
Definition: serialize.h:288
TxIndex is used to look up transactions included in the blockchain by hash.
Definition: txindex.h:26
Nodes collect new transactions into a block, hash them into a hash tree, and scan through nonce value...
Definition: block.h:26
#define LogError(...)
Definition: log.h:97
static constexpr TransactionSerParams TX_WITH_WITNESS
Definition: transaction.h:180