LCOV - code coverage report
Current view: top level - src - bitcoin-util.cpp (source / functions) Coverage Total Hit
Test: total_coverage.info Lines: 71.8 % 103 74
Test Date: 2025-01-19 05:08:01 Functions: 100.0 % 5 5
Branches: 39.9 % 138 55

             Branch data     Line data    Source code
       1                 :             : // Copyright (c) 2009-2022 The Bitcoin Core developers
       2                 :             : // Distributed under the MIT software license, see the accompanying
       3                 :             : // file COPYING or http://www.opensource.org/licenses/mit-license.php.
       4                 :             : 
       5                 :             : #include <bitcoin-build-config.h> // IWYU pragma: keep
       6                 :             : 
       7                 :             : #include <arith_uint256.h>
       8                 :             : #include <chain.h>
       9                 :             : #include <chainparams.h>
      10                 :             : #include <chainparamsbase.h>
      11                 :             : #include <clientversion.h>
      12                 :             : #include <common/args.h>
      13                 :             : #include <common/system.h>
      14                 :             : #include <compat/compat.h>
      15                 :             : #include <core_io.h>
      16                 :             : #include <streams.h>
      17                 :             : #include <util/exception.h>
      18                 :             : #include <util/strencodings.h>
      19                 :             : #include <util/translation.h>
      20                 :             : 
      21                 :             : #include <atomic>
      22                 :             : #include <cstdio>
      23                 :             : #include <functional>
      24                 :             : #include <memory>
      25                 :             : #include <thread>
      26                 :             : 
      27                 :             : static const int CONTINUE_EXECUTION=-1;
      28                 :             : 
      29                 :             : const TranslateFn G_TRANSLATION_FUN{nullptr};
      30                 :             : 
      31                 :           6 : static void SetupBitcoinUtilArgs(ArgsManager &argsman)
      32                 :             : {
      33                 :           6 :     SetupHelpOptions(argsman);
      34                 :             : 
      35   [ +  -  +  - ]:          12 :     argsman.AddArg("-version", "Print version and exit", ArgsManager::ALLOW_ANY, OptionsCategory::OPTIONS);
      36                 :             : 
      37   [ +  -  +  - ]:          12 :     argsman.AddCommand("grind", "Perform proof of work on hex header string");
      38                 :             : 
      39                 :           6 :     SetupChainParamsBaseOptions(argsman);
      40                 :           6 : }
      41                 :             : 
      42                 :             : // This function returns either one of EXIT_ codes when it's expected to stop the process or
      43                 :             : // CONTINUE_EXECUTION when it's expected to continue further.
      44                 :           6 : static int AppInitUtil(ArgsManager& args, int argc, char* argv[])
      45                 :             : {
      46                 :           6 :     SetupBitcoinUtilArgs(args);
      47         [ +  - ]:           6 :     std::string error;
      48   [ +  -  +  + ]:           6 :     if (!args.ParseParameters(argc, argv, error)) {
      49         [ +  - ]:           2 :         tfm::format(std::cerr, "Error parsing command line arguments: %s\n", error);
      50                 :             :         return EXIT_FAILURE;
      51                 :             :     }
      52                 :             : 
      53   [ +  -  +  -  :           8 :     if (HelpRequested(args) || args.GetBoolArg("-version", false)) {
          +  -  +  -  +  
                -  -  + ]
      54                 :             :         // First part of help message is specific to this utility
      55   [ #  #  #  # ]:           0 :         std::string strUsage = CLIENT_NAME " bitcoin-util utility version " + FormatFullVersion() + "\n";
      56                 :             : 
      57   [ #  #  #  #  :           0 :         if (args.GetBoolArg("-version", false)) {
                   #  # ]
      58   [ #  #  #  # ]:           0 :             strUsage += FormatParagraph(LicenseInfo());
      59                 :             :         } else {
      60         [ #  # ]:           0 :             strUsage += "\n"
      61                 :             :                 "The bitcoin-util tool provides bitcoin related functionality that does not rely on the ability to access a running node. Available [commands] are listed below.\n"
      62                 :             :                 "\n"
      63                 :             :                 "Usage:  bitcoin-util [options] [command]\n"
      64                 :           0 :                 "or:     bitcoin-util [options] grind <hex-block-header>\n";
      65   [ #  #  #  # ]:           0 :             strUsage += "\n" + args.GetHelpMessage();
      66                 :             :         }
      67                 :             : 
      68         [ #  # ]:           0 :         tfm::format(std::cout, "%s", strUsage);
      69                 :             : 
      70         [ #  # ]:           0 :         if (argc < 2) {
      71         [ #  # ]:           0 :             tfm::format(std::cerr, "Error: too few parameters\n");
      72                 :             :             return EXIT_FAILURE;
      73                 :             :         }
      74                 :             :         return EXIT_SUCCESS;
      75                 :           0 :     }
      76                 :             : 
      77                 :             :     // Check for chain settings (Params() calls are only valid after this clause)
      78                 :           4 :     try {
      79   [ +  -  +  - ]:           4 :         SelectParams(args.GetChainType());
      80         [ -  - ]:           0 :     } catch (const std::exception& e) {
      81         [ -  - ]:           0 :         tfm::format(std::cerr, "Error: %s\n", e.what());
      82                 :           0 :         return EXIT_FAILURE;
      83                 :           0 :     }
      84                 :             : 
      85                 :             :     return CONTINUE_EXECUTION;
      86                 :           6 : }
      87                 :             : 
      88                 :          16 : static void grind_task(uint32_t nBits, CBlockHeader header, uint32_t offset, uint32_t step, std::atomic<bool>& found, uint32_t& proposed_nonce)
      89                 :             : {
      90                 :          16 :     arith_uint256 target;
      91                 :          16 :     bool neg, over;
      92                 :          16 :     target.SetCompact(nBits, &neg, &over);
      93   [ +  -  +  -  :          16 :     if (target == 0 || neg || over) return;
                   +  - ]
      94                 :          16 :     header.nNonce = offset;
      95                 :             : 
      96                 :          16 :     uint32_t finish = std::numeric_limits<uint32_t>::max() - step;
      97                 :          16 :     finish = finish - (finish % step) + offset;
      98                 :             : 
      99   [ +  +  +  - ]:         596 :     while (!found && header.nNonce < finish) {
     100         [ +  - ]:         581 :         const uint32_t next = (finish - header.nNonce < 5000*step) ? finish : header.nNonce + 5000*step;
     101                 :     2904154 :         do {
     102         [ +  + ]:     2904154 :             if (UintToArith256(header.GetHash()) <= target) {
     103         [ +  - ]:           1 :                 if (!found.exchange(true)) {
     104                 :           1 :                     proposed_nonce = header.nNonce;
     105                 :             :                 }
     106                 :           1 :                 return;
     107                 :             :             }
     108                 :     2904153 :             header.nNonce += step;
     109         [ +  + ]:     2904153 :         } while(header.nNonce != next);
     110                 :             :     }
     111                 :             : }
     112                 :             : 
     113                 :           4 : static int Grind(const std::vector<std::string>& args, std::string& strPrint)
     114                 :             : {
     115         [ +  + ]:           4 :     if (args.size() != 1) {
     116                 :           2 :         strPrint = "Must specify block header to grind";
     117                 :           2 :         return EXIT_FAILURE;
     118                 :             :     }
     119                 :             : 
     120                 :           2 :     CBlockHeader header;
     121         [ +  + ]:           2 :     if (!DecodeHexBlockHeader(header, args[0])) {
     122                 :           1 :         strPrint = "Could not decode block header";
     123                 :           1 :         return EXIT_FAILURE;
     124                 :             :     }
     125                 :             : 
     126                 :           1 :     uint32_t nBits = header.nBits;
     127                 :           1 :     std::atomic<bool> found{false};
     128                 :           1 :     uint32_t proposed_nonce{};
     129                 :             : 
     130                 :           1 :     std::vector<std::thread> threads;
     131         [ -  + ]:           1 :     int n_tasks = std::max(1u, std::thread::hardware_concurrency());
     132         [ +  - ]:           1 :     threads.reserve(n_tasks);
     133         [ +  + ]:          17 :     for (int i = 0; i < n_tasks; ++i) {
     134         [ +  - ]:          16 :         threads.emplace_back(grind_task, nBits, header, i, n_tasks, std::ref(found), std::ref(proposed_nonce));
     135                 :             :     }
     136         [ +  + ]:          17 :     for (auto& t : threads) {
     137         [ +  - ]:          16 :         t.join();
     138                 :             :     }
     139         [ +  - ]:           1 :     if (found) {
     140                 :           1 :         header.nNonce = proposed_nonce;
     141                 :             :     } else {
     142         [ #  # ]:           0 :         strPrint = "Could not satisfy difficulty target";
     143                 :             :         return EXIT_FAILURE;
     144                 :             :     }
     145                 :             : 
     146                 :           1 :     DataStream ss{};
     147         [ +  - ]:           1 :     ss << header;
     148         [ +  - ]:           1 :     strPrint = HexStr(ss);
     149                 :           1 :     return EXIT_SUCCESS;
     150                 :           1 : }
     151                 :             : 
     152                 :           6 : MAIN_FUNCTION
     153                 :             : {
     154                 :           6 :     ArgsManager& args = gArgs;
     155                 :           6 :     SetupEnvironment();
     156                 :             : 
     157                 :           6 :     try {
     158         [ +  - ]:           6 :         int ret = AppInitUtil(args, argc, argv);
     159         [ +  + ]:           6 :         if (ret != CONTINUE_EXECUTION) {
     160                 :             :             return ret;
     161                 :             :         }
     162         [ -  - ]:           0 :     } catch (const std::exception& e) {
     163         [ -  - ]:           0 :         PrintExceptionContinue(&e, "AppInitUtil()");
     164                 :           0 :         return EXIT_FAILURE;
     165                 :           0 :     } catch (...) {
     166         [ -  - ]:           0 :         PrintExceptionContinue(nullptr, "AppInitUtil()");
     167                 :           0 :         return EXIT_FAILURE;
     168                 :           0 :     }
     169                 :             : 
     170                 :           4 :     const auto cmd = args.GetCommand();
     171         [ -  + ]:           4 :     if (!cmd) {
     172         [ #  # ]:           0 :         tfm::format(std::cerr, "Error: must specify a command\n");
     173                 :             :         return EXIT_FAILURE;
     174                 :             :     }
     175                 :             : 
     176                 :           4 :     int ret = EXIT_FAILURE;
     177         [ +  - ]:           4 :     std::string strPrint;
     178                 :           4 :     try {
     179         [ +  - ]:           4 :         if (cmd->command == "grind") {
     180         [ +  - ]:           4 :             ret = Grind(cmd->args, strPrint);
     181                 :             :         } else {
     182                 :           0 :             assert(false); // unknown command should be caught earlier
     183                 :             :         }
     184         [ -  - ]:           0 :     } catch (const std::exception& e) {
     185         [ -  - ]:           0 :         strPrint = std::string("error: ") + e.what();
     186                 :           0 :     } catch (...) {
     187         [ -  - ]:           0 :         strPrint = "unknown error";
     188         [ -  - ]:           0 :     }
     189                 :             : 
     190         [ +  - ]:           4 :     if (strPrint != "") {
     191   [ +  +  +  - ]:           7 :         tfm::format(ret == 0 ? std::cout : std::cerr, "%s\n", strPrint);
     192                 :             :     }
     193                 :             : 
     194                 :           4 :     return ret;
     195                 :           8 : }
        

Generated by: LCOV version 2.0-1