mirror of
https://github.com/bitcoin/bitcoin.git
synced 2025-01-11 04:12:36 -03:00
Merge bitcoin/bitcoin#25680: rpc, docs: Add note for commands that supports only legacy wallets
9141e4395a
rpc, docs: Add note for commands that supports only legacy wallets (Yusuf Sahin HAMZA) Pull request description: Refs #25363, apparently issue is not updated since over a month, so i decided to put the same `importaddress` note in #25368 to other rpc commands that needs this note. Note is added for following commands: - `importprivkey` - `importpubkey` - `importwallet` - `dumpprivkey` - `dumpwallet` - `importmulti` - `addmultisigaddress` - `sethdseed` ACKs for top commit: achow101: ACK9141e4395a
Tree-SHA512: f3dc05d26577fd8dbe2bd69cb5c14ffccebacd6010402af44427b3d01be8484895dfcf33d55dfa766eadb7f9f3bae5cc4c2add3ac816a2ac60e8beb5a97527f3
This commit is contained in:
commit
071308860a
3 changed files with 17 additions and 10 deletions
|
@ -218,7 +218,8 @@ RPCHelpMan addmultisigaddress()
|
|||
"Each key is a Bitcoin address or hex-encoded public key.\n"
|
||||
"This functionality is only intended for use with non-watchonly addresses.\n"
|
||||
"See `importaddress` for watchonly p2sh address support.\n"
|
||||
"If 'label' is specified, assign address to that label.\n",
|
||||
"If 'label' is specified, assign address to that label.\n"
|
||||
"Note: This command is only compatible with legacy wallets.\n",
|
||||
{
|
||||
{"nrequired", RPCArg::Type::NUM, RPCArg::Optional::NO, "The number of required signatures out of the n keys or addresses."},
|
||||
{"keys", RPCArg::Type::ARR, RPCArg::Optional::NO, "The bitcoin addresses or hex-encoded public keys",
|
||||
|
|
|
@ -119,7 +119,8 @@ RPCHelpMan importprivkey()
|
|||
"may report that the imported key exists but related transactions are still missing, leading to temporarily incorrect/bogus balances and unspent outputs until rescan completes.\n"
|
||||
"The rescan parameter can be set to false if the key was never used to create transactions. If it is set to false,\n"
|
||||
"but the key was used to create transactions, rescanblockchain needs to be called with the appropriate block range.\n"
|
||||
"Note: Use \"getwalletinfo\" to query the scanning progress.\n",
|
||||
"Note: Use \"getwalletinfo\" to query the scanning progress.\n"
|
||||
"Note: This command is only compatible with legacy wallets. Use \"importdescriptors\" with \"combo(X)\" for descriptor wallets.\n",
|
||||
{
|
||||
{"privkey", RPCArg::Type::STR, RPCArg::Optional::NO, "The private key (see dumpprivkey)"},
|
||||
{"label", RPCArg::Type::STR, RPCArg::DefaultHint{"current label if address exists, otherwise \"\""}, "An optional label"},
|
||||
|
@ -225,7 +226,7 @@ RPCHelpMan importaddress()
|
|||
"\nNote: If you import a non-standard raw script in hex form, outputs sending to it will be treated\n"
|
||||
"as change, and not show up in many RPCs.\n"
|
||||
"Note: Use \"getwalletinfo\" to query the scanning progress.\n"
|
||||
"Note: This command is only compatible with legacy wallets. Use \"importdescriptors\" with \"addr(X)\" for descriptor wallets.\n",
|
||||
"Note: This command is only compatible with legacy wallets. Use \"importdescriptors\" for descriptor wallets.\n",
|
||||
{
|
||||
{"address", RPCArg::Type::STR, RPCArg::Optional::NO, "The Bitcoin address (or hex-encoded script)"},
|
||||
{"label", RPCArg::Type::STR, RPCArg::Default{""}, "An optional label"},
|
||||
|
@ -417,7 +418,8 @@ RPCHelpMan importpubkey()
|
|||
"may report that the imported pubkey exists but related transactions are still missing, leading to temporarily incorrect/bogus balances and unspent outputs until rescan completes.\n"
|
||||
"The rescan parameter can be set to false if the key was never used to create transactions. If it is set to false,\n"
|
||||
"but the key was used to create transactions, rescanblockchain needs to be called with the appropriate block range.\n"
|
||||
"Note: Use \"getwalletinfo\" to query the scanning progress.\n",
|
||||
"Note: Use \"getwalletinfo\" to query the scanning progress.\n"
|
||||
"Note: This command is only compatible with legacy wallets. Use \"importdescriptors\" with \"combo(X)\" for descriptor wallets.\n",
|
||||
{
|
||||
{"pubkey", RPCArg::Type::STR, RPCArg::Optional::NO, "The hex-encoded public key"},
|
||||
{"label", RPCArg::Type::STR, RPCArg::Default{""}, "An optional label"},
|
||||
|
@ -495,7 +497,8 @@ RPCHelpMan importwallet()
|
|||
{
|
||||
return RPCHelpMan{"importwallet",
|
||||
"\nImports keys from a wallet dump file (see dumpwallet). Requires a new wallet backup to include imported keys.\n"
|
||||
"Note: Blockchain and Mempool will be rescanned after a successful import. Use \"getwalletinfo\" to query the scanning progress.\n",
|
||||
"Note: Blockchain and Mempool will be rescanned after a successful import. Use \"getwalletinfo\" to query the scanning progress.\n"
|
||||
"Note: This command is only compatible with legacy wallets.\n",
|
||||
{
|
||||
{"filename", RPCArg::Type::STR, RPCArg::Optional::NO, "The wallet file"},
|
||||
},
|
||||
|
@ -642,7 +645,8 @@ RPCHelpMan dumpprivkey()
|
|||
{
|
||||
return RPCHelpMan{"dumpprivkey",
|
||||
"\nReveals the private key corresponding to 'address'.\n"
|
||||
"Then the importprivkey can be used with this output\n",
|
||||
"Then the importprivkey can be used with this output\n"
|
||||
"Note: This command is only compatible with legacy wallets.\n",
|
||||
{
|
||||
{"address", RPCArg::Type::STR, RPCArg::Optional::NO, "The bitcoin address for the private key"},
|
||||
},
|
||||
|
@ -690,7 +694,8 @@ RPCHelpMan dumpwallet()
|
|||
"\nDumps all wallet keys in a human-readable format to a server-side file. This does not allow overwriting existing files.\n"
|
||||
"Imported scripts are included in the dumpfile, but corresponding BIP173 addresses, etc. may not be added automatically by importwallet.\n"
|
||||
"Note that if your wallet contains keys which are not derived from your HD seed (e.g. imported keys), these are not covered by\n"
|
||||
"only backing up the seed itself, and must be backed up too (e.g. ensure you back up the whole dumpfile).\n",
|
||||
"only backing up the seed itself, and must be backed up too (e.g. ensure you back up the whole dumpfile).\n"
|
||||
"Note: This command is only compatible with legacy wallets.\n",
|
||||
{
|
||||
{"filename", RPCArg::Type::STR, RPCArg::Optional::NO, "The filename with path (absolute path recommended)"},
|
||||
},
|
||||
|
@ -1253,7 +1258,8 @@ RPCHelpMan importmulti()
|
|||
"may report that the imported keys, addresses or scripts exist but related transactions are still missing.\n"
|
||||
"The rescan parameter can be set to false if the key was never used to create transactions. If it is set to false,\n"
|
||||
"but the key was used to create transactions, rescanblockchain needs to be called with the appropriate block range.\n"
|
||||
"Note: Use \"getwalletinfo\" to query the scanning progress.\n",
|
||||
"Note: Use \"getwalletinfo\" to query the scanning progress.\n"
|
||||
"Note: This command is only compatible with legacy wallets. Use \"importdescriptors\" for descriptor wallets.\n",
|
||||
{
|
||||
{"requests", RPCArg::Type::ARR, RPCArg::Optional::NO, "Data to be imported",
|
||||
{
|
||||
|
|
|
@ -504,8 +504,8 @@ static RPCHelpMan sethdseed()
|
|||
return RPCHelpMan{"sethdseed",
|
||||
"\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"
|
||||
"HD will have a new HD seed set so that new keys added to the keypool will be derived from this new seed.\n"
|
||||
"\nNote that you will need to MAKE A NEW BACKUP of your wallet after setting the HD wallet seed." +
|
||||
HELP_REQUIRING_PASSPHRASE,
|
||||
"\nNote that you will need to MAKE A NEW BACKUP of your wallet after setting the HD wallet seed." + HELP_REQUIRING_PASSPHRASE +
|
||||
"Note: This command is only compatible with legacy wallets.\n",
|
||||
{
|
||||
{"newkeypool", RPCArg::Type::BOOL, RPCArg::Default{true}, "Whether to flush old unused addresses, including change addresses, from the keypool and regenerate it.\n"
|
||||
"If true, the next address from getnewaddress and change address from getrawchangeaddress will be from this new seed.\n"
|
||||
|
|
Loading…
Reference in a new issue