Bitcoin Core 30.99.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 <logging.h>
14#include <node/blockstorage.h>
15#include <primitives/block.h>
17#include <serialize.h>
18#include <streams.h>
19#include <uint256.h>
20#include <util/fs.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
32constexpr uint8_t DB_TXINDEX{'t'};
33
34std::unique_ptr<TxIndex> g_txindex;
35
36
39{
40public:
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
51TxIndex::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
55bool TxIndex::DB::ReadTxPos(const Txid& txid, CDiskTxPos& pos) const
56{
57 return Read(std::make_pair(DB_TXINDEX, txid.ToUint256()), pos);
58}
59
60void 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
69TxIndex::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
73TxIndex::~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
92BaseIndex::DB& TxIndex::GetDB() const { return *m_db; }
93
94bool 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}
ArgsManager gArgs
Definition: args.cpp:40
Non-refcounted RAII wrapper for FILE*.
Definition: streams.h:371
The database stores a block locator of the chain the database is synced to so that the index can effi...
Definition: base.h:65
Base class for indices of blockchain data.
Definition: base.h:55
Chainstate * m_chainstate
Definition: base.h:118
Nodes collect new transactions into a block, hash them into a hash tree, and scan through nonce value...
Definition: block.h:27
uint256 GetHash() const
Definition: block.cpp:15
std::vector< CTransactionRef > vtx
Definition: block.h:77
Batch of changes queued to be written to a CDBWrapper.
Definition: dbwrapper.h:72
void Write(const K &key, const V &value)
Definition: dbwrapper.h:96
node::BlockManager & m_blockman
Reference to a BlockManager instance which itself is shared across all Chainstate instances.
Definition: validation.h:577
Access to the txindex database (indexes/txindex/)
Definition: txindex.cpp:39
DB(size_t n_cache_size, bool f_memory=false, bool f_wipe=false)
Definition: txindex.cpp:51
bool ReadTxPos(const Txid &txid, CDiskTxPos &pos) const
Read the disk location of the transaction data with the given hash.
Definition: txindex.cpp:55
void WriteTxs(const std::vector< std::pair< Txid, CDiskTxPos > > &v_pos)
Write a batch of transaction positions to the DB.
Definition: txindex.cpp:60
TxIndex is used to look up transactions included in the blockchain by hash.
Definition: txindex.h:27
BaseIndex::DB & GetDB() const override
Definition: txindex.cpp:92
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
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
virtual ~TxIndex() override
const std::unique_ptr< DB > m_db
Definition: txindex.h:32
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:458
const uint256 & ToUint256() const LIFETIMEBOUND
256-bit opaque blob.
Definition: uint256.h:195
#define LogError(...)
Definition: logging.h:394
static constexpr TransactionSerParams TX_WITH_WITNESS
Definition: transaction.h:180
std::shared_ptr< const CTransaction > CTransactionRef
Definition: transaction.h:403
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 byt...
Definition: serialize.h:288
uint64_t GetSerializeSize(const T &t)
Definition: serialize.h:1095
uint32_t nTxOffset
Definition: disktxpos.h:13
Block data sent with blockConnected, blockDisconnected notifications.
Definition: chain.h:19
unsigned data_pos
Definition: chain.h:24
const CBlock * data
Definition: chain.h:25
std::unique_ptr< TxIndex > g_txindex
The global transaction index, used in GetTransaction. May be null.
Definition: txindex.cpp:34
constexpr uint8_t DB_TXINDEX
Definition: txindex.cpp:32
assert(!tx.IsCoinBase())