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