Electroneum
cryptonote_core.h
Go to the documentation of this file.
1 // Copyrights(c) 2017-2021, The Electroneum Project
2 // Copyrights(c) 2014-2019, The Monero Project
3 //
4 // All rights reserved.
5 //
6 // Redistribution and use in source and binary forms, with or without modification, are
7 // permitted provided that the following conditions are met:
8 //
9 // 1. Redistributions of source code must retain the above copyright notice, this list of
10 // conditions and the following disclaimer.
11 //
12 // 2. Redistributions in binary form must reproduce the above copyright notice, this list
13 // of conditions and the following disclaimer in the documentation and/or other
14 // materials provided with the distribution.
15 //
16 // 3. Neither the name of the copyright holder nor the names of its contributors may be
17 // used to endorse or promote products derived from this software without specific
18 // prior written permission.
19 //
20 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
21 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
22 // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
23 // THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
25 // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
27 // STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
28 // THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 //
30 // Parts of this file are originally copyright (c) 2012-2013 The Cryptonote developers
31 
32 #pragma once
33 
34 #include <ctime>
35 
36 #include <boost/program_options/options_description.hpp>
37 #include <boost/program_options/variables_map.hpp>
38 
41 #include "common/download.h"
42 #include "common/command_line.h"
43 #include "tx_pool.h"
44 #include "blockchain.h"
45 #include "cryptonote_basic/miner.h"
48 #include "warnings.h"
49 #include "crypto/hash.h"
51 
54 
55 namespace cryptonote
56 {
57  struct test_options {
58  const std::pair<uint8_t, uint64_t> *hard_forks;
60  };
61 
73 
74  /************************************************************************/
75  /* */
76  /************************************************************************/
77 
85  class core: public i_miner_handler
86  {
87  public:
88 
96  core(i_cryptonote_protocol* pprotocol);
97 
105 
113  bool on_idle();
114 
129  bool handle_incoming_tx(const blobdata& tx_blob, tx_verification_context& tvc, bool keeped_by_block, bool relayed, bool do_not_relay);
130 
145  bool handle_incoming_txs(const std::vector<blobdata>& tx_blobs, std::vector<tx_verification_context>& tvc, bool keeped_by_block, bool relayed, bool do_not_relay);
146 
162  bool handle_incoming_block(const blobdata& block_blob, const block *b, block_verification_context& bvc, bool update_miner_blocktemplate = true);
163 
169  bool prepare_handle_incoming_blocks(const std::vector<block_complete_entry> &blocks_entry, std::vector<block> &blocks);
170 
176  bool cleanup_handle_incoming_blocks(bool force_sync = false);
177 
185  bool check_incoming_block_size(const blobdata& block_blob) const;
186 
192  i_cryptonote_protocol* get_protocol(){return m_pprotocol;}
193 
194  //-------------------- i_miner_handler -----------------------
195 
208  virtual bool handle_block_found(block& b, block_verification_context &bvc);
209 
215  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);
216  virtual bool get_block_template(block& b, const crypto::hash *prev_block, const account_public_address& adr, difficulty_type& diffic, uint64_t& height, uint64_t& expected_reward, const blobdata& ex_nonce);
217 
221  virtual void on_transaction_relayed(const cryptonote::blobdata& tx);
222 
223 
229  miner& get_miner(){return m_miner;}
230 
236  const miner& get_miner()const{return m_miner;}
237 
246  static void init_options(boost::program_options::options_description& desc);
247 
260  bool init(const boost::program_options::variables_map& vm, const test_options *test_options = NULL, const GetCheckpointsCallback& get_checkpoints = nullptr);
261 
267  bool set_genesis_block(const block& b);
268 
276  bool deinit();
277 
281  void test_drop_download();
282 
288  void test_drop_download_height(uint64_t height);
289 
295  bool get_test_drop_download() const;
296 
305  bool get_test_drop_download_height() const;
306 
312  uint64_t get_current_blockchain_height() const;
313 
320  void get_blockchain_top(uint64_t& height, crypto::hash& top_id) const;
321 
327  bool get_blocks(uint64_t start_offset, size_t count, std::vector<std::pair<cryptonote::blobdata,block>>& blocks, std::vector<cryptonote::blobdata>& txs) const;
328 
334  bool get_blocks(uint64_t start_offset, size_t count, std::vector<std::pair<cryptonote::blobdata,block>>& blocks) const;
335 
341  bool get_blocks(uint64_t start_offset, size_t count, std::vector<block>& blocks) const;
342 
348  template<class t_ids_container, class t_blocks_container, class t_missed_container>
349  bool get_blocks(const t_ids_container& block_ids, t_blocks_container& blocks, t_missed_container& missed_bs) const
350  {
351  return m_blockchain_storage.get_blocks(block_ids, blocks, missed_bs);
352  }
353 
359  crypto::hash get_block_id_by_height(uint64_t height) const;
360 
366  bool get_transactions(const std::vector<crypto::hash>& txs_ids, std::vector<cryptonote::blobdata>& txs, std::vector<crypto::hash>& missed_txs) const;
367 
373  bool get_split_transactions_blobs(const std::vector<crypto::hash>& txs_ids, std::vector<std::tuple<crypto::hash, cryptonote::blobdata, crypto::hash, cryptonote::blobdata>>& txs, std::vector<crypto::hash>& missed_txs) const;
374 
380  bool get_transactions(const std::vector<crypto::hash>& txs_ids, std::vector<transaction>& txs, std::vector<crypto::hash>& missed_txs) const;
381 
387  bool get_block_by_hash(const crypto::hash &h, block &blk, bool *orphan = NULL) const;
388 
394  bool get_alternative_blocks(std::vector<block>& blocks) const;
395 
401  size_t get_alternative_blocks_count() const;
402 
408  void set_cryptonote_protocol(i_cryptonote_protocol* pprotocol);
409 
415  void set_checkpoints(checkpoints&& chk_pts);
416 
422  void set_checkpoints_file_path(const std::string& path);
423 
429  void set_enforce_dns_checkpoints(bool enforce_dns);
430 
436  void disable_dns_checkpoints(bool disable = true) { m_disable_dns_checkpoints = disable; }
437 
443  bool pool_has_tx(const crypto::hash &txid) const;
444 
451  bool get_pool_transactions(std::vector<transaction>& txs, bool include_unrelayed_txes = true) const;
452 
458  bool get_txpool_backlog(std::vector<tx_backlog_entry>& backlog) const;
459 
466  bool get_pool_transaction_hashes(std::vector<crypto::hash>& txs, bool include_unrelayed_txes = true) const;
467 
474  bool get_pool_transaction_stats(struct txpool_stats& stats, bool include_unrelayed_txes = true) const;
475 
481  bool get_pool_transaction(const crypto::hash& id, cryptonote::blobdata& tx) const;
482 
489  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;
490 
496  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;
497 
503  size_t get_pool_transactions_count() const;
504 
510  size_t get_blockchain_total_transactions() const;
511 
517  bool have_block(const crypto::hash& id) const;
518 
524  bool get_short_chain_history(std::list<crypto::hash>& ids) const;
525 
531  bool find_blockchain_supplement(const std::list<crypto::hash>& qblock_ids, NOTIFY_RESPONSE_CHAIN_ENTRY::request& resp) const;
532 
538  bool find_blockchain_supplement(const uint64_t req_start_block, const std::list<crypto::hash>& qblock_ids, std::vector<std::pair<std::pair<cryptonote::blobdata, crypto::hash>, std::vector<std::pair<crypto::hash, cryptonote::blobdata> > > >& blocks, uint64_t& total_height, uint64_t& start_height, bool pruned, bool get_miner_tx_hash, size_t max_count) const;
539 
547  bool get_stat_info(core_stat_info& st_inf) const;
548 
554  bool get_tx_outputs_gindexs(const crypto::hash& tx_id, std::vector<uint64_t>& indexs) const;
555  bool get_tx_outputs_gindexs(const crypto::hash& tx_id, size_t n_txes, std::vector<std::vector<uint64_t>>& indexs) const;
556 
562  crypto::hash get_tail_id() const;
563 
569  void set_block_cumulative_difficulty(uint64_t height, difficulty_type diff);
570 
576  difficulty_type get_block_cumulative_difficulty(uint64_t height) const;
577 
584 
590  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;
591 
597  void pause_mine();
598 
604  void resume_mine();
605 
611  Blockchain& get_blockchain_storage(){return m_blockchain_storage;}
612 
618  const Blockchain& get_blockchain_storage()const{return m_blockchain_storage;}
619 
625  std::string print_pool(bool short_format) const;
626 
632  void on_synchronized();
633 
639  void safesyncmode(const bool onoff);
640 
646  void set_target_blockchain_height(uint64_t target_blockchain_height);
647 
653  uint64_t get_target_blockchain_height() const;
654 
660  uint8_t get_ideal_hard_fork_version() const;
661 
667  uint8_t get_ideal_hard_fork_version(uint64_t height) const;
668 
674  uint8_t get_hard_fork_version(uint64_t height) const;
675 
681  uint64_t get_earliest_ideal_height_for_version(uint8_t version) const;
682 
687  std::time_t get_start_time() const;
688 
699  bool update_checkpoints();
700 
706  std::string get_validators_list();
707 
714  electroneum::basic::list_update_outcome set_validators_list(std::string v_list, bool isEmergencyUpdate);
715 
721  bool isValidatorsListValid();
722 
729  void graceful_exit();
730 
736  void stop();
737 
743  bool is_key_image_spent(const crypto::key_image& key_im) const;
744 
755  bool are_key_images_spent(const std::vector<crypto::key_image>& key_im, std::vector<bool> &spent) const;
756 
765  bool are_key_images_spent_in_pool(const std::vector<crypto::key_image>& key_im, std::vector<bool> &spent) const;
766 
772  size_t get_block_sync_size(uint64_t height) const;
773 
779  std::pair<uint64_t, uint64_t> get_coinbase_tx_sum(const uint64_t start_offset, const size_t count);
780 
786  network_type get_nettype() const { return m_nettype; };
787 
796  bool is_update_available() const { return m_update_available; }
797 
803  bool fluffy_blocks_enabled() const { return m_fluffy_blocks_enabled; }
804 
810  bool pad_transactions() const { return m_pad_transactions; }
811 
817  uint64_t get_free_space() const;
818 
824  bool offline() const { return m_offline; }
825 
831  uint32_t get_blockchain_pruning_seed() const;
832 
840  bool prune_blockchain(uint32_t pruning_seed = 0);
841 
847  bool update_blockchain_pruning();
848 
854  bool check_blockchain_pruning();
855 
863  bool set_validator_key(std::string key);
864 
865  std::vector<std::string> generate_ed25519_keypair();
866 
868 
870 
871  std::vector<address_outputs> get_address_batch_history(const address_parse_info &addr, const uint64_t &start_tx_id = 0, const uint64_t &batch_size = 100, bool desc = false);
872 
873  private:
874 
885  bool add_new_tx(transaction& tx, const crypto::hash& tx_hash, const cryptonote::blobdata &blob, size_t tx_weight, tx_verification_context& tvc, bool keeped_by_block, bool relayed, bool do_not_relay);
886 
902  bool add_new_tx(transaction& tx, tx_verification_context& tvc, bool keeped_by_block, bool relayed, bool do_not_relay);
903 
909  bool add_new_block(const block& b, block_verification_context& bvc);
910 
918  bool load_state_data();
919 
925  bool parse_tx_from_blob(transaction& tx, crypto::hash& tx_hash, const blobdata& blob) const;
926 
937  bool check_tx_syntax(const transaction& tx) const;
938 
955  bool check_tx_semantic(const transaction& tx, bool keeped_by_block) const;
956  void set_semantics_failed(const crypto::hash &tx_hash);
957 
958  bool handle_incoming_tx_pre(const blobdata& tx_blob, tx_verification_context& tvc, cryptonote::transaction &tx, crypto::hash &tx_hash, bool keeped_by_block, bool relayed, bool do_not_relay);
959  bool handle_incoming_tx_post(const blobdata& tx_blob, tx_verification_context& tvc, cryptonote::transaction &tx, crypto::hash &tx_hash, bool keeped_by_block, bool relayed, bool do_not_relay);
960  struct tx_verification_batch_info { const cryptonote::transaction *tx; crypto::hash tx_hash; tx_verification_context &tvc; bool &result; };
961  bool handle_incoming_tx_accumulated_batch(std::vector<tx_verification_batch_info> &tx_info, bool keeped_by_block);
962 
970  bool update_miner_block_template();
971 
979  bool handle_command_line(const boost::program_options::variables_map& vm);
980 
988  bool check_tx_inputs_keyimages_diff(const transaction& tx) const;
989 
990  bool check_tx_inputs_utxos_diff(const transaction& tx) const;
991 
999  bool check_tx_inputs_ring_members_diff(const transaction& tx) const;
1000 
1009  bool check_tx_inputs_keyimages_domain(const transaction& tx) const;
1010 
1021  bool check_fork_time();
1022 
1028  bool relay_txpool_transactions();
1029 
1035  bool check_updates();
1036 
1042  bool check_disk_space();
1043 
1049  bool check_block_rate();
1050 
1051  bool m_test_drop_download = true;
1052 
1053  uint64_t m_test_drop_download_height = 0;
1054 
1055  tx_memory_pool m_mempool;
1056  Blockchain m_blockchain_storage;
1057 
1058  i_cryptonote_protocol* m_pprotocol;
1059 
1060  epee::critical_section m_incoming_tx_lock;
1061 
1062  //m_miner and m_miner_addres are probably temporary here
1063  miner m_miner;
1064  account_public_address m_miner_address;
1065 
1066  std::string m_config_folder;
1067 
1068  cryptonote_protocol_stub m_protocol_stub;
1069 
1070  epee::math_helper::once_a_time_seconds<60*60*12, false> m_store_blockchain_interval;
1074  epee::math_helper::once_a_time_seconds<60*10, true> m_check_disk_space_interval;
1076  epee::math_helper::once_a_time_seconds<60*60*5, true> m_blockchain_pruning_interval;
1077  epee::math_helper::once_a_time_seconds<60*2, true> m_check_validators_interval;
1078 
1079  std::atomic<bool> m_starter_message_showed;
1080 
1081  uint64_t m_target_blockchain_height;
1082 
1083  network_type m_nettype;
1084 
1085  std::atomic<bool> m_update_available;
1086 
1087  std::string m_checkpoints_path;
1088  time_t m_last_dns_checkpoints_update;
1089  time_t m_last_json_checkpoints_update;
1090 
1091  std::atomic_flag m_checkpoints_updating;
1092  bool m_disable_dns_checkpoints;
1093 
1094  size_t block_sync_size;
1095 
1096  time_t start_time;
1097 
1098  std::unordered_set<crypto::hash> bad_semantics_txes[2];
1099  boost::mutex bad_semantics_txes_lock;
1100 
1101  //tools::thread_group m_threadpool;
1102 
1103  std::unique_ptr<electroneum::basic::Validators> m_validators;
1104 
1105  enum {
1106  UPDATES_DISABLED,
1107  UPDATES_NOTIFY,
1108  UPDATES_DOWNLOAD,
1109  UPDATES_UPDATE,
1110  } check_updates_level;
1111 
1112  tools::download_async_handle m_update_download;
1113  size_t m_last_update_length;
1114  boost::mutex m_update_mutex;
1115 
1116  bool m_fluffy_blocks_enabled;
1117  bool m_offline;
1118  bool m_pad_transactions;
1119 
1120  std::shared_ptr<tools::Notify> m_block_rate_notify;
1121 
1122  bool m_fallback_to_pow;
1123  std::string m_fallback_to_pow_checkpoint_hash;
1124  uint64_t m_fallback_to_pow_checkpoint_height;
1125  };
1126 }
1127 
uint64_t height
Definition: blockchain.cpp:91
uint64_t get_balance(const cryptonote::account_base &addr, const std::vector< cryptonote::block > &blockchain, const map_hash2tx_t &mtx)
Definition: chaingen.cpp:940
A container for blockchain checkpoints.
Definition: checkpoints.h:52
handles core cryptonote functionality
bool fluffy_blocks_enabled() const
get whether fluffy blocks are enabled
bool is_update_available() const
check whether an update is known to be available or not
Blockchain & get_blockchain_storage()
gets the Blockchain instance
const miner & get_miner() const
gets the miner instance (const)
bool offline() const
get whether the core is running offline
network_type get_nettype() const
get the network type we're on
i_cryptonote_protocol * get_protocol()
get the cryptonote protocol instance
void disable_dns_checkpoints(bool disable=true)
set whether or not to enable or disable DNS checkpoints
miner & get_miner()
gets the miner instance
bool get_blocks(const t_ids_container &block_ids, t_blocks_container &blocks, t_missed_container &missed_bs) const
gets blocks based on a list of block hashes
bool pad_transactions() const
get whether transaction relay should be padded
const Blockchain & get_blockchain_storage() const
gets the Blockchain instance (const)
PUSH_WARNINGS
Definition: hash-ops.h:54
const char * res
Definition: hmac_keccak.cpp:41
const char * key
Definition: hmac_keccak.cpp:39
POD_CLASS key_image
Definition: crypto.h:102
POD_CLASS hash
Definition: hash.h:50
std::string sign_message(const std::string &message, const std::string &privateKey)
Definition: crypto.h:374
std::unordered_map< crypto::key_image, std::vector< crypto::hash > > key_images_with_tx_hashes
Holds cryptonote related classes and helpers.
Definition: ban.cpp:40
const command_line::arg_descriptor< std::string, false, true, 2 > arg_data_dir
boost::multiprecision::uint128_t difficulty_type
Definition: difficulty.h:43
const command_line::arg_descriptor< bool > arg_regtest_on
const command_line::arg_descriptor< bool > arg_offline
const command_line::arg_descriptor< difficulty_type > arg_fixed_difficulty
const command_line::arg_descriptor< bool > arg_fallback_to_pow
const command_line::arg_descriptor< bool, false > arg_testnet_on
const command_line::arg_descriptor< std::string > arg_fallback_to_pow_checkpoint_hash
const command_line::arg_descriptor< bool, false > arg_stagenet_on
const command_line::arg_descriptor< uint64_t > arg_fallback_to_pow_checkpoint_height
std::string blobdata
Definition: blobdatatype.h:39
const command_line::arg_descriptor< bool > arg_skip_block_sig_verification
const command_line::arg_descriptor< size_t > arg_block_download_max_size
std::function< const epee::span< const unsigned char >cryptonote::network_type network)> GetCheckpointsCallback
Callback routine that returns checkpoints data for specific network type.
Definition: blockchain.h:92
void init_options(boost::program_options::options_description &hidden_options, boost::program_options::options_description &normal_options)
mdb_size_t count(MDB_cursor *cur)
version
Supported socks variants.
Definition: socks.h:58
std::unique_ptr< void, terminate > context
Unique ZMQ context handle, calls zmq_term on destruction.
Definition: zmq.h:98
::std::string string
Definition: gtest-port.h:1097
std::shared_ptr< download_thread_control > download_async_handle
Definition: download.h:36
bool check_updates(const std::string &software, const std::string &buildtag, std::string &version, std::string &hash)
Definition: updates.cpp:41
bool get_output_distribution(uint64_t amount, uint64_t from, uint64_t to, uint64_t &start_height, std::vector< uint64_t > &distribution, uint64_t &base)
unsigned int uint32_t
Definition: stdint.h:126
unsigned char uint8_t
Definition: stdint.h:124
unsigned __int64 uint64_t
Definition: stdint.h:136
const size_t long_term_block_weight_window
const std::pair< uint8_t, uint64_t > * hard_forks
DISABLE_VS_WARNINGS(4244 4345 4503) using namespace crypto
#define POP_WARNINGS
Definition: warnings.h:17