Bitcoin Core  22.99.0
P2P Digital Currency
wallettool.cpp
Go to the documentation of this file.
1 // Copyright (c) 2016-2020 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 <fs.h>
6 #include <util/system.h>
7 #include <util/translation.h>
8 #include <wallet/dump.h>
9 #include <wallet/salvage.h>
10 #include <wallet/wallet.h>
11 #include <wallet/walletutil.h>
12 
13 namespace WalletTool {
14 
15 // The standard wallet deleter function blocks on the validation interface
16 // queue, which doesn't exist for the bitcoin-wallet. Define our own
17 // deleter here.
19 {
20  wallet->WalletLogPrintf("Releasing wallet\n");
21  wallet->Close();
22  delete wallet;
23 }
24 
25 static void WalletCreate(CWallet* wallet_instance, uint64_t wallet_creation_flags)
26 {
27  LOCK(wallet_instance->cs_wallet);
28 
29  wallet_instance->SetMinVersion(FEATURE_HD_SPLIT);
30  wallet_instance->AddWalletFlags(wallet_creation_flags);
31 
32  if (!wallet_instance->IsWalletFlagSet(WALLET_FLAG_DESCRIPTORS)) {
33  auto spk_man = wallet_instance->GetOrCreateLegacyScriptPubKeyMan();
34  spk_man->SetupGeneration(false);
35  } else {
36  wallet_instance->SetupDescriptorScriptPubKeyMans();
37  }
38 
39  tfm::format(std::cout, "Topping up keypool...\n");
40  wallet_instance->TopUpKeyPool();
41 }
42 
43 static std::shared_ptr<CWallet> MakeWallet(const std::string& name, const fs::path& path, DatabaseOptions options)
44 {
45  DatabaseStatus status;
47  std::unique_ptr<WalletDatabase> database = MakeDatabase(path, options, status, error);
48  if (!database) {
49  tfm::format(std::cerr, "%s\n", error.original);
50  return nullptr;
51  }
52 
53  // dummy chain interface
54  std::shared_ptr<CWallet> wallet_instance{new CWallet(nullptr /* chain */, name, std::move(database)), WalletToolReleaseWallet};
55  DBErrors load_wallet_ret;
56  try {
57  load_wallet_ret = wallet_instance->LoadWallet();
58  } catch (const std::runtime_error&) {
59  tfm::format(std::cerr, "Error loading %s. Is wallet being used by another process?\n", name);
60  return nullptr;
61  }
62 
63  if (load_wallet_ret != DBErrors::LOAD_OK) {
64  wallet_instance = nullptr;
65  if (load_wallet_ret == DBErrors::CORRUPT) {
66  tfm::format(std::cerr, "Error loading %s: Wallet corrupted", name);
67  return nullptr;
68  } else if (load_wallet_ret == DBErrors::NONCRITICAL_ERROR) {
69  tfm::format(std::cerr, "Error reading %s! All keys read correctly, but transaction data"
70  " or address book entries might be missing or incorrect.",
71  name);
72  } else if (load_wallet_ret == DBErrors::TOO_NEW) {
73  tfm::format(std::cerr, "Error loading %s: Wallet requires newer version of %s",
75  return nullptr;
76  } else if (load_wallet_ret == DBErrors::NEED_REWRITE) {
77  tfm::format(std::cerr, "Wallet needed to be rewritten: restart %s to complete", PACKAGE_NAME);
78  return nullptr;
79  } else {
80  tfm::format(std::cerr, "Error loading %s", name);
81  return nullptr;
82  }
83  }
84 
85  if (options.require_create) WalletCreate(wallet_instance.get(), options.create_flags);
86 
87  return wallet_instance;
88 }
89 
90 static void WalletShowInfo(CWallet* wallet_instance)
91 {
92  LOCK(wallet_instance->cs_wallet);
93 
94  tfm::format(std::cout, "Wallet info\n===========\n");
95  tfm::format(std::cout, "Name: %s\n", wallet_instance->GetName());
96  tfm::format(std::cout, "Format: %s\n", wallet_instance->GetDatabase().Format());
97  tfm::format(std::cout, "Descriptors: %s\n", wallet_instance->IsWalletFlagSet(WALLET_FLAG_DESCRIPTORS) ? "yes" : "no");
98  tfm::format(std::cout, "Encrypted: %s\n", wallet_instance->IsCrypted() ? "yes" : "no");
99  tfm::format(std::cout, "HD (hd seed available): %s\n", wallet_instance->IsHDEnabled() ? "yes" : "no");
100  tfm::format(std::cout, "Keypool Size: %u\n", wallet_instance->GetKeyPoolSize());
101  tfm::format(std::cout, "Transactions: %zu\n", wallet_instance->mapWallet.size());
102  tfm::format(std::cout, "Address Book: %zu\n", wallet_instance->m_address_book.size());
103 }
104 
105 bool ExecuteWalletToolFunc(const ArgsManager& args, const std::string& command)
106 {
107  if (args.IsArgSet("-format") && command != "createfromdump") {
108  tfm::format(std::cerr, "The -format option can only be used with the \"createfromdump\" command.\n");
109  return false;
110  }
111  if (args.IsArgSet("-dumpfile") && command != "dump" && command != "createfromdump") {
112  tfm::format(std::cerr, "The -dumpfile option can only be used with the \"dump\" and \"createfromdump\" commands.\n");
113  return false;
114  }
115  if (args.IsArgSet("-descriptors") && command != "create") {
116  tfm::format(std::cerr, "The -descriptors option can only be used with the 'create' command.\n");
117  return false;
118  }
119  if (command == "create" && !args.IsArgSet("-wallet")) {
120  tfm::format(std::cerr, "Wallet name must be provided when creating a new wallet.\n");
121  return false;
122  }
123  const std::string name = args.GetArg("-wallet", "");
124  const fs::path path = fsbridge::AbsPathJoin(GetWalletDir(), name);
125 
126  if (command == "create") {
127  DatabaseOptions options;
128  options.require_create = true;
129  if (args.GetBoolArg("-descriptors", false)) {
132  }
133 
134  std::shared_ptr<CWallet> wallet_instance = MakeWallet(name, path, options);
135  if (wallet_instance) {
136  WalletShowInfo(wallet_instance.get());
137  wallet_instance->Close();
138  }
139  } else if (command == "info") {
140  DatabaseOptions options;
141  options.require_existing = true;
142  std::shared_ptr<CWallet> wallet_instance = MakeWallet(name, path, options);
143  if (!wallet_instance) return false;
144  WalletShowInfo(wallet_instance.get());
145  wallet_instance->Close();
146  } else if (command == "salvage") {
147 #ifdef USE_BDB
149  std::vector<bilingual_str> warnings;
150  bool ret = RecoverDatabaseFile(path, error, warnings);
151  if (!ret) {
152  for (const auto& warning : warnings) {
153  tfm::format(std::cerr, "%s\n", warning.original);
154  }
155  if (!error.empty()) {
156  tfm::format(std::cerr, "%s\n", error.original);
157  }
158  }
159  return ret;
160 #else
161  tfm::format(std::cerr, "Salvage command is not available as BDB support is not compiled");
162  return false;
163 #endif
164  } else if (command == "dump") {
165  DatabaseOptions options;
166  options.require_existing = true;
167  std::shared_ptr<CWallet> wallet_instance = MakeWallet(name, path, options);
168  if (!wallet_instance) return false;
170  bool ret = DumpWallet(*wallet_instance, error);
171  if (!ret && !error.empty()) {
172  tfm::format(std::cerr, "%s\n", error.original);
173  return ret;
174  }
175  tfm::format(std::cout, "The dumpfile may contain private keys. To ensure the safety of your Bitcoin, do not share the dumpfile.\n");
176  return ret;
177  } else if (command == "createfromdump") {
179  std::vector<bilingual_str> warnings;
180  bool ret = CreateFromDump(name, path, error, warnings);
181  for (const auto& warning : warnings) {
182  tfm::format(std::cout, "%s\n", warning.original);
183  }
184  if (!ret && !error.empty()) {
185  tfm::format(std::cerr, "%s\n", error.original);
186  }
187  return ret;
188  } else {
189  tfm::format(std::cerr, "Invalid command: %s\n", command);
190  return false;
191  }
192 
193  return true;
194 }
195 } // namespace WalletTool
WalletTool::WalletShowInfo
static void WalletShowInfo(CWallet *wallet_instance)
Definition: wallettool.cpp:90
CWallet::GetKeyPoolSize
unsigned int GetKeyPoolSize() const EXCLUSIVE_LOCKS_REQUIRED(cs_wallet)
Definition: wallet.cpp:2119
DatabaseOptions::require_existing
bool require_existing
Definition: db.h:204
DatabaseOptions
Definition: db.h:203
ArgsManager::GetBoolArg
bool GetBoolArg(const std::string &strArg, bool fDefault) const
Return boolean argument or default value.
Definition: system.cpp:600
FEATURE_HD_SPLIT
@ FEATURE_HD_SPLIT
Definition: walletutil.h:23
DatabaseStatus
DatabaseStatus
Definition: db.h:212
tinyformat::format
void format(std::ostream &out, const char *fmt, const Args &... args)
Format list of arguments to the stream according to given format string.
Definition: tinyformat.h:1062
wallet.h
fs.h
DBErrors::NEED_REWRITE
@ NEED_REWRITE
CWallet::IsWalletFlagSet
bool IsWalletFlagSet(uint64_t flag) const override
check if a certain wallet flag is set
Definition: wallet.cpp:1420
bilingual_str
Bilingual messages:
Definition: translation.h:16
ArgsManager::IsArgSet
bool IsArgSet(const std::string &strArg) const
Return true if the given argument has been manually set.
Definition: system.cpp:492
CWallet::IsCrypted
bool IsCrypted() const
Definition: wallet.cpp:2955
DatabaseOptions::require_create
bool require_create
Definition: db.h:205
dump.h
WalletTool::WalletToolReleaseWallet
static void WalletToolReleaseWallet(CWallet *wallet)
Definition: wallettool.cpp:18
DBErrors::NONCRITICAL_ERROR
@ NONCRITICAL_ERROR
fsbridge::AbsPathJoin
fs::path AbsPathJoin(const fs::path &base, const fs::path &path)
Helper function for joining two paths.
Definition: fs.cpp:34
wallet
Definition: interfaces.cpp:50
WalletTool
Definition: wallettool.cpp:13
WalletTool::MakeWallet
static std::shared_ptr< CWallet > MakeWallet(const std::string &name, const fs::path &path, DatabaseOptions options)
Definition: wallettool.cpp:43
WalletTool::WalletCreate
static void WalletCreate(CWallet *wallet_instance, uint64_t wallet_creation_flags)
Definition: wallettool.cpp:25
salvage.h
walletutil.h
RecoverDatabaseFile
bool RecoverDatabaseFile(const fs::path &file_path, bilingual_str &error, std::vector< bilingual_str > &warnings)
Definition: salvage.cpp:25
PACKAGE_NAME
#define PACKAGE_NAME
Definition: bitcoin-config.h:362
LegacyScriptPubKeyMan::SetupGeneration
bool SetupGeneration(bool force=false) override
Sets up the key generation stuff, i.e.
Definition: scriptpubkeyman.cpp:424
CWallet::SetupDescriptorScriptPubKeyMans
void SetupDescriptorScriptPubKeyMans() EXCLUSIVE_LOCKS_REQUIRED(cs_wallet)
Create new DescriptorScriptPubKeyMans and add them to the wallet.
Definition: wallet.cpp:3138
ArgsManager::GetArg
std::string GetArg(const std::string &strArg, const std::string &strDefault) const
Return string argument or default value.
Definition: system.cpp:588
CWallet::SetMinVersion
void SetMinVersion(enum WalletFeature, WalletBatch *batch_in=nullptr) override
signify that a particular wallet feature is now used.
Definition: wallet.cpp:474
CWallet::IsHDEnabled
bool IsHDEnabled() const
Definition: wallet.cpp:1369
CWallet::GetDatabase
WalletDatabase & GetDatabase() const override
Definition: wallet.h:346
CWallet::GetName
const std::string & GetName() const
Get a name for this wallet for logging/debugging purposes.
Definition: wallet.h:354
DatabaseFormat::SQLITE
@ SQLITE
DBErrors::LOAD_OK
@ LOAD_OK
name
const char * name
Definition: rest.cpp:43
system.h
DBErrors
DBErrors
Error statuses for the wallet database.
Definition: walletdb.h:44
CWallet::TopUpKeyPool
bool TopUpKeyPool(unsigned int kpSize=0)
Definition: wallet.cpp:2130
ArgsManager
Definition: system.h:158
DumpWallet
bool DumpWallet(CWallet &wallet, bilingual_str &error)
Definition: dump.cpp:13
translation.h
CreateFromDump
bool CreateFromDump(const std::string &name, const fs::path &wallet_path, bilingual_str &error, std::vector< bilingual_str > &warnings)
Definition: dump.cpp:108
MakeDatabase
std::unique_ptr< WalletDatabase > MakeDatabase(const fs::path &path, const DatabaseOptions &options, DatabaseStatus &status, bilingual_str &error)
Definition: walletdb.cpp:1087
LOCK
#define LOCK(cs)
Definition: sync.h:226
WalletTool::ExecuteWalletToolFunc
bool ExecuteWalletToolFunc(const ArgsManager &args, const std::string &command)
Definition: wallettool.cpp:105
CWallet
A CWallet maintains a set of transactions and balances, and provides the ability to create new transa...
Definition: wallet.h:228
WalletDatabase::Format
virtual std::string Format()=0
DBErrors::CORRUPT
@ CORRUPT
CWallet::cs_wallet
RecursiveMutex cs_wallet
Main wallet lock.
Definition: wallet.h:344
CWallet::AddWalletFlags
bool AddWalletFlags(uint64_t flags)
overwrite all flags by the given uint64_t returns false if unknown, non-tolerable flags are present
Definition: wallet.cpp:1437
error
bool error(const char *fmt, const Args &... args)
Definition: system.h:49
GetWalletDir
fs::path GetWalletDir()
Get the path of the wallet directory.
Definition: walletutil.cpp:10
DatabaseOptions::require_format
std::optional< DatabaseFormat > require_format
Definition: db.h:206
CWallet::GetOrCreateLegacyScriptPubKeyMan
LegacyScriptPubKeyMan * GetOrCreateLegacyScriptPubKeyMan()
Definition: wallet.cpp:3089
DatabaseOptions::create_flags
uint64_t create_flags
Definition: db.h:207
WALLET_FLAG_DESCRIPTORS
@ WALLET_FLAG_DESCRIPTORS
Indicate that this wallet supports DescriptorScriptPubKeyMan.
Definition: walletutil.h:65
DBErrors::TOO_NEW
@ TOO_NEW