Bitcoin Core  22.99.0
P2P Digital Currency
external_signer.cpp
Go to the documentation of this file.
1 // Copyright (c) 2018-2021 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 <chainparams.h>
6 #include <core_io.h>
7 #include <psbt.h>
8 #include <util/strencodings.h>
9 #include <util/system.h>
10 #include <external_signer.h>
11 
12 #include <stdexcept>
13 #include <string>
14 #include <vector>
15 
16 ExternalSigner::ExternalSigner(const std::string& command, const std::string chain, const std::string& fingerprint, const std::string name): m_command(command), m_chain(chain), m_fingerprint(fingerprint), m_name(name) {}
17 
18 const std::string ExternalSigner::NetworkArg() const
19 {
20  return " --chain " + m_chain;
21 }
22 
23 bool ExternalSigner::Enumerate(const std::string& command, std::vector<ExternalSigner>& signers, const std::string chain)
24 {
25  // Call <command> enumerate
26  const UniValue result = RunCommandParseJSON(command + " enumerate");
27  if (!result.isArray()) {
28  throw std::runtime_error(strprintf("'%s' received invalid response, expected array of signers", command));
29  }
30  for (UniValue signer : result.getValues()) {
31  // Check for error
32  const UniValue& error = find_value(signer, "error");
33  if (!error.isNull()) {
34  if (!error.isStr()) {
35  throw std::runtime_error(strprintf("'%s' error", command));
36  }
37  throw std::runtime_error(strprintf("'%s' error: %s", command, error.getValStr()));
38  }
39  // Check if fingerprint is present
40  const UniValue& fingerprint = find_value(signer, "fingerprint");
41  if (fingerprint.isNull()) {
42  throw std::runtime_error(strprintf("'%s' received invalid response, missing signer fingerprint", command));
43  }
44  const std::string fingerprintStr = fingerprint.get_str();
45  // Skip duplicate signer
46  bool duplicate = false;
47  for (const ExternalSigner& signer : signers) {
48  if (signer.m_fingerprint.compare(fingerprintStr) == 0) duplicate = true;
49  }
50  if (duplicate) break;
51  std::string name = "";
52  const UniValue& model_field = find_value(signer, "model");
53  if (model_field.isStr() && model_field.getValStr() != "") {
54  name += model_field.getValStr();
55  }
56  signers.push_back(ExternalSigner(command, chain, fingerprintStr, name));
57  }
58  return true;
59 }
60 
61 UniValue ExternalSigner::DisplayAddress(const std::string& descriptor) const
62 {
63  return RunCommandParseJSON(m_command + " --fingerprint \"" + m_fingerprint + "\"" + NetworkArg() + " displayaddress --desc \"" + descriptor + "\"");
64 }
65 
67 {
68  return RunCommandParseJSON(m_command + " --fingerprint \"" + m_fingerprint + "\"" + NetworkArg() + " getdescriptors --account " + strprintf("%d", account));
69 }
70 
72 {
73  // Serialize the PSBT
75  ssTx << psbtx;
76 
77  // Check if signer fingerprint matches any input master key fingerprint
78  bool match = false;
79  for (unsigned int i = 0; i < psbtx.inputs.size(); ++i) {
80  const PSBTInput& input = psbtx.inputs[i];
81  for (const auto& entry : input.hd_keypaths) {
82  if (m_fingerprint == strprintf("%08x", ReadBE32(entry.second.fingerprint))) match = true;
83  }
84  }
85 
86  if (!match) {
87  error = "Signer fingerprint " + m_fingerprint + " does not match any of the inputs:\n" + EncodeBase64(ssTx.str());
88  return false;
89  }
90 
91  const std::string command = m_command + " --stdin --fingerprint \"" + m_fingerprint + "\"" + NetworkArg();
92  const std::string stdinStr = "signtx \"" + EncodeBase64(ssTx.str()) + "\"";
93 
94  const UniValue signer_result = RunCommandParseJSON(command, stdinStr);
95 
96  if (find_value(signer_result, "error").isStr()) {
97  error = find_value(signer_result, "error").get_str();
98  return false;
99  }
100 
101  if (!find_value(signer_result, "psbt").isStr()) {
102  error = "Unexpected result from signer";
103  return false;
104  }
105 
106  PartiallySignedTransaction signer_psbtx;
107  std::string signer_psbt_error;
108  if (!DecodeBase64PSBT(signer_psbtx, find_value(signer_result, "psbt").get_str(), signer_psbt_error)) {
109  error = strprintf("TX decode failed %s", signer_psbt_error);
110  return false;
111  }
112 
113  psbtx = signer_psbtx;
114 
115  return true;
116 }
ExternalSigner::DisplayAddress
UniValue DisplayAddress(const std::string &descriptor) const
Display address on the device.
Definition: external_signer.cpp:61
ExternalSigner::m_chain
std::string m_chain
Bitcoin mainnet, testnet, etc.
Definition: external_signer.h:25
RunCommandParseJSON
UniValue RunCommandParseJSON(const std::string &str_command, const std::string &str_std_in)
Execute a command which returns JSON, and parse the result.
Definition: system.cpp:1254
ExternalSigner::Enumerate
static bool Enumerate(const std::string &command, std::vector< ExternalSigner > &signers, const std::string chain)
Obtain a list of signers.
Definition: external_signer.cpp:23
ReadBE32
static uint32_t ReadBE32(const unsigned char *ptr)
Definition: common.h:63
UniValue::isNull
bool isNull() const
Definition: univalue.h:77
EncodeBase64
std::string EncodeBase64(Span< const unsigned char > input)
Definition: strencodings.cpp:130
chainparams.h
core_io.h
DecodeBase64PSBT
bool DecodeBase64PSBT(PartiallySignedTransaction &psbt, const std::string &base64_tx, std::string &error)
Decode a base64ed PSBT into a PartiallySignedTransaction.
Definition: psbt.cpp:374
UniValue
Definition: univalue.h:19
UniValue::get_str
const std::string & get_str() const
Definition: univalue_get.cpp:97
strencodings.h
UniValue::isStr
bool isStr() const
Definition: univalue.h:81
ExternalSigner::SignTransaction
bool SignTransaction(PartiallySignedTransaction &psbt, std::string &error)
Sign PartiallySignedTransaction on the device.
Definition: external_signer.cpp:71
ExternalSigner::GetDescriptors
UniValue GetDescriptors(const int account)
Get receive and change Descriptor(s) from device for a given account.
Definition: external_signer.cpp:66
external_signer.h
PSBTInput::hd_keypaths
std::map< CPubKey, KeyOriginInfo > hd_keypaths
Definition: psbt.h:57
UniValue::isArray
bool isArray() const
Definition: univalue.h:83
ExternalSigner::ExternalSigner
ExternalSigner(const std::string &command, const std::string chain, const std::string &fingerprint, const std::string name)
Definition: external_signer.cpp:16
ExternalSigner
Enables interaction with an external signing device or service, such as a hardware wallet.
Definition: external_signer.h:18
name
const char * name
Definition: rest.cpp:43
system.h
strprintf
#define strprintf
Format arguments and return the string or write to given std::ostream (see tinyformat::format doc for...
Definition: tinyformat.h:1164
UniValue::getValStr
const std::string & getValStr() const
Definition: univalue.h:65
PSBTInput
A structure for PSBTs which contain per-input information.
Definition: psbt.h:49
PartiallySignedTransaction
A version of CTransaction with the PSBT format.
Definition: psbt.h:391
ExternalSigner::m_command
std::string m_command
The command which handles interaction with the external signer.
Definition: external_signer.h:22
UniValue::getValues
const std::vector< UniValue > & getValues() const
Definition: univalue_get.cpp:83
CDataStream
Double ended buffer combining vector and stream-like interfaces.
Definition: streams.h:204
ExternalSigner::NetworkArg
const std::string NetworkArg() const
Definition: external_signer.cpp:18
SER_NETWORK
@ SER_NETWORK
Definition: serialize.h:138
m_command
CRPCCommand m_command
Definition: interfaces.cpp:425
find_value
const UniValue & find_value(const UniValue &obj, const std::string &name)
Definition: univalue.cpp:234
error
bool error(const char *fmt, const Args &... args)
Definition: system.h:49
CDataStream::str
std::string str() const
Definition: streams.h:242
ExternalSigner::m_fingerprint
std::string m_fingerprint
Master key fingerprint of the signer.
Definition: external_signer.h:37
PROTOCOL_VERSION
static const int PROTOCOL_VERSION
network protocol versioning
Definition: version.h:12
psbt.h