6 #if defined(HAVE_CONFIG_H)
31 "You need to rescan the blockchain in order to correctly mark used "
32 "destinations in the past. Until this is done, some destinations may "
33 "be considered unused, even if the opposite is the case."},
47 "Returns an object containing various wallet state info.\n",
61 {
RPCResult::Type::NUM,
"keypoolsize",
"how many new keys are pre-generated (only counts external keys)"},
62 {
RPCResult::Type::NUM,
"keypoolsize_hd_internal",
true,
"how many new keys are pre-generated for internal use (used for change outputs, only appears if the wallet is using this feature, otherwise external keys are used)"},
63 {
RPCResult::Type::NUM_TIME,
"unlocked_until",
true,
"the " +
UNIX_EPOCH_TIME +
" until which the wallet is unlocked for transfers, or 0 if the wallet is locked (only present for passphrase-encrypted wallets)"},
66 {
RPCResult::Type::BOOL,
"private_keys_enabled",
"false if privatekeys are disabled for this wallet (enforced watch-only wallet)"},
67 {
RPCResult::Type::BOOL,
"avoid_reuse",
"whether this wallet tracks clean/dirty coins in terms of reuse"},
68 {
RPCResult::Type::OBJ,
"scanning",
"current scanning details, or false if no scan is in progress",
73 {
RPCResult::Type::BOOL,
"descriptors",
"whether this wallet uses descriptors for scriptPubKey management"},
74 {
RPCResult::Type::BOOL,
"external_signer",
"whether this wallet is configured to use an external signer such as a hardware wallet"},
75 {
RPCResult::Type::BOOL,
"blank",
"Whether this wallet intentionally does not contain any keys, scripts, or descriptors"},
76 {
RPCResult::Type::NUM_TIME,
"birthtime",
true,
"The start time for blocks scanning. It could be modified by (re)importing any descriptor with an earlier timestamp."},
91 pwallet->BlockUntilSyncedToCurrentChain();
93 LOCK(pwallet->cs_wallet);
97 size_t kpExternalSize = pwallet->KeypoolCountExternalKeys();
99 obj.
pushKV(
"walletname", pwallet->GetName());
100 obj.
pushKV(
"walletversion", pwallet->GetVersion());
101 obj.
pushKV(
"format", pwallet->GetDatabase().Format());
105 obj.
pushKV(
"txcount", (
int)pwallet->mapWallet.size());
106 const auto kp_oldest = pwallet->GetOldestKeyPoolTime();
107 if (kp_oldest.has_value()) {
108 obj.
pushKV(
"keypoololdest", kp_oldest.value());
110 obj.
pushKV(
"keypoolsize", (int64_t)kpExternalSize);
121 obj.
pushKV(
"keypoolsize_hd_internal", (int64_t)(pwallet->GetKeyPoolSize() - kpExternalSize));
123 if (pwallet->IsCrypted()) {
124 obj.
pushKV(
"unlocked_until", pwallet->nRelockTime);
129 if (pwallet->IsScanning()) {
131 scanning.
pushKV(
"duration", Ticks<std::chrono::seconds>(pwallet->ScanningDuration()));
132 scanning.
pushKV(
"progress", pwallet->ScanningProgress());
133 obj.
pushKV(
"scanning", scanning);
135 obj.
pushKV(
"scanning",
false);
140 if (int64_t birthtime = pwallet->GetBirthTime(); birthtime !=
UNKNOWN_TIME) {
141 obj.
pushKV(
"birthtime", birthtime);
153 "Returns a list of wallets in the wallet directory.\n",
176 wallet.pushKV(
"name", path.utf8string());
181 result.
pushKV(
"wallets", wallets);
190 "Returns a list of currently loaded wallets.\n"
191 "For full information on the wallet, use \"getwalletinfo\"\n",
221 "\nLoads a wallet from a wallet file or directory."
222 "\nNote that all wallet command-line options used when starting bitcoind will be"
223 "\napplied to the new wallet.\n",
232 {
RPCResult::Type::ARR,
"warnings",
true,
"Warning messages, if any, related to loading the wallet.",
245 const std::string
name(request.params[0].get_str());
252 std::vector<bilingual_str> warnings;
253 std::optional<bool> load_on_start = request.params[1].isNull() ? std::nullopt : std::optional<bool>(request.params[1].get_bool());
257 if (std::any_of(context.wallets.begin(), context.wallets.end(), [&
name](
const auto&
wallet) { return wallet->GetName() == name; })) {
262 std::shared_ptr<CWallet>
const wallet =
LoadWallet(context,
name, load_on_start, options, status, error, warnings);
280 flags += (
flags ==
"" ?
"" :
", ") + it.first;
283 "\nChange the state of the given wallet flag for a wallet.\n",
305 std::string flag_str = request.params[0].get_str();
306 bool value = request.params[1].isNull() || request.params[1].get_bool();
320 if (pwallet->IsWalletFlagSet(flag) == value) {
324 res.pushKV(
"flag_name", flag_str);
325 res.pushKV(
"flag_state", value);
328 pwallet->SetWalletFlag(flag);
330 pwallet->UnsetWalletFlag(flag);
346 "\nCreates and loads a new wallet.\n",
352 {
"avoid_reuse",
RPCArg::Type::BOOL,
RPCArg::Default{
false},
"Keep track of coin reuse, and treat dirty and clean coins differently with privacy considerations in mind."},
353 {
"descriptors",
RPCArg::Type::BOOL,
RPCArg::Default{
true},
"Create a native descriptor wallet. The wallet will use descriptors internally to handle address creation."
354 " Setting to \"false\" will create a legacy wallet; This is only possible with the -deprecatedrpc=create_bdb setting because, the legacy wallet type is being deprecated and"
355 " support for creating and opening legacy wallets will be removed in the future."},
357 {
"external_signer",
RPCArg::Type::BOOL,
RPCArg::Default{
false},
"Use an external signer such as a hardware wallet. Requires -signer to be configured. Wallet creation will fail if keys cannot be fetched. Requires disable_private_keys and descriptors set to true."},
362 {
RPCResult::Type::STR,
"name",
"The wallet name if created successfully. If the wallet was created using a full path, the wallet_name will be the full path."},
363 {
RPCResult::Type::ARR,
"warnings",
true,
"Warning messages, if any, related to creating and loading the wallet.",
372 +
HelpExampleCliNamed(
"createwallet", {{
"wallet_name",
"descriptors"}, {
"avoid_reuse",
true}, {
"descriptors",
true}, {
"load_on_startup",
true}})
373 +
HelpExampleRpcNamed(
"createwallet", {{
"wallet_name",
"descriptors"}, {
"avoid_reuse",
true}, {
"descriptors",
true}, {
"load_on_startup",
true}})
379 if (!request.params[1].isNull() && request.params[1].get_bool()) {
383 if (!request.params[2].isNull() && request.params[2].get_bool()) {
387 passphrase.reserve(100);
388 std::vector<bilingual_str> warnings;
389 if (!request.params[3].isNull()) {
390 passphrase = std::string_view{request.params[3].get_str()};
391 if (passphrase.empty()) {
393 warnings.emplace_back(
Untranslated(
"Empty string given as passphrase, wallet will not be encrypted."));
397 if (!request.params[4].isNull() && request.params[4].get_bool()) {
400 if (
self.Arg<bool>(5)) {
408 " In this release it can be re-enabled temporarily with the -deprecatedrpc=create_bdb setting.");
411 if (!request.params[7].isNull() && request.params[7].get_bool()) {
412 #ifdef ENABLE_EXTERNAL_SIGNER
432 std::optional<bool> load_on_start = request.params[6].isNull() ? std::nullopt : std::optional<bool>(request.params[6].get_bool());
433 const std::shared_ptr<CWallet>
wallet =
CreateWallet(context, request.params[0].get_str(), load_on_start, options, status, error, warnings);
451 "Unloads the wallet referenced by the request endpoint, otherwise unloads the wallet specified in the argument.\n"
452 "Specifying the wallet name on a wallet endpoint is invalid.",
454 {
"wallet_name",
RPCArg::Type::STR,
RPCArg::DefaultHint{
"the wallet name from the RPC endpoint"},
"The name of the wallet to unload. If provided both here and in the RPC endpoint, the two must be identical."},
458 {
RPCResult::Type::ARR,
"warnings",
true,
"Warning messages, if any, related to unloading the wallet.",
469 std::string wallet_name;
471 if (!(request.params[0].isNull() || request.params[0].get_str() == wallet_name)) {
475 wallet_name = request.params[0].get_str();
484 std::vector<bilingual_str> warnings;
494 std::optional<bool> load_on_start{
self.MaybeArg<
bool>(1)};
513 "\nSet or generate a new HD wallet seed. Non-HD wallets will not be upgraded to being a HD wallet. Wallets that are already\n"
514 "HD will have a new HD seed set so that new keys added to the keypool will be derived from this new seed.\n"
515 "\nNote that you will need to MAKE A NEW BACKUP of your wallet after setting the HD wallet seed." +
HELP_REQUIRING_PASSPHRASE +
516 "Note: This command is only compatible with legacy wallets.\n",
518 {
"newkeypool",
RPCArg::Type::BOOL,
RPCArg::Default{
true},
"Whether to flush old unused addresses, including change addresses, from the keypool and regenerate it.\n"
519 "If true, the next address from getnewaddress and change address from getrawchangeaddress will be from this new seed.\n"
520 "If false, addresses (including change addresses if the wallet already had HD Chain Split enabled) from the existing\n"
521 "keypool will be used until it has been depleted."},
523 "The seed value can be retrieved using the dumpwallet command. It is the private key marked hdseed=1"},
546 if (!pwallet->CanSupportFeature(
FEATURE_HD)) {
547 throw JSONRPCError(
RPC_WALLET_ERROR,
"Cannot set an HD seed on a non-HD wallet. Use the upgradewallet RPC in order to upgrade a non-HD wallet to HD");
552 bool flush_key_pool =
true;
553 if (!request.params[0].isNull()) {
554 flush_key_pool = request.params[0].get_bool();
558 if (request.params[1].isNull()) {
584 "\nUpgrade the wallet. Upgrades to the latest version if no version number is specified.\n"
585 "New keys may be generated and a new wallet backup will need to be made.",
611 if (!request.params[0].isNull()) {
612 version = request.params[0].getInt<
int>();
615 const int previous_version{pwallet->GetVersion()};
616 const bool wallet_upgraded{pwallet->UpgradeWallet(version, error)};
617 const int current_version{pwallet->GetVersion()};
620 if (wallet_upgraded) {
621 if (previous_version == current_version) {
622 result =
"Already at latest version. Wallet version unchanged.";
624 result =
strprintf(
"Wallet upgraded successfully from version %i to version %i.", previous_version, current_version);
629 obj.
pushKV(
"wallet_name", pwallet->GetName());
630 obj.
pushKV(
"previous_version", previous_version);
631 obj.
pushKV(
"current_version", current_version);
632 if (!result.empty()) {
633 obj.
pushKV(
"result", result);
646 "\nCalculate the balance change resulting in the signing and broadcasting of the given transaction(s).\n",
678 if (request.params[1].isObject()) {
679 UniValue options = request.params[1];
686 include_watchonly = options[
"include_watchonly"];
694 const auto& txs = request.params[0].get_array();
696 std::map<COutPoint, CAmount> new_utxos;
697 std::set<COutPoint> spent;
699 for (
size_t i = 0; i < txs.size(); ++i) {
701 if (!
DecodeHexTx(mtx, txs[i].get_str(),
true,
true)) {
706 std::map<COutPoint, Coin> coins;
710 wallet.chain().findCoins(coins);
714 for (
const auto& txin : mtx.
vin) {
715 const auto& outpoint = txin.
prevout;
716 if (spent.count(outpoint)) {
719 if (new_utxos.count(outpoint)) {
720 changes -= new_utxos.at(outpoint);
721 new_utxos.erase(outpoint);
723 if (coins.at(outpoint).IsSpent()) {
726 changes -=
wallet.GetDebit(txin, filter);
728 spent.insert(outpoint);
736 const auto& hash = mtx.
GetHash();
737 for (
size_t i = 0; i < mtx.
vout.size(); ++i) {
738 const auto& txout = mtx.
vout[i];
739 bool is_mine = 0 < (
wallet.IsMine(txout) & filter);
740 changes += new_utxos[
COutPoint(hash, i)] = is_mine ? txout.nValue : 0;
755 "\nMigrate the wallet to a descriptor wallet.\n"
756 "A new wallet backup will need to be made.\n"
757 "\nThe migration process will create a backup of the wallet before migrating. This backup\n"
758 "file will be named <wallet name>-<timestamp>.legacy.bak and can be found in the directory\n"
759 "for this wallet. In the event of an incorrect migration, the backup can be restored using restorewallet."
760 "\nEncrypted wallets must have the passphrase provided as an argument to this call.\n"
761 "\nThis RPC may take a long time to complete. Increasing the RPC client timeout is recommended.",
763 {
"wallet_name",
RPCArg::Type::STR,
RPCArg::DefaultHint{
"the wallet name from the RPC endpoint"},
"The name of the wallet to migrate. If provided both here and in the RPC endpoint, the two must be identical."},
770 {
RPCResult::Type::STR,
"watchonly_name",
true,
"The name of the migrated wallet containing the watchonly scripts"},
771 {
RPCResult::Type::STR,
"solvables_name",
true,
"The name of the migrated wallet containing solvable but not watched scripts"},
781 std::string wallet_name;
783 if (!(request.params[0].isNull() || request.params[0].get_str() == wallet_name)) {
787 if (request.params[0].isNull()) {
790 wallet_name = request.params[0].get_str();
794 wallet_pass.reserve(100);
795 if (!request.params[1].isNull()) {
796 wallet_pass = std::string_view{request.params[1].get_str()};
806 r.pushKV(
"wallet_name", res->wallet_name);
807 if (res->watchonly_wallet) {
808 r.pushKV(
"watchonly_name", res->watchonly_wallet->GetName());
810 if (res->solvables_wallet) {
811 r.pushKV(
"solvables_name", res->solvables_wallet->GetName());
813 r.pushKV(
"backup_path", res->backup_path.utf8string());
824 "\nList all BIP 32 HD keys in the wallet and which descriptors use them.\n",
841 {
RPCResult::Type::BOOL,
"active",
"Whether this descriptor is currently used to generate new addresses"},
863 const bool active_only{options.exists(
"active_only") ? options[
"active_only"].get_bool() :
false};
864 const bool priv{options.exists(
"private") ? options[
"private"].get_bool() :
false};
870 std::set<ScriptPubKeyMan*> spkms;
872 spkms =
wallet->GetActiveScriptPubKeyMans();
874 spkms =
wallet->GetAllScriptPubKeyMans();
877 std::map<CExtPubKey, std::set<std::tuple<std::string, bool, bool>>> wallet_xpubs;
878 std::map<CExtPubKey, CExtKey> wallet_xprvs;
879 for (
auto* spkm : spkms) {
882 LOCK(desc_spkm->cs_desc_man);
886 std::set<CPubKey> desc_pubkeys;
887 std::set<CExtPubKey> desc_xpubs;
888 w_desc.
descriptor->GetPubKeys(desc_pubkeys, desc_xpubs);
890 std::string desc_str;
891 bool ok = desc_spkm->GetDescriptorString(desc_str,
false);
893 wallet_xpubs[xpub].emplace(desc_str,
wallet->IsActiveScriptPubKeyMan(*spkm), desc_spkm->HasPrivKey(xpub.pubkey.GetID()));
894 if (std::optional<CKey> key = priv ? desc_spkm->GetKey(xpub.pubkey.GetID()) : std::nullopt) {
895 wallet_xprvs[xpub] =
CExtKey(xpub, *key);
901 for (
const auto& [xpub, descs] : wallet_xpubs) {
902 bool has_xprv =
false;
904 for (
const auto& [desc, active, has_priv] : descs) {
907 d.
pushKV(
"active", active);
908 has_xprv |= has_priv;
914 xpub_info.
pushKV(
"has_private", has_xprv);
918 xpub_info.
pushKV(
"descriptors", std::move(descriptors));
920 response.
push_back(std::move(xpub_info));
931 "Creates the wallet's descriptor for the given address type. "
932 "The address type must be one that the wallet does not already have a descriptor for."
937 {
"internal",
RPCArg::Type::BOOL,
RPCArg::DefaultHint{
"Both external and internal will be generated unless this parameter is specified"},
"Whether to only make one descriptor that is internal (if parameter is true) or external (if parameter is false)"},
938 {
"hdkey",
RPCArg::Type::STR,
RPCArg::DefaultHint{
"The HD key used by all other active descriptors"},
"The HD key that the wallet knows the private key of, listed using 'gethdkeys', to use for this descriptor's key"},
963 std::optional<OutputType> output_type =
ParseOutputType(request.params[0].get_str());
969 UniValue internal_only{options[
"internal"]};
972 std::vector<bool> internals;
973 if (internal_only.isNull()) {
975 internals.push_back(
true);
977 internals.push_back(internal_only.get_bool());
980 LOCK(pwallet->cs_wallet);
984 if (hdkey.isNull()) {
985 std::set<CExtPubKey> active_xpubs = pwallet->GetActiveHDPubKeys();
986 if (active_xpubs.size() != 1) {
989 xpub = *active_xpubs.begin();
997 std::optional<CKey> key = pwallet->GetKey(xpub.
pubkey.
GetID());
1001 CExtKey active_hdkey(xpub, *key);
1003 std::vector<std::reference_wrapper<DescriptorScriptPubKeyMan>> spkms;
1005 for (
bool internal : internals) {
1008 if (!pwallet->GetScriptPubKeyMan(w_id)) {
1009 spkms.emplace_back(pwallet->SetupDescriptorScriptPubKeyMan(batch, active_hdkey, *output_type,
internal));
1012 if (spkms.empty()) {
1018 for (
const auto& spkm : spkms) {
1019 std::string desc_str;
1020 bool ok = spkm.get().GetDescriptorString(desc_str,
false);
1022 descs.push_back(desc_str);
1025 out.pushKV(
"descs", std::move(descs));
1042 #ifdef ENABLE_EXTERNAL_SIGNER
1170 #ifdef ENABLE_EXTERNAL_SIGNER
int64_t CAmount
Amount in satoshis (Can be negative)
#define CHECK_NONFATAL(condition)
Identity function.
An encapsulated private key.
const std::byte * end() const
bool IsValid() const
Check whether this private key is valid.
bool IsCompressed() const
Check whether the public key corresponding to this private key is (to be) compressed.
CPubKey GetPubKey() const
Compute the public key from a private key.
void Set(const T pbegin, const T pend, bool fCompressedIn)
Initialize using begin and end iterators to byte data.
const std::byte * begin() const
A reference to a CKey: the Hash160 of its serialized public key.
An outpoint - a combination of a transaction hash and an index n into its vout.
An encapsulated public key.
CKeyID GetID() const
Get the KeyID of this public key (hash of its serialization)
An input of a transaction.
RecursiveMutex cs_KeyStore
An interface to be implemented by keystores that support signing.
A Span is an object that can refer to a contiguous sequence of objects.
void push_back(UniValue val)
void pushKV(std::string key, UniValue val)
constexpr bool IsNull() const
std::string GetHex() const
virtual bool rpcEnableDeprecated(const std::string &method)=0
Check if deprecated RPC is enabled.
CKeyID seed_id
seed hash160
A CWallet maintains a set of transactions and balances, and provides the ability to create new transa...
const CHDChain & GetHDChain() const
bool NewKeyPool()
Mark old keypool keys as used, and generate all new keys.
CPubKey GenerateNewSeed()
CPubKey DeriveNewSeed(const CKey &key)
void SetHDSeed(const CPubKey &key)
Access to the wallet database.
Descriptor with some wallet metadata.
std::shared_ptr< Descriptor > descriptor
RAII object to check and reserve a wallet rescan.
bool reserve(bool with_passphrase=false)
UniValue ValueFromAmount(const CAmount amount)
bool DecodeHexTx(CMutableTransaction &tx, const std::string &hex_tx, bool try_no_witness=false, bool try_witness=true)
const std::string CURRENCY_UNIT
std::string EncodeExtKey(const CExtKey &key)
CExtPubKey DecodeExtPubKey(const std::string &str)
CKey DecodeSecret(const std::string &str)
std::string EncodeExtPubKey(const CExtPubKey &key)
void ReadDatabaseArgs(const ArgsManager &args, DBOptions &options)
bilingual_str ErrorString(const Result< T > &result)
static RPCHelpMan sethdseed()
void UnloadWallet(std::shared_ptr< CWallet > &&wallet)
Explicitly unload and delete the wallet.
void AppendLastProcessedBlock(UniValue &entry, const CWallet &wallet) EXCLUSIVE_LOCKS_REQUIRED(wallet.cs_wallet)
void ReadDatabaseArgs(const ArgsManager &args, DatabaseOptions &options)
Balance GetBalance(const CWallet &wallet, const int min_depth, bool avoid_reuse)
std::shared_ptr< CWallet > LoadWallet(WalletContext &context, const std::string &name, std::optional< bool > load_on_start, const DatabaseOptions &options, DatabaseStatus &status, bilingual_str &error, std::vector< bilingual_str > &warnings)
static RPCHelpMan loadwallet()
std::shared_ptr< CWallet > GetWalletForJSONRPCRequest(const JSONRPCRequest &request)
Figures out what wallet, if any, to use for a JSONRPCRequest.
RPCHelpMan listreceivedbyaddress()
std::vector< std::shared_ptr< CWallet > > GetWallets(WalletContext &context)
RPCHelpMan keypoolrefill()
RPCHelpMan removeprunedfunds()
RPCHelpMan listlockunspent()
static const RPCResult RESULT_LAST_PROCESSED_BLOCK
RPCHelpMan importwallet()
bool GetWalletNameFromJSONRPCRequest(const JSONRPCRequest &request, std::string &wallet_name)
RPCHelpMan walletprocesspsbt()
void HandleWalletError(const std::shared_ptr< CWallet > wallet, DatabaseStatus &status, bilingual_str &error)
void EnsureWalletIsUnlocked(const CWallet &wallet)
static RPCHelpMan getwalletinfo()
RPCHelpMan backupwallet()
static RPCHelpMan listwalletdir()
RPCHelpMan walletpassphrase()
const std::string HELP_REQUIRING_PASSPHRASE
std::vector< fs::path > ListDatabases(const fs::path &wallet_dir)
Recursively list database paths in directory.
RPCHelpMan getreceivedbyaddress()
RPCHelpMan walletdisplayaddress()
RPCHelpMan importaddress()
RPCHelpMan importprunedfunds()
LegacyScriptPubKeyMan & EnsureLegacyScriptPubKeyMan(CWallet &wallet, bool also_create)
RPCHelpMan simulaterawtransaction()
static RPCHelpMan setwalletflag()
RPCHelpMan importprivkey()
RPCHelpMan walletcreatefundedpsbt()
bool RemoveWallet(WalletContext &context, const std::shared_ptr< CWallet > &wallet, std::optional< bool > load_on_start)
RPCHelpMan addmultisigaddress()
WalletContext & EnsureWalletContext(const std::any &context)
RPCHelpMan listaddressgroupings()
RPCHelpMan walletpassphrasechange()
std::underlying_type< isminetype >::type isminefilter
used for bitflags of isminetype
fs::path GetWalletDir()
Get the path of the wallet directory.
RPCHelpMan abandontransaction()
bool HaveKey(const SigningProvider &wallet, const CKey &key)
Checks if a CKey is in the given CWallet compressed or otherwise.
RPCHelpMan listdescriptors()
RPCHelpMan listtransactions()
RPCHelpMan signrawtransactionwithwallet()
util::Result< MigrationResult > MigrateLegacyToDescriptor(const std::string &wallet_name, const SecureString &passphrase, WalletContext &context)
Do all steps to migrate a legacy wallet to a descriptor wallet.
RPCHelpMan importpubkey()
static RPCHelpMan listwallets()
static RPCHelpMan upgradewallet()
static constexpr int64_t UNKNOWN_TIME
Constant representing an unknown spkm creation time.
static const std::map< std::string, WalletFlags > WALLET_FLAG_MAP
static RPCHelpMan unloadwallet()
RPCHelpMan listsinceblock()
RPCHelpMan restorewallet()
bool ParseIncludeWatchonly(const UniValue &include_watchonly, const CWallet &wallet)
Used by RPC commands that have an include_watchonly parameter.
RPCHelpMan getreceivedbylabel()
RPCHelpMan importdescriptors()
RPCHelpMan getrawchangeaddress()
static RPCHelpMan createwallet()
RPCHelpMan getaddressinfo()
RPCHelpMan encryptwallet()
RPCHelpMan gettransaction()
RPCHelpMan getaddressesbylabel()
RPCHelpMan fundrawtransaction()
static const std::map< uint64_t, std::string > WALLET_FLAG_CAVEATS
Span< const CRPCCommand > GetWalletRPCCommands()
std::shared_ptr< CWallet > CreateWallet(WalletContext &context, const std::string &name, std::optional< bool > load_on_start, DatabaseOptions &options, DatabaseStatus &status, bilingual_str &error, std::vector< bilingual_str > &warnings)
static RPCHelpMan migratewallet()
RPCHelpMan rescanblockchain()
@ WALLET_FLAG_EXTERNAL_SIGNER
Indicates that the wallet needs an external signer.
@ WALLET_FLAG_AVOID_REUSE
@ WALLET_FLAG_DESCRIPTORS
Indicate that this wallet supports DescriptorScriptPubKeyMan.
@ WALLET_FLAG_DISABLE_PRIVATE_KEYS
@ WALLET_FLAG_BLANK_WALLET
Flag set when a wallet contains no HD seed and no private keys, scripts, addresses,...
static constexpr uint64_t MUTABLE_WALLET_FLAGS
RPCHelpMan getnewaddress()
RPCHelpMan listreceivedbylabel()
std::shared_ptr< CWallet > GetWallet(WalletContext &context, const std::string &name)
RPCHelpMan getunconfirmedbalance()
RPCHelpMan sendtoaddress()
static RPCHelpMan createwalletdescriptor()
WalletDescriptor GenerateWalletDescriptor(const CExtPubKey &master_key, const OutputType &addr_type, bool internal)
std::shared_ptr< CWallet > wallet
std::optional< OutputType > ParseOutputType(const std::string &type)
UniValue JSONRPCError(int code, const std::string &message)
RPCErrorCode
Bitcoin RPC error codes.
@ RPC_MISC_ERROR
General application defined errors.
@ RPC_WALLET_ENCRYPTION_FAILED
Failed to encrypt the wallet.
@ RPC_INVALID_PARAMETER
Invalid, missing or duplicate parameter.
@ RPC_WALLET_ERROR
Wallet errors.
@ RPC_WALLET_ALREADY_LOADED
This same wallet is already loaded.
@ RPC_WALLET_NOT_FOUND
Invalid wallet specified.
@ RPC_DESERIALIZATION_ERROR
Error parsing or validating structure in raw format.
@ RPC_INVALID_ADDRESS_OR_KEY
Invalid address or key.
std::string HelpExampleCli(const std::string &methodname, const std::string &args)
std::string HelpExampleRpcNamed(const std::string &methodname, const RPCArgList &args)
void PushWarnings(const UniValue &warnings, UniValue &obj)
Push warning messages to an RPC "warnings" field as a JSON array of strings.
std::string HelpExampleRpc(const std::string &methodname, const std::string &args)
const std::string UNIX_EPOCH_TIME
String used to describe UNIX epoch time in documentation, factored out to a constant for consistency.
void RPCTypeCheckObj(const UniValue &o, const std::map< std::string, UniValueType > &typesExpected, bool fAllowNull, bool fStrict)
std::string HelpExampleCliNamed(const std::string &methodname, const RPCArgList &args)
uint256 DescriptorID(const Descriptor &desc)
Unique identifier that may not change over time, unless explicitly marked as not backwards compatible...
std::basic_string< char, std::char_traits< char >, secure_allocator< char > > SecureString
A mutable version of CTransaction.
std::vector< CTxOut > vout
Txid GetHash() const
Compute the hash of this CMutableTransaction.
@ STR_HEX
Special type that is a STR with only hex chars.
@ OBJ_NAMED_PARAMS
Special type that behaves almost exactly like OBJ, defining an options object with a list of pre-defi...
std::string DefaultHint
Hint for default value.
@ OMITTED
Optional argument for which the default value is omitted from help text for one of two reasons:
@ NUM_TIME
Special numeric to denote unix epoch time.
@ STR_HEX
Special string with only hex chars.
@ STR_AMOUNT
Special string to represent a floating point amount.
Wrapper for UniValue::VType, which includes typeAny: Used to denote don't care type.
SecureString create_passphrase
WalletContext struct containing references to state shared between CWallet instances,...
interfaces::Chain * chain
bilingual_str Untranslated(std::string original)
Mark a bilingual_str as untranslated.