Bitcoin Core  27.99.0
P2P Digital Currency
signmessage.cpp
Go to the documentation of this file.
1 // Copyright (c) 2011-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 <key_io.h>
6 #include <rpc/util.h>
7 #include <util/message.h>
8 #include <wallet/rpc/util.h>
9 #include <wallet/wallet.h>
10 
11 #include <univalue.h>
12 
13 namespace wallet {
15 {
16  return RPCHelpMan{"signmessage",
17  "\nSign a message with the private key of an address" +
19  {
20  {"address", RPCArg::Type::STR, RPCArg::Optional::NO, "The bitcoin address to use for the private key."},
21  {"message", RPCArg::Type::STR, RPCArg::Optional::NO, "The message to create a signature of."},
22  },
23  RPCResult{
24  RPCResult::Type::STR, "signature", "The signature of the message encoded in base 64"
25  },
27  "\nUnlock the wallet for 30 seconds\n"
28  + HelpExampleCli("walletpassphrase", "\"mypassphrase\" 30") +
29  "\nCreate the signature\n"
30  + HelpExampleCli("signmessage", "\"1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX\" \"my message\"") +
31  "\nVerify the signature\n"
32  + HelpExampleCli("verifymessage", "\"1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX\" \"signature\" \"my message\"") +
33  "\nAs a JSON-RPC call\n"
34  + HelpExampleRpc("signmessage", "\"1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX\", \"my message\"")
35  },
36  [&](const RPCHelpMan& self, const JSONRPCRequest& request) -> UniValue
37  {
38  const std::shared_ptr<const CWallet> pwallet = GetWalletForJSONRPCRequest(request);
39  if (!pwallet) return UniValue::VNULL;
40 
41  LOCK(pwallet->cs_wallet);
42 
43  EnsureWalletIsUnlocked(*pwallet);
44 
45  std::string strAddress = request.params[0].get_str();
46  std::string strMessage = request.params[1].get_str();
47 
48  CTxDestination dest = DecodeDestination(strAddress);
49  if (!IsValidDestination(dest)) {
50  throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, "Invalid address");
51  }
52 
53  const PKHash* pkhash = std::get_if<PKHash>(&dest);
54  if (!pkhash) {
55  throw JSONRPCError(RPC_TYPE_ERROR, "Address does not refer to key");
56  }
57 
58  std::string signature;
59  SigningResult err = pwallet->SignMessage(strMessage, *pkhash, signature);
60  if (err == SigningResult::SIGNING_FAILED) {
62  } else if (err != SigningResult::OK) {
64  }
65 
66  return signature;
67  },
68  };
69 }
70 } // namespace wallet
bool IsValidDestination(const CTxDestination &dest)
Check whether a CTxDestination corresponds to one with an address.
std::variant< CNoDestination, PubKeyDestination, PKHash, ScriptHash, WitnessV0ScriptHash, WitnessV0KeyHash, WitnessV1Taproot, WitnessUnknown > CTxDestination
A txout script categorized into standard templates.
Definition: addresstype.h:131
@ VNULL
Definition: univalue.h:24
CTxDestination DecodeDestination(const std::string &str, std::string &error_msg, std::vector< int > *error_locations)
Definition: key_io.cpp:292
SigningResult
Definition: message.h:43
@ OK
No error.
std::shared_ptr< CWallet > GetWalletForJSONRPCRequest(const JSONRPCRequest &request)
Figures out what wallet, if any, to use for a JSONRPCRequest.
Definition: util.cpp:72
void EnsureWalletIsUnlocked(const CWallet &wallet)
Definition: util.cpp:96
const std::string HELP_REQUIRING_PASSPHRASE
Definition: util.cpp:20
RPCHelpMan signmessage()
Definition: signmessage.cpp:14
UniValue JSONRPCError(int code, const std::string &message)
Definition: request.cpp:58
@ RPC_TYPE_ERROR
Unexpected type was passed as parameter.
Definition: protocol.h:40
@ RPC_WALLET_ERROR
Wallet errors.
Definition: protocol.h:71
@ RPC_INVALID_ADDRESS_OR_KEY
Invalid address or key.
Definition: protocol.h:41
std::string HelpExampleCli(const std::string &methodname, const std::string &args)
Definition: util.cpp:155
std::string HelpExampleRpc(const std::string &methodname, const std::string &args)
Definition: util.cpp:173
@ NO
Required arg.
#define LOCK(cs)
Definition: sync.h:257
std::string SigningResultString(const SigningResult res)
Definition: message.cpp:81