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 @@
@@ -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