1 // Copyright (c) 2010 Satoshi Nakamoto
2 // Distributed under the MIT/X11 software license, see the accompanying
3 // file license.txt or http://www.opensource.org/licenses/mit-license.php.
6 #include "cryptopp/sha.h"
8 #include <boost/asio.hpp>
9 #include <boost/iostreams/concepts.hpp>
10 #include <boost/iostreams/stream.hpp>
12 #include <boost/asio/ssl.hpp>
13 typedef boost::asio::ssl::stream<boost::asio::ip::tcp::socket> SSLStream;
15 #include "json/json_spirit_reader_template.h"
16 #include "json/json_spirit_writer_template.h"
17 #include "json/json_spirit_utils.h"
18 #define printf OutputDebugStringF
19 // MinGW 3.4.5 gets "fatal error: had to relocate PCH" if the json headers are
20 // precompiled in headers.h. The problem might be when the pch file goes over
21 // a certain size around 145MB. If we need access to json_spirit outside this
22 // file, we could use the compiled json_spirit option.
24 using namespace boost::asio;
25 using namespace json_spirit;
27 void ThreadRPCServer2(void* parg);
28 typedef Value(*rpcfn_type)(const Array& params, bool fHelp);
29 extern map<string, rpcfn_type> mapCallTable;
32 Object JSONRPCError(int code, const string& message)
35 error.push_back(Pair("code", code));
36 error.push_back(Pair("message", message));
41 void PrintConsole(const char* format, ...)
44 int limit = sizeof(buffer);
46 va_start(arg_ptr, format);
47 int ret = _vsnprintf(buffer, limit, format, arg_ptr);
49 if (ret < 0 || ret >= limit)
55 #if defined(__WXMSW__) && defined(GUI)
56 MyMessageBox(buffer, "Bitcoin", wxOK | wxICON_EXCLAMATION);
58 fprintf(stdout, "%s", buffer);
63 int64 AmountFromValue(const Value& value)
65 double dAmount = value.get_real();
66 if (dAmount <= 0.0 || dAmount > 21000000.0)
67 throw JSONRPCError(-3, "Invalid amount");
68 int64 nAmount = roundint64(dAmount * COIN);
69 if (!MoneyRange(nAmount))
70 throw JSONRPCError(-3, "Invalid amount");
74 Value ValueFromAmount(int64 amount)
76 return (double)amount / (double)COIN;
79 void WalletTxToJSON(const CWalletTx& wtx, Object& entry)
81 entry.push_back(Pair("confirmations", wtx.GetDepthInMainChain()));
82 entry.push_back(Pair("txid", wtx.GetHash().GetHex()));
83 entry.push_back(Pair("time", (boost::int64_t)wtx.GetTxTime()));
84 foreach(const PAIRTYPE(string,string)& item, wtx.mapValue)
85 entry.push_back(Pair(item.first, item.second));
88 string AccountFromValue(const Value& value)
90 string strAccount = value.get_str();
91 if (strAccount == "*")
92 throw JSONRPCError(-11, "Invalid account name");
99 /// Note: This interface may still be subject to change.
103 Value help(const Array& params, bool fHelp)
105 if (fHelp || params.size() > 1)
108 "List commands, or get help for a command.");
111 if (params.size() > 0)
112 strCommand = params[0].get_str();
115 set<rpcfn_type> setDone;
116 for (map<string, rpcfn_type>::iterator mi = mapCallTable.begin(); mi != mapCallTable.end(); ++mi)
118 string strMethod = (*mi).first;
119 // We already filter duplicates, but these deprecated screw up the sort order
120 if (strMethod == "getamountreceived" ||
121 strMethod == "getallreceived" ||
122 (strMethod.find("label") != string::npos))
124 if (strCommand != "" && strMethod != strCommand)
129 rpcfn_type pfn = (*mi).second;
130 if (setDone.insert(pfn).second)
131 (*pfn)(params, true);
133 catch (std::exception& e)
135 // Help text is returned in an exception
136 string strHelp = string(e.what());
137 if (strCommand == "")
138 if (strHelp.find('\n') != -1)
139 strHelp = strHelp.substr(0, strHelp.find('\n'));
140 strRet += strHelp + "\n";
144 strRet = strprintf("help: unknown command: %s\n", strCommand.c_str());
145 strRet = strRet.substr(0,strRet.size()-1);
150 Value stop(const Array& params, bool fHelp)
152 if (fHelp || params.size() != 0)
155 "Stop bitcoin server.");
157 // Shutdown will take long enough that the response should get back
158 CreateThread(Shutdown, NULL);
159 return "bitcoin server stopping";
163 Value getblockcount(const Array& params, bool fHelp)
165 if (fHelp || params.size() != 0)
168 "Returns the number of blocks in the longest block chain.");
174 Value getblocknumber(const Array& params, bool fHelp)
176 if (fHelp || params.size() != 0)
179 "Returns the block number of the latest block in the longest block chain.");
185 Value getconnectioncount(const Array& params, bool fHelp)
187 if (fHelp || params.size() != 0)
189 "getconnectioncount\n"
190 "Returns the number of connections to other nodes.");
192 return (int)vNodes.size();
196 double GetDifficulty()
198 // Floating point number that is a multiple of the minimum difficulty,
199 // minimum difficulty = 1.0.
200 if (pindexBest == NULL)
202 int nShift = 256 - 32 - 31; // to fit in a uint
203 double dMinimum = (CBigNum().SetCompact(bnProofOfWorkLimit.GetCompact()) >> nShift).getuint();
204 double dCurrently = (CBigNum().SetCompact(pindexBest->nBits) >> nShift).getuint();
205 return dMinimum / dCurrently;
208 Value getdifficulty(const Array& params, bool fHelp)
210 if (fHelp || params.size() != 0)
213 "Returns the proof-of-work difficulty as a multiple of the minimum difficulty.");
215 return GetDifficulty();
219 Value getgenerate(const Array& params, bool fHelp)
221 if (fHelp || params.size() != 0)
224 "Returns true or false.");
226 return (bool)fGenerateBitcoins;
230 Value setgenerate(const Array& params, bool fHelp)
232 if (fHelp || params.size() < 1 || params.size() > 2)
234 "setgenerate <generate> [genproclimit]\n"
235 "<generate> is true or false to turn generation on or off.\n"
236 "Generation is limited to [genproclimit] processors, -1 is unlimited.");
238 bool fGenerate = true;
239 if (params.size() > 0)
240 fGenerate = params[0].get_bool();
242 if (params.size() > 1)
244 int nGenProcLimit = params[1].get_int();
245 fLimitProcessors = (nGenProcLimit != -1);
246 CWalletDB().WriteSetting("fLimitProcessors", fLimitProcessors);
247 if (nGenProcLimit != -1)
248 CWalletDB().WriteSetting("nLimitProcessors", nLimitProcessors = nGenProcLimit);
249 if (nGenProcLimit == 0)
253 GenerateBitcoins(fGenerate);
258 Value gethashespersec(const Array& params, bool fHelp)
260 if (fHelp || params.size() != 0)
263 "Returns a recent hashes per second performance measurement while generating.");
265 if (GetTimeMillis() - nHPSTimerStart > 8000)
266 return (boost::int64_t)0;
267 return (boost::int64_t)dHashesPerSec;
271 Value getinfo(const Array& params, bool fHelp)
273 if (fHelp || params.size() != 0)
276 "Returns an object containing various state info.");
279 obj.push_back(Pair("version", (int)VERSION));
280 obj.push_back(Pair("balance", ValueFromAmount(GetBalance())));
281 obj.push_back(Pair("blocks", (int)nBestHeight));
282 obj.push_back(Pair("connections", (int)vNodes.size()));
283 obj.push_back(Pair("proxy", (fUseProxy ? addrProxy.ToStringIPPort() : string())));
284 obj.push_back(Pair("generate", (bool)fGenerateBitcoins));
285 obj.push_back(Pair("genproclimit", (int)(fLimitProcessors ? nLimitProcessors : -1)));
286 obj.push_back(Pair("difficulty", (double)GetDifficulty()));
287 obj.push_back(Pair("hashespersec", gethashespersec(params, false)));
288 obj.push_back(Pair("testnet", fTestNet));
289 obj.push_back(Pair("keypoololdest", (boost::int64_t)GetOldestKeyPoolTime()));
290 obj.push_back(Pair("paytxfee", ValueFromAmount(nTransactionFee)));
291 obj.push_back(Pair("errors", GetWarnings("statusbar")));
296 Value getnewaddress(const Array& params, bool fHelp)
298 if (fHelp || params.size() > 1)
300 "getnewaddress [account]\n"
301 "Returns a new bitcoin address for receiving payments. "
302 "If [account] is specified (recommended), it is added to the address book "
303 "so payments received with the address will be credited to [account].");
305 // Parse the account first so we don't generate a key if there's an error
307 if (params.size() > 0)
308 strAccount = AccountFromValue(params[0]);
310 // Generate a new key that is added to wallet
311 string strAddress = PubKeyToAddress(GetKeyFromKeyPool());
313 SetAddressBookName(strAddress, strAccount);
318 // requires cs_main, cs_mapWallet locks
319 string GetAccountAddress(string strAccount, bool bForceNew=false)
327 walletdb.ReadAccount(strAccount, account);
329 // Check if the current key has been used
330 if (!account.vchPubKey.empty())
332 CScript scriptPubKey;
333 scriptPubKey.SetBitcoinAddress(account.vchPubKey);
334 for (map<uint256, CWalletTx>::iterator it = mapWallet.begin();
335 it != mapWallet.end() && !account.vchPubKey.empty();
338 const CWalletTx& wtx = (*it).second;
339 foreach(const CTxOut& txout, wtx.vout)
340 if (txout.scriptPubKey == scriptPubKey)
341 account.vchPubKey.clear();
345 // Generate a new key
346 if (account.vchPubKey.empty() || bForceNew)
348 account.vchPubKey = GetKeyFromKeyPool();
349 string strAddress = PubKeyToAddress(account.vchPubKey);
350 SetAddressBookName(strAddress, strAccount);
351 walletdb.WriteAccount(strAccount, account);
354 walletdb.TxnCommit();
355 strAddress = PubKeyToAddress(account.vchPubKey);
360 Value getaccountaddress(const Array& params, bool fHelp)
362 if (fHelp || params.size() != 1)
364 "getaccountaddress <account>\n"
365 "Returns the current bitcoin address for receiving payments to this account.");
367 // Parse the account first so we don't generate a key if there's an error
368 string strAccount = AccountFromValue(params[0]);
372 CRITICAL_BLOCK(cs_main)
373 CRITICAL_BLOCK(cs_mapWallet)
375 ret = GetAccountAddress(strAccount);
383 Value setaccount(const Array& params, bool fHelp)
385 if (fHelp || params.size() < 1 || params.size() > 2)
387 "setaccount <bitcoinaddress> <account>\n"
388 "Sets the account associated with the given address.");
390 string strAddress = params[0].get_str();
392 bool isValid = AddressToHash160(strAddress, hash160);
394 throw JSONRPCError(-5, "Invalid bitcoin address");
398 if (params.size() > 1)
399 strAccount = AccountFromValue(params[1]);
401 // Detect when changing the account of an address that is the 'unused current key' of another account:
402 CRITICAL_BLOCK(cs_main)
403 CRITICAL_BLOCK(cs_mapWallet)
404 CRITICAL_BLOCK(cs_mapAddressBook)
406 if (mapAddressBook.count(strAddress))
408 string strOldAccount = mapAddressBook[strAddress];
409 if (strAddress == GetAccountAddress(strOldAccount))
410 GetAccountAddress(strOldAccount, true);
414 SetAddressBookName(strAddress, strAccount);
419 Value getaccount(const Array& params, bool fHelp)
421 if (fHelp || params.size() != 1)
423 "getaccount <bitcoinaddress>\n"
424 "Returns the account associated with the given address.");
426 string strAddress = params[0].get_str();
429 CRITICAL_BLOCK(cs_mapAddressBook)
431 map<string, string>::iterator mi = mapAddressBook.find(strAddress);
432 if (mi != mapAddressBook.end() && !(*mi).second.empty())
433 strAccount = (*mi).second;
439 Value getaddressesbyaccount(const Array& params, bool fHelp)
441 if (fHelp || params.size() != 1)
443 "getaddressesbyaccount <account>\n"
444 "Returns the list of addresses for the given account.");
446 string strAccount = AccountFromValue(params[0]);
448 // Find all addresses that have the given account
450 CRITICAL_BLOCK(cs_mapAddressBook)
452 foreach(const PAIRTYPE(string, string)& item, mapAddressBook)
454 const string& strAddress = item.first;
455 const string& strName = item.second;
456 if (strName == strAccount)
458 // We're only adding valid bitcoin addresses and not ip addresses
459 CScript scriptPubKey;
460 if (scriptPubKey.SetBitcoinAddress(strAddress))
461 ret.push_back(strAddress);
468 Value settxfee(const Array& params, bool fHelp)
470 if (fHelp || params.size() < 1 || params.size() > 1)
472 "settxfee <amount>\n"
473 "<amount> is a real and is rounded to the nearest 0.00000001");
477 if (params[0].get_real() != 0.0)
478 nAmount = AmountFromValue(params[0]); // rejects 0.0 amounts
480 nTransactionFee = nAmount;
484 Value sendtoaddress(const Array& params, bool fHelp)
486 if (fHelp || params.size() < 2 || params.size() > 4)
488 "sendtoaddress <bitcoinaddress> <amount> [comment] [comment-to]\n"
489 "<amount> is a real and is rounded to the nearest 0.00000001");
491 string strAddress = params[0].get_str();
494 int64 nAmount = AmountFromValue(params[1]);
498 if (params.size() > 2 && params[2].type() != null_type && !params[2].get_str().empty())
499 wtx.mapValue["comment"] = params[2].get_str();
500 if (params.size() > 3 && params[3].type() != null_type && !params[3].get_str().empty())
501 wtx.mapValue["to"] = params[3].get_str();
503 CRITICAL_BLOCK(cs_main)
505 string strError = SendMoneyToBitcoinAddress(strAddress, nAmount, wtx);
507 throw JSONRPCError(-4, strError);
510 return wtx.GetHash().GetHex();
514 Value getreceivedbyaddress(const Array& params, bool fHelp)
516 if (fHelp || params.size() < 1 || params.size() > 2)
518 "getreceivedbyaddress <bitcoinaddress> [minconf=1]\n"
519 "Returns the total amount received by <bitcoinaddress> in transactions with at least [minconf] confirmations.");
522 string strAddress = params[0].get_str();
523 CScript scriptPubKey;
524 if (!scriptPubKey.SetBitcoinAddress(strAddress))
525 throw JSONRPCError(-5, "Invalid bitcoin address");
526 if (!IsMine(scriptPubKey))
529 // Minimum confirmations
531 if (params.size() > 1)
532 nMinDepth = params[1].get_int();
536 CRITICAL_BLOCK(cs_mapWallet)
538 for (map<uint256, CWalletTx>::iterator it = mapWallet.begin(); it != mapWallet.end(); ++it)
540 const CWalletTx& wtx = (*it).second;
541 if (wtx.IsCoinBase() || !wtx.IsFinal())
544 foreach(const CTxOut& txout, wtx.vout)
545 if (txout.scriptPubKey == scriptPubKey)
546 if (wtx.GetDepthInMainChain() >= nMinDepth)
547 nAmount += txout.nValue;
551 return ValueFromAmount(nAmount);
555 void GetAccountPubKeys(string strAccount, set<CScript>& setPubKey)
557 CRITICAL_BLOCK(cs_mapAddressBook)
559 foreach(const PAIRTYPE(string, string)& item, mapAddressBook)
561 const string& strAddress = item.first;
562 const string& strName = item.second;
563 if (strName == strAccount)
565 // We're only counting our own valid bitcoin addresses and not ip addresses
566 CScript scriptPubKey;
567 if (scriptPubKey.SetBitcoinAddress(strAddress))
568 if (IsMine(scriptPubKey))
569 setPubKey.insert(scriptPubKey);
576 Value getreceivedbyaccount(const Array& params, bool fHelp)
578 if (fHelp || params.size() < 1 || params.size() > 2)
580 "getreceivedbyaccount <account> [minconf=1]\n"
581 "Returns the total amount received by addresses with <account> in transactions with at least [minconf] confirmations.");
583 // Minimum confirmations
585 if (params.size() > 1)
586 nMinDepth = params[1].get_int();
588 // Get the set of pub keys that have the label
589 string strAccount = AccountFromValue(params[0]);
590 set<CScript> setPubKey;
591 GetAccountPubKeys(strAccount, setPubKey);
595 CRITICAL_BLOCK(cs_mapWallet)
597 for (map<uint256, CWalletTx>::iterator it = mapWallet.begin(); it != mapWallet.end(); ++it)
599 const CWalletTx& wtx = (*it).second;
600 if (wtx.IsCoinBase() || !wtx.IsFinal())
603 foreach(const CTxOut& txout, wtx.vout)
604 if (setPubKey.count(txout.scriptPubKey))
605 if (wtx.GetDepthInMainChain() >= nMinDepth)
606 nAmount += txout.nValue;
610 return (double)nAmount / (double)COIN;
614 int64 GetAccountBalance(CWalletDB& walletdb, const string& strAccount, int nMinDepth)
617 CRITICAL_BLOCK(cs_mapWallet)
619 // Tally wallet transactions
620 for (map<uint256, CWalletTx>::iterator it = mapWallet.begin(); it != mapWallet.end(); ++it)
622 const CWalletTx& wtx = (*it).second;
626 int64 nGenerated, nReceived, nSent, nFee;
627 wtx.GetAccountAmounts(strAccount, nGenerated, nReceived, nSent, nFee);
629 if (nReceived != 0 && wtx.GetDepthInMainChain() >= nMinDepth)
630 nBalance += nReceived;
631 nBalance += nGenerated - nSent - nFee;
634 // Tally internal accounting entries
635 nBalance += walletdb.GetAccountCreditDebit(strAccount);
641 int64 GetAccountBalance(const string& strAccount, int nMinDepth)
644 return GetAccountBalance(walletdb, strAccount, nMinDepth);
648 Value getbalance(const Array& params, bool fHelp)
650 if (fHelp || params.size() < 0 || params.size() > 2)
652 "getbalance [account] [minconf=1]\n"
653 "If [account] is not specified, returns the server's total available balance.\n"
654 "If [account] is specified, returns the balance in the account.");
656 if (params.size() == 0)
657 return ValueFromAmount(GetBalance());
660 if (params.size() > 1)
661 nMinDepth = params[1].get_int();
663 if (params[0].get_str() == "*") {
664 // Calculate total balance a different way from GetBalance()
665 // (GetBalance() sums up all unspent TxOuts)
666 // getbalance and getbalance '*' should always return the same number.
668 for (map<uint256, CWalletTx>::iterator it = mapWallet.begin(); it != mapWallet.end(); ++it)
670 const CWalletTx& wtx = (*it).second;
674 int64 allGeneratedImmature, allGeneratedMature, allFee;
675 allGeneratedImmature = allGeneratedMature = allFee = 0;
676 string strSentAccount;
677 list<pair<string, int64> > listReceived;
678 list<pair<string, int64> > listSent;
679 wtx.GetAmounts(allGeneratedImmature, allGeneratedMature, listReceived, listSent, allFee, strSentAccount);
680 if (wtx.GetDepthInMainChain() >= nMinDepth)
681 foreach(const PAIRTYPE(string,int64)& r, listReceived)
682 nBalance += r.second;
683 foreach(const PAIRTYPE(string,int64)& r, listSent)
684 nBalance -= r.second;
686 nBalance += allGeneratedMature;
688 return ValueFromAmount(nBalance);
691 string strAccount = AccountFromValue(params[0]);
693 int64 nBalance = GetAccountBalance(strAccount, nMinDepth);
695 return ValueFromAmount(nBalance);
699 Value movecmd(const Array& params, bool fHelp)
701 if (fHelp || params.size() < 3 || params.size() > 5)
703 "move <fromaccount> <toaccount> <amount> [minconf=1] [comment]\n"
704 "Move from one account in your wallet to another.");
706 string strFrom = AccountFromValue(params[0]);
707 string strTo = AccountFromValue(params[1]);
708 int64 nAmount = AmountFromValue(params[2]);
710 if (params.size() > 3)
711 nMinDepth = params[3].get_int();
713 if (params.size() > 4)
714 strComment = params[4].get_str();
716 CRITICAL_BLOCK(cs_mapWallet)
722 if (!strFrom.empty())
724 int64 nBalance = GetAccountBalance(walletdb, strFrom, nMinDepth);
725 if (nAmount > nBalance)
726 throw JSONRPCError(-6, "Account has insufficient funds");
730 // move from "" account special case
731 int64 nBalance = GetAccountBalance(walletdb, strTo, nMinDepth);
732 if (nAmount > GetBalance() - nBalance)
733 throw JSONRPCError(-6, "Account has insufficient funds");
736 int64 nNow = GetAdjustedTime();
739 CAccountingEntry debit;
740 debit.strAccount = strFrom;
741 debit.nCreditDebit = -nAmount;
743 debit.strOtherAccount = strTo;
744 debit.strComment = strComment;
745 walletdb.WriteAccountingEntry(debit);
748 CAccountingEntry credit;
749 credit.strAccount = strTo;
750 credit.nCreditDebit = nAmount;
752 credit.strOtherAccount = strFrom;
753 credit.strComment = strComment;
754 walletdb.WriteAccountingEntry(credit);
756 walletdb.TxnCommit();
762 Value sendfrom(const Array& params, bool fHelp)
764 if (fHelp || params.size() < 3 || params.size() > 6)
766 "sendfrom <fromaccount> <tobitcoinaddress> <amount> [minconf=1] [comment] [comment-to]\n"
767 "<amount> is a real and is rounded to the nearest 0.00000001");
769 string strAccount = AccountFromValue(params[0]);
770 string strAddress = params[1].get_str();
771 int64 nAmount = AmountFromValue(params[2]);
773 if (params.size() > 3)
774 nMinDepth = params[3].get_int();
777 wtx.strFromAccount = strAccount;
778 if (params.size() > 4 && params[4].type() != null_type && !params[4].get_str().empty())
779 wtx.mapValue["comment"] = params[4].get_str();
780 if (params.size() > 5 && params[5].type() != null_type && !params[5].get_str().empty())
781 wtx.mapValue["to"] = params[5].get_str();
783 CRITICAL_BLOCK(cs_main)
784 CRITICAL_BLOCK(cs_mapWallet)
787 int64 nBalance = GetAccountBalance(strAccount, nMinDepth);
788 if (nAmount > nBalance)
789 throw JSONRPCError(-6, "Account has insufficient funds");
792 string strError = SendMoneyToBitcoinAddress(strAddress, nAmount, wtx);
794 throw JSONRPCError(-4, strError);
797 return wtx.GetHash().GetHex();
800 Value sendmany(const Array& params, bool fHelp)
802 if (fHelp || params.size() < 2 || params.size() > 4)
804 "sendmany <fromaccount> {address:amount,...} [minconf=1] [comment]\n"
805 "amounts are double-precision floating point numbers");
807 string strAccount = AccountFromValue(params[0]);
808 Object sendTo = params[1].get_obj();
810 if (params.size() > 2)
811 nMinDepth = params[2].get_int();
814 wtx.strFromAccount = strAccount;
815 if (params.size() > 3 && params[3].type() != null_type && !params[3].get_str().empty())
816 wtx.mapValue["comment"] = params[3].get_str();
818 set<string> setAddress;
819 vector<pair<CScript, int64> > vecSend;
821 int64 totalAmount = 0;
822 foreach(const Pair& s, sendTo)
825 string strAddress = s.name_;
827 if (setAddress.count(strAddress))
828 throw JSONRPCError(-8, string("Invalid parameter, duplicated address: ")+strAddress);
829 setAddress.insert(strAddress);
831 CScript scriptPubKey;
832 if (!scriptPubKey.SetBitcoinAddress(strAddress))
833 throw JSONRPCError(-5, string("Invalid bitcoin address:")+strAddress);
834 int64 nAmount = AmountFromValue(s.value_);
835 totalAmount += nAmount;
837 vecSend.push_back(make_pair(scriptPubKey, nAmount));
840 CRITICAL_BLOCK(cs_main)
841 CRITICAL_BLOCK(cs_mapWallet)
844 int64 nBalance = GetAccountBalance(strAccount, nMinDepth);
845 if (totalAmount > nBalance)
846 throw JSONRPCError(-6, "Account has insufficient funds");
849 CReserveKey keyChange;
850 int64 nFeeRequired = 0;
851 bool fCreated = CreateTransaction(vecSend, wtx, keyChange, nFeeRequired);
854 if (totalAmount + nFeeRequired > GetBalance())
855 throw JSONRPCError(-6, "Insufficient funds");
856 throw JSONRPCError(-4, "Transaction creation failed");
858 if (!CommitTransaction(wtx, keyChange))
859 throw JSONRPCError(-4, "Transaction commit failed");
862 return wtx.GetHash().GetHex();
877 Value ListReceived(const Array& params, bool fByAccounts)
879 // Minimum confirmations
881 if (params.size() > 0)
882 nMinDepth = params[0].get_int();
884 // Whether to include empty accounts
885 bool fIncludeEmpty = false;
886 if (params.size() > 1)
887 fIncludeEmpty = params[1].get_bool();
890 map<uint160, tallyitem> mapTally;
891 CRITICAL_BLOCK(cs_mapWallet)
893 for (map<uint256, CWalletTx>::iterator it = mapWallet.begin(); it != mapWallet.end(); ++it)
895 const CWalletTx& wtx = (*it).second;
896 if (wtx.IsCoinBase() || !wtx.IsFinal())
899 int nDepth = wtx.GetDepthInMainChain();
900 if (nDepth < nMinDepth)
903 foreach(const CTxOut& txout, wtx.vout)
905 // Only counting our own bitcoin addresses and not ip addresses
906 uint160 hash160 = txout.scriptPubKey.GetBitcoinAddressHash160();
907 if (hash160 == 0 || !mapPubKeys.count(hash160)) // IsMine
910 tallyitem& item = mapTally[hash160];
911 item.nAmount += txout.nValue;
912 item.nConf = min(item.nConf, nDepth);
919 map<string, tallyitem> mapAccountTally;
920 CRITICAL_BLOCK(cs_mapAddressBook)
922 foreach(const PAIRTYPE(string, string)& item, mapAddressBook)
924 const string& strAddress = item.first;
925 const string& strAccount = item.second;
927 if (!AddressToHash160(strAddress, hash160))
929 map<uint160, tallyitem>::iterator it = mapTally.find(hash160);
930 if (it == mapTally.end() && !fIncludeEmpty)
935 if (it != mapTally.end())
937 nAmount = (*it).second.nAmount;
938 nConf = (*it).second.nConf;
943 tallyitem& item = mapAccountTally[strAccount];
944 item.nAmount += nAmount;
945 item.nConf = min(item.nConf, nConf);
950 obj.push_back(Pair("address", strAddress));
951 obj.push_back(Pair("account", strAccount));
952 obj.push_back(Pair("label", strAccount)); // deprecated
953 obj.push_back(Pair("amount", ValueFromAmount(nAmount)));
954 obj.push_back(Pair("confirmations", (nConf == INT_MAX ? 0 : nConf)));
962 for (map<string, tallyitem>::iterator it = mapAccountTally.begin(); it != mapAccountTally.end(); ++it)
964 int64 nAmount = (*it).second.nAmount;
965 int nConf = (*it).second.nConf;
967 obj.push_back(Pair("account", (*it).first));
968 obj.push_back(Pair("label", (*it).first)); // deprecated
969 obj.push_back(Pair("amount", ValueFromAmount(nAmount)));
970 obj.push_back(Pair("confirmations", (nConf == INT_MAX ? 0 : nConf)));
978 Value listreceivedbyaddress(const Array& params, bool fHelp)
980 if (fHelp || params.size() > 2)
982 "listreceivedbyaddress [minconf=1] [includeempty=false]\n"
983 "[minconf] is the minimum number of confirmations before payments are included.\n"
984 "[includeempty] whether to include addresses that haven't received any payments.\n"
985 "Returns an array of objects containing:\n"
986 " \"address\" : receiving address\n"
987 " \"account\" : the account of the receiving address\n"
988 " \"amount\" : total amount received by the address\n"
989 " \"confirmations\" : number of confirmations of the most recent transaction included");
991 return ListReceived(params, false);
994 Value listreceivedbyaccount(const Array& params, bool fHelp)
996 if (fHelp || params.size() > 2)
998 "listreceivedbyaccount [minconf=1] [includeempty=false]\n"
999 "[minconf] is the minimum number of confirmations before payments are included.\n"
1000 "[includeempty] whether to include accounts that haven't received any payments.\n"
1001 "Returns an array of objects containing:\n"
1002 " \"account\" : the account of the receiving addresses\n"
1003 " \"amount\" : total amount received by addresses with this account\n"
1004 " \"confirmations\" : number of confirmations of the most recent transaction included");
1006 return ListReceived(params, true);
1009 void ListTransactions(const CWalletTx& wtx, const string& strAccount, int nMinDepth, bool fLong, Array& ret)
1011 int64 nGeneratedImmature, nGeneratedMature, nFee;
1012 string strSentAccount;
1013 list<pair<string, int64> > listReceived;
1014 list<pair<string, int64> > listSent;
1015 wtx.GetAmounts(nGeneratedImmature, nGeneratedMature, listReceived, listSent, nFee, strSentAccount);
1017 bool fAllAccounts = (strAccount == string("*"));
1019 // Generated blocks assigned to account ""
1020 if ((nGeneratedMature+nGeneratedImmature) != 0 && (fAllAccounts || strAccount == ""))
1023 entry.push_back(Pair("account", string("")));
1024 if (nGeneratedImmature)
1026 entry.push_back(Pair("category", wtx.GetDepthInMainChain() ? "immature" : "orphan"));
1027 entry.push_back(Pair("amount", ValueFromAmount(nGeneratedImmature)));
1031 entry.push_back(Pair("category", "generate"));
1032 entry.push_back(Pair("amount", ValueFromAmount(nGeneratedMature)));
1035 WalletTxToJSON(wtx, entry);
1036 ret.push_back(entry);
1040 if ((!listSent.empty() || nFee != 0) && (fAllAccounts || strAccount == strSentAccount))
1042 foreach(const PAIRTYPE(string, int64)& s, listSent)
1045 entry.push_back(Pair("account", strSentAccount));
1046 entry.push_back(Pair("address", s.first));
1047 entry.push_back(Pair("category", "send"));
1048 entry.push_back(Pair("amount", ValueFromAmount(-s.second)));
1049 entry.push_back(Pair("fee", ValueFromAmount(-nFee)));
1051 WalletTxToJSON(wtx, entry);
1052 ret.push_back(entry);
1057 if (listReceived.size() > 0 && wtx.GetDepthInMainChain() >= nMinDepth)
1058 CRITICAL_BLOCK(cs_mapAddressBook)
1060 foreach(const PAIRTYPE(string, int64)& r, listReceived)
1063 if (mapAddressBook.count(r.first))
1064 account = mapAddressBook[r.first];
1065 if (fAllAccounts || (account == strAccount))
1068 entry.push_back(Pair("account", account));
1069 entry.push_back(Pair("address", r.first));
1070 entry.push_back(Pair("category", "receive"));
1071 entry.push_back(Pair("amount", ValueFromAmount(r.second)));
1073 WalletTxToJSON(wtx, entry);
1074 ret.push_back(entry);
1081 void AcentryToJSON(const CAccountingEntry& acentry, const string& strAccount, Array& ret)
1083 bool fAllAccounts = (strAccount == string("*"));
1085 if (fAllAccounts || acentry.strAccount == strAccount)
1088 entry.push_back(Pair("account", acentry.strAccount));
1089 entry.push_back(Pair("category", "move"));
1090 entry.push_back(Pair("time", (boost::int64_t)acentry.nTime));
1091 entry.push_back(Pair("amount", ValueFromAmount(acentry.nCreditDebit)));
1092 entry.push_back(Pair("otheraccount", acentry.strOtherAccount));
1093 entry.push_back(Pair("comment", acentry.strComment));
1094 ret.push_back(entry);
1098 Value listtransactions(const Array& params, bool fHelp)
1100 if (fHelp || params.size() > 3)
1101 throw runtime_error(
1102 "listtransactions [account] [count=10] [from=0]\n"
1103 "Returns up to [count] most recent transactions skipping the first [from] transactions for account [account].");
1105 string strAccount = "*";
1106 if (params.size() > 0)
1107 strAccount = params[0].get_str();
1109 if (params.size() > 1)
1110 nCount = params[1].get_int();
1112 if (params.size() > 2)
1113 nFrom = params[2].get_int();
1118 CRITICAL_BLOCK(cs_mapWallet)
1120 // Firs: get all CWalletTx and CAccountingEntry into a sorted-by-time multimap:
1121 typedef pair<CWalletTx*, CAccountingEntry*> TxPair;
1122 typedef multimap<int64, TxPair > TxItems;
1125 for (map<uint256, CWalletTx>::iterator it = mapWallet.begin(); it != mapWallet.end(); ++it)
1127 CWalletTx* wtx = &((*it).second);
1128 txByTime.insert(make_pair(wtx->GetTxTime(), TxPair(wtx, (CAccountingEntry*)0)));
1130 list<CAccountingEntry> acentries;
1131 walletdb.ListAccountCreditDebit(strAccount, acentries);
1132 foreach(CAccountingEntry& entry, acentries)
1134 txByTime.insert(make_pair(entry.nTime, TxPair((CWalletTx*)0, &entry)));
1137 // Now: iterate backwards until we have nCount items to return:
1138 TxItems::reverse_iterator it = txByTime.rbegin();
1139 for (std::advance(it, nFrom); it != txByTime.rend(); ++it)
1141 CWalletTx *const pwtx = (*it).second.first;
1143 ListTransactions(*pwtx, strAccount, 0, true, ret);
1144 CAccountingEntry *const pacentry = (*it).second.second;
1146 AcentryToJSON(*pacentry, strAccount, ret);
1148 if (ret.size() >= nCount) break;
1150 // ret is now newest to oldest
1153 // Make sure we return only last nCount items (sends-to-self might give us an extra):
1154 if (ret.size() > nCount)
1156 Array::iterator last = ret.begin();
1157 std::advance(last, nCount);
1158 ret.erase(last, ret.end());
1160 std::reverse(ret.begin(), ret.end()); // oldest to newest
1165 Value listaccounts(const Array& params, bool fHelp)
1167 if (fHelp || params.size() > 1)
1168 throw runtime_error(
1169 "listaccounts [minconf=1]\n"
1170 "Returns Object that has account names as keys, account balances as values.");
1173 if (params.size() > 0)
1174 nMinDepth = params[0].get_int();
1176 map<string, int64> mapAccountBalances;
1177 CRITICAL_BLOCK(cs_mapWallet)
1178 CRITICAL_BLOCK(cs_mapAddressBook)
1180 foreach(const PAIRTYPE(string, string)& entry, mapAddressBook) {
1182 if(AddressToHash160(entry.first, hash160) && mapPubKeys.count(hash160)) // This address belongs to me
1183 mapAccountBalances[entry.second] = 0;
1186 for (map<uint256, CWalletTx>::iterator it = mapWallet.begin(); it != mapWallet.end(); ++it)
1188 const CWalletTx& wtx = (*it).second;
1189 int64 nGeneratedImmature, nGeneratedMature, nFee;
1190 string strSentAccount;
1191 list<pair<string, int64> > listReceived;
1192 list<pair<string, int64> > listSent;
1193 wtx.GetAmounts(nGeneratedImmature, nGeneratedMature, listReceived, listSent, nFee, strSentAccount);
1194 mapAccountBalances[strSentAccount] -= nFee;
1195 foreach(const PAIRTYPE(string, int64)& s, listSent)
1196 mapAccountBalances[strSentAccount] -= s.second;
1197 if (wtx.GetDepthInMainChain() >= nMinDepth)
1199 mapAccountBalances[""] += nGeneratedMature;
1200 foreach(const PAIRTYPE(string, int64)& r, listReceived)
1201 if (mapAddressBook.count(r.first))
1202 mapAccountBalances[mapAddressBook[r.first]] += r.second;
1204 mapAccountBalances[""] += r.second;
1209 list<CAccountingEntry> acentries;
1210 CWalletDB().ListAccountCreditDebit("*", acentries);
1211 foreach(const CAccountingEntry& entry, acentries)
1212 mapAccountBalances[entry.strAccount] += entry.nCreditDebit;
1215 foreach(const PAIRTYPE(string, int64)& accountBalance, mapAccountBalances) {
1216 ret.push_back(Pair(accountBalance.first, ValueFromAmount(accountBalance.second)));
1221 Value gettransaction(const Array& params, bool fHelp)
1223 if (fHelp || params.size() != 1)
1224 throw runtime_error(
1225 "gettransaction <txid>\n"
1226 "Get detailed information about <txid>");
1229 hash.SetHex(params[0].get_str());
1232 CRITICAL_BLOCK(cs_mapWallet)
1234 if (!mapWallet.count(hash))
1235 throw JSONRPCError(-5, "Invalid or non-wallet transaction id");
1236 const CWalletTx& wtx = mapWallet[hash];
1238 int64 nCredit = wtx.GetCredit();
1239 int64 nDebit = wtx.GetDebit();
1240 int64 nNet = nCredit - nDebit;
1241 int64 nFee = (wtx.IsFromMe() ? wtx.GetValueOut() - nDebit : 0);
1243 entry.push_back(Pair("amount", ValueFromAmount(nNet - nFee)));
1245 entry.push_back(Pair("fee", ValueFromAmount(nFee)));
1247 WalletTxToJSON(mapWallet[hash], entry);
1250 ListTransactions(mapWallet[hash], "*", 0, false, details);
1251 entry.push_back(Pair("details", details));
1258 Value backupwallet(const Array& params, bool fHelp)
1260 if (fHelp || params.size() != 1)
1261 throw runtime_error(
1262 "backupwallet <destination>\n"
1263 "Safely copies wallet.dat to destination, which can be a directory or a path with filename.");
1265 string strDest = params[0].get_str();
1266 BackupWallet(strDest);
1272 Value validateaddress(const Array& params, bool fHelp)
1274 if (fHelp || params.size() != 1)
1275 throw runtime_error(
1276 "validateaddress <bitcoinaddress>\n"
1277 "Return information about <bitcoinaddress>.");
1279 string strAddress = params[0].get_str();
1281 bool isValid = AddressToHash160(strAddress, hash160);
1284 ret.push_back(Pair("isvalid", isValid));
1287 // Call Hash160ToAddress() so we always return current ADDRESSVERSION
1288 // version of the address:
1289 string currentAddress = Hash160ToAddress(hash160);
1290 ret.push_back(Pair("address", currentAddress));
1291 ret.push_back(Pair("ismine", (mapPubKeys.count(hash160) > 0)));
1292 CRITICAL_BLOCK(cs_mapAddressBook)
1294 if (mapAddressBook.count(currentAddress))
1295 ret.push_back(Pair("account", mapAddressBook[currentAddress]));
1302 Value getwork(const Array& params, bool fHelp)
1304 if (fHelp || params.size() > 1)
1305 throw runtime_error(
1307 "If [data] is not specified, returns formatted hash data to work on:\n"
1308 " \"midstate\" : precomputed hash state after hashing the first half of the data\n"
1309 " \"data\" : block data\n"
1310 " \"hash1\" : formatted hash buffer for second hash\n"
1311 " \"target\" : little endian hash target\n"
1312 "If [data] is specified, tries to solve the block and returns true if it was successful.");
1315 throw JSONRPCError(-9, "Bitcoin is not connected!");
1317 if (IsInitialBlockDownload())
1318 throw JSONRPCError(-10, "Bitcoin is downloading blocks...");
1320 static map<uint256, pair<CBlock*, unsigned int> > mapNewBlock;
1321 static vector<CBlock*> vNewBlock;
1322 static CReserveKey reservekey;
1324 if (params.size() == 0)
1327 static unsigned int nTransactionsUpdatedLast;
1328 static CBlockIndex* pindexPrev;
1329 static int64 nStart;
1330 static CBlock* pblock;
1331 if (pindexPrev != pindexBest ||
1332 (nTransactionsUpdated != nTransactionsUpdatedLast && GetTime() - nStart > 60))
1334 if (pindexPrev != pindexBest)
1336 // Deallocate old blocks since they're obsolete now
1337 mapNewBlock.clear();
1338 foreach(CBlock* pblock, vNewBlock)
1342 nTransactionsUpdatedLast = nTransactionsUpdated;
1343 pindexPrev = pindexBest;
1347 pblock = CreateNewBlock(reservekey);
1349 throw JSONRPCError(-7, "Out of memory");
1350 vNewBlock.push_back(pblock);
1354 pblock->nTime = max(pindexPrev->GetMedianTimePast()+1, GetAdjustedTime());
1357 // Update nExtraNonce
1358 static unsigned int nExtraNonce = 0;
1359 static int64 nPrevTime = 0;
1360 IncrementExtraNonce(pblock, pindexPrev, nExtraNonce, nPrevTime);
1363 mapNewBlock[pblock->hashMerkleRoot] = make_pair(pblock, nExtraNonce);
1365 // Prebuild hash buffers
1369 FormatHashBuffers(pblock, pmidstate, pdata, phash1);
1371 uint256 hashTarget = CBigNum().SetCompact(pblock->nBits).getuint256();
1374 result.push_back(Pair("midstate", HexStr(BEGIN(pmidstate), END(pmidstate))));
1375 result.push_back(Pair("data", HexStr(BEGIN(pdata), END(pdata))));
1376 result.push_back(Pair("hash1", HexStr(BEGIN(phash1), END(phash1))));
1377 result.push_back(Pair("target", HexStr(BEGIN(hashTarget), END(hashTarget))));
1383 vector<unsigned char> vchData = ParseHex(params[0].get_str());
1384 if (vchData.size() != 128)
1385 throw JSONRPCError(-8, "Invalid parameter");
1386 CBlock* pdata = (CBlock*)&vchData[0];
1389 for (int i = 0; i < 128/4; i++)
1390 ((unsigned int*)pdata)[i] = CryptoPP::ByteReverse(((unsigned int*)pdata)[i]);
1393 if (!mapNewBlock.count(pdata->hashMerkleRoot))
1395 CBlock* pblock = mapNewBlock[pdata->hashMerkleRoot].first;
1396 unsigned int nExtraNonce = mapNewBlock[pdata->hashMerkleRoot].second;
1398 pblock->nTime = pdata->nTime;
1399 pblock->nNonce = pdata->nNonce;
1400 pblock->vtx[0].vin[0].scriptSig = CScript() << pblock->nBits << CBigNum(nExtraNonce);
1401 pblock->hashMerkleRoot = pblock->BuildMerkleTree();
1403 return CheckWork(pblock, reservekey);
1421 pair<string, rpcfn_type> pCallTable[] =
1423 make_pair("help", &help),
1424 make_pair("stop", &stop),
1425 make_pair("getblockcount", &getblockcount),
1426 make_pair("getblocknumber", &getblocknumber),
1427 make_pair("getconnectioncount", &getconnectioncount),
1428 make_pair("getdifficulty", &getdifficulty),
1429 make_pair("getgenerate", &getgenerate),
1430 make_pair("setgenerate", &setgenerate),
1431 make_pair("gethashespersec", &gethashespersec),
1432 make_pair("getinfo", &getinfo),
1433 make_pair("getnewaddress", &getnewaddress),
1434 make_pair("getaccountaddress", &getaccountaddress),
1435 make_pair("setaccount", &setaccount),
1436 make_pair("setlabel", &setaccount), // deprecated
1437 make_pair("getaccount", &getaccount),
1438 make_pair("getlabel", &getaccount), // deprecated
1439 make_pair("getaddressesbyaccount", &getaddressesbyaccount),
1440 make_pair("getaddressesbylabel", &getaddressesbyaccount), // deprecated
1441 make_pair("sendtoaddress", &sendtoaddress),
1442 make_pair("getamountreceived", &getreceivedbyaddress), // deprecated, renamed to getreceivedbyaddress
1443 make_pair("getallreceived", &listreceivedbyaddress), // deprecated, renamed to listreceivedbyaddress
1444 make_pair("getreceivedbyaddress", &getreceivedbyaddress),
1445 make_pair("getreceivedbyaccount", &getreceivedbyaccount),
1446 make_pair("getreceivedbylabel", &getreceivedbyaccount), // deprecated
1447 make_pair("listreceivedbyaddress", &listreceivedbyaddress),
1448 make_pair("listreceivedbyaccount", &listreceivedbyaccount),
1449 make_pair("listreceivedbylabel", &listreceivedbyaccount), // deprecated
1450 make_pair("backupwallet", &backupwallet),
1451 make_pair("validateaddress", &validateaddress),
1452 make_pair("getbalance", &getbalance),
1453 make_pair("move", &movecmd),
1454 make_pair("sendfrom", &sendfrom),
1455 make_pair("sendmany", &sendmany),
1456 make_pair("gettransaction", &gettransaction),
1457 make_pair("listtransactions", &listtransactions),
1458 make_pair("getwork", &getwork),
1459 make_pair("listaccounts", &listaccounts),
1460 make_pair("settxfee", &settxfee),
1462 map<string, rpcfn_type> mapCallTable(pCallTable, pCallTable + sizeof(pCallTable)/sizeof(pCallTable[0]));
1464 string pAllowInSafeMode[] =
1470 "getconnectioncount",
1477 "getaccountaddress",
1480 "getlabel", // deprecated
1481 "getaddressesbyaccount",
1482 "getaddressesbylabel", // deprecated
1487 set<string> setAllowInSafeMode(pAllowInSafeMode, pAllowInSafeMode + sizeof(pAllowInSafeMode)/sizeof(pAllowInSafeMode[0]));
1495 // This ain't Apache. We're just using HTTP header for the length field
1496 // and to be compatible with other JSON-RPC implementations.
1499 string HTTPPost(const string& strMsg, const map<string,string>& mapRequestHeaders)
1502 s << "POST / HTTP/1.1\r\n"
1503 << "User-Agent: bitcoin-json-rpc/" << FormatFullVersion() << "\r\n"
1504 << "Host: 127.0.0.1\r\n"
1505 << "Content-Type: application/json\r\n"
1506 << "Content-Length: " << strMsg.size() << "\r\n"
1507 << "Accept: application/json\r\n";
1508 foreach(const PAIRTYPE(string, string)& item, mapRequestHeaders)
1509 s << item.first << ": " << item.second << "\r\n";
1510 s << "\r\n" << strMsg;
1515 string rfc1123Time()
1520 struct tm* now_gmt = gmtime(&now);
1521 string locale(setlocale(LC_TIME, NULL));
1522 setlocale(LC_TIME, "C"); // we want posix (aka "C") weekday/month strings
1523 strftime(buffer, sizeof(buffer), "%a, %d %b %Y %H:%M:%S +0000", now_gmt);
1524 setlocale(LC_TIME, locale.c_str());
1525 return string(buffer);
1528 string HTTPReply(int nStatus, const string& strMsg)
1531 return strprintf("HTTP/1.0 401 Authorization Required\r\n"
1533 "Server: bitcoin-json-rpc/%s\r\n"
1534 "WWW-Authenticate: Basic realm=\"jsonrpc\"\r\n"
1535 "Content-Type: text/html\r\n"
1536 "Content-Length: 296\r\n"
1538 "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\"\r\n"
1539 "\"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd\">\r\n"
1542 "<TITLE>Error</TITLE>\r\n"
1543 "<META HTTP-EQUIV='Content-Type' CONTENT='text/html; charset=ISO-8859-1'>\r\n"
1545 "<BODY><H1>401 Unauthorized.</H1></BODY>\r\n"
1546 "</HTML>\r\n", rfc1123Time().c_str(), FormatFullVersion().c_str());
1548 if (nStatus == 200) strStatus = "OK";
1549 else if (nStatus == 400) strStatus = "Bad Request";
1550 else if (nStatus == 404) strStatus = "Not Found";
1551 else if (nStatus == 500) strStatus = "Internal Server Error";
1553 "HTTP/1.1 %d %s\r\n"
1555 "Connection: close\r\n"
1556 "Content-Length: %d\r\n"
1557 "Content-Type: application/json\r\n"
1558 "Server: bitcoin-json-rpc/%s\r\n"
1563 rfc1123Time().c_str(),
1565 FormatFullVersion().c_str(),
1569 int ReadHTTPStatus(std::basic_istream<char>& stream)
1572 getline(stream, str);
1573 vector<string> vWords;
1574 boost::split(vWords, str, boost::is_any_of(" "));
1575 if (vWords.size() < 2)
1577 return atoi(vWords[1].c_str());
1580 int ReadHTTPHeader(std::basic_istream<char>& stream, map<string, string>& mapHeadersRet)
1586 std::getline(stream, str);
1587 if (str.empty() || str == "\r")
1589 string::size_type nColon = str.find(":");
1590 if (nColon != string::npos)
1592 string strHeader = str.substr(0, nColon);
1593 boost::trim(strHeader);
1594 boost::to_lower(strHeader);
1595 string strValue = str.substr(nColon+1);
1596 boost::trim(strValue);
1597 mapHeadersRet[strHeader] = strValue;
1598 if (strHeader == "content-length")
1599 nLen = atoi(strValue.c_str());
1605 int ReadHTTP(std::basic_istream<char>& stream, map<string, string>& mapHeadersRet, string& strMessageRet)
1607 mapHeadersRet.clear();
1611 int nStatus = ReadHTTPStatus(stream);
1614 int nLen = ReadHTTPHeader(stream, mapHeadersRet);
1615 if (nLen < 0 || nLen > MAX_SIZE)
1621 vector<char> vch(nLen);
1622 stream.read(&vch[0], nLen);
1623 strMessageRet = string(vch.begin(), vch.end());
1629 string EncodeBase64(string s)
1634 b64 = BIO_new(BIO_f_base64());
1635 BIO_set_flags(b64, BIO_FLAGS_BASE64_NO_NL);
1636 bmem = BIO_new(BIO_s_mem());
1637 b64 = BIO_push(b64, bmem);
1638 BIO_write(b64, s.c_str(), s.size());
1640 BIO_get_mem_ptr(b64, &bptr);
1642 string result(bptr->data, bptr->length);
1648 string DecodeBase64(string s)
1652 char* buffer = static_cast<char*>(calloc(s.size(), sizeof(char)));
1654 b64 = BIO_new(BIO_f_base64());
1655 BIO_set_flags(b64, BIO_FLAGS_BASE64_NO_NL);
1656 bmem = BIO_new_mem_buf(const_cast<char*>(s.c_str()), s.size());
1657 bmem = BIO_push(b64, bmem);
1658 BIO_read(bmem, buffer, s.size());
1661 string result(buffer);
1666 bool HTTPAuthorized(map<string, string>& mapHeaders)
1668 string strAuth = mapHeaders["authorization"];
1669 if (strAuth.substr(0,6) != "Basic ")
1671 string strUserPass64 = strAuth.substr(6); boost::trim(strUserPass64);
1672 string strUserPass = DecodeBase64(strUserPass64);
1673 string::size_type nColon = strUserPass.find(":");
1674 if (nColon == string::npos)
1676 string strUser = strUserPass.substr(0, nColon);
1677 string strPassword = strUserPass.substr(nColon+1);
1678 return (strUser == mapArgs["-rpcuser"] && strPassword == mapArgs["-rpcpassword"]);
1682 // JSON-RPC protocol. Bitcoin speaks version 1.0 for maximum compatibility,
1683 // but uses JSON-RPC 1.1/2.0 standards for parts of the 1.0 standard that were
1684 // unspecified (HTTP errors and contents of 'error').
1686 // 1.0 spec: http://json-rpc.org/wiki/specification
1687 // 1.2 spec: http://groups.google.com/group/json-rpc/web/json-rpc-over-http
1688 // http://www.codeproject.com/KB/recipes/JSON_Spirit.aspx
1691 string JSONRPCRequest(const string& strMethod, const Array& params, const Value& id)
1694 request.push_back(Pair("method", strMethod));
1695 request.push_back(Pair("params", params));
1696 request.push_back(Pair("id", id));
1697 return write_string(Value(request), false) + "\n";
1700 string JSONRPCReply(const Value& result, const Value& error, const Value& id)
1703 if (error.type() != null_type)
1704 reply.push_back(Pair("result", Value::null));
1706 reply.push_back(Pair("result", result));
1707 reply.push_back(Pair("error", error));
1708 reply.push_back(Pair("id", id));
1709 return write_string(Value(reply), false) + "\n";
1712 void ErrorReply(std::ostream& stream, const Object& objError, const Value& id)
1714 // Send error reply from json-rpc error object
1716 int code = find_value(objError, "code").get_int();
1717 if (code == -32600) nStatus = 400;
1718 else if (code == -32601) nStatus = 404;
1719 string strReply = JSONRPCReply(Value::null, objError, id);
1720 stream << HTTPReply(nStatus, strReply) << std::flush;
1723 bool ClientAllowed(const string& strAddress)
1725 if (strAddress == asio::ip::address_v4::loopback().to_string())
1727 const vector<string>& vAllow = mapMultiArgs["-rpcallowip"];
1728 foreach(string strAllow, vAllow)
1729 if (WildcardMatch(strAddress, strAllow))
1736 // IOStream device that speaks SSL but can also speak non-SSL
1738 class SSLIOStreamDevice : public iostreams::device<iostreams::bidirectional> {
1740 SSLIOStreamDevice(SSLStream &streamIn, bool fUseSSLIn) : stream(streamIn)
1742 fUseSSL = fUseSSLIn;
1743 fNeedHandshake = fUseSSLIn;
1746 void handshake(ssl::stream_base::handshake_type role)
1748 if (!fNeedHandshake) return;
1749 fNeedHandshake = false;
1750 stream.handshake(role);
1752 std::streamsize read(char* s, std::streamsize n)
1754 handshake(ssl::stream_base::server); // HTTPS servers read first
1755 if (fUseSSL) return stream.read_some(asio::buffer(s, n));
1756 return stream.next_layer().read_some(asio::buffer(s, n));
1758 std::streamsize write(const char* s, std::streamsize n)
1760 handshake(ssl::stream_base::client); // HTTPS clients write first
1761 if (fUseSSL) return asio::write(stream, asio::buffer(s, n));
1762 return asio::write(stream.next_layer(), asio::buffer(s, n));
1764 bool connect(const std::string& server, const std::string& port)
1766 ip::tcp::resolver resolver(stream.get_io_service());
1767 ip::tcp::resolver::query query(server.c_str(), port.c_str());
1768 ip::tcp::resolver::iterator endpoint_iterator = resolver.resolve(query);
1769 ip::tcp::resolver::iterator end;
1770 boost::system::error_code error = asio::error::host_not_found;
1771 while (error && endpoint_iterator != end)
1773 stream.lowest_layer().close();
1774 stream.lowest_layer().connect(*endpoint_iterator++, error);
1782 bool fNeedHandshake;
1788 void ThreadRPCServer(void* parg)
1790 IMPLEMENT_RANDOMIZE_STACK(ThreadRPCServer(parg));
1793 vnThreadsRunning[4]++;
1794 ThreadRPCServer2(parg);
1795 vnThreadsRunning[4]--;
1797 catch (std::exception& e) {
1798 vnThreadsRunning[4]--;
1799 PrintException(&e, "ThreadRPCServer()");
1801 vnThreadsRunning[4]--;
1802 PrintException(NULL, "ThreadRPCServer()");
1804 printf("ThreadRPCServer exiting\n");
1807 void ThreadRPCServer2(void* parg)
1809 printf("ThreadRPCServer started\n");
1811 if (mapArgs["-rpcuser"] == "" && mapArgs["-rpcpassword"] == "")
1813 string strWhatAmI = "To use bitcoind";
1814 if (mapArgs.count("-server"))
1815 strWhatAmI = strprintf(_("To use the %s option"), "\"-server\"");
1816 else if (mapArgs.count("-daemon"))
1817 strWhatAmI = strprintf(_("To use the %s option"), "\"-daemon\"");
1819 _("Warning: %s, you must set rpcpassword=<password>\nin the configuration file: %s\n"
1820 "If the file does not exist, create it with owner-readable-only file permissions.\n"),
1822 GetConfigFile().c_str());
1823 CreateThread(Shutdown, NULL);
1827 bool fUseSSL = GetBoolArg("-rpcssl");
1828 asio::ip::address bindAddress = mapArgs.count("-rpcallowip") ? asio::ip::address_v4::any() : asio::ip::address_v4::loopback();
1830 asio::io_service io_service;
1831 ip::tcp::endpoint endpoint(bindAddress, GetArg("-rpcport", 8332));
1832 ip::tcp::acceptor acceptor(io_service, endpoint);
1834 acceptor.set_option(boost::asio::ip::tcp::acceptor::reuse_address(true));
1837 ssl::context context(io_service, ssl::context::sslv23);
1840 context.set_options(ssl::context::no_sslv2);
1841 filesystem::path certfile = GetArg("-rpcsslcertificatechainfile", "server.cert");
1842 if (!certfile.is_complete()) certfile = filesystem::path(GetDataDir()) / certfile;
1843 if (filesystem::exists(certfile)) context.use_certificate_chain_file(certfile.string().c_str());
1844 else printf("ThreadRPCServer ERROR: missing server certificate file %s\n", certfile.string().c_str());
1845 filesystem::path pkfile = GetArg("-rpcsslprivatekeyfile", "server.pem");
1846 if (!pkfile.is_complete()) pkfile = filesystem::path(GetDataDir()) / pkfile;
1847 if (filesystem::exists(pkfile)) context.use_private_key_file(pkfile.string().c_str(), ssl::context::pem);
1848 else printf("ThreadRPCServer ERROR: missing server private key file %s\n", pkfile.string().c_str());
1850 string ciphers = GetArg("-rpcsslciphers",
1851 "TLSv1+HIGH:!SSLv2:!aNULL:!eNULL:!AH:!3DES:@STRENGTH");
1852 SSL_CTX_set_cipher_list(context.impl(), ciphers.c_str());
1856 throw runtime_error("-rpcssl=1, but bitcoin compiled without full openssl libraries.");
1861 // Accept connection
1863 SSLStream sslStream(io_service, context);
1864 SSLIOStreamDevice d(sslStream, fUseSSL);
1865 iostreams::stream<SSLIOStreamDevice> stream(d);
1867 ip::tcp::iostream stream;
1870 ip::tcp::endpoint peer;
1871 vnThreadsRunning[4]--;
1873 acceptor.accept(sslStream.lowest_layer(), peer);
1875 acceptor.accept(*stream.rdbuf(), peer);
1877 vnThreadsRunning[4]++;
1881 // Restrict callers by IP
1882 if (!ClientAllowed(peer.address().to_string()))
1885 map<string, string> mapHeaders;
1888 boost::thread api_caller(ReadHTTP, boost::ref(stream), boost::ref(mapHeaders), boost::ref(strRequest));
1889 if (!api_caller.timed_join(boost::posix_time::seconds(GetArg("-rpctimeout", 30))))
1892 printf("ThreadRPCServer ReadHTTP timeout\n");
1896 // Check authorization
1897 if (mapHeaders.count("authorization") == 0)
1899 stream << HTTPReply(401, "") << std::flush;
1902 if (!HTTPAuthorized(mapHeaders))
1904 // Deter brute-forcing short passwords
1905 if (mapArgs["-rpcpassword"].size() < 15)
1908 stream << HTTPReply(401, "") << std::flush;
1909 printf("ThreadRPCServer incorrect password attempt\n");
1913 Value id = Value::null;
1918 if (!read_string(strRequest, valRequest) || valRequest.type() != obj_type)
1919 throw JSONRPCError(-32700, "Parse error");
1920 const Object& request = valRequest.get_obj();
1922 // Parse id now so errors from here on will have the id
1923 id = find_value(request, "id");
1926 Value valMethod = find_value(request, "method");
1927 if (valMethod.type() == null_type)
1928 throw JSONRPCError(-32600, "Missing method");
1929 if (valMethod.type() != str_type)
1930 throw JSONRPCError(-32600, "Method must be a string");
1931 string strMethod = valMethod.get_str();
1932 if (strMethod != "getwork")
1933 printf("ThreadRPCServer method=%s\n", strMethod.c_str());
1936 Value valParams = find_value(request, "params");
1938 if (valParams.type() == array_type)
1939 params = valParams.get_array();
1940 else if (valParams.type() == null_type)
1943 throw JSONRPCError(-32600, "Params must be an array");
1946 map<string, rpcfn_type>::iterator mi = mapCallTable.find(strMethod);
1947 if (mi == mapCallTable.end())
1948 throw JSONRPCError(-32601, "Method not found");
1950 // Observe safe mode
1951 string strWarning = GetWarnings("rpc");
1952 if (strWarning != "" && !GetBoolArg("-disablesafemode") && !setAllowInSafeMode.count(strMethod))
1953 throw JSONRPCError(-2, string("Safe mode: ") + strWarning);
1958 Value result = (*(*mi).second)(params, false);
1961 string strReply = JSONRPCReply(result, Value::null, id);
1962 stream << HTTPReply(200, strReply) << std::flush;
1964 catch (std::exception& e)
1966 ErrorReply(stream, JSONRPCError(-1, e.what()), id);
1969 catch (Object& objError)
1971 ErrorReply(stream, objError, id);
1973 catch (std::exception& e)
1975 ErrorReply(stream, JSONRPCError(-32700, e.what()), id);
1983 Object CallRPC(const string& strMethod, const Array& params)
1985 if (mapArgs["-rpcuser"] == "" && mapArgs["-rpcpassword"] == "")
1986 throw runtime_error(strprintf(
1987 _("You must set rpcpassword=<password> in the configuration file:\n%s\n"
1988 "If the file does not exist, create it with owner-readable-only file permissions."),
1989 GetConfigFile().c_str()));
1991 // Connect to localhost
1992 bool fUseSSL = GetBoolArg("-rpcssl");
1994 asio::io_service io_service;
1995 ssl::context context(io_service, ssl::context::sslv23);
1996 context.set_options(ssl::context::no_sslv2);
1997 SSLStream sslStream(io_service, context);
1998 SSLIOStreamDevice d(sslStream, fUseSSL);
1999 iostreams::stream<SSLIOStreamDevice> stream(d);
2000 if (!d.connect(GetArg("-rpcconnect", "127.0.0.1"), GetArg("-rpcport", "8332")))
2001 throw runtime_error("couldn't connect to server");
2004 throw runtime_error("-rpcssl=1, but bitcoin compiled without full openssl libraries.");
2006 ip::tcp::iostream stream(GetArg("-rpcconnect", "127.0.0.1"), GetArg("-rpcport", "8332"));
2008 throw runtime_error("couldn't connect to server");
2012 // HTTP basic authentication
2013 string strUserPass64 = EncodeBase64(mapArgs["-rpcuser"] + ":" + mapArgs["-rpcpassword"]);
2014 map<string, string> mapRequestHeaders;
2015 mapRequestHeaders["Authorization"] = string("Basic ") + strUserPass64;
2018 string strRequest = JSONRPCRequest(strMethod, params, 1);
2019 string strPost = HTTPPost(strRequest, mapRequestHeaders);
2020 stream << strPost << std::flush;
2023 map<string, string> mapHeaders;
2025 int nStatus = ReadHTTP(stream, mapHeaders, strReply);
2027 throw runtime_error("incorrect rpcuser or rpcpassword (authorization failed)");
2028 else if (nStatus >= 400 && nStatus != 400 && nStatus != 404 && nStatus != 500)
2029 throw runtime_error(strprintf("server returned HTTP error %d", nStatus));
2030 else if (strReply.empty())
2031 throw runtime_error("no response from server");
2035 if (!read_string(strReply, valReply))
2036 throw runtime_error("couldn't parse reply from server");
2037 const Object& reply = valReply.get_obj();
2039 throw runtime_error("expected reply to have result, error and id properties");
2047 template<typename T>
2048 void ConvertTo(Value& value)
2050 if (value.type() == str_type)
2052 // reinterpret string as unquoted json value
2054 if (!read_string(value.get_str(), value2))
2055 throw runtime_error("type mismatch");
2056 value = value2.get_value<T>();
2060 value = value.get_value<T>();
2064 int CommandLineRPC(int argc, char *argv[])
2071 while (argc > 1 && IsSwitchChar(argv[1][0]))
2079 throw runtime_error("too few parameters");
2080 string strMethod = argv[1];
2082 // Parameters default to strings
2084 for (int i = 2; i < argc; i++)
2085 params.push_back(argv[i]);
2086 int n = params.size();
2089 // Special case non-string parameter types
2091 if (strMethod == "setgenerate" && n > 0) ConvertTo<bool>(params[0]);
2092 if (strMethod == "setgenerate" && n > 1) ConvertTo<boost::int64_t>(params[1]);
2093 if (strMethod == "sendtoaddress" && n > 1) ConvertTo<double>(params[1]);
2094 if (strMethod == "settxfee" && n > 0) ConvertTo<double>(params[0]);
2095 if (strMethod == "getamountreceived" && n > 1) ConvertTo<boost::int64_t>(params[1]); // deprecated
2096 if (strMethod == "getreceivedbyaddress" && n > 1) ConvertTo<boost::int64_t>(params[1]);
2097 if (strMethod == "getreceivedbyaccount" && n > 1) ConvertTo<boost::int64_t>(params[1]);
2098 if (strMethod == "getreceivedbylabel" && n > 1) ConvertTo<boost::int64_t>(params[1]); // deprecated
2099 if (strMethod == "getallreceived" && n > 0) ConvertTo<boost::int64_t>(params[0]); // deprecated
2100 if (strMethod == "getallreceived" && n > 1) ConvertTo<bool>(params[1]);
2101 if (strMethod == "listreceivedbyaddress" && n > 0) ConvertTo<boost::int64_t>(params[0]);
2102 if (strMethod == "listreceivedbyaddress" && n > 1) ConvertTo<bool>(params[1]);
2103 if (strMethod == "listreceivedbyaccount" && n > 0) ConvertTo<boost::int64_t>(params[0]);
2104 if (strMethod == "listreceivedbyaccount" && n > 1) ConvertTo<bool>(params[1]);
2105 if (strMethod == "listreceivedbylabel" && n > 0) ConvertTo<boost::int64_t>(params[0]); // deprecated
2106 if (strMethod == "listreceivedbylabel" && n > 1) ConvertTo<bool>(params[1]); // deprecated
2107 if (strMethod == "getbalance" && n > 1) ConvertTo<boost::int64_t>(params[1]);
2108 if (strMethod == "move" && n > 2) ConvertTo<double>(params[2]);
2109 if (strMethod == "move" && n > 3) ConvertTo<boost::int64_t>(params[3]);
2110 if (strMethod == "sendfrom" && n > 2) ConvertTo<double>(params[2]);
2111 if (strMethod == "sendfrom" && n > 3) ConvertTo<boost::int64_t>(params[3]);
2112 if (strMethod == "listtransactions" && n > 1) ConvertTo<boost::int64_t>(params[1]);
2113 if (strMethod == "listtransactions" && n > 2) ConvertTo<boost::int64_t>(params[2]);
2114 if (strMethod == "listaccounts" && n > 0) ConvertTo<boost::int64_t>(params[0]);
2115 if (strMethod == "sendmany" && n > 1)
2117 string s = params[1].get_str();
2119 if (!read_string(s, v) || v.type() != obj_type)
2120 throw runtime_error("type mismatch");
2121 params[1] = v.get_obj();
2123 if (strMethod == "sendmany" && n > 2) ConvertTo<boost::int64_t>(params[2]);
2126 Object reply = CallRPC(strMethod, params);
2129 const Value& result = find_value(reply, "result");
2130 const Value& error = find_value(reply, "error");
2131 const Value& id = find_value(reply, "id");
2133 if (error.type() != null_type)
2136 strPrint = "error: " + write_string(error, false);
2137 int code = find_value(error.get_obj(), "code").get_int();
2143 if (result.type() == null_type)
2145 else if (result.type() == str_type)
2146 strPrint = result.get_str();
2148 strPrint = write_string(result, true);
2151 catch (std::exception& e)
2153 strPrint = string("error: ") + e.what();
2158 PrintException(NULL, "CommandLineRPC()");
2163 #if defined(__WXMSW__) && defined(GUI)
2164 // Windows GUI apps can't print to command line,
2165 // so settle for a message box yuck
2166 MyMessageBox(strPrint, "Bitcoin", wxOK);
2168 fprintf((nRet == 0 ? stdout : stderr), "%s\n", strPrint.c_str());
2178 int main(int argc, char *argv[])
2181 // Turn off microsoft heap dump noise
2182 _CrtSetReportMode(_CRT_WARN, _CRTDBG_MODE_FILE);
2183 _CrtSetReportFile(_CRT_WARN, CreateFile("NUL", GENERIC_WRITE, 0, NULL, OPEN_EXISTING, 0, 0));
2185 setbuf(stdin, NULL);
2186 setbuf(stdout, NULL);
2187 setbuf(stderr, NULL);
2191 if (argc >= 2 && string(argv[1]) == "-server")
2193 printf("server ready\n");
2194 ThreadRPCServer(NULL);
2198 return CommandLineRPC(argc, argv);
2201 catch (std::exception& e) {
2202 PrintException(&e, "main()");
2204 PrintException(NULL, "main()");