Browse Source
Implement listunspent / getrawtransaction / createrawtransaction / signrawtransaction, to support creation and signing-on-multiple-device multisignature transactions.0.8
Gavin Andresen
13 years ago
12 changed files with 750 additions and 56 deletions
@ -0,0 +1,470 @@ |
|||||||
|
// Copyright (c) 2010 Satoshi Nakamoto
|
||||||
|
// Copyright (c) 2009-2012 The Bitcoin developers
|
||||||
|
// Distributed under the MIT/X11 software license, see the accompanying
|
||||||
|
// file COPYING or http://www.opensource.org/licenses/mit-license.php.
|
||||||
|
|
||||||
|
#include <boost/assign/list_of.hpp> |
||||||
|
|
||||||
|
#include "base58.h" |
||||||
|
#include "bitcoinrpc.h" |
||||||
|
#include "db.h" |
||||||
|
#include "init.h" |
||||||
|
#include "main.h" |
||||||
|
#include "wallet.h" |
||||||
|
|
||||||
|
using namespace std; |
||||||
|
using namespace boost; |
||||||
|
using namespace boost::assign; |
||||||
|
using namespace json_spirit; |
||||||
|
|
||||||
|
// These are all in bitcoinrpc.cpp:
|
||||||
|
extern Object JSONRPCError(int code, const string& message); |
||||||
|
extern int64 AmountFromValue(const Value& value); |
||||||
|
extern Value ValueFromAmount(int64 amount); |
||||||
|
extern std::string HelpRequiringPassphrase(); |
||||||
|
extern void EnsureWalletIsUnlocked(); |
||||||
|
|
||||||
|
void |
||||||
|
ScriptPubKeyToJSON(const CScript& scriptPubKey, Object& out) |
||||||
|
{ |
||||||
|
txnouttype type; |
||||||
|
vector<CTxDestination> addresses; |
||||||
|
int nRequired; |
||||||
|
|
||||||
|
out.push_back(Pair("asm", scriptPubKey.ToString())); |
||||||
|
out.push_back(Pair("hex", HexStr(scriptPubKey.begin(), scriptPubKey.end()))); |
||||||
|
|
||||||
|
if (!ExtractDestinations(scriptPubKey, type, addresses, nRequired)) |
||||||
|
{ |
||||||
|
out.push_back(Pair("type", GetTxnOutputType(TX_NONSTANDARD))); |
||||||
|
return; |
||||||
|
} |
||||||
|
|
||||||
|
out.push_back(Pair("reqSigs", nRequired)); |
||||||
|
out.push_back(Pair("type", GetTxnOutputType(type))); |
||||||
|
|
||||||
|
Array a; |
||||||
|
BOOST_FOREACH(const CTxDestination& addr, addresses) |
||||||
|
a.push_back(CBitcoinAddress(addr).ToString()); |
||||||
|
out.push_back(Pair("addresses", a)); |
||||||
|
} |
||||||
|
|
||||||
|
void |
||||||
|
TxToJSON(const CTransaction& tx, const uint256 hashBlock, Object& entry) |
||||||
|
{ |
||||||
|
entry.push_back(Pair("txid", tx.GetHash().GetHex())); |
||||||
|
entry.push_back(Pair("version", tx.nVersion)); |
||||||
|
entry.push_back(Pair("locktime", (boost::int64_t)tx.nLockTime)); |
||||||
|
Array vin; |
||||||
|
BOOST_FOREACH(const CTxIn& txin, tx.vin) |
||||||
|
{ |
||||||
|
Object in; |
||||||
|
if (tx.IsCoinBase()) |
||||||
|
in.push_back(Pair("coinbase", HexStr(txin.scriptSig.begin(), txin.scriptSig.end()))); |
||||||
|
else |
||||||
|
{ |
||||||
|
in.push_back(Pair("txid", txin.prevout.hash.GetHex())); |
||||||
|
in.push_back(Pair("vout", (boost::int64_t)txin.prevout.n)); |
||||||
|
Object o; |
||||||
|
o.push_back(Pair("asm", txin.scriptSig.ToString())); |
||||||
|
o.push_back(Pair("hex", HexStr(txin.scriptSig.begin(), txin.scriptSig.end()))); |
||||||
|
in.push_back(Pair("scriptSig", o)); |
||||||
|
} |
||||||
|
in.push_back(Pair("sequence", (boost::int64_t)txin.nSequence)); |
||||||
|
vin.push_back(in); |
||||||
|
} |
||||||
|
entry.push_back(Pair("vin", vin)); |
||||||
|
Array vout; |
||||||
|
for (int i = 0; i < tx.vout.size(); i++) |
||||||
|
{ |
||||||
|
const CTxOut& txout = tx.vout[i]; |
||||||
|
Object out; |
||||||
|
out.push_back(Pair("value", ValueFromAmount(txout.nValue))); |
||||||
|
out.push_back(Pair("n", i)); |
||||||
|
Object o; |
||||||
|
ScriptPubKeyToJSON(txout.scriptPubKey, o); |
||||||
|
out.push_back(Pair("scriptPubKey", o)); |
||||||
|
vout.push_back(out); |
||||||
|
} |
||||||
|
entry.push_back(Pair("vout", vout)); |
||||||
|
|
||||||
|
if (hashBlock != 0) |
||||||
|
{ |
||||||
|
entry.push_back(Pair("blockhash", hashBlock.GetHex())); |
||||||
|
map<uint256, CBlockIndex*>::iterator mi = mapBlockIndex.find(hashBlock); |
||||||
|
if (mi != mapBlockIndex.end() && (*mi).second) |
||||||
|
{ |
||||||
|
CBlockIndex* pindex = (*mi).second; |
||||||
|
if (pindex->IsInMainChain()) |
||||||
|
{ |
||||||
|
entry.push_back(Pair("confirmations", 1 + nBestHeight - pindex->nHeight)); |
||||||
|
entry.push_back(Pair("time", (boost::int64_t)pindex->nTime)); |
||||||
|
} |
||||||
|
else |
||||||
|
entry.push_back(Pair("confirmations", 0)); |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
Value getrawtransaction(const Array& params, bool fHelp) |
||||||
|
{ |
||||||
|
if (fHelp || params.size() < 1 || params.size() > 2) |
||||||
|
throw runtime_error( |
||||||
|
"getrawtransaction <txid> [verbose=0]\n" |
||||||
|
"If verbose=0, returns a string that is\n" |
||||||
|
"serialized, hex-encoded data for <txid>.\n" |
||||||
|
"If verbose is non-zero, returns an Object\n" |
||||||
|
"with information about <txid>."); |
||||||
|
|
||||||
|
uint256 hash; |
||||||
|
hash.SetHex(params[0].get_str()); |
||||||
|
|
||||||
|
bool fVerbose = false; |
||||||
|
if (params.size() > 1) |
||||||
|
fVerbose = (params[1].get_int() != 0); |
||||||
|
|
||||||
|
CTransaction tx; |
||||||
|
uint256 hashBlock = 0; |
||||||
|
if (!GetTransaction(hash, tx, hashBlock)) |
||||||
|
throw JSONRPCError(-5, "No information available about transaction"); |
||||||
|
|
||||||
|
CDataStream ssTx(SER_NETWORK, PROTOCOL_VERSION); |
||||||
|
ssTx << tx; |
||||||
|
string strHex = HexStr(ssTx.begin(), ssTx.end()); |
||||||
|
|
||||||
|
if (!fVerbose) |
||||||
|
return strHex; |
||||||
|
|
||||||
|
Object result; |
||||||
|
result.push_back(Pair("hex", strHex)); |
||||||
|
TxToJSON(tx, hashBlock, result); |
||||||
|
return result; |
||||||
|
} |
||||||
|
|
||||||
|
Value listunspent(const Array& params, bool fHelp) |
||||||
|
{ |
||||||
|
if (fHelp || params.size() > 2) |
||||||
|
throw runtime_error( |
||||||
|
"listunspent [minconf=1] [maxconf=999999]\n" |
||||||
|
"Returns array of unspent transaction outputs\n" |
||||||
|
"with between minconf and maxconf (inclusive) confirmations.\n" |
||||||
|
"Results are an array of Objects, each of which has:\n" |
||||||
|
"{txid, vout, scriptPubKey, amount, confirmations}"); |
||||||
|
|
||||||
|
RPCTypeCheck(params, list_of(int_type)(int_type)); |
||||||
|
|
||||||
|
int nMinDepth = 1; |
||||||
|
if (params.size() > 0) |
||||||
|
nMinDepth = params[0].get_int(); |
||||||
|
|
||||||
|
int nMaxDepth = 999999; |
||||||
|
if (params.size() > 1) |
||||||
|
nMaxDepth = params[1].get_int(); |
||||||
|
|
||||||
|
Array results; |
||||||
|
vector<COutput> vecOutputs; |
||||||
|
pwalletMain->AvailableCoins(vecOutputs, false); |
||||||
|
BOOST_FOREACH(const COutput& out, vecOutputs) |
||||||
|
{ |
||||||
|
if (out.nDepth < nMinDepth || out.nDepth > nMaxDepth) |
||||||
|
continue; |
||||||
|
|
||||||
|
int64 nValue = out.tx->vout[out.i].nValue; |
||||||
|
const CScript& pk = out.tx->vout[out.i].scriptPubKey; |
||||||
|
Object entry; |
||||||
|
entry.push_back(Pair("txid", out.tx->GetHash().GetHex())); |
||||||
|
entry.push_back(Pair("vout", out.i)); |
||||||
|
entry.push_back(Pair("scriptPubKey", HexStr(pk.begin(), pk.end()))); |
||||||
|
entry.push_back(Pair("amount",ValueFromAmount(nValue))); |
||||||
|
entry.push_back(Pair("confirmations",out.nDepth)); |
||||||
|
results.push_back(entry); |
||||||
|
} |
||||||
|
|
||||||
|
return results; |
||||||
|
} |
||||||
|
|
||||||
|
Value createrawtransaction(const Array& params, bool fHelp) |
||||||
|
{ |
||||||
|
if (fHelp || params.size() != 2) |
||||||
|
throw runtime_error( |
||||||
|
"createrawtransaction [{\"txid\":txid,\"vout\":n},...] {address:amount,...}\n" |
||||||
|
"Create a transaction spending given inputs\n" |
||||||
|
"(array of objects containing transaction id and output number),\n" |
||||||
|
"sending to given address(es).\n" |
||||||
|
"Returns hex-encoded raw transaction.\n" |
||||||
|
"Note that the transaction's inputs are not signed, and\n" |
||||||
|
"it is not stored in the wallet or transmitted to the network."); |
||||||
|
|
||||||
|
RPCTypeCheck(params, list_of(array_type)(obj_type)); |
||||||
|
|
||||||
|
Array inputs = params[0].get_array(); |
||||||
|
Object sendTo = params[1].get_obj(); |
||||||
|
|
||||||
|
CTransaction rawTx; |
||||||
|
|
||||||
|
BOOST_FOREACH(Value& input, inputs) |
||||||
|
{ |
||||||
|
const Object& o = input.get_obj(); |
||||||
|
|
||||||
|
const Value& txid_v = find_value(o, "txid"); |
||||||
|
if (txid_v.type() != str_type) |
||||||
|
throw JSONRPCError(-8, "Invalid parameter, missing txid key"); |
||||||
|
string txid = txid_v.get_str(); |
||||||
|
if (!IsHex(txid)) |
||||||
|
throw JSONRPCError(-8, "Invalid parameter, expected hex txid"); |
||||||
|
|
||||||
|
const Value& vout_v = find_value(o, "vout"); |
||||||
|
if (vout_v.type() != int_type) |
||||||
|
throw JSONRPCError(-8, "Invalid parameter, missing vout key"); |
||||||
|
int nOutput = vout_v.get_int(); |
||||||
|
if (nOutput < 0) |
||||||
|
throw JSONRPCError(-8, "Invalid parameter, vout must be positive"); |
||||||
|
|
||||||
|
CTxIn in(COutPoint(uint256(txid), nOutput)); |
||||||
|
rawTx.vin.push_back(in); |
||||||
|
} |
||||||
|
|
||||||
|
set<CBitcoinAddress> setAddress; |
||||||
|
BOOST_FOREACH(const Pair& s, sendTo) |
||||||
|
{ |
||||||
|
CBitcoinAddress address(s.name_); |
||||||
|
if (!address.IsValid()) |
||||||
|
throw JSONRPCError(-5, string("Invalid Bitcoin address:")+s.name_); |
||||||
|
|
||||||
|
if (setAddress.count(address)) |
||||||
|
throw JSONRPCError(-8, string("Invalid parameter, duplicated address: ")+s.name_); |
||||||
|
setAddress.insert(address); |
||||||
|
|
||||||
|
CScript scriptPubKey; |
||||||
|
scriptPubKey.SetDestination(address.Get()); |
||||||
|
int64 nAmount = AmountFromValue(s.value_); |
||||||
|
|
||||||
|
CTxOut out(nAmount, scriptPubKey); |
||||||
|
rawTx.vout.push_back(out); |
||||||
|
} |
||||||
|
|
||||||
|
CDataStream ss(SER_NETWORK, PROTOCOL_VERSION); |
||||||
|
ss << rawTx; |
||||||
|
return HexStr(ss.begin(), ss.end()); |
||||||
|
} |
||||||
|
|
||||||
|
Value decoderawtransaction(const Array& params, bool fHelp) |
||||||
|
{ |
||||||
|
if (fHelp || params.size() != 1) |
||||||
|
throw runtime_error( |
||||||
|
"decoderawtransaction <hex string>\n" |
||||||
|
"Return a JSON object representing the serialized, hex-encoded transaction."); |
||||||
|
|
||||||
|
RPCTypeCheck(params, list_of(str_type)); |
||||||
|
|
||||||
|
vector<unsigned char> txData(ParseHex(params[0].get_str())); |
||||||
|
CDataStream ssData(txData, SER_NETWORK, PROTOCOL_VERSION); |
||||||
|
CTransaction tx; |
||||||
|
try { |
||||||
|
ssData >> tx; |
||||||
|
} |
||||||
|
catch (std::exception &e) { |
||||||
|
throw JSONRPCError(-22, "TX decode failed"); |
||||||
|
} |
||||||
|
|
||||||
|
Object result; |
||||||
|
TxToJSON(tx, 0, result); |
||||||
|
|
||||||
|
return result; |
||||||
|
} |
||||||
|
|
||||||
|
Value signrawtransaction(const Array& params, bool fHelp) |
||||||
|
{ |
||||||
|
if (fHelp || params.size() < 1 || params.size() > 3) |
||||||
|
throw runtime_error( |
||||||
|
"signrawtransaction <hex string> [{\"txid\":txid,\"vout\":n,\"scriptPubKey\":hex},...] [<privatekey1>,...]\n" |
||||||
|
"Sign inputs for raw transaction (serialized, hex-encoded).\n" |
||||||
|
"Second optional argument is an array of previous transaction outputs that\n" |
||||||
|
"this transaction depends on but may not yet be in the blockchain.\n" |
||||||
|
"Third optional argument is an array of base58-encoded private\n" |
||||||
|
"keys that, if given, will be the only keys used to sign the transaction.\n" |
||||||
|
"Returns json object with keys:\n" |
||||||
|
" hex : raw transaction with signature(s) (hex-encoded string)\n" |
||||||
|
" complete : 1 if transaction has a complete set of signature (0 if not)" |
||||||
|
+ HelpRequiringPassphrase()); |
||||||
|
|
||||||
|
if (params.size() < 3) |
||||||
|
EnsureWalletIsUnlocked(); |
||||||
|
|
||||||
|
RPCTypeCheck(params, list_of(str_type)(array_type)(array_type)); |
||||||
|
|
||||||
|
vector<unsigned char> txData(ParseHex(params[0].get_str())); |
||||||
|
CDataStream ssData(txData, SER_NETWORK, PROTOCOL_VERSION); |
||||||
|
vector<CTransaction> txVariants; |
||||||
|
while (!ssData.empty()) |
||||||
|
{ |
||||||
|
try { |
||||||
|
CTransaction tx; |
||||||
|
ssData >> tx; |
||||||
|
txVariants.push_back(tx); |
||||||
|
} |
||||||
|
catch (std::exception &e) { |
||||||
|
throw JSONRPCError(-22, "TX decode failed"); |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
if (txVariants.empty()) |
||||||
|
throw JSONRPCError(-22, "Missing transaction"); |
||||||
|
|
||||||
|
// mergedTx will end up with all the signatures; it
|
||||||
|
// starts as a clone of the rawtx:
|
||||||
|
CTransaction mergedTx(txVariants[0]); |
||||||
|
bool fComplete = true; |
||||||
|
|
||||||
|
// Fetch previous transactions (inputs):
|
||||||
|
map<COutPoint, CScript> mapPrevOut; |
||||||
|
{ |
||||||
|
MapPrevTx mapPrevTx; |
||||||
|
CTxDB txdb("r"); |
||||||
|
map<uint256, CTxIndex> unused; |
||||||
|
bool fInvalid; |
||||||
|
mergedTx.FetchInputs(txdb, unused, false, false, mapPrevTx, fInvalid); |
||||||
|
|
||||||
|
// Copy results into mapPrevOut:
|
||||||
|
BOOST_FOREACH(const CTxIn& txin, mergedTx.vin) |
||||||
|
{ |
||||||
|
const uint256& prevHash = txin.prevout.hash; |
||||||
|
if (mapPrevTx.count(prevHash)) |
||||||
|
mapPrevOut[txin.prevout] = mapPrevTx[prevHash].second.vout[txin.prevout.n].scriptPubKey; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
// Add previous txouts given in the RPC call:
|
||||||
|
if (params.size() > 1) |
||||||
|
{ |
||||||
|
Array prevTxs = params[1].get_array(); |
||||||
|
BOOST_FOREACH(Value& p, prevTxs) |
||||||
|
{ |
||||||
|
if (p.type() != obj_type) |
||||||
|
throw JSONRPCError(-22, "expected object with {\"txid'\",\"vout\",\"scriptPubKey\"}"); |
||||||
|
|
||||||
|
Object prevOut = p.get_obj(); |
||||||
|
|
||||||
|
RPCTypeCheck(prevOut, map_list_of("txid", str_type)("vout", int_type)("scriptPubKey", str_type)); |
||||||
|
|
||||||
|
string txidHex = find_value(prevOut, "txid").get_str(); |
||||||
|
if (!IsHex(txidHex)) |
||||||
|
throw JSONRPCError(-22, "txid must be hexadecimal"); |
||||||
|
uint256 txid; |
||||||
|
txid.SetHex(txidHex); |
||||||
|
|
||||||
|
int nOut = find_value(prevOut, "vout").get_int(); |
||||||
|
if (nOut < 0) |
||||||
|
throw JSONRPCError(-22, "vout must be positive"); |
||||||
|
|
||||||
|
string pkHex = find_value(prevOut, "scriptPubKey").get_str(); |
||||||
|
if (!IsHex(pkHex)) |
||||||
|
throw JSONRPCError(-22, "scriptPubKey must be hexadecimal"); |
||||||
|
vector<unsigned char> pkData(ParseHex(pkHex)); |
||||||
|
CScript scriptPubKey(pkData.begin(), pkData.end()); |
||||||
|
|
||||||
|
COutPoint outpoint(txid, nOut); |
||||||
|
if (mapPrevOut.count(outpoint)) |
||||||
|
{ |
||||||
|
// Complain if scriptPubKey doesn't match
|
||||||
|
if (mapPrevOut[outpoint] != scriptPubKey) |
||||||
|
{ |
||||||
|
string err("Previous output scriptPubKey mismatch:\n"); |
||||||
|
err = err + mapPrevOut[outpoint].ToString() + "\nvs:\n"+ |
||||||
|
scriptPubKey.ToString(); |
||||||
|
throw JSONRPCError(-22, err); |
||||||
|
} |
||||||
|
} |
||||||
|
else |
||||||
|
mapPrevOut[outpoint] = scriptPubKey; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
bool fGivenKeys = false; |
||||||
|
CBasicKeyStore tempKeystore; |
||||||
|
if (params.size() > 2) |
||||||
|
{ |
||||||
|
fGivenKeys = true; |
||||||
|
Array keys = params[2].get_array(); |
||||||
|
BOOST_FOREACH(Value k, keys) |
||||||
|
{ |
||||||
|
CBitcoinSecret vchSecret; |
||||||
|
bool fGood = vchSecret.SetString(k.get_str()); |
||||||
|
if (!fGood) |
||||||
|
throw JSONRPCError(-5,"Invalid private key"); |
||||||
|
CKey key; |
||||||
|
bool fCompressed; |
||||||
|
CSecret secret = vchSecret.GetSecret(fCompressed); |
||||||
|
key.SetSecret(secret, fCompressed); |
||||||
|
tempKeystore.AddKey(key); |
||||||
|
} |
||||||
|
} |
||||||
|
const CKeyStore& keystore = (fGivenKeys ? tempKeystore : *pwalletMain); |
||||||
|
|
||||||
|
// Sign what we can:
|
||||||
|
for (int i = 0; i < mergedTx.vin.size(); i++) |
||||||
|
{ |
||||||
|
CTxIn& txin = mergedTx.vin[i]; |
||||||
|
if (mapPrevOut.count(txin.prevout) == 0) |
||||||
|
{ |
||||||
|
fComplete = false; |
||||||
|
continue; |
||||||
|
} |
||||||
|
const CScript& prevPubKey = mapPrevOut[txin.prevout]; |
||||||
|
|
||||||
|
txin.scriptSig.clear(); |
||||||
|
SignSignature(keystore, prevPubKey, mergedTx, i); |
||||||
|
|
||||||
|
// ... and merge in other signatures:
|
||||||
|
BOOST_FOREACH(const CTransaction& txv, txVariants) |
||||||
|
{ |
||||||
|
txin.scriptSig = CombineSignatures(prevPubKey, mergedTx, i, txin.scriptSig, txv.vin[i].scriptSig); |
||||||
|
} |
||||||
|
if (!VerifyScript(txin.scriptSig, prevPubKey, mergedTx, i, true, 0)) |
||||||
|
fComplete = false; |
||||||
|
} |
||||||
|
|
||||||
|
Object result; |
||||||
|
CDataStream ssTx(SER_NETWORK, PROTOCOL_VERSION); |
||||||
|
ssTx << mergedTx; |
||||||
|
result.push_back(Pair("hex", HexStr(ssTx.begin(), ssTx.end()))); |
||||||
|
result.push_back(Pair("complete", fComplete)); |
||||||
|
|
||||||
|
return result; |
||||||
|
} |
||||||
|
|
||||||
|
Value sendrawtransaction(const Array& params, bool fHelp) |
||||||
|
{ |
||||||
|
if (fHelp || params.size() < 1 || params.size() > 1) |
||||||
|
throw runtime_error( |
||||||
|
"sendrawtransaction <hex string>\n" |
||||||
|
"Submits raw transaction (serialized, hex-encoded) to local node and network."); |
||||||
|
|
||||||
|
RPCTypeCheck(params, list_of(str_type)); |
||||||
|
|
||||||
|
// parse hex string from parameter
|
||||||
|
vector<unsigned char> txData(ParseHex(params[0].get_str())); |
||||||
|
CDataStream ssData(txData, SER_NETWORK, PROTOCOL_VERSION); |
||||||
|
CTransaction tx; |
||||||
|
|
||||||
|
// deserialize binary data stream
|
||||||
|
try { |
||||||
|
ssData >> tx; |
||||||
|
} |
||||||
|
catch (std::exception &e) { |
||||||
|
throw JSONRPCError(-22, "TX decode failed"); |
||||||
|
} |
||||||
|
|
||||||
|
// push to local node
|
||||||
|
CTxDB txdb("r"); |
||||||
|
if (!tx.AcceptToMemoryPool(txdb)) |
||||||
|
throw JSONRPCError(-22, "TX rejected"); |
||||||
|
|
||||||
|
SyncWithWallets(tx, NULL, true); |
||||||
|
|
||||||
|
// relay to network
|
||||||
|
CInv inv(MSG_TX, tx.GetHash()); |
||||||
|
RelayInventory(inv); |
||||||
|
|
||||||
|
return tx.GetHash().GetHex(); |
||||||
|
} |
||||||
Loading…
Reference in new issue