2018-01-07 06:05:16 +01:00
|
|
|
// Copyright (c) 2014-2018, The Monero Project
|
2015-12-14 05:54:39 +01:00
|
|
|
//
|
2014-07-23 15:03:52 +02:00
|
|
|
// All rights reserved.
|
2015-12-14 05:54:39 +01:00
|
|
|
//
|
2014-07-23 15:03:52 +02:00
|
|
|
// Redistribution and use in source and binary forms, with or without modification, are
|
|
|
|
// permitted provided that the following conditions are met:
|
2015-12-14 05:54:39 +01:00
|
|
|
//
|
2014-07-23 15:03:52 +02:00
|
|
|
// 1. Redistributions of source code must retain the above copyright notice, this list of
|
|
|
|
// conditions and the following disclaimer.
|
2015-12-14 05:54:39 +01:00
|
|
|
//
|
2014-07-23 15:03:52 +02:00
|
|
|
// 2. Redistributions in binary form must reproduce the above copyright notice, this list
|
|
|
|
// of conditions and the following disclaimer in the documentation and/or other
|
|
|
|
// materials provided with the distribution.
|
2015-12-14 05:54:39 +01:00
|
|
|
//
|
2014-07-23 15:03:52 +02:00
|
|
|
// 3. Neither the name of the copyright holder nor the names of its contributors may be
|
|
|
|
// used to endorse or promote products derived from this software without specific
|
|
|
|
// prior written permission.
|
2015-12-14 05:54:39 +01:00
|
|
|
//
|
2014-07-23 15:03:52 +02:00
|
|
|
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
|
|
|
|
// EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
|
|
// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
|
|
|
|
// THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
|
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
|
|
// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
|
|
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
|
|
// STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
|
|
|
|
// THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
2015-12-14 05:54:39 +01:00
|
|
|
//
|
2014-07-23 15:03:52 +02:00
|
|
|
// Parts of this file are originally copyright (c) 2012-2013 The Cryptonote developers
|
2014-03-03 23:07:58 +01:00
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
2014-09-25 07:15:28 +02:00
|
|
|
#include <ctime>
|
|
|
|
|
2014-03-03 23:07:58 +01:00
|
|
|
#include <boost/program_options/options_description.hpp>
|
|
|
|
#include <boost/program_options/variables_map.hpp>
|
2016-01-31 13:58:08 +01:00
|
|
|
#include <boost/interprocess/sync/file_lock.hpp>
|
2014-03-03 23:07:58 +01:00
|
|
|
|
|
|
|
#include "cryptonote_protocol/cryptonote_protocol_handler_common.h"
|
|
|
|
#include "storages/portable_storage_template_helper.h"
|
2017-02-26 22:00:38 +01:00
|
|
|
#include "common/download.h"
|
2017-09-14 05:39:37 +02:00
|
|
|
#include "common/threadpool.h"
|
2017-10-28 17:06:43 +02:00
|
|
|
#include "common/command_line.h"
|
2014-03-03 23:07:58 +01:00
|
|
|
#include "tx_pool.h"
|
2014-10-28 04:44:45 +01:00
|
|
|
#include "blockchain.h"
|
2017-01-26 16:07:23 +01:00
|
|
|
#include "cryptonote_basic/miner.h"
|
|
|
|
#include "cryptonote_basic/connection_context.h"
|
|
|
|
#include "cryptonote_basic/cryptonote_stat_info.h"
|
2014-03-03 23:07:58 +01:00
|
|
|
#include "warnings.h"
|
|
|
|
#include "crypto/hash.h"
|
|
|
|
|
|
|
|
PUSH_WARNINGS
|
|
|
|
DISABLE_VS_WARNINGS(4355)
|
|
|
|
|
|
|
|
namespace cryptonote
|
|
|
|
{
|
2016-02-08 19:47:56 +01:00
|
|
|
struct test_options {
|
|
|
|
const std::pair<uint8_t, uint64_t> *hard_forks;
|
|
|
|
};
|
|
|
|
|
2018-02-16 12:04:04 +01:00
|
|
|
extern const command_line::arg_descriptor<std::string, false, true, 2> arg_data_dir;
|
2017-10-28 17:06:43 +02:00
|
|
|
extern const command_line::arg_descriptor<bool, false> arg_testnet_on;
|
2018-02-16 12:04:04 +01:00
|
|
|
extern const command_line::arg_descriptor<bool, false> arg_stagenet_on;
|
2017-11-30 16:35:52 +01:00
|
|
|
extern const command_line::arg_descriptor<bool> arg_offline;
|
2017-10-28 17:06:43 +02:00
|
|
|
|
2014-03-03 23:07:58 +01:00
|
|
|
/************************************************************************/
|
|
|
|
/* */
|
|
|
|
/************************************************************************/
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief handles core cryptonote functionality
|
|
|
|
*
|
|
|
|
* This class coordinates cryptonote functionality including, but not
|
|
|
|
* limited to, communication among the Blockchain, the transaction pool,
|
|
|
|
* any miners, and the network.
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
class core: public i_miner_handler
|
|
|
|
{
|
|
|
|
public:
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief constructor
|
|
|
|
*
|
|
|
|
* sets member variables into a usable state
|
|
|
|
*
|
|
|
|
* @param pprotocol pre-constructed protocol object to store and use
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
core(i_cryptonote_protocol* pprotocol);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::handle_get_objects
|
|
|
|
*
|
|
|
|
* @note see Blockchain::handle_get_objects()
|
|
|
|
* @param context connection context associated with the request
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
bool handle_get_objects(NOTIFY_REQUEST_GET_OBJECTS::request& arg, NOTIFY_RESPONSE_GET_OBJECTS::request& rsp, cryptonote_connection_context& context);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief calls various idle routines
|
|
|
|
*
|
|
|
|
* @note see miner::on_idle and tx_memory_pool::on_idle
|
|
|
|
*
|
|
|
|
* @return true
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
bool on_idle();
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief handles an incoming transaction
|
|
|
|
*
|
|
|
|
* Parses an incoming transaction and, if nothing is obviously wrong,
|
|
|
|
* passes it along to the transaction pool
|
|
|
|
*
|
|
|
|
* @param tx_blob the tx to handle
|
|
|
|
* @param tvc metadata about the transaction's validity
|
|
|
|
* @param keeped_by_block if the transaction has been in a block
|
|
|
|
* @param relayed whether or not the transaction was relayed to us
|
2017-01-14 14:01:21 +01:00
|
|
|
* @param do_not_relay whether to prevent the transaction from being relayed
|
2016-03-25 07:22:06 +01:00
|
|
|
*
|
|
|
|
* @return true if the transaction made it to the transaction pool, otherwise false
|
|
|
|
*/
|
2017-01-14 14:01:21 +01:00
|
|
|
bool handle_incoming_tx(const blobdata& tx_blob, tx_verification_context& tvc, bool keeped_by_block, bool relayed, bool do_not_relay);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
2017-07-10 16:38:56 +02:00
|
|
|
/**
|
|
|
|
* @brief handles a list of incoming transactions
|
|
|
|
*
|
|
|
|
* Parses incoming transactions and, if nothing is obviously wrong,
|
|
|
|
* passes them along to the transaction pool
|
|
|
|
*
|
|
|
|
* @param tx_blobs the txs to handle
|
|
|
|
* @param tvc metadata about the transactions' validity
|
|
|
|
* @param keeped_by_block if the transactions have been in a block
|
|
|
|
* @param relayed whether or not the transactions were relayed to us
|
|
|
|
* @param do_not_relay whether to prevent the transactions from being relayed
|
|
|
|
*
|
|
|
|
* @return true if the transactions made it to the transaction pool, otherwise false
|
|
|
|
*/
|
|
|
|
bool handle_incoming_txs(const std::list<blobdata>& tx_blobs, std::vector<tx_verification_context>& tvc, bool keeped_by_block, bool relayed, bool do_not_relay);
|
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @brief handles an incoming block
|
|
|
|
*
|
|
|
|
* periodic update to checkpoints is triggered here
|
|
|
|
* Attempts to add the block to the Blockchain and, on success,
|
|
|
|
* optionally updates the miner's block template.
|
|
|
|
*
|
|
|
|
* @param block_blob the block to be added
|
|
|
|
* @param bvc return-by-reference metadata context about the block's validity
|
|
|
|
* @param update_miner_blocktemplate whether or not to update the miner's block template
|
|
|
|
*
|
|
|
|
* @return false if loading new checkpoints fails, or the block is not
|
|
|
|
* added, otherwise true
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
bool handle_incoming_block(const blobdata& block_blob, block_verification_context& bvc, bool update_miner_blocktemplate = true);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::prepare_handle_incoming_blocks
|
|
|
|
*
|
|
|
|
* @note see Blockchain::prepare_handle_incoming_blocks
|
|
|
|
*/
|
** CHANGES ARE EXPERIMENTAL (FOR TESTING ONLY)
Bockchain:
1. Optim: Multi-thread long-hash computation when encountering groups of blocks.
2. Optim: Cache verified txs and return result from cache instead of re-checking whenever possible.
3. Optim: Preload output-keys when encoutering groups of blocks. Sort by amount and global-index before bulk querying database and multi-thread when possible.
4. Optim: Disable double spend check on block verification, double spend is already detected when trying to add blocks.
5. Optim: Multi-thread signature computation whenever possible.
6. Patch: Disable locking (recursive mutex) on called functions from check_tx_inputs which causes slowdowns (only seems to happen on ubuntu/VMs??? Reason: TBD)
7. Optim: Removed looped full-tx hash computation when retrieving transactions from pool (???).
8. Optim: Cache difficulty/timestamps (735 blocks) for next-difficulty calculations so that only 2 db reads per new block is needed when a new block arrives (instead of 1470 reads).
Berkeley-DB:
1. Fix: 32-bit data errors causing wrong output global indices and failure to send blocks to peers (etc).
2. Fix: Unable to pop blocks on reorganize due to transaction errors.
3. Patch: Large number of transaction aborts when running multi-threaded bulk queries.
4. Patch: Insufficient locks error when running full sync.
5. Patch: Incorrect db stats when returning from an immediate exit from "pop block" operation.
6. Optim: Add bulk queries to get output global indices.
7. Optim: Modified output_keys table to store public_key+unlock_time+height for single transaction lookup (vs 3)
8. Optim: Used output_keys table retrieve public_keys instead of going through output_amounts->output_txs+output_indices->txs->output:public_key
9. Optim: Added thread-safe buffers used when multi-threading bulk queries.
10. Optim: Added support for nosync/write_nosync options for improved performance (*see --db-sync-mode option for details)
11. Mod: Added checkpoint thread and auto-remove-logs option.
12. *Now usable on 32-bit systems like RPI2.
LMDB:
1. Optim: Added custom comparison for 256-bit key tables (minor speed-up, TBD: get actual effect)
2. Optim: Modified output_keys table to store public_key+unlock_time+height for single transaction lookup (vs 3)
3. Optim: Used output_keys table retrieve public_keys instead of going through output_amounts->output_txs+output_indices->txs->output:public_key
4. Optim: Added support for sync/writemap options for improved performance (*see --db-sync-mode option for details)
5. Mod: Auto resize to +1GB instead of multiplier x1.5
ETC:
1. Minor optimizations for slow-hash for ARM (RPI2). Incomplete.
2. Fix: 32-bit saturation bug when computing next difficulty on large blocks.
[PENDING ISSUES]
1. Berkely db has a very slow "pop-block" operation. This is very noticeable on the RPI2 as it sometimes takes > 10 MINUTES to pop a block during reorganization.
This does not happen very often however, most reorgs seem to take a few seconds but it possibly depends on the number of outputs present. TBD.
2. Berkeley db, possible bug "unable to allocate memory". TBD.
[NEW OPTIONS] (*Currently all enabled for testing purposes)
1. --fast-block-sync arg=[0:1] (default: 1)
a. 0 = Compute long hash per block (may take a while depending on CPU)
b. 1 = Skip long-hash and verify blocks based on embedded known good block hashes (faster, minimal CPU dependence)
2. --db-sync-mode arg=[[safe|fast|fastest]:[sync|async]:[nblocks_per_sync]] (default: fastest:async:1000)
a. safe = fdatasync/fsync (or equivalent) per stored block. Very slow, but safest option to protect against power-out/crash conditions.
b. fast/fastest = Enables asynchronous fdatasync/fsync (or equivalent). Useful for battery operated devices or STABLE systems with UPS and/or systems with battery backed write cache/solid state cache.
Fast - Write meta-data but defer data flush.
Fastest - Defer meta-data and data flush.
Sync - Flush data after nblocks_per_sync and wait.
Async - Flush data after nblocks_per_sync but do not wait for the operation to finish.
3. --prep-blocks-threads arg=[n] (default: 4 or system max threads, whichever is lower)
Max number of threads to use when computing long-hash in groups.
4. --show-time-stats arg=[0:1] (default: 1)
Show benchmark related time stats.
5. --db-auto-remove-logs arg=[0:1] (default: 1)
For berkeley-db only. Auto remove logs if enabled.
**Note: lmdb and berkeley-db have changes to the tables and are not compatible with official git head version.
At the moment, you need a full resync to use this optimized version.
[PERFORMANCE COMPARISON]
**Some figures are approximations only.
Using a baseline machine of an i7-2600K+SSD+(with full pow computation):
1. The optimized lmdb/blockhain core can process blocks up to 585K for ~1.25 hours + download time, so it usually takes 2.5 hours to sync the full chain.
2. The current head with memory can process blocks up to 585K for ~4.2 hours + download time, so it usually takes 5.5 hours to sync the full chain.
3. The current head with lmdb can process blocks up to 585K for ~32 hours + download time and usually takes 36 hours to sync the full chain.
Averate procesing times (with full pow computation):
lmdb-optimized:
1. tx_ave = 2.5 ms / tx
2. block_ave = 5.87 ms / block
memory-official-repo:
1. tx_ave = 8.85 ms / tx
2. block_ave = 19.68 ms / block
lmdb-official-repo (0f4a036437fd41a5498ee5e74e2422ea6177aa3e)
1. tx_ave = 47.8 ms / tx
2. block_ave = 64.2 ms / block
**Note: The following data denotes processing times only (does not include p2p download time)
lmdb-optimized processing times (with full pow computation):
1. Desktop, Quad-core / 8-threads 2600k (8Mb) - 1.25 hours processing time (--db-sync-mode=fastest:async:1000).
2. Laptop, Dual-core / 4-threads U4200 (3Mb) - 4.90 hours processing time (--db-sync-mode=fastest:async:1000).
3. Embedded, Quad-core / 4-threads Z3735F (2x1Mb) - 12.0 hours processing time (--db-sync-mode=fastest:async:1000).
lmdb-optimized processing times (with per-block-checkpoint)
1. Desktop, Quad-core / 8-threads 2600k (8Mb) - 10 minutes processing time (--db-sync-mode=fastest:async:1000).
berkeley-db optimized processing times (with full pow computation)
1. Desktop, Quad-core / 8-threads 2600k (8Mb) - 1.8 hours processing time (--db-sync-mode=fastest:async:1000).
2. RPI2. Improved from estimated 3 months(???) into 2.5 days (*Need 2AMP supply + Clock:1Ghz + [usb+ssd] to achieve this speed) (--db-sync-mode=fastest:async:1000).
berkeley-db optimized processing times (with per-block-checkpoint)
1. RPI2. 12-15 hours (*Need 2AMP supply + Clock:1Ghz + [usb+ssd] to achieve this speed) (--db-sync-mode=fastest:async:1000).
2015-07-10 22:09:32 +02:00
|
|
|
bool prepare_handle_incoming_blocks(const std::list<block_complete_entry> &blocks);
|
2015-10-08 04:28:51 +02:00
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::cleanup_handle_incoming_blocks
|
|
|
|
*
|
|
|
|
* @note see Blockchain::cleanup_handle_incoming_blocks
|
|
|
|
*/
|
|
|
|
bool cleanup_handle_incoming_blocks(bool force_sync = false);
|
2016-10-10 22:41:24 +02:00
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @brief check the size of a block against the current maximum
|
|
|
|
*
|
|
|
|
* @param block_blob the block to check
|
|
|
|
*
|
|
|
|
* @return whether or not the block is too big
|
|
|
|
*/
|
2016-03-25 07:42:42 +01:00
|
|
|
bool check_incoming_block_size(const blobdata& block_blob) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief get the cryptonote protocol instance
|
|
|
|
*
|
|
|
|
* @return the instance
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
i_cryptonote_protocol* get_protocol(){return m_pprotocol;}
|
|
|
|
|
|
|
|
//-------------------- i_miner_handler -----------------------
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief stores and relays a block found by a miner
|
|
|
|
*
|
|
|
|
* Updates the miner's target block, attempts to store the found
|
|
|
|
* block in Blockchain, and -- on success -- relays that block to
|
|
|
|
* the network.
|
|
|
|
*
|
|
|
|
* @param b the block found
|
|
|
|
*
|
|
|
|
* @return true if the block was added to the main chain, otherwise false
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
virtual bool handle_block_found( block& b);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::create_block_template
|
|
|
|
*
|
|
|
|
* @note see Blockchain::create_block_template
|
|
|
|
*/
|
2017-03-28 16:55:38 +02:00
|
|
|
virtual bool get_block_template(block& b, const account_public_address& adr, difficulty_type& diffic, uint64_t& height, uint64_t& expected_reward, const blobdata& ex_nonce);
|
2014-03-03 23:07:58 +01:00
|
|
|
|
2016-10-22 21:46:51 +02:00
|
|
|
/**
|
|
|
|
* @brief called when a transaction is relayed
|
|
|
|
*/
|
|
|
|
virtual void on_transaction_relayed(const cryptonote::blobdata& tx);
|
|
|
|
|
2014-03-03 23:07:58 +01:00
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @brief gets the miner instance
|
|
|
|
*
|
|
|
|
* @return a reference to the miner instance
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
miner& get_miner(){return m_miner;}
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief gets the miner instance (const)
|
|
|
|
*
|
|
|
|
* @return a const reference to the miner instance
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
const miner& get_miner()const{return m_miner;}
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief adds command line options to the given options set
|
|
|
|
*
|
|
|
|
* As of now, there are no command line options specific to core,
|
|
|
|
* so this function simply returns.
|
|
|
|
*
|
|
|
|
* @param desc return-by-reference the command line options set to add to
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
static void init_options(boost::program_options::options_description& desc);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief initializes the core as needed
|
|
|
|
*
|
|
|
|
* This function initializes the transaction pool, the Blockchain, and
|
|
|
|
* a miner instance with parameters given on the command line (or defaults)
|
|
|
|
*
|
|
|
|
* @param vm command line parameters
|
2017-11-29 23:53:58 +01:00
|
|
|
* @param config_subdir subdirectory for config storage
|
2016-03-25 07:22:06 +01:00
|
|
|
* @param test_options configuration options for testing
|
|
|
|
*
|
|
|
|
* @return false if one of the init steps fails, otherwise true
|
|
|
|
*/
|
2017-11-29 23:53:58 +01:00
|
|
|
bool init(const boost::program_options::variables_map& vm, const char *config_subdir = NULL, const test_options *test_options = NULL);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::reset_and_set_genesis_block
|
|
|
|
*
|
|
|
|
* @note see Blockchain::reset_and_set_genesis_block
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
bool set_genesis_block(const block& b);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief performs safe shutdown steps for core and core components
|
|
|
|
*
|
|
|
|
* Uninitializes the miner instance, transaction pool, and Blockchain
|
|
|
|
*
|
|
|
|
* @return true
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
bool deinit();
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief sets to drop blocks downloaded (for testing)
|
|
|
|
*/
|
2015-02-20 22:28:03 +01:00
|
|
|
void test_drop_download();
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief sets to drop blocks downloaded below a certain height
|
|
|
|
*
|
|
|
|
* @param height height below which to drop blocks
|
|
|
|
*/
|
2015-02-20 22:28:03 +01:00
|
|
|
void test_drop_download_height(uint64_t height);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief gets whether or not to drop blocks (for testing)
|
|
|
|
*
|
|
|
|
* @return whether or not to drop blocks
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool get_test_drop_download() const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief gets whether or not to drop blocks
|
|
|
|
*
|
|
|
|
* If the current blockchain height <= our block drop threshold
|
|
|
|
* and test drop blocks is set, return true
|
|
|
|
*
|
|
|
|
* @return see above
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool get_test_drop_download_height() const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_current_blockchain_height
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_current_blockchain_height()
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
uint64_t get_current_blockchain_height() const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief get the hash and height of the most recent block
|
|
|
|
*
|
|
|
|
* @param height return-by-reference height of the block
|
|
|
|
* @param top_id return-by-reference hash of the block
|
|
|
|
*/
|
2017-09-09 13:06:24 +02:00
|
|
|
void get_blockchain_top(uint64_t& height, crypto::hash& top_id) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
2017-01-15 17:05:55 +01:00
|
|
|
* @copydoc Blockchain::get_blocks(uint64_t, size_t, std::list<std::pair<cryptonote::blobdata,block>>&, std::list<transaction>&) const
|
2016-03-25 07:22:06 +01:00
|
|
|
*
|
2017-01-15 17:05:55 +01:00
|
|
|
* @note see Blockchain::get_blocks(uint64_t, size_t, std::list<std::pair<cryptonote::blobdata,block>>&, std::list<transaction>&) const
|
2016-03-25 07:22:06 +01:00
|
|
|
*/
|
2017-01-15 17:05:55 +01:00
|
|
|
bool get_blocks(uint64_t start_offset, size_t count, std::list<std::pair<cryptonote::blobdata,block>>& blocks, std::list<cryptonote::blobdata>& txs) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
2017-01-15 17:05:55 +01:00
|
|
|
* @copydoc Blockchain::get_blocks(uint64_t, size_t, std::list<std::pair<cryptonote::blobdata,block>>&) const
|
2016-03-25 07:22:06 +01:00
|
|
|
*
|
2017-01-15 17:05:55 +01:00
|
|
|
* @note see Blockchain::get_blocks(uint64_t, size_t, std::list<std::pair<cryptonote::blobdata,block>>&) const
|
|
|
|
*/
|
|
|
|
bool get_blocks(uint64_t start_offset, size_t count, std::list<std::pair<cryptonote::blobdata,block>>& blocks) const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_blocks(uint64_t, size_t, std::list<std::pair<cryptonote::blobdata,block>>&) const
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_blocks(uint64_t, size_t, std::list<std::pair<cryptonote::blobdata,block>>&) const
|
2016-03-25 07:22:06 +01:00
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool get_blocks(uint64_t start_offset, size_t count, std::list<block>& blocks) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_blocks(const t_ids_container&, t_blocks_container&, t_missed_container&) const
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_blocks(const t_ids_container&, t_blocks_container&, t_missed_container&) const
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
template<class t_ids_container, class t_blocks_container, class t_missed_container>
|
2015-09-19 12:25:57 +02:00
|
|
|
bool get_blocks(const t_ids_container& block_ids, t_blocks_container& blocks, t_missed_container& missed_bs) const
|
2014-03-03 23:07:58 +01:00
|
|
|
{
|
|
|
|
return m_blockchain_storage.get_blocks(block_ids, blocks, missed_bs);
|
|
|
|
}
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_block_id_by_height
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_block_id_by_height
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
crypto::hash get_block_id_by_height(uint64_t height) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
2017-01-15 17:05:55 +01:00
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_transactions
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_transactions
|
|
|
|
*/
|
|
|
|
bool get_transactions(const std::vector<crypto::hash>& txs_ids, std::list<cryptonote::blobdata>& txs, std::list<crypto::hash>& missed_txs) const;
|
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_transactions
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_transactions
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool get_transactions(const std::vector<crypto::hash>& txs_ids, std::list<transaction>& txs, std::list<crypto::hash>& missed_txs) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_block_by_hash
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_block_by_hash
|
|
|
|
*/
|
2017-01-22 13:20:55 +01:00
|
|
|
bool get_block_by_hash(const crypto::hash &h, block &blk, bool *orphan = NULL) const;
|
2014-03-03 23:07:58 +01:00
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_alternative_blocks
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_alternative_blocks(std::list<block>&) const
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool get_alternative_blocks(std::list<block>& blocks) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_alternative_blocks_count
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_alternative_blocks_count() const
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
size_t get_alternative_blocks_count() const;
|
2014-03-03 23:07:58 +01:00
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @brief set the pointer to the cryptonote protocol object to use
|
|
|
|
*
|
|
|
|
* @param pprotocol the pointer to set ours as
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
void set_cryptonote_protocol(i_cryptonote_protocol* pprotocol);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::set_checkpoints
|
|
|
|
*
|
|
|
|
* @note see Blockchain::set_checkpoints()
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
void set_checkpoints(checkpoints&& chk_pts);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief set the file path to read from when loading checkpoints
|
|
|
|
*
|
|
|
|
* @param path the path to set ours as
|
|
|
|
*/
|
2014-09-25 07:15:28 +02:00
|
|
|
void set_checkpoints_file_path(const std::string& path);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief set whether or not we enforce DNS checkpoints
|
|
|
|
*
|
|
|
|
* @param enforce_dns enforce DNS checkpoints or not
|
|
|
|
*/
|
2014-09-26 07:01:58 +02:00
|
|
|
void set_enforce_dns_checkpoints(bool enforce_dns);
|
2014-03-03 23:07:58 +01:00
|
|
|
|
2017-07-26 11:18:44 +02:00
|
|
|
/**
|
|
|
|
* @brief set whether or not to enable or disable DNS checkpoints
|
|
|
|
*
|
|
|
|
* @param disble whether to disable DNS checkpoints
|
|
|
|
*/
|
|
|
|
void disable_dns_checkpoints(bool disable = true) { m_disable_dns_checkpoints = disable; }
|
|
|
|
|
2017-05-14 15:06:55 +02:00
|
|
|
/**
|
|
|
|
* @copydoc tx_memory_pool::have_tx
|
|
|
|
*
|
|
|
|
* @note see tx_memory_pool::have_tx
|
|
|
|
*/
|
|
|
|
bool pool_has_tx(const crypto::hash &txid) const;
|
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @copydoc tx_memory_pool::get_transactions
|
2017-11-08 13:06:41 +01:00
|
|
|
* @param include_unrelayed_txes include unrelayed txes in result
|
2016-03-25 07:22:06 +01:00
|
|
|
*
|
|
|
|
* @note see tx_memory_pool::get_transactions
|
|
|
|
*/
|
2017-11-08 13:06:41 +01:00
|
|
|
bool get_pool_transactions(std::list<transaction>& txs, bool include_unrelayed_txes = true) const;
|
|
|
|
|
2017-08-26 17:23:31 +02:00
|
|
|
/**
|
|
|
|
* @copydoc tx_memory_pool::get_txpool_backlog
|
|
|
|
*
|
|
|
|
* @note see tx_memory_pool::get_txpool_backlog
|
|
|
|
*/
|
|
|
|
bool get_txpool_backlog(std::vector<tx_backlog_entry>& backlog) const;
|
|
|
|
|
2017-03-22 19:03:23 +01:00
|
|
|
/**
|
|
|
|
* @copydoc tx_memory_pool::get_transactions
|
2017-11-08 13:06:41 +01:00
|
|
|
* @param include_unrelayed_txes include unrelayed txes in result
|
2017-03-22 19:03:23 +01:00
|
|
|
*
|
|
|
|
* @note see tx_memory_pool::get_transactions
|
|
|
|
*/
|
2017-11-08 13:06:41 +01:00
|
|
|
bool get_pool_transaction_hashes(std::vector<crypto::hash>& txs, bool include_unrelayed_txes = true) const;
|
2017-03-22 19:03:23 +01:00
|
|
|
|
2017-05-31 20:11:56 +02:00
|
|
|
/**
|
|
|
|
* @copydoc tx_memory_pool::get_transactions
|
2017-11-08 13:06:41 +01:00
|
|
|
* @param include_unrelayed_txes include unrelayed txes in result
|
2017-05-31 20:11:56 +02:00
|
|
|
*
|
|
|
|
* @note see tx_memory_pool::get_transactions
|
|
|
|
*/
|
2017-11-08 13:06:41 +01:00
|
|
|
bool get_pool_transaction_stats(struct txpool_stats& stats, bool include_unrelayed_txes = true) const;
|
2017-05-31 20:11:56 +02:00
|
|
|
|
2016-10-26 21:00:08 +02:00
|
|
|
/**
|
|
|
|
* @copydoc tx_memory_pool::get_transaction
|
|
|
|
*
|
|
|
|
* @note see tx_memory_pool::get_transaction
|
|
|
|
*/
|
2017-05-14 15:06:55 +02:00
|
|
|
bool get_pool_transaction(const crypto::hash& id, cryptonote::blobdata& tx) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc tx_memory_pool::get_pool_transactions_and_spent_keys_info
|
2017-11-08 13:06:41 +01:00
|
|
|
* @param include_unrelayed_txes include unrelayed txes in result
|
2016-03-25 07:22:06 +01:00
|
|
|
*
|
|
|
|
* @note see tx_memory_pool::get_pool_transactions_and_spent_keys_info
|
|
|
|
*/
|
2017-11-08 13:06:41 +01:00
|
|
|
bool get_pool_transactions_and_spent_keys_info(std::vector<tx_info>& tx_infos, std::vector<spent_key_image_info>& key_image_infos, bool include_unrelayed_txes = true) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
2017-09-05 18:20:27 +02:00
|
|
|
/**
|
|
|
|
* @copydoc tx_memory_pool::get_pool_for_rpc
|
|
|
|
*
|
|
|
|
* @note see tx_memory_pool::get_pool_for_rpc
|
|
|
|
*/
|
|
|
|
bool get_pool_for_rpc(std::vector<cryptonote::rpc::tx_in_pool>& tx_infos, cryptonote::rpc::key_images_with_tx_hashes& key_image_infos) const;
|
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @copydoc tx_memory_pool::get_transactions_count
|
|
|
|
*
|
|
|
|
* @note see tx_memory_pool::get_transactions_count
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
size_t get_pool_transactions_count() const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_total_transactions
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_total_transactions
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
size_t get_blockchain_total_transactions() const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::have_block
|
|
|
|
*
|
|
|
|
* @note see Blockchain::have_block
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool have_block(const crypto::hash& id) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_short_chain_history
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_short_chain_history
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool get_short_chain_history(std::list<crypto::hash>& ids) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::find_blockchain_supplement(const std::list<crypto::hash>&, NOTIFY_RESPONSE_CHAIN_ENTRY::request&) const
|
|
|
|
*
|
|
|
|
* @note see Blockchain::find_blockchain_supplement(const std::list<crypto::hash>&, NOTIFY_RESPONSE_CHAIN_ENTRY::request&) const
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool find_blockchain_supplement(const std::list<crypto::hash>& qblock_ids, NOTIFY_RESPONSE_CHAIN_ENTRY::request& resp) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
2017-01-15 17:05:55 +01:00
|
|
|
* @copydoc Blockchain::find_blockchain_supplement(const uint64_t, const std::list<crypto::hash>&, std::list<std::pair<cryptonote::blobdata, std::list<cryptonote::blobdata> > >&, uint64_t&, uint64_t&, size_t) const
|
2016-03-25 07:22:06 +01:00
|
|
|
*
|
2017-01-15 17:05:55 +01:00
|
|
|
* @note see Blockchain::find_blockchain_supplement(const uint64_t, const std::list<crypto::hash>&, std::list<std::pair<cryptonote::blobdata, std::list<transaction> > >&, uint64_t&, uint64_t&, size_t) const
|
2016-03-25 07:22:06 +01:00
|
|
|
*/
|
2017-01-15 17:05:55 +01:00
|
|
|
bool find_blockchain_supplement(const uint64_t req_start_block, const std::list<crypto::hash>& qblock_ids, std::list<std::pair<cryptonote::blobdata, std::list<cryptonote::blobdata> > >& blocks, uint64_t& total_height, uint64_t& start_height, size_t max_count) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief gets some stats about the daemon
|
|
|
|
*
|
|
|
|
* @param st_inf return-by-reference container for the stats requested
|
|
|
|
*
|
|
|
|
* @return true
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool get_stat_info(core_stat_info& st_inf) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_tx_outputs_gindexs
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_tx_outputs_gindexs
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool get_tx_outputs_gindexs(const crypto::hash& tx_id, std::vector<uint64_t>& indexs) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_tail_id
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_tail_id
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
crypto::hash get_tail_id() const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
2017-08-12 16:24:39 +02:00
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_block_cumulative_difficulty
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_block_cumulative_difficulty
|
|
|
|
*/
|
|
|
|
difficulty_type get_block_cumulative_difficulty(uint64_t height) const;
|
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_random_outs_for_amounts
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_random_outs_for_amounts
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool get_random_outs_for_amounts(const COMMAND_RPC_GET_RANDOM_OUTPUTS_FOR_AMOUNTS::request& req, COMMAND_RPC_GET_RANDOM_OUTPUTS_FOR_AMOUNTS::response& res) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
2016-08-02 22:48:09 +02:00
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_outs
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_outs
|
|
|
|
*/
|
2016-11-22 21:00:40 +01:00
|
|
|
bool get_outs(const COMMAND_RPC_GET_OUTPUTS_BIN::request& req, COMMAND_RPC_GET_OUTPUTS_BIN::response& res) const;
|
2016-08-02 22:48:09 +02:00
|
|
|
|
2016-06-05 11:46:18 +02:00
|
|
|
/**
|
|
|
|
*
|
|
|
|
* @copydoc Blockchain::get_random_rct_outs
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_random_rct_outs
|
|
|
|
*/
|
|
|
|
bool get_random_rct_outs(const COMMAND_RPC_GET_RANDOM_RCT_OUTPUTS::request& req, COMMAND_RPC_GET_RANDOM_RCT_OUTPUTS::response& res) const;
|
|
|
|
|
2018-02-19 12:15:15 +01:00
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::get_output_distribution
|
|
|
|
*
|
|
|
|
* @brief get per block distribution of outputs of a given amount
|
|
|
|
*/
|
2018-05-16 23:41:50 +02:00
|
|
|
bool get_output_distribution(uint64_t amount, uint64_t from_height, uint64_t to_height, uint64_t &start_height, std::vector<uint64_t> &distribution, uint64_t &base) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc miner::pause
|
|
|
|
*
|
|
|
|
* @note see miner::pause
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
void pause_mine();
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc miner::resume
|
|
|
|
*
|
|
|
|
* @note see miner::resume
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
void resume_mine();
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief gets the Blockchain instance
|
|
|
|
*
|
|
|
|
* @return a reference to the Blockchain instance
|
|
|
|
*/
|
2014-10-28 04:44:45 +01:00
|
|
|
Blockchain& get_blockchain_storage(){return m_blockchain_storage;}
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief gets the Blockchain instance (const)
|
|
|
|
*
|
|
|
|
* @return a const reference to the Blockchain instance
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
const Blockchain& get_blockchain_storage()const{return m_blockchain_storage;}
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc tx_memory_pool::print_pool
|
|
|
|
*
|
|
|
|
* @note see tx_memory_pool::print_pool
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
std::string print_pool(bool short_format) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc miner::on_synchronized
|
|
|
|
*
|
|
|
|
* @note see miner::on_synchronized
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
void on_synchronized();
|
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
2017-08-22 15:54:18 +02:00
|
|
|
* @copydoc Blockchain::safesyncmode
|
|
|
|
*
|
|
|
|
* 2note see Blockchain::safesyncmode
|
|
|
|
*/
|
|
|
|
void safesyncmode(const bool onoff);
|
|
|
|
|
|
|
|
/**
|
2016-03-25 07:22:06 +01:00
|
|
|
* @brief sets the target blockchain height
|
|
|
|
*
|
|
|
|
* @param target_blockchain_height the height to set
|
|
|
|
*/
|
2014-06-04 22:50:13 +02:00
|
|
|
void set_target_blockchain_height(uint64_t target_blockchain_height);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief gets the target blockchain height
|
|
|
|
*
|
|
|
|
* @param target_blockchain_height the target height
|
|
|
|
*/
|
2014-06-04 22:50:13 +02:00
|
|
|
uint64_t get_target_blockchain_height() const;
|
|
|
|
|
2018-04-16 04:02:26 +02:00
|
|
|
/**
|
|
|
|
* @brief returns the newest hardfork version known to the blockchain
|
|
|
|
*
|
|
|
|
* @return the version
|
|
|
|
*/
|
|
|
|
uint8_t get_ideal_hard_fork_version() const;
|
|
|
|
|
2017-08-10 11:10:04 +02:00
|
|
|
/**
|
|
|
|
* @brief return the ideal hard fork version for a given block height
|
|
|
|
*
|
|
|
|
* @return what it says above
|
|
|
|
*/
|
|
|
|
uint8_t get_ideal_hard_fork_version(uint64_t height) const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief return the hard fork version for a given block height
|
|
|
|
*
|
|
|
|
* @return what it says above
|
|
|
|
*/
|
|
|
|
uint8_t get_hard_fork_version(uint64_t height) const;
|
|
|
|
|
2017-01-09 00:50:29 +01:00
|
|
|
/**
|
|
|
|
* @brief gets start_time
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
std::time_t get_start_time() const;
|
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @brief tells the Blockchain to update its checkpoints
|
|
|
|
*
|
|
|
|
* This function will check if enough time has passed since the last
|
|
|
|
* time checkpoints were updated and tell the Blockchain to update
|
|
|
|
* its checkpoints if it is time. If updating checkpoints fails,
|
|
|
|
* the daemon is told to shut down.
|
|
|
|
*
|
|
|
|
* @note see Blockchain::update_checkpoints()
|
|
|
|
*/
|
2014-09-26 07:01:58 +02:00
|
|
|
bool update_checkpoints();
|
2014-09-25 07:15:28 +02:00
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @brief tells the daemon to wind down operations and stop running
|
|
|
|
*
|
|
|
|
* Currently this function raises SIGTERM, allowing the installed signal
|
|
|
|
* handlers to do the actual stopping.
|
|
|
|
*/
|
|
|
|
void graceful_exit();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief stops the daemon running
|
|
|
|
*
|
|
|
|
* @note see graceful_exit()
|
|
|
|
*/
|
2015-02-05 10:11:20 +01:00
|
|
|
void stop();
|
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::have_tx_keyimg_as_spent
|
|
|
|
*
|
|
|
|
* @note see Blockchain::have_tx_keyimg_as_spent
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool is_key_image_spent(const crypto::key_image& key_im) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief check if multiple key images are spent
|
|
|
|
*
|
|
|
|
* plural version of is_key_image_spent()
|
|
|
|
*
|
|
|
|
* @param key_im list of key images to check
|
|
|
|
* @param spent return-by-reference result for each image checked
|
|
|
|
*
|
|
|
|
* @return true
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool are_key_images_spent(const std::vector<crypto::key_image>& key_im, std::vector<bool> &spent) const;
|
2015-08-11 11:49:15 +02:00
|
|
|
|
2016-09-24 18:00:19 +02:00
|
|
|
/**
|
2017-09-05 18:20:27 +02:00
|
|
|
* @brief check if multiple key images are spent in the transaction pool
|
|
|
|
*
|
|
|
|
* @param key_im list of key images to check
|
|
|
|
* @param spent return-by-reference result for each image checked
|
|
|
|
*
|
|
|
|
* @return true
|
|
|
|
*/
|
|
|
|
bool are_key_images_spent_in_pool(const std::vector<crypto::key_image>& key_im, std::vector<bool> &spent) const;
|
|
|
|
|
2016-09-24 18:00:19 +02:00
|
|
|
/**
|
|
|
|
* @brief get the number of blocks to sync in one go
|
|
|
|
*
|
|
|
|
* @return the number of blocks to sync in one go
|
|
|
|
*/
|
2017-08-16 22:19:53 +02:00
|
|
|
size_t get_block_sync_size(uint64_t height) const;
|
2016-09-24 18:00:19 +02:00
|
|
|
|
2016-10-10 21:45:51 +02:00
|
|
|
/**
|
|
|
|
* @brief get the sum of coinbase tx amounts between blocks
|
|
|
|
*
|
|
|
|
* @return the number of blocks to sync in one go
|
|
|
|
*/
|
2016-10-13 18:49:25 +02:00
|
|
|
std::pair<uint64_t, uint64_t> get_coinbase_tx_sum(const uint64_t start_offset, const size_t count);
|
2016-10-26 21:00:08 +02:00
|
|
|
|
|
|
|
/**
|
2018-02-16 12:04:04 +01:00
|
|
|
* @brief get the network type we're on
|
2016-10-26 21:00:08 +02:00
|
|
|
*
|
2018-02-16 12:04:04 +01:00
|
|
|
* @return which network are we on?
|
2016-10-26 21:00:08 +02:00
|
|
|
*/
|
2018-02-16 12:04:04 +01:00
|
|
|
network_type get_nettype() const { return m_nettype; };
|
2016-10-10 21:45:51 +02:00
|
|
|
|
2017-09-02 18:11:20 +02:00
|
|
|
/**
|
|
|
|
* @brief get whether fluffy blocks are enabled
|
|
|
|
*
|
|
|
|
* @return whether fluffy blocks are enabled
|
|
|
|
*/
|
|
|
|
bool fluffy_blocks_enabled() const { return m_fluffy_blocks_enabled; }
|
|
|
|
|
2017-09-13 22:03:04 +02:00
|
|
|
/**
|
|
|
|
* @brief check a set of hashes against the precompiled hash set
|
|
|
|
*
|
|
|
|
* @return number of usable blocks
|
|
|
|
*/
|
|
|
|
uint64_t prevalidate_block_hashes(uint64_t height, const std::list<crypto::hash> &hashes);
|
|
|
|
|
2017-11-12 00:25:12 +01:00
|
|
|
/**
|
|
|
|
* @brief get free disk space on the blockchain partition
|
|
|
|
*
|
|
|
|
* @return free space in bytes
|
|
|
|
*/
|
|
|
|
uint64_t get_free_space() const;
|
|
|
|
|
2017-11-30 16:35:52 +01:00
|
|
|
/**
|
|
|
|
* @brief get whether the core is running offline
|
|
|
|
*
|
|
|
|
* @return whether the core is running offline
|
|
|
|
*/
|
|
|
|
bool offline() const { return m_offline; }
|
|
|
|
|
2014-09-26 07:01:58 +02:00
|
|
|
private:
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
2017-05-14 15:06:55 +02:00
|
|
|
* @copydoc add_new_tx(transaction&, tx_verification_context&, bool)
|
2016-03-25 07:22:06 +01:00
|
|
|
*
|
|
|
|
* @param tx_hash the transaction's hash
|
|
|
|
* @param tx_prefix_hash the transaction prefix' hash
|
|
|
|
* @param blob_size the size of the transaction
|
|
|
|
* @param relayed whether or not the transaction was relayed to us
|
2017-01-14 14:01:21 +01:00
|
|
|
* @param do_not_relay whether to prevent the transaction from being relayed
|
2016-03-25 07:22:06 +01:00
|
|
|
*
|
|
|
|
*/
|
2017-05-14 15:06:55 +02:00
|
|
|
bool add_new_tx(transaction& tx, const crypto::hash& tx_hash, const crypto::hash& tx_prefix_hash, size_t blob_size, tx_verification_context& tvc, bool keeped_by_block, bool relayed, bool do_not_relay);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief add a new transaction to the transaction pool
|
|
|
|
*
|
|
|
|
* Adds a new transaction to the transaction pool.
|
|
|
|
*
|
|
|
|
* @param tx the transaction to add
|
|
|
|
* @param tvc return-by-reference metadata about the transaction's verification process
|
|
|
|
* @param keeped_by_block whether or not the transaction has been in a block
|
|
|
|
* @param relayed whether or not the transaction was relayed to us
|
2017-01-14 14:01:21 +01:00
|
|
|
* @param do_not_relay whether to prevent the transaction from being relayed
|
2016-03-25 07:22:06 +01:00
|
|
|
*
|
|
|
|
* @return true if the transaction is already in the transaction pool,
|
|
|
|
* is already in a block on the Blockchain, or is successfully added
|
|
|
|
* to the transaction pool
|
|
|
|
*/
|
2017-05-14 15:06:55 +02:00
|
|
|
bool add_new_tx(transaction& tx, tx_verification_context& tvc, bool keeped_by_block, bool relayed, bool do_not_relay);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc Blockchain::add_new_block
|
|
|
|
*
|
|
|
|
* @note see Blockchain::add_new_block
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
bool add_new_block(const block& b, block_verification_context& bvc);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief load any core state stored on disk
|
|
|
|
*
|
|
|
|
* currently does nothing, but may have state to load in the future.
|
|
|
|
*
|
|
|
|
* @return true
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
bool load_state_data();
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @copydoc parse_tx_from_blob(transaction&, crypto::hash&, crypto::hash&, const blobdata&) const
|
|
|
|
*
|
|
|
|
* @note see parse_tx_from_blob(transaction&, crypto::hash&, crypto::hash&, const blobdata&) const
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool parse_tx_from_blob(transaction& tx, crypto::hash& tx_hash, crypto::hash& tx_prefix_hash, const blobdata& blob) const;
|
2014-03-03 23:07:58 +01:00
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @brief check a transaction's syntax
|
|
|
|
*
|
|
|
|
* For now this does nothing, but it may check something about the tx
|
|
|
|
* in the future.
|
|
|
|
*
|
|
|
|
* @param tx the transaction to check
|
|
|
|
*
|
|
|
|
* @return true
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool check_tx_syntax(const transaction& tx) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief validates some simple properties of a transaction
|
|
|
|
*
|
|
|
|
* Currently checks: tx has inputs,
|
|
|
|
* tx inputs all of supported type(s),
|
|
|
|
* tx outputs valid (type, key, amount),
|
|
|
|
* input and output total amounts don't overflow,
|
|
|
|
* output amount <= input amount,
|
|
|
|
* tx not too large,
|
|
|
|
* each input has a different key image.
|
|
|
|
*
|
|
|
|
* @param tx the transaction to check
|
|
|
|
* @param keeped_by_block if the transaction has been in a block
|
|
|
|
*
|
|
|
|
* @return true if all the checks pass, otherwise false
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool check_tx_semantic(const transaction& tx, bool keeped_by_block) const;
|
2014-03-03 23:07:58 +01:00
|
|
|
|
2017-07-10 16:38:56 +02:00
|
|
|
bool handle_incoming_tx_pre(const blobdata& tx_blob, tx_verification_context& tvc, cryptonote::transaction &tx, crypto::hash &tx_hash, crypto::hash &tx_prefixt_hash, bool keeped_by_block, bool relayed, bool do_not_relay);
|
|
|
|
bool handle_incoming_tx_post(const blobdata& tx_blob, tx_verification_context& tvc, cryptonote::transaction &tx, crypto::hash &tx_hash, crypto::hash &tx_prefixt_hash, bool keeped_by_block, bool relayed, bool do_not_relay);
|
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @copydoc miner::on_block_chain_update
|
|
|
|
*
|
|
|
|
* @note see miner::on_block_chain_update
|
|
|
|
*
|
|
|
|
* @return true
|
|
|
|
*/
|
2014-03-03 23:07:58 +01:00
|
|
|
bool update_miner_block_template();
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief act on a set of command line options given
|
|
|
|
*
|
|
|
|
* @param vm the command line options
|
|
|
|
*
|
|
|
|
* @return true
|
|
|
|
*/
|
2015-01-29 23:10:53 +01:00
|
|
|
bool handle_command_line(const boost::program_options::variables_map& vm);
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief verify that each input key image in a transaction is unique
|
|
|
|
*
|
|
|
|
* @param tx the transaction to check
|
|
|
|
*
|
|
|
|
* @return false if any key image is repeated, otherwise true
|
|
|
|
*/
|
2015-09-19 12:25:57 +02:00
|
|
|
bool check_tx_inputs_keyimages_diff(const transaction& tx) const;
|
2016-03-25 07:22:06 +01:00
|
|
|
|
2017-07-18 23:38:26 +02:00
|
|
|
/**
|
|
|
|
* @brief verify that each ring uses distinct members
|
|
|
|
*
|
|
|
|
* @param tx the transaction to check
|
|
|
|
*
|
|
|
|
* @return false if any ring uses duplicate members, true otherwise
|
|
|
|
*/
|
|
|
|
bool check_tx_inputs_ring_members_diff(const transaction& tx) const;
|
|
|
|
|
2017-02-20 18:41:39 +01:00
|
|
|
/**
|
|
|
|
* @brief verify that each input key image in a transaction is in
|
|
|
|
* the valid domain
|
|
|
|
*
|
|
|
|
* @param tx the transaction to check
|
|
|
|
*
|
|
|
|
* @return false if any key image is not in the valid domain, otherwise true
|
|
|
|
*/
|
|
|
|
bool check_tx_inputs_keyimages_domain(const transaction& tx) const;
|
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
/**
|
|
|
|
* @brief checks HardFork status and prints messages about it
|
|
|
|
*
|
|
|
|
* Checks the status of HardFork and logs/prints if an update to
|
|
|
|
* the daemon is necessary.
|
|
|
|
*
|
|
|
|
* @note see Blockchain::get_hard_fork_state and HardFork::State
|
|
|
|
*
|
|
|
|
* @return true
|
|
|
|
*/
|
2015-09-13 19:09:57 +02:00
|
|
|
bool check_fork_time();
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief attempts to relay any transactions in the mempool which need it
|
|
|
|
*
|
|
|
|
* @return true
|
|
|
|
*/
|
2015-11-21 01:26:48 +01:00
|
|
|
bool relay_txpool_transactions();
|
2016-03-25 07:22:06 +01:00
|
|
|
|
2017-02-18 17:30:29 +01:00
|
|
|
/**
|
|
|
|
* @brief checks DNS versions
|
|
|
|
*
|
|
|
|
* @return true on success, false otherwise
|
|
|
|
*/
|
|
|
|
bool check_updates();
|
|
|
|
|
2017-11-12 00:25:12 +01:00
|
|
|
/**
|
|
|
|
* @brief checks free disk space
|
|
|
|
*
|
|
|
|
* @return true on success, false otherwise
|
|
|
|
*/
|
|
|
|
bool check_disk_space();
|
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
bool m_test_drop_download = true; //!< whether or not to drop incoming blocks (for testing)
|
2014-03-03 23:07:58 +01:00
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
uint64_t m_test_drop_download_height = 0; //!< height under which to drop incoming blocks, if doing so
|
|
|
|
|
|
|
|
tx_memory_pool m_mempool; //!< transaction pool instance
|
|
|
|
Blockchain m_blockchain_storage; //!< Blockchain instance
|
|
|
|
|
|
|
|
i_cryptonote_protocol* m_pprotocol; //!< cryptonote protocol instance
|
|
|
|
|
|
|
|
epee::critical_section m_incoming_tx_lock; //!< incoming transaction lock
|
|
|
|
|
2014-03-03 23:07:58 +01:00
|
|
|
//m_miner and m_miner_addres are probably temporary here
|
2016-03-25 07:22:06 +01:00
|
|
|
miner m_miner; //!< miner instance
|
|
|
|
account_public_address m_miner_address; //!< address to mine to (for miner instance)
|
|
|
|
|
|
|
|
std::string m_config_folder; //!< folder to look in for configs and other files
|
|
|
|
|
|
|
|
cryptonote_protocol_stub m_protocol_stub; //!< cryptonote protocol stub instance
|
|
|
|
|
|
|
|
epee::math_helper::once_a_time_seconds<60*60*12, false> m_store_blockchain_interval; //!< interval for manual storing of Blockchain, if enabled
|
2017-02-17 00:46:42 +01:00
|
|
|
epee::math_helper::once_a_time_seconds<60*60*2, true> m_fork_moaner; //!< interval for checking HardFork status
|
2015-11-21 01:26:48 +01:00
|
|
|
epee::math_helper::once_a_time_seconds<60*2, false> m_txpool_auto_relayer; //!< interval for checking re-relaying txpool transactions
|
2017-02-18 17:30:29 +01:00
|
|
|
epee::math_helper::once_a_time_seconds<60*60*12, true> m_check_updates_interval; //!< interval for checking for new versions
|
2017-11-12 00:25:12 +01:00
|
|
|
epee::math_helper::once_a_time_seconds<60*10, true> m_check_disk_space_interval; //!< interval for checking for disk space
|
2016-03-25 07:22:06 +01:00
|
|
|
|
|
|
|
std::atomic<bool> m_starter_message_showed; //!< has the "daemon will sync now" message been shown?
|
|
|
|
|
|
|
|
uint64_t m_target_blockchain_height; //!< blockchain height target
|
|
|
|
|
2018-02-16 12:04:04 +01:00
|
|
|
network_type m_nettype; //!< which network are we on?
|
2014-09-25 07:15:28 +02:00
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
std::string m_checkpoints_path; //!< path to json checkpoints file
|
|
|
|
time_t m_last_dns_checkpoints_update; //!< time when dns checkpoints were last updated
|
|
|
|
time_t m_last_json_checkpoints_update; //!< time when json checkpoints were last updated
|
2015-04-22 10:36:39 +02:00
|
|
|
|
2016-03-25 07:22:06 +01:00
|
|
|
std::atomic_flag m_checkpoints_updating; //!< set if checkpoints are currently updating to avoid multiple threads attempting to update at once
|
2017-07-26 11:18:44 +02:00
|
|
|
bool m_disable_dns_checkpoints;
|
2016-01-31 13:58:08 +01:00
|
|
|
|
2016-09-24 18:00:19 +02:00
|
|
|
size_t block_sync_size;
|
2017-01-09 00:50:29 +01:00
|
|
|
|
|
|
|
time_t start_time;
|
2017-01-22 17:13:31 +01:00
|
|
|
|
2017-02-23 21:15:52 +01:00
|
|
|
std::unordered_set<crypto::hash> bad_semantics_txes[2];
|
2017-07-10 16:38:56 +02:00
|
|
|
boost::mutex bad_semantics_txes_lock;
|
|
|
|
|
2017-09-14 05:39:37 +02:00
|
|
|
tools::threadpool& m_threadpool;
|
2017-02-18 17:30:29 +01:00
|
|
|
|
|
|
|
enum {
|
|
|
|
UPDATES_DISABLED,
|
|
|
|
UPDATES_NOTIFY,
|
|
|
|
UPDATES_DOWNLOAD,
|
|
|
|
UPDATES_UPDATE,
|
|
|
|
} check_updates_level;
|
2017-02-26 22:00:38 +01:00
|
|
|
|
|
|
|
tools::download_async_handle m_update_download;
|
|
|
|
size_t m_last_update_length;
|
|
|
|
boost::mutex m_update_mutex;
|
2017-09-02 18:11:20 +02:00
|
|
|
|
|
|
|
bool m_fluffy_blocks_enabled;
|
2017-11-30 16:35:52 +01:00
|
|
|
bool m_offline;
|
2014-03-03 23:07:58 +01:00
|
|
|
};
|
|
|
|
}
|
|
|
|
|
|
|
|
POP_WARNINGS
|