/ src / consensus / tx_verify.h
tx_verify.h
 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  #ifndef BITCOIN_CONSENSUS_TX_VERIFY_H
 6  #define BITCOIN_CONSENSUS_TX_VERIFY_H
 7  
 8  #include <consensus/amount.h>
 9  #include <script/verify_flags.h>
10  
11  #include <cstdint>
12  #include <vector>
13  
14  class CBlockIndex;
15  class CCoinsViewCache;
16  class CTransaction;
17  class TxValidationState;
18  
19  /** Transaction validation functions */
20  
21  namespace Consensus {
22  /**
23   * Check whether all inputs of this transaction are valid (no double spends and amounts)
24   * This does not modify the UTXO set. This does not check scripts and sigs.
25   * @param[out] txfee Set to the transaction fee if successful.
26   * Preconditions: tx.IsCoinBase() is false.
27   */
28  [[nodiscard]] bool CheckTxInputs(const CTransaction& tx, TxValidationState& state, const CCoinsViewCache& inputs, int nSpendHeight, CAmount& txfee);
29  } // namespace Consensus
30  
31  /** Auxiliary functions for transaction validation (ideally should not be exposed) */
32  
33  /**
34   * Count ECDSA signature operations the old-fashioned (pre-0.6) way
35   * @return number of sigops this transaction's outputs will produce when spent
36   * @see CTransaction::FetchInputs
37   */
38  unsigned int GetLegacySigOpCount(const CTransaction& tx);
39  
40  /**
41   * Count ECDSA signature operations in pay-to-script-hash inputs.
42   *
43   * @param[in] mapInputs Map of previous transactions that have outputs we're spending
44   * @return maximum number of sigops required to validate this transaction's inputs
45   * @see CTransaction::FetchInputs
46   */
47  unsigned int GetP2SHSigOpCount(const CTransaction& tx, const CCoinsViewCache& mapInputs);
48  
49  /**
50   * Compute total signature operation cost of a transaction.
51   * @param[in] tx     Transaction for which we are computing the cost
52   * @param[in] inputs Map of previous transactions that have outputs we're spending
53   * @param[in] flags Script verification flags
54   * @return Total signature operation cost of tx
55   */
56  int64_t GetTransactionSigOpCost(const CTransaction& tx, const CCoinsViewCache& inputs, script_verify_flags flags);
57  
58  /**
59   * Check if transaction is final and can be included in a block with the
60   * specified height and time. Consensus critical.
61   */
62  bool IsFinalTx(const CTransaction &tx, int nBlockHeight, int64_t nBlockTime);
63  
64  /**
65   * Calculates the block height and previous block's median time past at
66   * which the transaction will be considered final in the context of BIP 68.
67   * For each input that is not sequence locked, the corresponding entries in
68   * prevHeights are set to 0 as they do not affect the calculation.
69   */
70  std::pair<int, int64_t> CalculateSequenceLocks(const CTransaction &tx, int flags, std::vector<int>& prevHeights, const CBlockIndex& block);
71  
72  bool EvaluateSequenceLocks(const CBlockIndex& block, std::pair<int, int64_t> lockPair);
73  /**
74   * Check if transaction is final per BIP 68 sequence numbers and can be included in a block.
75   * Consensus critical. Takes as input a list of heights at which tx's inputs (in order) confirmed.
76   */
77  bool SequenceLocks(const CTransaction &tx, int flags, std::vector<int>& prevHeights, const CBlockIndex& block);
78  
79  #endif // BITCOIN_CONSENSUS_TX_VERIFY_H