You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

main.h 25KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557
  1. // Copyright (c) 2009-2010 Satoshi Nakamoto
  2. // Copyright (c) 2009-2015 The Bitcoin Core developers
  3. // Distributed under the MIT software license, see the accompanying
  4. // file COPYING or http://www.opensource.org/licenses/mit-license.php.
  5. #ifndef BITCOIN_MAIN_H
  6. #define BITCOIN_MAIN_H
  7. #if defined(HAVE_CONFIG_H)
  8. #include "config/bitcoin-config.h"
  9. #endif
  10. #include "amount.h"
  11. #include "chain.h"
  12. #include "coins.h"
  13. #include "net.h"
  14. #include "script/script_error.h"
  15. #include "sync.h"
  16. #include <algorithm>
  17. #include <exception>
  18. #include <map>
  19. #include <set>
  20. #include <stdint.h>
  21. #include <string>
  22. #include <utility>
  23. #include <vector>
  24. #include <boost/unordered_map.hpp>
  25. class CBlockIndex;
  26. class CBlockTreeDB;
  27. class CBloomFilter;
  28. class CChainParams;
  29. class CInv;
  30. class CScriptCheck;
  31. class CTxMemPool;
  32. class CValidationInterface;
  33. class CValidationState;
  34. struct CNodeStateStats;
  35. /** Default for accepting alerts from the P2P network. */
  36. static const bool DEFAULT_ALERTS = true;
  37. /** Default for DEFAULT_WHITELISTRELAY. */
  38. static const bool DEFAULT_WHITELISTRELAY = true;
  39. /** Default for DEFAULT_WHITELISTFORCERELAY. */
  40. static const bool DEFAULT_WHITELISTFORCERELAY = true;
  41. /** Default for -minrelaytxfee, minimum relay fee for transactions */
  42. static const unsigned int DEFAULT_MIN_RELAY_TX_FEE = 1000;
  43. //! -maxtxfee default
  44. static const CAmount DEFAULT_TRANSACTION_MAXFEE = 0.1 * COIN;
  45. //! Discourage users to set fees higher than this amount (in satoshis) per kB
  46. static const CAmount HIGH_TX_FEE_PER_KB = 0.01 * COIN;
  47. //! -maxtxfee will warn if called with a higher fee than this amount (in satoshis)
  48. static const CAmount HIGH_MAX_TX_FEE = 100 * HIGH_TX_FEE_PER_KB;
  49. /** Default for -maxorphantx, maximum number of orphan transactions kept in memory */
  50. static const unsigned int DEFAULT_MAX_ORPHAN_TRANSACTIONS = 100;
  51. /** Default for -limitancestorcount, max number of in-mempool ancestors */
  52. static const unsigned int DEFAULT_ANCESTOR_LIMIT = 25;
  53. /** Default for -limitancestorsize, maximum kilobytes of tx + all in-mempool ancestors */
  54. static const unsigned int DEFAULT_ANCESTOR_SIZE_LIMIT = 101;
  55. /** Default for -limitdescendantcount, max number of in-mempool descendants */
  56. static const unsigned int DEFAULT_DESCENDANT_LIMIT = 25;
  57. /** Default for -limitdescendantsize, maximum kilobytes of in-mempool descendants */
  58. static const unsigned int DEFAULT_DESCENDANT_SIZE_LIMIT = 101;
  59. /** Default for -mempoolexpiry, expiration time for mempool transactions in hours */
  60. static const unsigned int DEFAULT_MEMPOOL_EXPIRY = 72;
  61. /** The maximum size of a blk?????.dat file (since 0.8) */
  62. static const unsigned int MAX_BLOCKFILE_SIZE = 0x8000000; // 128 MiB
  63. /** The pre-allocation chunk size for blk?????.dat files (since 0.8) */
  64. static const unsigned int BLOCKFILE_CHUNK_SIZE = 0x1000000; // 16 MiB
  65. /** The pre-allocation chunk size for rev?????.dat files (since 0.8) */
  66. static const unsigned int UNDOFILE_CHUNK_SIZE = 0x100000; // 1 MiB
  67. /** Maximum number of script-checking threads allowed */
  68. static const int MAX_SCRIPTCHECK_THREADS = 16;
  69. /** -par default (number of script-checking threads, 0 = auto) */
  70. static const int DEFAULT_SCRIPTCHECK_THREADS = 0;
  71. /** Number of blocks that can be requested at any given time from a single peer. */
  72. static const int MAX_BLOCKS_IN_TRANSIT_PER_PEER = 16;
  73. /** Timeout in seconds during which a peer must stall block download progress before being disconnected. */
  74. static const unsigned int BLOCK_STALLING_TIMEOUT = 2;
  75. /** Number of headers sent in one getheaders result. We rely on the assumption that if a peer sends
  76. * less than this number, we reached its tip. Changing this value is a protocol upgrade. */
  77. static const unsigned int MAX_HEADERS_RESULTS = 2000;
  78. /** Size of the "block download window": how far ahead of our current height do we fetch?
  79. * Larger windows tolerate larger download speed differences between peer, but increase the potential
  80. * degree of disordering of blocks on disk (which make reindexing and in the future perhaps pruning
  81. * harder). We'll probably want to make this a per-peer adaptive value at some point. */
  82. static const unsigned int BLOCK_DOWNLOAD_WINDOW = 1024;
  83. /** Time to wait (in seconds) between writing blocks/block index to disk. */
  84. static const unsigned int DATABASE_WRITE_INTERVAL = 60 * 60;
  85. /** Time to wait (in seconds) between flushing chainstate to disk. */
  86. static const unsigned int DATABASE_FLUSH_INTERVAL = 24 * 60 * 60;
  87. /** Maximum length of reject messages. */
  88. static const unsigned int MAX_REJECT_MESSAGE_LENGTH = 111;
  89. /** Average delay between local address broadcasts in seconds. */
  90. static const unsigned int AVG_LOCAL_ADDRESS_BROADCAST_INTERVAL = 24 * 24 * 60;
  91. /** Average delay between peer address broadcasts in seconds. */
  92. static const unsigned int AVG_ADDRESS_BROADCAST_INTERVAL = 30;
  93. /** Average delay between trickled inventory broadcasts in seconds.
  94. * Blocks, whitelisted receivers, and a random 25% of transactions bypass this. */
  95. static const unsigned int AVG_INVENTORY_BROADCAST_INTERVAL = 5;
  96. static const unsigned int DEFAULT_LIMITFREERELAY = 15;
  97. static const bool DEFAULT_RELAYPRIORITY = true;
  98. static const int64_t DEFAULT_MAX_TIP_AGE = 24 * 60 * 60;
  99. /** Default for -permitbaremultisig */
  100. static const bool DEFAULT_PERMIT_BAREMULTISIG = true;
  101. static const unsigned int DEFAULT_BYTES_PER_SIGOP = 20;
  102. static const bool DEFAULT_CHECKPOINTS_ENABLED = true;
  103. static const bool DEFAULT_TXINDEX = false;
  104. static const unsigned int DEFAULT_BANSCORE_THRESHOLD = 100;
  105. static const bool DEFAULT_TESTSAFEMODE = false;
  106. /** Default for -mempoolreplacement */
  107. static const bool DEFAULT_ENABLE_REPLACEMENT = true;
  108. /** Maximum number of headers to announce when relaying blocks with headers message.*/
  109. static const unsigned int MAX_BLOCKS_TO_ANNOUNCE = 8;
  110. static const bool DEFAULT_PEERBLOOMFILTERS = true;
  111. static const bool DEFAULT_ENFORCENODEBLOOM = false;
  112. struct BlockHasher
  113. {
  114. size_t operator()(const uint256& hash) const { return hash.GetCheapHash(); }
  115. };
  116. extern CScript COINBASE_FLAGS;
  117. extern CCriticalSection cs_main;
  118. extern CTxMemPool mempool;
  119. typedef boost::unordered_map<uint256, CBlockIndex*, BlockHasher> BlockMap;
  120. extern BlockMap mapBlockIndex;
  121. extern uint64_t nLastBlockTx;
  122. extern uint64_t nLastBlockSize;
  123. extern const std::string strMessageMagic;
  124. extern CWaitableCriticalSection csBestBlock;
  125. extern CConditionVariable cvBlockChange;
  126. extern bool fImporting;
  127. extern bool fReindex;
  128. extern int nScriptCheckThreads;
  129. extern bool fTxIndex;
  130. extern bool fIsBareMultisigStd;
  131. extern bool fRequireStandard;
  132. extern unsigned int nBytesPerSigOp;
  133. extern bool fCheckBlockIndex;
  134. extern bool fCheckpointsEnabled;
  135. extern size_t nCoinCacheUsage;
  136. /** A fee rate smaller than this is considered zero fee (for relaying, mining and transaction creation) */
  137. extern CFeeRate minRelayTxFee;
  138. /** Absolute maximum transaction fee (in satoshis) used by wallet and mempool (rejects high fee in sendrawtransaction) */
  139. extern CAmount maxTxFee;
  140. extern bool fAlerts;
  141. /** If the tip is older than this (in seconds), the node is considered to be in initial block download. */
  142. extern int64_t nMaxTipAge;
  143. extern bool fEnableReplacement;
  144. /** Best header we've seen so far (used for getheaders queries' starting points). */
  145. extern CBlockIndex *pindexBestHeader;
  146. /** Minimum disk space required - used in CheckDiskSpace() */
  147. static const uint64_t nMinDiskSpace = 52428800;
  148. /** Pruning-related variables and constants */
  149. /** True if any block files have ever been pruned. */
  150. extern bool fHavePruned;
  151. /** True if we're running in -prune mode. */
  152. extern bool fPruneMode;
  153. /** Number of MiB of block files that we're trying to stay below. */
  154. extern uint64_t nPruneTarget;
  155. /** Block files containing a block-height within MIN_BLOCKS_TO_KEEP of chainActive.Tip() will not be pruned. */
  156. static const unsigned int MIN_BLOCKS_TO_KEEP = 288;
  157. static const signed int DEFAULT_CHECKBLOCKS = MIN_BLOCKS_TO_KEEP;
  158. static const unsigned int DEFAULT_CHECKLEVEL = 3;
  159. // Require that user allocate at least 550MB for block & undo files (blk???.dat and rev???.dat)
  160. // At 1MB per block, 288 blocks = 288MB.
  161. // Add 15% for Undo data = 331MB
  162. // Add 20% for Orphan block rate = 397MB
  163. // We want the low water mark after pruning to be at least 397 MB and since we prune in
  164. // full block file chunks, we need the high water mark which triggers the prune to be
  165. // one 128MB block file + added 15% undo data = 147MB greater for a total of 545MB
  166. // Setting the target to > than 550MB will make it likely we can respect the target.
  167. static const uint64_t MIN_DISK_SPACE_FOR_BLOCK_FILES = 550 * 1024 * 1024;
  168. /** Register with a network node to receive its signals */
  169. void RegisterNodeSignals(CNodeSignals& nodeSignals);
  170. /** Unregister a network node */
  171. void UnregisterNodeSignals(CNodeSignals& nodeSignals);
  172. /**
  173. * Process an incoming block. This only returns after the best known valid
  174. * block is made active. Note that it does not, however, guarantee that the
  175. * specific block passed to it has been checked for validity!
  176. *
  177. * @param[out] state This may be set to an Error state if any error occurred processing it, including during validation/connection/etc of otherwise unrelated blocks during reorganisation; or it may be set to an Invalid state if pblock is itself invalid (but this is not guaranteed even when the block is checked). If you want to *possibly* get feedback on whether pblock is valid, you must also install a CValidationInterface (see validationinterface.h) - this will have its BlockChecked method called whenever *any* block completes validation.
  178. * @param[in] pfrom The node which we are receiving the block from; it is added to mapBlockSource and may be penalised if the block is invalid.
  179. * @param[in] pblock The block we want to process.
  180. * @param[in] fForceProcessing Process this block even if unrequested; used for non-network block sources and whitelisted peers.
  181. * @param[out] dbp If pblock is stored to disk (or already there), this will be set to its location.
  182. * @return True if state.IsValid()
  183. */
  184. bool ProcessNewBlock(CValidationState& state, const CChainParams& chainparams, const CNode* pfrom, const CBlock* pblock, bool fForceProcessing, CDiskBlockPos* dbp);
  185. /** Check whether enough disk space is available for an incoming block */
  186. bool CheckDiskSpace(uint64_t nAdditionalBytes = 0);
  187. /** Open a block file (blk?????.dat) */
  188. FILE* OpenBlockFile(const CDiskBlockPos &pos, bool fReadOnly = false);
  189. /** Open an undo file (rev?????.dat) */
  190. FILE* OpenUndoFile(const CDiskBlockPos &pos, bool fReadOnly = false);
  191. /** Translation to a filesystem path */
  192. boost::filesystem::path GetBlockPosFilename(const CDiskBlockPos &pos, const char *prefix);
  193. /** Import blocks from an external file */
  194. bool LoadExternalBlockFile(const CChainParams& chainparams, FILE* fileIn, CDiskBlockPos *dbp = NULL);
  195. /** Initialize a new block tree database + block data on disk */
  196. bool InitBlockIndex(const CChainParams& chainparams);
  197. /** Load the block tree and coins database from disk */
  198. bool LoadBlockIndex();
  199. /** Unload database information */
  200. void UnloadBlockIndex();
  201. /** Process protocol messages received from a given node */
  202. bool ProcessMessages(CNode* pfrom);
  203. /**
  204. * Send queued protocol messages to be sent to a give node.
  205. *
  206. * @param[in] pto The node which we are sending messages to.
  207. */
  208. bool SendMessages(CNode* pto);
  209. /** Run an instance of the script checking thread */
  210. void ThreadScriptCheck();
  211. /** Try to detect Partition (network isolation) attacks against us */
  212. void PartitionCheck(bool (*initialDownloadCheck)(), CCriticalSection& cs, const CBlockIndex *const &bestHeader, int64_t nPowTargetSpacing);
  213. /** Check whether we are doing an initial block download (synchronizing from disk or network) */
  214. bool IsInitialBlockDownload();
  215. /** Format a string that describes several potential problems detected by the core.
  216. * strFor can have three values:
  217. * - "rpc": get critical warnings, which should put the client in safe mode if non-empty
  218. * - "statusbar": get all warnings
  219. * - "gui": get all warnings, translated (where possible) for GUI
  220. * This function only returns the highest priority warning of the set selected by strFor.
  221. */
  222. std::string GetWarnings(const std::string& strFor);
  223. /** Retrieve a transaction (from memory pool, or from disk, if possible) */
  224. bool GetTransaction(const uint256 &hash, CTransaction &tx, const Consensus::Params& params, uint256 &hashBlock, bool fAllowSlow = false);
  225. /** Find the best known block, and make it the tip of the block chain */
  226. bool ActivateBestChain(CValidationState& state, const CChainParams& chainparams, const CBlock* pblock = NULL);
  227. CAmount GetBlockSubsidy(int nHeight, const Consensus::Params& consensusParams);
  228. /**
  229. * Prune block and undo files (blk???.dat and undo???.dat) so that the disk space used is less than a user-defined target.
  230. * The user sets the target (in MB) on the command line or in config file. This will be run on startup and whenever new
  231. * space is allocated in a block or undo file, staying below the target. Changing back to unpruned requires a reindex
  232. * (which in this case means the blockchain must be re-downloaded.)
  233. *
  234. * Pruning functions are called from FlushStateToDisk when the global fCheckForPruning flag has been set.
  235. * Block and undo files are deleted in lock-step (when blk00003.dat is deleted, so is rev00003.dat.)
  236. * Pruning cannot take place until the longest chain is at least a certain length (100000 on mainnet, 1000 on testnet, 1000 on regtest).
  237. * Pruning will never delete a block within a defined distance (currently 288) from the active chain's tip.
  238. * The block index is updated by unsetting HAVE_DATA and HAVE_UNDO for any blocks that were stored in the deleted files.
  239. * A db flag records the fact that at least some block files have been pruned.
  240. *
  241. * @param[out] setFilesToPrune The set of file indices that can be unlinked will be returned
  242. */
  243. void FindFilesToPrune(std::set<int>& setFilesToPrune, uint64_t nPruneAfterHeight);
  244. /**
  245. * Actually unlink the specified files
  246. */
  247. void UnlinkPrunedFiles(std::set<int>& setFilesToPrune);
  248. /** Create a new block index entry for a given block hash */
  249. CBlockIndex * InsertBlockIndex(uint256 hash);
  250. /** Get statistics from node state */
  251. bool GetNodeStateStats(NodeId nodeid, CNodeStateStats &stats);
  252. /** Increase a node's misbehavior score. */
  253. void Misbehaving(NodeId nodeid, int howmuch);
  254. /** Flush all state, indexes and buffers to disk. */
  255. void FlushStateToDisk();
  256. /** Prune block files and flush state to disk. */
  257. void PruneAndFlush();
  258. /** (try to) add transaction to memory pool **/
  259. bool AcceptToMemoryPool(CTxMemPool& pool, CValidationState &state, const CTransaction &tx, bool fLimitFree,
  260. bool* pfMissingInputs, bool fOverrideMempoolLimit=false, const CAmount nAbsurdFee=0);
  261. /** Convert CValidationState to a human-readable message for logging */
  262. std::string FormatStateMessage(const CValidationState &state);
  263. struct CNodeStateStats {
  264. int nMisbehavior;
  265. int nSyncHeight;
  266. int nCommonHeight;
  267. std::vector<int> vHeightInFlight;
  268. };
  269. struct CDiskTxPos : public CDiskBlockPos
  270. {
  271. unsigned int nTxOffset; // after header
  272. ADD_SERIALIZE_METHODS;
  273. template <typename Stream, typename Operation>
  274. inline void SerializationOp(Stream& s, Operation ser_action, int nType, int nVersion) {
  275. READWRITE(*(CDiskBlockPos*)this);
  276. READWRITE(VARINT(nTxOffset));
  277. }
  278. CDiskTxPos(const CDiskBlockPos &blockIn, unsigned int nTxOffsetIn) : CDiskBlockPos(blockIn.nFile, blockIn.nPos), nTxOffset(nTxOffsetIn) {
  279. }
  280. CDiskTxPos() {
  281. SetNull();
  282. }
  283. void SetNull() {
  284. CDiskBlockPos::SetNull();
  285. nTxOffset = 0;
  286. }
  287. };
  288. /**
  289. * Count ECDSA signature operations the old-fashioned (pre-0.6) way
  290. * @return number of sigops this transaction's outputs will produce when spent
  291. * @see CTransaction::FetchInputs
  292. */
  293. unsigned int GetLegacySigOpCount(const CTransaction& tx);
  294. /**
  295. * Count ECDSA signature operations in pay-to-script-hash inputs.
  296. *
  297. * @param[in] mapInputs Map of previous transactions that have outputs we're spending
  298. * @return maximum number of sigops required to validate this transaction's inputs
  299. * @see CTransaction::FetchInputs
  300. */
  301. unsigned int GetP2SHSigOpCount(const CTransaction& tx, const CCoinsViewCache& mapInputs);
  302. /**
  303. * Check whether all inputs of this transaction are valid (no double spends, scripts & sigs, amounts)
  304. * This does not modify the UTXO set. If pvChecks is not NULL, script checks are pushed onto it
  305. * instead of being performed inline.
  306. */
  307. bool CheckInputs(const CTransaction& tx, CValidationState &state, const CCoinsViewCache &view, bool fScriptChecks,
  308. unsigned int flags, bool cacheStore, std::vector<CScriptCheck> *pvChecks = NULL);
  309. /** Apply the effects of this transaction on the UTXO set represented by view */
  310. void UpdateCoins(const CTransaction& tx, CValidationState &state, CCoinsViewCache &inputs, int nHeight);
  311. /** Context-independent validity checks */
  312. bool CheckTransaction(const CTransaction& tx, CValidationState& state);
  313. /**
  314. * Check if transaction is final and can be included in a block with the
  315. * specified height and time. Consensus critical.
  316. */
  317. bool IsFinalTx(const CTransaction &tx, int nBlockHeight, int64_t nBlockTime);
  318. /**
  319. * Check if transaction will be final in the next block to be created.
  320. *
  321. * Calls IsFinalTx() with current block height and appropriate block time.
  322. *
  323. * See consensus/consensus.h for flag definitions.
  324. */
  325. bool CheckFinalTx(const CTransaction &tx, int flags = -1);
  326. /**
  327. * Check if transaction is final per BIP 68 sequence numbers and can be included in a block.
  328. * Consensus critical. Takes as input a list of heights at which tx's inputs (in order) confirmed.
  329. */
  330. bool SequenceLocks(const CTransaction &tx, int flags, std::vector<int>* prevHeights, const CBlockIndex& block);
  331. /**
  332. * Check if transaction will be BIP 68 final in the next block to be created.
  333. *
  334. * Simulates calling SequenceLocks() with data from the tip of the current active chain.
  335. *
  336. * See consensus/consensus.h for flag definitions.
  337. */
  338. bool CheckSequenceLocks(const CTransaction &tx, int flags);
  339. /**
  340. * Closure representing one script verification
  341. * Note that this stores references to the spending transaction
  342. */
  343. class CScriptCheck
  344. {
  345. private:
  346. CScript scriptPubKey;
  347. const CTransaction *ptxTo;
  348. unsigned int nIn;
  349. unsigned int nFlags;
  350. bool cacheStore;
  351. ScriptError error;
  352. public:
  353. CScriptCheck(): ptxTo(0), nIn(0), nFlags(0), cacheStore(false), error(SCRIPT_ERR_UNKNOWN_ERROR) {}
  354. CScriptCheck(const CCoins& txFromIn, const CTransaction& txToIn, unsigned int nInIn, unsigned int nFlagsIn, bool cacheIn) :
  355. scriptPubKey(txFromIn.vout[txToIn.vin[nInIn].prevout.n].scriptPubKey),
  356. ptxTo(&txToIn), nIn(nInIn), nFlags(nFlagsIn), cacheStore(cacheIn), error(SCRIPT_ERR_UNKNOWN_ERROR) { }
  357. bool operator()();
  358. void swap(CScriptCheck &check) {
  359. scriptPubKey.swap(check.scriptPubKey);
  360. std::swap(ptxTo, check.ptxTo);
  361. std::swap(nIn, check.nIn);
  362. std::swap(nFlags, check.nFlags);
  363. std::swap(cacheStore, check.cacheStore);
  364. std::swap(error, check.error);
  365. }
  366. ScriptError GetScriptError() const { return error; }
  367. };
  368. /** Functions for disk access for blocks */
  369. bool WriteBlockToDisk(const CBlock& block, CDiskBlockPos& pos, const CMessageHeader::MessageStartChars& messageStart);
  370. bool ReadBlockFromDisk(CBlock& block, const CDiskBlockPos& pos, const Consensus::Params& consensusParams);
  371. bool ReadBlockFromDisk(CBlock& block, const CBlockIndex* pindex, const Consensus::Params& consensusParams);
  372. /** Functions for validating blocks and updating the block tree */
  373. /** Context-independent validity checks */
  374. bool CheckBlockHeader(const CBlockHeader& block, CValidationState& state, bool fCheckPOW = true);
  375. bool CheckBlock(const CBlock& block, CValidationState& state, bool fCheckPOW = true, bool fCheckMerkleRoot = true);
  376. /** Context-dependent validity checks.
  377. * By "context", we mean only the previous block headers, but not the UTXO
  378. * set; UTXO-related validity checks are done in ConnectBlock(). */
  379. bool ContextualCheckBlockHeader(const CBlockHeader& block, CValidationState& state, CBlockIndex *pindexPrev);
  380. bool ContextualCheckBlock(const CBlock& block, CValidationState& state, CBlockIndex *pindexPrev);
  381. /** Apply the effects of this block (with given index) on the UTXO set represented by coins.
  382. * Validity checks that depend on the UTXO set are also done; ConnectBlock()
  383. * can fail if those validity checks fail (among other reasons). */
  384. bool ConnectBlock(const CBlock& block, CValidationState& state, CBlockIndex* pindex, CCoinsViewCache& coins, bool fJustCheck = false);
  385. /** Undo the effects of this block (with given index) on the UTXO set represented by coins.
  386. * In case pfClean is provided, operation will try to be tolerant about errors, and *pfClean
  387. * will be true if no problems were found. Otherwise, the return value will be false in case
  388. * of problems. Note that in any case, coins may be modified. */
  389. bool DisconnectBlock(const CBlock& block, CValidationState& state, const CBlockIndex* pindex, CCoinsViewCache& coins, bool* pfClean = NULL);
  390. /** Check a block is completely valid from start to finish (only works on top of our current best block, with cs_main held) */
  391. bool TestBlockValidity(CValidationState& state, const CChainParams& chainparams, const CBlock& block, CBlockIndex* pindexPrev, bool fCheckPOW = true, bool fCheckMerkleRoot = true);
  392. class CBlockFileInfo
  393. {
  394. public:
  395. unsigned int nBlocks; //! number of blocks stored in file
  396. unsigned int nSize; //! number of used bytes of block file
  397. unsigned int nUndoSize; //! number of used bytes in the undo file
  398. unsigned int nHeightFirst; //! lowest height of block in file
  399. unsigned int nHeightLast; //! highest height of block in file
  400. uint64_t nTimeFirst; //! earliest time of block in file
  401. uint64_t nTimeLast; //! latest time of block in file
  402. ADD_SERIALIZE_METHODS;
  403. template <typename Stream, typename Operation>
  404. inline void SerializationOp(Stream& s, Operation ser_action, int nType, int nVersion) {
  405. READWRITE(VARINT(nBlocks));
  406. READWRITE(VARINT(nSize));
  407. READWRITE(VARINT(nUndoSize));
  408. READWRITE(VARINT(nHeightFirst));
  409. READWRITE(VARINT(nHeightLast));
  410. READWRITE(VARINT(nTimeFirst));
  411. READWRITE(VARINT(nTimeLast));
  412. }
  413. void SetNull() {
  414. nBlocks = 0;
  415. nSize = 0;
  416. nUndoSize = 0;
  417. nHeightFirst = 0;
  418. nHeightLast = 0;
  419. nTimeFirst = 0;
  420. nTimeLast = 0;
  421. }
  422. CBlockFileInfo() {
  423. SetNull();
  424. }
  425. std::string ToString() const;
  426. /** update statistics (does not update nSize) */
  427. void AddBlock(unsigned int nHeightIn, uint64_t nTimeIn) {
  428. if (nBlocks==0 || nHeightFirst > nHeightIn)
  429. nHeightFirst = nHeightIn;
  430. if (nBlocks==0 || nTimeFirst > nTimeIn)
  431. nTimeFirst = nTimeIn;
  432. nBlocks++;
  433. if (nHeightIn > nHeightLast)
  434. nHeightLast = nHeightIn;
  435. if (nTimeIn > nTimeLast)
  436. nTimeLast = nTimeIn;
  437. }
  438. };
  439. /** RAII wrapper for VerifyDB: Verify consistency of the block and coin databases */
  440. class CVerifyDB {
  441. public:
  442. CVerifyDB();
  443. ~CVerifyDB();
  444. bool VerifyDB(const CChainParams& chainparams, CCoinsView *coinsview, int nCheckLevel, int nCheckDepth);
  445. };
  446. /** Find the last common block between the parameter chain and a locator. */
  447. CBlockIndex* FindForkInGlobalIndex(const CChain& chain, const CBlockLocator& locator);
  448. /** Mark a block as invalid. */
  449. bool InvalidateBlock(CValidationState& state, const Consensus::Params& consensusParams, CBlockIndex *pindex);
  450. /** Remove invalidity status from a block and its descendants. */
  451. bool ReconsiderBlock(CValidationState& state, CBlockIndex *pindex);
  452. /** The currently-connected chain of blocks (protected by cs_main). */
  453. extern CChain chainActive;
  454. /** Global variable that points to the active CCoinsView (protected by cs_main) */
  455. extern CCoinsViewCache *pcoinsTip;
  456. /** Global variable that points to the active block tree (protected by cs_main) */
  457. extern CBlockTreeDB *pblocktree;
  458. /**
  459. * Return the spend height, which is one more than the inputs.GetBestBlock().
  460. * While checking, GetBestBlock() refers to the parent block. (protected by cs_main)
  461. * This is also true for mempool checks.
  462. */
  463. int GetSpendHeight(const CCoinsViewCache& inputs);
  464. /**
  465. * Determine what nVersion a new block should use.
  466. */
  467. int32_t ComputeBlockVersion(const CBlockIndex* pindexPrev, const Consensus::Params& params);
  468. /** Reject codes greater or equal to this can be returned by AcceptToMemPool
  469. * for transactions, to signal internal conditions. They cannot and should not
  470. * be sent over the P2P network.
  471. */
  472. static const unsigned int REJECT_INTERNAL = 0x100;
  473. /** Too high fee. Can not be triggered by P2P transactions */
  474. static const unsigned int REJECT_HIGHFEE = 0x100;
  475. /** Transaction is already known (either in mempool or blockchain) */
  476. static const unsigned int REJECT_ALREADY_KNOWN = 0x101;
  477. /** Transaction conflicts with a transaction already known */
  478. static const unsigned int REJECT_CONFLICT = 0x102;
  479. #endif // BITCOIN_MAIN_H