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"
11 #include <boost/asio.hpp>
12 #include <boost/iostreams/concepts.hpp>
13 #include <boost/iostreams/stream.hpp>
14 #include <boost/algorithm/string.hpp>
16 #include <boost/asio/ssl.hpp>
17 #include <boost/filesystem.hpp>
18 #include <boost/filesystem/fstream.hpp>
19 typedef boost::asio::ssl::stream<boost::asio::ip::tcp::socket> SSLStream;
21 #include "json/json_spirit_reader_template.h"
22 #include "json/json_spirit_writer_template.h"
23 #include "json/json_spirit_utils.h"
24 #define printf OutputDebugStringF
25 // MinGW 3.4.5 gets "fatal error: had to relocate PCH" if the json headers are
26 // precompiled in headers.h. The problem might be when the pch file goes over
27 // a certain size around 145MB. If we need access to json_spirit outside this
28 // file, we could use the compiled json_spirit option.
31 using namespace boost;
32 using namespace boost::asio;
33 using namespace json_spirit;
35 void ThreadRPCServer2(void* parg);
36 typedef Value(*rpcfn_type)(const Array& params, bool fHelp);
37 extern map<string, rpcfn_type> mapCallTable;
40 Object JSONRPCError(int code, const string& message)
43 error.push_back(Pair("code", code));
44 error.push_back(Pair("message", message));
49 void PrintConsole(const char* format, ...)
52 int limit = sizeof(buffer);
54 va_start(arg_ptr, format);
55 int ret = _vsnprintf(buffer, limit, format, arg_ptr);
57 if (ret < 0 || ret >= limit)
63 #if defined(__WXMSW__) && defined(GUI)
64 MyMessageBox(buffer, "Bitcoin", wxOK | wxICON_EXCLAMATION);
66 fprintf(stdout, "%s", buffer);
71 int64 AmountFromValue(const Value& value)
73 double dAmount = value.get_real();
74 if (dAmount <= 0.0 || dAmount > MAX_MONEY)
75 throw JSONRPCError(-3, "Invalid amount");
76 int64 nAmount = roundint64(dAmount * COIN);
77 if (!MoneyRange(nAmount))
78 throw JSONRPCError(-3, "Invalid amount");
82 Value ValueFromAmount(int64 amount)
84 return (double)amount / (double)COIN;
87 void WalletTxToJSON(const CWalletTx& wtx, Object& entry)
89 entry.push_back(Pair("confirmations", wtx.GetDepthInMainChain()));
90 entry.push_back(Pair("txid", wtx.GetHash().GetHex()));
91 entry.push_back(Pair("time", (boost::int64_t)wtx.GetTxTime()));
92 BOOST_FOREACH(const PAIRTYPE(string,string)& item, wtx.mapValue)
93 entry.push_back(Pair(item.first, item.second));
96 string AccountFromValue(const Value& value)
98 string strAccount = value.get_str();
99 if (strAccount == "*")
100 throw JSONRPCError(-11, "Invalid account name");
107 /// Note: This interface may still be subject to change.
111 Value help(const Array& params, bool fHelp)
113 if (fHelp || params.size() > 1)
116 "List commands, or get help for a command.");
119 if (params.size() > 0)
120 strCommand = params[0].get_str();
123 set<rpcfn_type> setDone;
124 for (map<string, rpcfn_type>::iterator mi = mapCallTable.begin(); mi != mapCallTable.end(); ++mi)
126 string strMethod = (*mi).first;
127 // We already filter duplicates, but these deprecated screw up the sort order
128 if (strMethod == "getamountreceived" ||
129 strMethod == "getallreceived" ||
130 (strMethod.find("label") != string::npos))
132 if (strCommand != "" && strMethod != strCommand)
137 rpcfn_type pfn = (*mi).second;
138 if (setDone.insert(pfn).second)
139 (*pfn)(params, true);
141 catch (std::exception& e)
143 // Help text is returned in an exception
144 string strHelp = string(e.what());
145 if (strCommand == "")
146 if (strHelp.find('\n') != -1)
147 strHelp = strHelp.substr(0, strHelp.find('\n'));
148 strRet += strHelp + "\n";
152 strRet = strprintf("help: unknown command: %s\n", strCommand.c_str());
153 strRet = strRet.substr(0,strRet.size()-1);
158 Value stop(const Array& params, bool fHelp)
160 if (fHelp || params.size() != 0)
163 "Stop bitcoin server.");
165 // Shutdown will take long enough that the response should get back
166 CreateThread(Shutdown, NULL);
167 return "bitcoin server stopping";
171 Value getblockcount(const Array& params, bool fHelp)
173 if (fHelp || params.size() != 0)
176 "Returns the number of blocks in the longest block chain.");
182 Value getblocknumber(const Array& params, bool fHelp)
184 if (fHelp || params.size() != 0)
187 "Returns the block number of the latest block in the longest block chain.");
193 Value getconnectioncount(const Array& params, bool fHelp)
195 if (fHelp || params.size() != 0)
197 "getconnectioncount\n"
198 "Returns the number of connections to other nodes.");
200 return (int)vNodes.size();
204 double GetDifficulty()
206 // Floating point number that is a multiple of the minimum difficulty,
207 // minimum difficulty = 1.0.
209 if (pindexBest == NULL)
211 int nShift = (pindexBest->nBits >> 24) & 0xff;
214 (double)0x0000ffff / (double)(pindexBest->nBits & 0x00ffffff);
230 Value getdifficulty(const Array& params, bool fHelp)
232 if (fHelp || params.size() != 0)
235 "Returns the proof-of-work difficulty as a multiple of the minimum difficulty.");
237 return GetDifficulty();
241 Value getgenerate(const Array& params, bool fHelp)
243 if (fHelp || params.size() != 0)
246 "Returns true or false.");
248 return (bool)fGenerateBitcoins;
252 Value setgenerate(const Array& params, bool fHelp)
254 if (fHelp || params.size() < 1 || params.size() > 2)
256 "setgenerate <generate> [genproclimit]\n"
257 "<generate> is true or false to turn generation on or off.\n"
258 "Generation is limited to [genproclimit] processors, -1 is unlimited.");
260 bool fGenerate = true;
261 if (params.size() > 0)
262 fGenerate = params[0].get_bool();
264 if (params.size() > 1)
266 int nGenProcLimit = params[1].get_int();
267 fLimitProcessors = (nGenProcLimit != -1);
268 WriteSetting("fLimitProcessors", fLimitProcessors);
269 if (nGenProcLimit != -1)
270 WriteSetting("nLimitProcessors", nLimitProcessors = nGenProcLimit);
271 if (nGenProcLimit == 0)
275 GenerateBitcoins(fGenerate, pwalletMain);
280 Value gethashespersec(const Array& params, bool fHelp)
282 if (fHelp || params.size() != 0)
285 "Returns a recent hashes per second performance measurement while generating.");
287 if (GetTimeMillis() - nHPSTimerStart > 8000)
288 return (boost::int64_t)0;
289 return (boost::int64_t)dHashesPerSec;
293 Value getinfo(const Array& params, bool fHelp)
295 if (fHelp || params.size() != 0)
298 "Returns an object containing various state info.");
301 obj.push_back(Pair("version", (int)VERSION));
302 obj.push_back(Pair("balance", ValueFromAmount(pwalletMain->GetBalance())));
303 obj.push_back(Pair("blocks", (int)nBestHeight));
304 obj.push_back(Pair("connections", (int)vNodes.size()));
305 obj.push_back(Pair("proxy", (fUseProxy ? addrProxy.ToStringIPPort() : string())));
306 obj.push_back(Pair("generate", (bool)fGenerateBitcoins));
307 obj.push_back(Pair("genproclimit", (int)(fLimitProcessors ? nLimitProcessors : -1)));
308 obj.push_back(Pair("difficulty", (double)GetDifficulty()));
309 obj.push_back(Pair("hashespersec", gethashespersec(params, false)));
310 obj.push_back(Pair("testnet", fTestNet));
311 obj.push_back(Pair("keypoololdest", (boost::int64_t)pwalletMain->GetOldestKeyPoolTime()));
312 obj.push_back(Pair("paytxfee", ValueFromAmount(nTransactionFee)));
313 obj.push_back(Pair("errors", GetWarnings("statusbar")));
318 Value getnewaddress(const Array& params, bool fHelp)
320 if (fHelp || params.size() > 1)
322 "getnewaddress [account]\n"
323 "Returns a new bitcoin address for receiving payments. "
324 "If [account] is specified (recommended), it is added to the address book "
325 "so payments received with the address will be credited to [account].");
327 // Parse the account first so we don't generate a key if there's an error
329 if (params.size() > 0)
330 strAccount = AccountFromValue(params[0]);
332 // Generate a new key that is added to wallet
333 string strAddress = PubKeyToAddress(pwalletMain->GetKeyFromKeyPool());
335 // This could be done in the same main CS as GetKeyFromKeyPool.
336 CRITICAL_BLOCK(pwalletMain->cs_mapAddressBook)
337 pwalletMain->SetAddressBookName(strAddress, strAccount);
343 // requires cs_main, cs_mapWallet, cs_mapAddressBook locks
344 string GetAccountAddress(string strAccount, bool bForceNew=false)
348 CWalletDB walletdb(pwalletMain->strWalletFile);
352 walletdb.ReadAccount(strAccount, account);
354 // Check if the current key has been used
355 if (!account.vchPubKey.empty())
357 CScript scriptPubKey;
358 scriptPubKey.SetBitcoinAddress(account.vchPubKey);
359 for (map<uint256, CWalletTx>::iterator it = pwalletMain->mapWallet.begin();
360 it != pwalletMain->mapWallet.end() && !account.vchPubKey.empty();
363 const CWalletTx& wtx = (*it).second;
364 BOOST_FOREACH(const CTxOut& txout, wtx.vout)
365 if (txout.scriptPubKey == scriptPubKey)
366 account.vchPubKey.clear();
370 // Generate a new key
371 if (account.vchPubKey.empty() || bForceNew)
373 account.vchPubKey = pwalletMain->GetKeyFromKeyPool();
374 string strAddress = PubKeyToAddress(account.vchPubKey);
375 pwalletMain->SetAddressBookName(strAddress, strAccount);
376 walletdb.WriteAccount(strAccount, account);
379 walletdb.TxnCommit();
380 strAddress = PubKeyToAddress(account.vchPubKey);
385 Value getaccountaddress(const Array& params, bool fHelp)
387 if (fHelp || params.size() != 1)
389 "getaccountaddress <account>\n"
390 "Returns the current bitcoin address for receiving payments to this account.");
392 // Parse the account first so we don't generate a key if there's an error
393 string strAccount = AccountFromValue(params[0]);
397 CRITICAL_BLOCK(cs_main)
398 CRITICAL_BLOCK(pwalletMain->cs_mapWallet)
399 CRITICAL_BLOCK(pwalletMain->cs_mapAddressBook)
401 ret = GetAccountAddress(strAccount);
409 Value setaccount(const Array& params, bool fHelp)
411 if (fHelp || params.size() < 1 || params.size() > 2)
413 "setaccount <bitcoinaddress> <account>\n"
414 "Sets the account associated with the given address.");
416 string strAddress = params[0].get_str();
418 bool isValid = AddressToHash160(strAddress, hash160);
420 throw JSONRPCError(-5, "Invalid bitcoin address");
424 if (params.size() > 1)
425 strAccount = AccountFromValue(params[1]);
427 // Detect when changing the account of an address that is the 'unused current key' of another account:
428 CRITICAL_BLOCK(cs_main)
429 CRITICAL_BLOCK(pwalletMain->cs_mapWallet)
430 CRITICAL_BLOCK(pwalletMain->cs_mapAddressBook)
432 if (pwalletMain->mapAddressBook.count(strAddress))
434 string strOldAccount = pwalletMain->mapAddressBook[strAddress];
435 if (strAddress == GetAccountAddress(strOldAccount))
436 GetAccountAddress(strOldAccount, true);
439 pwalletMain->SetAddressBookName(strAddress, strAccount);
446 Value getaccount(const Array& params, bool fHelp)
448 if (fHelp || params.size() != 1)
450 "getaccount <bitcoinaddress>\n"
451 "Returns the account associated with the given address.");
453 string strAddress = params[0].get_str();
456 CRITICAL_BLOCK(pwalletMain->cs_mapAddressBook)
458 map<string, string>::iterator mi = pwalletMain->mapAddressBook.find(strAddress);
459 if (mi != pwalletMain->mapAddressBook.end() && !(*mi).second.empty())
460 strAccount = (*mi).second;
466 Value getaddressesbyaccount(const Array& params, bool fHelp)
468 if (fHelp || params.size() != 1)
470 "getaddressesbyaccount <account>\n"
471 "Returns the list of addresses for the given account.");
473 string strAccount = AccountFromValue(params[0]);
475 // Find all addresses that have the given account
477 CRITICAL_BLOCK(pwalletMain->cs_mapAddressBook)
479 BOOST_FOREACH(const PAIRTYPE(string, string)& item, pwalletMain->mapAddressBook)
481 const string& strAddress = item.first;
482 const string& strName = item.second;
483 if (strName == strAccount)
485 // We're only adding valid bitcoin addresses and not ip addresses
486 CScript scriptPubKey;
487 if (scriptPubKey.SetBitcoinAddress(strAddress))
488 ret.push_back(strAddress);
495 Value settxfee(const Array& params, bool fHelp)
497 if (fHelp || params.size() < 1 || params.size() > 1)
499 "settxfee <amount>\n"
500 "<amount> is a real and is rounded to the nearest 0.0001\n"
501 "Minimum and default transaction fee is 1 coin");
504 int64 nAmount = MIN_TX_FEE;
505 if (params[0].get_real() != 0.0) // rejects 0.0 amounts
506 nAmount = max(nAmount, AmountFromValue(params[0]));
508 nTransactionFee = nAmount;
512 Value sendtoaddress(const Array& params, bool fHelp)
514 if (fHelp || params.size() < 2 || params.size() > 4)
516 "sendtoaddress <bitcoinaddress> <amount> [comment] [comment-to]\n"
517 "<amount> is a real and is rounded to the nearest 0.00000001");
519 string strAddress = params[0].get_str();
522 int64 nAmount = AmountFromValue(params[1]);
526 if (params.size() > 2 && params[2].type() != null_type && !params[2].get_str().empty())
527 wtx.mapValue["comment"] = params[2].get_str();
528 if (params.size() > 3 && params[3].type() != null_type && !params[3].get_str().empty())
529 wtx.mapValue["to"] = params[3].get_str();
531 CRITICAL_BLOCK(cs_main)
533 string strError = pwalletMain->SendMoneyToBitcoinAddress(strAddress, nAmount, wtx);
535 throw JSONRPCError(-4, strError);
538 return wtx.GetHash().GetHex();
542 Value getreceivedbyaddress(const Array& params, bool fHelp)
544 if (fHelp || params.size() < 1 || params.size() > 2)
546 "getreceivedbyaddress <bitcoinaddress> [minconf=1]\n"
547 "Returns the total amount received by <bitcoinaddress> in transactions with at least [minconf] confirmations.");
550 string strAddress = params[0].get_str();
551 CScript scriptPubKey;
552 if (!scriptPubKey.SetBitcoinAddress(strAddress))
553 throw JSONRPCError(-5, "Invalid bitcoin address");
554 if (!IsMine(*pwalletMain,scriptPubKey))
557 // Minimum confirmations
559 if (params.size() > 1)
560 nMinDepth = params[1].get_int();
564 CRITICAL_BLOCK(pwalletMain->cs_mapWallet)
566 for (map<uint256, CWalletTx>::iterator it = pwalletMain->mapWallet.begin(); it != pwalletMain->mapWallet.end(); ++it)
568 const CWalletTx& wtx = (*it).second;
569 if (wtx.IsCoinBase() || !wtx.IsFinal())
572 BOOST_FOREACH(const CTxOut& txout, wtx.vout)
573 if (txout.scriptPubKey == scriptPubKey)
574 if (wtx.GetDepthInMainChain() >= nMinDepth)
575 nAmount += txout.nValue;
579 return ValueFromAmount(nAmount);
583 void GetAccountPubKeys(string strAccount, set<CScript>& setPubKey)
585 CRITICAL_BLOCK(pwalletMain->cs_mapAddressBook)
587 BOOST_FOREACH(const PAIRTYPE(string, string)& item, pwalletMain->mapAddressBook)
589 const string& strAddress = item.first;
590 const string& strName = item.second;
591 if (strName == strAccount)
593 // We're only counting our own valid bitcoin addresses and not ip addresses
594 CScript scriptPubKey;
595 if (scriptPubKey.SetBitcoinAddress(strAddress))
596 if (IsMine(*pwalletMain,scriptPubKey))
597 setPubKey.insert(scriptPubKey);
604 Value getreceivedbyaccount(const Array& params, bool fHelp)
606 if (fHelp || params.size() < 1 || params.size() > 2)
608 "getreceivedbyaccount <account> [minconf=1]\n"
609 "Returns the total amount received by addresses with <account> in transactions with at least [minconf] confirmations.");
611 // Minimum confirmations
613 if (params.size() > 1)
614 nMinDepth = params[1].get_int();
616 // Get the set of pub keys that have the label
617 string strAccount = AccountFromValue(params[0]);
618 set<CScript> setPubKey;
619 GetAccountPubKeys(strAccount, setPubKey);
623 CRITICAL_BLOCK(pwalletMain->cs_mapWallet)
625 for (map<uint256, CWalletTx>::iterator it = pwalletMain->mapWallet.begin(); it != pwalletMain->mapWallet.end(); ++it)
627 const CWalletTx& wtx = (*it).second;
628 if (wtx.IsCoinBase() || !wtx.IsFinal())
631 BOOST_FOREACH(const CTxOut& txout, wtx.vout)
632 if (setPubKey.count(txout.scriptPubKey))
633 if (wtx.GetDepthInMainChain() >= nMinDepth)
634 nAmount += txout.nValue;
638 return (double)nAmount / (double)COIN;
642 int64 GetAccountBalance(CWalletDB& walletdb, const string& strAccount, int nMinDepth)
645 CRITICAL_BLOCK(pwalletMain->cs_mapWallet)
647 // Tally wallet transactions
648 for (map<uint256, CWalletTx>::iterator it = pwalletMain->mapWallet.begin(); it != pwalletMain->mapWallet.end(); ++it)
650 const CWalletTx& wtx = (*it).second;
654 int64 nGenerated, nReceived, nSent, nFee;
655 wtx.GetAccountAmounts(strAccount, nGenerated, nReceived, nSent, nFee);
657 if (nReceived != 0 && wtx.GetDepthInMainChain() >= nMinDepth)
658 nBalance += nReceived;
659 nBalance += nGenerated - nSent - nFee;
662 // Tally internal accounting entries
663 nBalance += walletdb.GetAccountCreditDebit(strAccount);
669 int64 GetAccountBalance(const string& strAccount, int nMinDepth)
671 CWalletDB walletdb(pwalletMain->strWalletFile);
672 return GetAccountBalance(walletdb, strAccount, nMinDepth);
676 Value getbalance(const Array& params, bool fHelp)
678 if (fHelp || params.size() < 0 || params.size() > 2)
680 "getbalance [account] [minconf=1]\n"
681 "If [account] is not specified, returns the server's total available balance.\n"
682 "If [account] is specified, returns the balance in the account.");
684 if (params.size() == 0)
685 return ValueFromAmount(pwalletMain->GetBalance());
688 if (params.size() > 1)
689 nMinDepth = params[1].get_int();
691 if (params[0].get_str() == "*") {
692 // Calculate total balance a different way from GetBalance()
693 // (GetBalance() sums up all unspent TxOuts)
694 // getbalance and getbalance '*' should always return the same number.
696 for (map<uint256, CWalletTx>::iterator it = pwalletMain->mapWallet.begin(); it != pwalletMain->mapWallet.end(); ++it)
698 const CWalletTx& wtx = (*it).second;
702 int64 allGeneratedImmature, allGeneratedMature, allFee;
703 allGeneratedImmature = allGeneratedMature = allFee = 0;
704 string strSentAccount;
705 list<pair<string, int64> > listReceived;
706 list<pair<string, int64> > listSent;
707 wtx.GetAmounts(allGeneratedImmature, allGeneratedMature, listReceived, listSent, allFee, strSentAccount);
708 if (wtx.GetDepthInMainChain() >= nMinDepth)
709 BOOST_FOREACH(const PAIRTYPE(string,int64)& r, listReceived)
710 nBalance += r.second;
711 BOOST_FOREACH(const PAIRTYPE(string,int64)& r, listSent)
712 nBalance -= r.second;
714 nBalance += allGeneratedMature;
716 return ValueFromAmount(nBalance);
719 string strAccount = AccountFromValue(params[0]);
721 int64 nBalance = GetAccountBalance(strAccount, nMinDepth);
723 return ValueFromAmount(nBalance);
727 Value movecmd(const Array& params, bool fHelp)
729 if (fHelp || params.size() < 3 || params.size() > 5)
731 "move <fromaccount> <toaccount> <amount> [minconf=1] [comment]\n"
732 "Move from one account in your wallet to another.");
734 string strFrom = AccountFromValue(params[0]);
735 string strTo = AccountFromValue(params[1]);
736 int64 nAmount = AmountFromValue(params[2]);
738 if (params.size() > 3)
739 nMinDepth = params[3].get_int();
741 if (params.size() > 4)
742 strComment = params[4].get_str();
744 CRITICAL_BLOCK(pwalletMain->cs_mapWallet)
746 CWalletDB walletdb(pwalletMain->strWalletFile);
749 int64 nNow = GetAdjustedTime();
752 CAccountingEntry debit;
753 debit.strAccount = strFrom;
754 debit.nCreditDebit = -nAmount;
756 debit.strOtherAccount = strTo;
757 debit.strComment = strComment;
758 walletdb.WriteAccountingEntry(debit);
761 CAccountingEntry credit;
762 credit.strAccount = strTo;
763 credit.nCreditDebit = nAmount;
765 credit.strOtherAccount = strFrom;
766 credit.strComment = strComment;
767 walletdb.WriteAccountingEntry(credit);
769 walletdb.TxnCommit();
775 Value sendfrom(const Array& params, bool fHelp)
777 if (fHelp || params.size() < 3 || params.size() > 6)
779 "sendfrom <fromaccount> <tobitcoinaddress> <amount> [minconf=1] [comment] [comment-to]\n"
780 "<amount> is a real and is rounded to the nearest 0.00000001");
782 string strAccount = AccountFromValue(params[0]);
783 string strAddress = params[1].get_str();
784 int64 nAmount = AmountFromValue(params[2]);
786 if (params.size() > 3)
787 nMinDepth = params[3].get_int();
790 wtx.strFromAccount = strAccount;
791 if (params.size() > 4 && params[4].type() != null_type && !params[4].get_str().empty())
792 wtx.mapValue["comment"] = params[4].get_str();
793 if (params.size() > 5 && params[5].type() != null_type && !params[5].get_str().empty())
794 wtx.mapValue["to"] = params[5].get_str();
796 CRITICAL_BLOCK(cs_main)
797 CRITICAL_BLOCK(pwalletMain->cs_mapWallet)
800 int64 nBalance = GetAccountBalance(strAccount, nMinDepth);
801 if (nAmount > nBalance)
802 throw JSONRPCError(-6, "Account has insufficient funds");
805 string strError = pwalletMain->SendMoneyToBitcoinAddress(strAddress, nAmount, wtx);
807 throw JSONRPCError(-4, strError);
810 return wtx.GetHash().GetHex();
813 Value sendmany(const Array& params, bool fHelp)
815 if (fHelp || params.size() < 2 || params.size() > 4)
817 "sendmany <fromaccount> {address:amount,...} [minconf=1] [comment]\n"
818 "amounts are double-precision floating point numbers");
820 string strAccount = AccountFromValue(params[0]);
821 Object sendTo = params[1].get_obj();
823 if (params.size() > 2)
824 nMinDepth = params[2].get_int();
827 wtx.strFromAccount = strAccount;
828 if (params.size() > 3 && params[3].type() != null_type && !params[3].get_str().empty())
829 wtx.mapValue["comment"] = params[3].get_str();
831 set<string> setAddress;
832 vector<pair<CScript, int64> > vecSend;
834 int64 totalAmount = 0;
835 BOOST_FOREACH(const Pair& s, sendTo)
838 string strAddress = s.name_;
840 if (setAddress.count(strAddress))
841 throw JSONRPCError(-8, string("Invalid parameter, duplicated address: ")+strAddress);
842 setAddress.insert(strAddress);
844 CScript scriptPubKey;
845 if (!scriptPubKey.SetBitcoinAddress(strAddress))
846 throw JSONRPCError(-5, string("Invalid bitcoin address:")+strAddress);
847 int64 nAmount = AmountFromValue(s.value_);
848 totalAmount += nAmount;
850 vecSend.push_back(make_pair(scriptPubKey, nAmount));
853 CRITICAL_BLOCK(cs_main)
854 CRITICAL_BLOCK(pwalletMain->cs_mapWallet)
857 int64 nBalance = GetAccountBalance(strAccount, nMinDepth);
858 if (totalAmount > nBalance)
859 throw JSONRPCError(-6, "Account has insufficient funds");
862 CReserveKey keyChange(pwalletMain);
863 int64 nFeeRequired = 0;
864 bool fCreated = pwalletMain->CreateTransaction(vecSend, wtx, keyChange, nFeeRequired);
867 if (totalAmount + nFeeRequired > pwalletMain->GetBalance())
868 throw JSONRPCError(-6, "Insufficient funds");
869 throw JSONRPCError(-4, "Transaction creation failed");
871 if (!pwalletMain->CommitTransaction(wtx, keyChange))
872 throw JSONRPCError(-4, "Transaction commit failed");
875 return wtx.GetHash().GetHex();
890 Value ListReceived(const Array& params, bool fByAccounts)
892 // Minimum confirmations
894 if (params.size() > 0)
895 nMinDepth = params[0].get_int();
897 // Whether to include empty accounts
898 bool fIncludeEmpty = false;
899 if (params.size() > 1)
900 fIncludeEmpty = params[1].get_bool();
903 map<uint160, tallyitem> mapTally;
904 CRITICAL_BLOCK(pwalletMain->cs_mapWallet)
906 for (map<uint256, CWalletTx>::iterator it = pwalletMain->mapWallet.begin(); it != pwalletMain->mapWallet.end(); ++it)
908 const CWalletTx& wtx = (*it).second;
909 if (wtx.IsCoinBase() || !wtx.IsFinal())
912 int nDepth = wtx.GetDepthInMainChain();
913 if (nDepth < nMinDepth)
916 BOOST_FOREACH(const CTxOut& txout, wtx.vout)
918 // Only counting our own bitcoin addresses and not ip addresses
919 uint160 hash160 = txout.scriptPubKey.GetBitcoinAddressHash160();
920 if (hash160 == 0 || !mapPubKeys.count(hash160)) // IsMine
923 tallyitem& item = mapTally[hash160];
924 item.nAmount += txout.nValue;
925 item.nConf = min(item.nConf, nDepth);
932 map<string, tallyitem> mapAccountTally;
933 CRITICAL_BLOCK(pwalletMain->cs_mapAddressBook)
935 BOOST_FOREACH(const PAIRTYPE(string, string)& item, pwalletMain->mapAddressBook)
937 const string& strAddress = item.first;
938 const string& strAccount = item.second;
940 if (!AddressToHash160(strAddress, hash160))
942 map<uint160, tallyitem>::iterator it = mapTally.find(hash160);
943 if (it == mapTally.end() && !fIncludeEmpty)
948 if (it != mapTally.end())
950 nAmount = (*it).second.nAmount;
951 nConf = (*it).second.nConf;
956 tallyitem& item = mapAccountTally[strAccount];
957 item.nAmount += nAmount;
958 item.nConf = min(item.nConf, nConf);
963 obj.push_back(Pair("address", strAddress));
964 obj.push_back(Pair("account", strAccount));
965 obj.push_back(Pair("label", strAccount)); // deprecated
966 obj.push_back(Pair("amount", ValueFromAmount(nAmount)));
967 obj.push_back(Pair("confirmations", (nConf == INT_MAX ? 0 : nConf)));
975 for (map<string, tallyitem>::iterator it = mapAccountTally.begin(); it != mapAccountTally.end(); ++it)
977 int64 nAmount = (*it).second.nAmount;
978 int nConf = (*it).second.nConf;
980 obj.push_back(Pair("account", (*it).first));
981 obj.push_back(Pair("label", (*it).first)); // deprecated
982 obj.push_back(Pair("amount", ValueFromAmount(nAmount)));
983 obj.push_back(Pair("confirmations", (nConf == INT_MAX ? 0 : nConf)));
991 Value listreceivedbyaddress(const Array& params, bool fHelp)
993 if (fHelp || params.size() > 2)
995 "listreceivedbyaddress [minconf=1] [includeempty=false]\n"
996 "[minconf] is the minimum number of confirmations before payments are included.\n"
997 "[includeempty] whether to include addresses that haven't received any payments.\n"
998 "Returns an array of objects containing:\n"
999 " \"address\" : receiving address\n"
1000 " \"account\" : the account of the receiving address\n"
1001 " \"amount\" : total amount received by the address\n"
1002 " \"confirmations\" : number of confirmations of the most recent transaction included");
1004 return ListReceived(params, false);
1007 Value listreceivedbyaccount(const Array& params, bool fHelp)
1009 if (fHelp || params.size() > 2)
1010 throw runtime_error(
1011 "listreceivedbyaccount [minconf=1] [includeempty=false]\n"
1012 "[minconf] is the minimum number of confirmations before payments are included.\n"
1013 "[includeempty] whether to include accounts that haven't received any payments.\n"
1014 "Returns an array of objects containing:\n"
1015 " \"account\" : the account of the receiving addresses\n"
1016 " \"amount\" : total amount received by addresses with this account\n"
1017 " \"confirmations\" : number of confirmations of the most recent transaction included");
1019 return ListReceived(params, true);
1022 void ListTransactions(const CWalletTx& wtx, const string& strAccount, int nMinDepth, bool fLong, Array& ret)
1024 int64 nGeneratedImmature, nGeneratedMature, nFee;
1025 string strSentAccount;
1026 list<pair<string, int64> > listReceived;
1027 list<pair<string, int64> > listSent;
1028 wtx.GetAmounts(nGeneratedImmature, nGeneratedMature, listReceived, listSent, nFee, strSentAccount);
1030 bool fAllAccounts = (strAccount == string("*"));
1032 // Generated blocks assigned to account ""
1033 if ((nGeneratedMature+nGeneratedImmature) != 0 && (fAllAccounts || strAccount == ""))
1036 entry.push_back(Pair("account", string("")));
1037 if (nGeneratedImmature)
1039 entry.push_back(Pair("category", wtx.GetDepthInMainChain() ? "immature" : "orphan"));
1040 entry.push_back(Pair("amount", ValueFromAmount(nGeneratedImmature)));
1044 entry.push_back(Pair("category", "generate"));
1045 entry.push_back(Pair("amount", ValueFromAmount(nGeneratedMature)));
1048 WalletTxToJSON(wtx, entry);
1049 ret.push_back(entry);
1053 if ((!listSent.empty() || nFee != 0) && (fAllAccounts || strAccount == strSentAccount))
1055 BOOST_FOREACH(const PAIRTYPE(string, int64)& s, listSent)
1058 entry.push_back(Pair("account", strSentAccount));
1059 entry.push_back(Pair("address", s.first));
1060 entry.push_back(Pair("category", "send"));
1061 entry.push_back(Pair("amount", ValueFromAmount(-s.second)));
1062 entry.push_back(Pair("fee", ValueFromAmount(-nFee)));
1064 WalletTxToJSON(wtx, entry);
1065 ret.push_back(entry);
1070 if (listReceived.size() > 0 && wtx.GetDepthInMainChain() >= nMinDepth)
1071 CRITICAL_BLOCK(pwalletMain->cs_mapAddressBook)
1073 BOOST_FOREACH(const PAIRTYPE(string, int64)& r, listReceived)
1076 if (pwalletMain->mapAddressBook.count(r.first))
1077 account = pwalletMain->mapAddressBook[r.first];
1078 if (fAllAccounts || (account == strAccount))
1081 entry.push_back(Pair("account", account));
1082 entry.push_back(Pair("address", r.first));
1083 entry.push_back(Pair("category", "receive"));
1084 entry.push_back(Pair("amount", ValueFromAmount(r.second)));
1086 WalletTxToJSON(wtx, entry);
1087 ret.push_back(entry);
1094 void AcentryToJSON(const CAccountingEntry& acentry, const string& strAccount, Array& ret)
1096 bool fAllAccounts = (strAccount == string("*"));
1098 if (fAllAccounts || acentry.strAccount == strAccount)
1101 entry.push_back(Pair("account", acentry.strAccount));
1102 entry.push_back(Pair("category", "move"));
1103 entry.push_back(Pair("time", (boost::int64_t)acentry.nTime));
1104 entry.push_back(Pair("amount", ValueFromAmount(acentry.nCreditDebit)));
1105 entry.push_back(Pair("otheraccount", acentry.strOtherAccount));
1106 entry.push_back(Pair("comment", acentry.strComment));
1107 ret.push_back(entry);
1111 Value listtransactions(const Array& params, bool fHelp)
1113 if (fHelp || params.size() > 3)
1114 throw runtime_error(
1115 "listtransactions [account] [count=10] [from=0]\n"
1116 "Returns up to [count] most recent transactions skipping the first [from] transactions for account [account].");
1118 string strAccount = "*";
1119 if (params.size() > 0)
1120 strAccount = params[0].get_str();
1122 if (params.size() > 1)
1123 nCount = params[1].get_int();
1125 if (params.size() > 2)
1126 nFrom = params[2].get_int();
1129 CWalletDB walletdb(pwalletMain->strWalletFile);
1131 CRITICAL_BLOCK(pwalletMain->cs_mapWallet)
1133 // Firs: get all CWalletTx and CAccountingEntry into a sorted-by-time multimap:
1134 typedef pair<CWalletTx*, CAccountingEntry*> TxPair;
1135 typedef multimap<int64, TxPair > TxItems;
1138 for (map<uint256, CWalletTx>::iterator it = pwalletMain->mapWallet.begin(); it != pwalletMain->mapWallet.end(); ++it)
1140 CWalletTx* wtx = &((*it).second);
1141 txByTime.insert(make_pair(wtx->GetTxTime(), TxPair(wtx, (CAccountingEntry*)0)));
1143 list<CAccountingEntry> acentries;
1144 walletdb.ListAccountCreditDebit(strAccount, acentries);
1145 BOOST_FOREACH(CAccountingEntry& entry, acentries)
1147 txByTime.insert(make_pair(entry.nTime, TxPair((CWalletTx*)0, &entry)));
1150 // Now: iterate backwards until we have nCount items to return:
1151 TxItems::reverse_iterator it = txByTime.rbegin();
1152 for (std::advance(it, nFrom); it != txByTime.rend(); ++it)
1154 CWalletTx *const pwtx = (*it).second.first;
1156 ListTransactions(*pwtx, strAccount, 0, true, ret);
1157 CAccountingEntry *const pacentry = (*it).second.second;
1159 AcentryToJSON(*pacentry, strAccount, ret);
1161 if (ret.size() >= nCount) break;
1163 // ret is now newest to oldest
1166 // Make sure we return only last nCount items (sends-to-self might give us an extra):
1167 if (ret.size() > nCount)
1169 Array::iterator last = ret.begin();
1170 std::advance(last, nCount);
1171 ret.erase(last, ret.end());
1173 std::reverse(ret.begin(), ret.end()); // oldest to newest
1178 Value listaccounts(const Array& params, bool fHelp)
1180 if (fHelp || params.size() > 1)
1181 throw runtime_error(
1182 "listaccounts [minconf=1]\n"
1183 "Returns Object that has account names as keys, account balances as values.");
1186 if (params.size() > 0)
1187 nMinDepth = params[0].get_int();
1189 map<string, int64> mapAccountBalances;
1190 CRITICAL_BLOCK(pwalletMain->cs_mapWallet)
1191 CRITICAL_BLOCK(pwalletMain->cs_mapAddressBook)
1193 BOOST_FOREACH(const PAIRTYPE(string, string)& entry, pwalletMain->mapAddressBook) {
1195 if(AddressToHash160(entry.first, hash160) && mapPubKeys.count(hash160)) // This address belongs to me
1196 mapAccountBalances[entry.second] = 0;
1199 for (map<uint256, CWalletTx>::iterator it = pwalletMain->mapWallet.begin(); it != pwalletMain->mapWallet.end(); ++it)
1201 const CWalletTx& wtx = (*it).second;
1202 int64 nGeneratedImmature, nGeneratedMature, nFee;
1203 string strSentAccount;
1204 list<pair<string, int64> > listReceived;
1205 list<pair<string, int64> > listSent;
1206 wtx.GetAmounts(nGeneratedImmature, nGeneratedMature, listReceived, listSent, nFee, strSentAccount);
1207 mapAccountBalances[strSentAccount] -= nFee;
1208 BOOST_FOREACH(const PAIRTYPE(string, int64)& s, listSent)
1209 mapAccountBalances[strSentAccount] -= s.second;
1210 if (wtx.GetDepthInMainChain() >= nMinDepth)
1212 mapAccountBalances[""] += nGeneratedMature;
1213 BOOST_FOREACH(const PAIRTYPE(string, int64)& r, listReceived)
1214 if (pwalletMain->mapAddressBook.count(r.first))
1215 mapAccountBalances[pwalletMain->mapAddressBook[r.first]] += r.second;
1217 mapAccountBalances[""] += r.second;
1222 list<CAccountingEntry> acentries;
1223 CWalletDB(pwalletMain->strWalletFile).ListAccountCreditDebit("*", acentries);
1224 BOOST_FOREACH(const CAccountingEntry& entry, acentries)
1225 mapAccountBalances[entry.strAccount] += entry.nCreditDebit;
1228 BOOST_FOREACH(const PAIRTYPE(string, int64)& accountBalance, mapAccountBalances) {
1229 ret.push_back(Pair(accountBalance.first, ValueFromAmount(accountBalance.second)));
1234 Value gettransaction(const Array& params, bool fHelp)
1236 if (fHelp || params.size() != 1)
1237 throw runtime_error(
1238 "gettransaction <txid>\n"
1239 "Get detailed information about <txid>");
1242 hash.SetHex(params[0].get_str());
1245 CRITICAL_BLOCK(pwalletMain->cs_mapWallet)
1247 if (!pwalletMain->mapWallet.count(hash))
1248 throw JSONRPCError(-5, "Invalid or non-wallet transaction id");
1249 const CWalletTx& wtx = pwalletMain->mapWallet[hash];
1251 int64 nCredit = wtx.GetCredit();
1252 int64 nDebit = wtx.GetDebit();
1253 int64 nNet = nCredit - nDebit;
1254 int64 nFee = (wtx.IsFromMe() ? wtx.GetValueOut() - nDebit : 0);
1256 entry.push_back(Pair("amount", ValueFromAmount(nNet - nFee)));
1258 entry.push_back(Pair("fee", ValueFromAmount(nFee)));
1260 WalletTxToJSON(pwalletMain->mapWallet[hash], entry);
1263 ListTransactions(pwalletMain->mapWallet[hash], "*", 0, false, details);
1264 entry.push_back(Pair("details", details));
1271 Value backupwallet(const Array& params, bool fHelp)
1273 if (fHelp || params.size() != 1)
1274 throw runtime_error(
1275 "backupwallet <destination>\n"
1276 "Safely copies wallet.dat to destination, which can be a directory or a path with filename.");
1278 string strDest = params[0].get_str();
1279 BackupWallet(*pwalletMain, strDest);
1285 Value validateaddress(const Array& params, bool fHelp)
1287 if (fHelp || params.size() != 1)
1288 throw runtime_error(
1289 "validateaddress <bitcoinaddress>\n"
1290 "Return information about <bitcoinaddress>.");
1292 string strAddress = params[0].get_str();
1294 bool isValid = AddressToHash160(strAddress, hash160);
1297 ret.push_back(Pair("isvalid", isValid));
1300 // Call Hash160ToAddress() so we always return current ADDRESSVERSION
1301 // version of the address:
1302 string currentAddress = Hash160ToAddress(hash160);
1303 ret.push_back(Pair("address", currentAddress));
1304 ret.push_back(Pair("ismine", (mapPubKeys.count(hash160) > 0)));
1305 CRITICAL_BLOCK(pwalletMain->cs_mapAddressBook)
1307 if (pwalletMain->mapAddressBook.count(currentAddress))
1308 ret.push_back(Pair("account", pwalletMain->mapAddressBook[currentAddress]));
1315 Value getwork(const Array& params, bool fHelp)
1317 if (fHelp || params.size() > 1)
1318 throw runtime_error(
1320 "If [data] is not specified, returns formatted hash data to work on:\n"
1321 " \"midstate\" : precomputed hash state after hashing the first half of the data\n"
1322 " \"data\" : block data\n"
1323 " \"hash1\" : formatted hash buffer for second hash\n"
1324 " \"target\" : little endian hash target\n"
1325 "If [data] is specified, tries to solve the block and returns true if it was successful.");
1328 throw JSONRPCError(-9, "Bitcoin is not connected!");
1330 if (IsInitialBlockDownload())
1331 throw JSONRPCError(-10, "Bitcoin is downloading blocks...");
1333 static map<uint256, pair<CBlock*, unsigned int> > mapNewBlock;
1334 static vector<CBlock*> vNewBlock;
1335 static CReserveKey reservekey(pwalletMain);
1337 if (params.size() == 0)
1340 static unsigned int nTransactionsUpdatedLast;
1341 static CBlockIndex* pindexPrev;
1342 static int64 nStart;
1343 static CBlock* pblock;
1344 if (pindexPrev != pindexBest ||
1345 (nTransactionsUpdated != nTransactionsUpdatedLast && GetTime() - nStart > 60))
1347 if (pindexPrev != pindexBest)
1349 // Deallocate old blocks since they're obsolete now
1350 mapNewBlock.clear();
1351 BOOST_FOREACH(CBlock* pblock, vNewBlock)
1355 nTransactionsUpdatedLast = nTransactionsUpdated;
1356 pindexPrev = pindexBest;
1360 pblock = CreateNewBlock(reservekey);
1362 throw JSONRPCError(-7, "Out of memory");
1363 vNewBlock.push_back(pblock);
1367 pblock->nTime = max(pindexPrev->GetMedianTimePast()+1, GetAdjustedTime());
1370 // Update nExtraNonce
1371 static unsigned int nExtraNonce = 0;
1372 static int64 nPrevTime = 0;
1373 IncrementExtraNonce(pblock, pindexPrev, nExtraNonce, nPrevTime);
1376 mapNewBlock[pblock->hashMerkleRoot] = make_pair(pblock, nExtraNonce);
1378 // Prebuild hash buffers
1382 FormatHashBuffers(pblock, pmidstate, pdata, phash1);
1384 uint256 hashTarget = CBigNum().SetCompact(pblock->nBits).getuint256();
1387 result.push_back(Pair("midstate", HexStr(BEGIN(pmidstate), END(pmidstate))));
1388 result.push_back(Pair("data", HexStr(BEGIN(pdata), END(pdata))));
1389 result.push_back(Pair("hash1", HexStr(BEGIN(phash1), END(phash1))));
1390 result.push_back(Pair("target", HexStr(BEGIN(hashTarget), END(hashTarget))));
1396 vector<unsigned char> vchData = ParseHex(params[0].get_str());
1397 if (vchData.size() != 128)
1398 throw JSONRPCError(-8, "Invalid parameter");
1399 CBlock* pdata = (CBlock*)&vchData[0];
1402 for (int i = 0; i < 128/4; i++)
1403 ((unsigned int*)pdata)[i] = CryptoPP::ByteReverse(((unsigned int*)pdata)[i]);
1406 if (!mapNewBlock.count(pdata->hashMerkleRoot))
1408 CBlock* pblock = mapNewBlock[pdata->hashMerkleRoot].first;
1409 unsigned int nExtraNonce = mapNewBlock[pdata->hashMerkleRoot].second;
1411 pblock->nTime = pdata->nTime;
1412 pblock->nNonce = pdata->nNonce;
1413 pblock->vtx[0].vin[0].scriptSig = CScript() << pblock->nBits << CBigNum(nExtraNonce);
1414 pblock->hashMerkleRoot = pblock->BuildMerkleTree();
1416 return CheckWork(pblock, *pwalletMain, reservekey);
1434 pair<string, rpcfn_type> pCallTable[] =
1436 make_pair("help", &help),
1437 make_pair("stop", &stop),
1438 make_pair("getblockcount", &getblockcount),
1439 make_pair("getblocknumber", &getblocknumber),
1440 make_pair("getconnectioncount", &getconnectioncount),
1441 make_pair("getdifficulty", &getdifficulty),
1442 make_pair("getgenerate", &getgenerate),
1443 make_pair("setgenerate", &setgenerate),
1444 make_pair("gethashespersec", &gethashespersec),
1445 make_pair("getinfo", &getinfo),
1446 make_pair("getnewaddress", &getnewaddress),
1447 make_pair("getaccountaddress", &getaccountaddress),
1448 make_pair("setaccount", &setaccount),
1449 make_pair("setlabel", &setaccount), // deprecated
1450 make_pair("getaccount", &getaccount),
1451 make_pair("getlabel", &getaccount), // deprecated
1452 make_pair("getaddressesbyaccount", &getaddressesbyaccount),
1453 make_pair("getaddressesbylabel", &getaddressesbyaccount), // deprecated
1454 make_pair("sendtoaddress", &sendtoaddress),
1455 make_pair("getamountreceived", &getreceivedbyaddress), // deprecated, renamed to getreceivedbyaddress
1456 make_pair("getallreceived", &listreceivedbyaddress), // deprecated, renamed to listreceivedbyaddress
1457 make_pair("getreceivedbyaddress", &getreceivedbyaddress),
1458 make_pair("getreceivedbyaccount", &getreceivedbyaccount),
1459 make_pair("getreceivedbylabel", &getreceivedbyaccount), // deprecated
1460 make_pair("listreceivedbyaddress", &listreceivedbyaddress),
1461 make_pair("listreceivedbyaccount", &listreceivedbyaccount),
1462 make_pair("listreceivedbylabel", &listreceivedbyaccount), // deprecated
1463 make_pair("backupwallet", &backupwallet),
1464 make_pair("validateaddress", &validateaddress),
1465 make_pair("getbalance", &getbalance),
1466 make_pair("move", &movecmd),
1467 make_pair("sendfrom", &sendfrom),
1468 make_pair("sendmany", &sendmany),
1469 make_pair("gettransaction", &gettransaction),
1470 make_pair("listtransactions", &listtransactions),
1471 make_pair("getwork", &getwork),
1472 make_pair("listaccounts", &listaccounts),
1473 make_pair("settxfee", &settxfee),
1475 map<string, rpcfn_type> mapCallTable(pCallTable, pCallTable + sizeof(pCallTable)/sizeof(pCallTable[0]));
1477 string pAllowInSafeMode[] =
1483 "getconnectioncount",
1490 "getaccountaddress",
1493 "getlabel", // deprecated
1494 "getaddressesbyaccount",
1495 "getaddressesbylabel", // deprecated
1500 set<string> setAllowInSafeMode(pAllowInSafeMode, pAllowInSafeMode + sizeof(pAllowInSafeMode)/sizeof(pAllowInSafeMode[0]));
1508 // This ain't Apache. We're just using HTTP header for the length field
1509 // and to be compatible with other JSON-RPC implementations.
1512 string HTTPPost(const string& strMsg, const map<string,string>& mapRequestHeaders)
1515 s << "POST / HTTP/1.1\r\n"
1516 << "User-Agent: bitcoin-json-rpc/" << FormatFullVersion() << "\r\n"
1517 << "Host: 127.0.0.1\r\n"
1518 << "Content-Type: application/json\r\n"
1519 << "Content-Length: " << strMsg.size() << "\r\n"
1520 << "Accept: application/json\r\n";
1521 BOOST_FOREACH(const PAIRTYPE(string, string)& item, mapRequestHeaders)
1522 s << item.first << ": " << item.second << "\r\n";
1523 s << "\r\n" << strMsg;
1528 string rfc1123Time()
1533 struct tm* now_gmt = gmtime(&now);
1534 string locale(setlocale(LC_TIME, NULL));
1535 setlocale(LC_TIME, "C"); // we want posix (aka "C") weekday/month strings
1536 strftime(buffer, sizeof(buffer), "%a, %d %b %Y %H:%M:%S +0000", now_gmt);
1537 setlocale(LC_TIME, locale.c_str());
1538 return string(buffer);
1541 static string HTTPReply(int nStatus, const string& strMsg)
1544 return strprintf("HTTP/1.0 401 Authorization Required\r\n"
1546 "Server: bitcoin-json-rpc/%s\r\n"
1547 "WWW-Authenticate: Basic realm=\"jsonrpc\"\r\n"
1548 "Content-Type: text/html\r\n"
1549 "Content-Length: 296\r\n"
1551 "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\"\r\n"
1552 "\"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd\">\r\n"
1555 "<TITLE>Error</TITLE>\r\n"
1556 "<META HTTP-EQUIV='Content-Type' CONTENT='text/html; charset=ISO-8859-1'>\r\n"
1558 "<BODY><H1>401 Unauthorized.</H1></BODY>\r\n"
1559 "</HTML>\r\n", rfc1123Time().c_str(), FormatFullVersion().c_str());
1561 if (nStatus == 200) strStatus = "OK";
1562 else if (nStatus == 400) strStatus = "Bad Request";
1563 else if (nStatus == 403) strStatus = "Forbidden";
1564 else if (nStatus == 404) strStatus = "Not Found";
1565 else if (nStatus == 500) strStatus = "Internal Server Error";
1567 "HTTP/1.1 %d %s\r\n"
1569 "Connection: close\r\n"
1570 "Content-Length: %d\r\n"
1571 "Content-Type: application/json\r\n"
1572 "Server: bitcoin-json-rpc/%s\r\n"
1577 rfc1123Time().c_str(),
1579 FormatFullVersion().c_str(),
1583 int ReadHTTPStatus(std::basic_istream<char>& stream)
1586 getline(stream, str);
1587 vector<string> vWords;
1588 boost::split(vWords, str, boost::is_any_of(" "));
1589 if (vWords.size() < 2)
1591 return atoi(vWords[1].c_str());
1594 int ReadHTTPHeader(std::basic_istream<char>& stream, map<string, string>& mapHeadersRet)
1600 std::getline(stream, str);
1601 if (str.empty() || str == "\r")
1603 string::size_type nColon = str.find(":");
1604 if (nColon != string::npos)
1606 string strHeader = str.substr(0, nColon);
1607 boost::trim(strHeader);
1608 boost::to_lower(strHeader);
1609 string strValue = str.substr(nColon+1);
1610 boost::trim(strValue);
1611 mapHeadersRet[strHeader] = strValue;
1612 if (strHeader == "content-length")
1613 nLen = atoi(strValue.c_str());
1619 int ReadHTTP(std::basic_istream<char>& stream, map<string, string>& mapHeadersRet, string& strMessageRet)
1621 mapHeadersRet.clear();
1625 int nStatus = ReadHTTPStatus(stream);
1628 int nLen = ReadHTTPHeader(stream, mapHeadersRet);
1629 if (nLen < 0 || nLen > MAX_SIZE)
1635 vector<char> vch(nLen);
1636 stream.read(&vch[0], nLen);
1637 strMessageRet = string(vch.begin(), vch.end());
1643 string EncodeBase64(string s)
1648 b64 = BIO_new(BIO_f_base64());
1649 BIO_set_flags(b64, BIO_FLAGS_BASE64_NO_NL);
1650 bmem = BIO_new(BIO_s_mem());
1651 b64 = BIO_push(b64, bmem);
1652 BIO_write(b64, s.c_str(), s.size());
1654 BIO_get_mem_ptr(b64, &bptr);
1656 string result(bptr->data, bptr->length);
1662 string DecodeBase64(string s)
1666 char* buffer = static_cast<char*>(calloc(s.size(), sizeof(char)));
1668 b64 = BIO_new(BIO_f_base64());
1669 BIO_set_flags(b64, BIO_FLAGS_BASE64_NO_NL);
1670 bmem = BIO_new_mem_buf(const_cast<char*>(s.c_str()), s.size());
1671 bmem = BIO_push(b64, bmem);
1672 BIO_read(bmem, buffer, s.size());
1675 string result(buffer);
1680 bool HTTPAuthorized(map<string, string>& mapHeaders)
1682 string strAuth = mapHeaders["authorization"];
1683 if (strAuth.substr(0,6) != "Basic ")
1685 string strUserPass64 = strAuth.substr(6); boost::trim(strUserPass64);
1686 string strUserPass = DecodeBase64(strUserPass64);
1687 string::size_type nColon = strUserPass.find(":");
1688 if (nColon == string::npos)
1690 string strUser = strUserPass.substr(0, nColon);
1691 string strPassword = strUserPass.substr(nColon+1);
1692 return (strUser == mapArgs["-rpcuser"] && strPassword == mapArgs["-rpcpassword"]);
1696 // JSON-RPC protocol. Bitcoin speaks version 1.0 for maximum compatibility,
1697 // but uses JSON-RPC 1.1/2.0 standards for parts of the 1.0 standard that were
1698 // unspecified (HTTP errors and contents of 'error').
1700 // 1.0 spec: http://json-rpc.org/wiki/specification
1701 // 1.2 spec: http://groups.google.com/group/json-rpc/web/json-rpc-over-http
1702 // http://www.codeproject.com/KB/recipes/JSON_Spirit.aspx
1705 string JSONRPCRequest(const string& strMethod, const Array& params, const Value& id)
1708 request.push_back(Pair("method", strMethod));
1709 request.push_back(Pair("params", params));
1710 request.push_back(Pair("id", id));
1711 return write_string(Value(request), false) + "\n";
1714 string JSONRPCReply(const Value& result, const Value& error, const Value& id)
1717 if (error.type() != null_type)
1718 reply.push_back(Pair("result", Value::null));
1720 reply.push_back(Pair("result", result));
1721 reply.push_back(Pair("error", error));
1722 reply.push_back(Pair("id", id));
1723 return write_string(Value(reply), false) + "\n";
1726 void ErrorReply(std::ostream& stream, const Object& objError, const Value& id)
1728 // Send error reply from json-rpc error object
1730 int code = find_value(objError, "code").get_int();
1731 if (code == -32600) nStatus = 400;
1732 else if (code == -32601) nStatus = 404;
1733 string strReply = JSONRPCReply(Value::null, objError, id);
1734 stream << HTTPReply(nStatus, strReply) << std::flush;
1737 bool ClientAllowed(const string& strAddress)
1739 if (strAddress == asio::ip::address_v4::loopback().to_string())
1741 const vector<string>& vAllow = mapMultiArgs["-rpcallowip"];
1742 BOOST_FOREACH(string strAllow, vAllow)
1743 if (WildcardMatch(strAddress, strAllow))
1750 // IOStream device that speaks SSL but can also speak non-SSL
1752 class SSLIOStreamDevice : public iostreams::device<iostreams::bidirectional> {
1754 SSLIOStreamDevice(SSLStream &streamIn, bool fUseSSLIn) : stream(streamIn)
1756 fUseSSL = fUseSSLIn;
1757 fNeedHandshake = fUseSSLIn;
1760 void handshake(ssl::stream_base::handshake_type role)
1762 if (!fNeedHandshake) return;
1763 fNeedHandshake = false;
1764 stream.handshake(role);
1766 std::streamsize read(char* s, std::streamsize n)
1768 handshake(ssl::stream_base::server); // HTTPS servers read first
1769 if (fUseSSL) return stream.read_some(asio::buffer(s, n));
1770 return stream.next_layer().read_some(asio::buffer(s, n));
1772 std::streamsize write(const char* s, std::streamsize n)
1774 handshake(ssl::stream_base::client); // HTTPS clients write first
1775 if (fUseSSL) return asio::write(stream, asio::buffer(s, n));
1776 return asio::write(stream.next_layer(), asio::buffer(s, n));
1778 bool connect(const std::string& server, const std::string& port)
1780 ip::tcp::resolver resolver(stream.get_io_service());
1781 ip::tcp::resolver::query query(server.c_str(), port.c_str());
1782 ip::tcp::resolver::iterator endpoint_iterator = resolver.resolve(query);
1783 ip::tcp::resolver::iterator end;
1784 boost::system::error_code error = asio::error::host_not_found;
1785 while (error && endpoint_iterator != end)
1787 stream.lowest_layer().close();
1788 stream.lowest_layer().connect(*endpoint_iterator++, error);
1796 bool fNeedHandshake;
1802 void ThreadRPCServer(void* parg)
1804 IMPLEMENT_RANDOMIZE_STACK(ThreadRPCServer(parg));
1807 vnThreadsRunning[4]++;
1808 ThreadRPCServer2(parg);
1809 vnThreadsRunning[4]--;
1811 catch (std::exception& e) {
1812 vnThreadsRunning[4]--;
1813 PrintException(&e, "ThreadRPCServer()");
1815 vnThreadsRunning[4]--;
1816 PrintException(NULL, "ThreadRPCServer()");
1818 printf("ThreadRPCServer exiting\n");
1821 void ThreadRPCServer2(void* parg)
1823 printf("ThreadRPCServer started\n");
1825 if (mapArgs["-rpcuser"] == "" && mapArgs["-rpcpassword"] == "")
1827 string strWhatAmI = "To use bitcoind";
1828 if (mapArgs.count("-server"))
1829 strWhatAmI = strprintf(_("To use the %s option"), "\"-server\"");
1830 else if (mapArgs.count("-daemon"))
1831 strWhatAmI = strprintf(_("To use the %s option"), "\"-daemon\"");
1833 _("Warning: %s, you must set rpcpassword=<password>\nin the configuration file: %s\n"
1834 "If the file does not exist, create it with owner-readable-only file permissions.\n"),
1836 GetConfigFile().c_str());
1837 CreateThread(Shutdown, NULL);
1841 bool fUseSSL = GetBoolArg("-rpcssl");
1842 asio::ip::address bindAddress = mapArgs.count("-rpcallowip") ? asio::ip::address_v4::any() : asio::ip::address_v4::loopback();
1844 asio::io_service io_service;
1845 ip::tcp::endpoint endpoint(bindAddress, GetArg("-rpcport", 8332));
1846 ip::tcp::acceptor acceptor(io_service, endpoint);
1848 acceptor.set_option(boost::asio::ip::tcp::acceptor::reuse_address(true));
1851 ssl::context context(io_service, ssl::context::sslv23);
1854 context.set_options(ssl::context::no_sslv2);
1855 filesystem::path certfile = GetArg("-rpcsslcertificatechainfile", "server.cert");
1856 if (!certfile.is_complete()) certfile = filesystem::path(GetDataDir()) / certfile;
1857 if (filesystem::exists(certfile)) context.use_certificate_chain_file(certfile.string().c_str());
1858 else printf("ThreadRPCServer ERROR: missing server certificate file %s\n", certfile.string().c_str());
1859 filesystem::path pkfile = GetArg("-rpcsslprivatekeyfile", "server.pem");
1860 if (!pkfile.is_complete()) pkfile = filesystem::path(GetDataDir()) / pkfile;
1861 if (filesystem::exists(pkfile)) context.use_private_key_file(pkfile.string().c_str(), ssl::context::pem);
1862 else printf("ThreadRPCServer ERROR: missing server private key file %s\n", pkfile.string().c_str());
1864 string ciphers = GetArg("-rpcsslciphers",
1865 "TLSv1+HIGH:!SSLv2:!aNULL:!eNULL:!AH:!3DES:@STRENGTH");
1866 SSL_CTX_set_cipher_list(context.impl(), ciphers.c_str());
1870 throw runtime_error("-rpcssl=1, but bitcoin compiled without full openssl libraries.");
1875 // Accept connection
1877 SSLStream sslStream(io_service, context);
1878 SSLIOStreamDevice d(sslStream, fUseSSL);
1879 iostreams::stream<SSLIOStreamDevice> stream(d);
1881 ip::tcp::iostream stream;
1884 ip::tcp::endpoint peer;
1885 vnThreadsRunning[4]--;
1887 acceptor.accept(sslStream.lowest_layer(), peer);
1889 acceptor.accept(*stream.rdbuf(), peer);
1891 vnThreadsRunning[4]++;
1895 // Restrict callers by IP
1896 if (!ClientAllowed(peer.address().to_string()))
1898 // Only send a 403 if we're not using SSL to prevent a DoS during the SSL handshake.
1900 stream << HTTPReply(403, "") << std::flush;
1904 map<string, string> mapHeaders;
1907 boost::thread api_caller(ReadHTTP, boost::ref(stream), boost::ref(mapHeaders), boost::ref(strRequest));
1908 if (!api_caller.timed_join(boost::posix_time::seconds(GetArg("-rpctimeout", 30))))
1911 printf("ThreadRPCServer ReadHTTP timeout\n");
1915 // Check authorization
1916 if (mapHeaders.count("authorization") == 0)
1918 stream << HTTPReply(401, "") << std::flush;
1921 if (!HTTPAuthorized(mapHeaders))
1923 // Deter brute-forcing short passwords
1924 if (mapArgs["-rpcpassword"].size() < 15)
1927 stream << HTTPReply(401, "") << std::flush;
1928 printf("ThreadRPCServer incorrect password attempt\n");
1932 Value id = Value::null;
1937 if (!read_string(strRequest, valRequest) || valRequest.type() != obj_type)
1938 throw JSONRPCError(-32700, "Parse error");
1939 const Object& request = valRequest.get_obj();
1941 // Parse id now so errors from here on will have the id
1942 id = find_value(request, "id");
1945 Value valMethod = find_value(request, "method");
1946 if (valMethod.type() == null_type)
1947 throw JSONRPCError(-32600, "Missing method");
1948 if (valMethod.type() != str_type)
1949 throw JSONRPCError(-32600, "Method must be a string");
1950 string strMethod = valMethod.get_str();
1951 if (strMethod != "getwork")
1952 printf("ThreadRPCServer method=%s\n", strMethod.c_str());
1955 Value valParams = find_value(request, "params");
1957 if (valParams.type() == array_type)
1958 params = valParams.get_array();
1959 else if (valParams.type() == null_type)
1962 throw JSONRPCError(-32600, "Params must be an array");
1965 map<string, rpcfn_type>::iterator mi = mapCallTable.find(strMethod);
1966 if (mi == mapCallTable.end())
1967 throw JSONRPCError(-32601, "Method not found");
1969 // Observe safe mode
1970 string strWarning = GetWarnings("rpc");
1971 if (strWarning != "" && !GetBoolArg("-disablesafemode") && !setAllowInSafeMode.count(strMethod))
1972 throw JSONRPCError(-2, string("Safe mode: ") + strWarning);
1977 Value result = (*(*mi).second)(params, false);
1980 string strReply = JSONRPCReply(result, Value::null, id);
1981 stream << HTTPReply(200, strReply) << std::flush;
1983 catch (std::exception& e)
1985 ErrorReply(stream, JSONRPCError(-1, e.what()), id);
1988 catch (Object& objError)
1990 ErrorReply(stream, objError, id);
1992 catch (std::exception& e)
1994 ErrorReply(stream, JSONRPCError(-32700, e.what()), id);
2002 Object CallRPC(const string& strMethod, const Array& params)
2004 if (mapArgs["-rpcuser"] == "" && mapArgs["-rpcpassword"] == "")
2005 throw runtime_error(strprintf(
2006 _("You must set rpcpassword=<password> in the configuration file:\n%s\n"
2007 "If the file does not exist, create it with owner-readable-only file permissions."),
2008 GetConfigFile().c_str()));
2010 // Connect to localhost
2011 bool fUseSSL = GetBoolArg("-rpcssl");
2013 asio::io_service io_service;
2014 ssl::context context(io_service, ssl::context::sslv23);
2015 context.set_options(ssl::context::no_sslv2);
2016 SSLStream sslStream(io_service, context);
2017 SSLIOStreamDevice d(sslStream, fUseSSL);
2018 iostreams::stream<SSLIOStreamDevice> stream(d);
2019 if (!d.connect(GetArg("-rpcconnect", "127.0.0.1"), GetArg("-rpcport", "8332")))
2020 throw runtime_error("couldn't connect to server");
2023 throw runtime_error("-rpcssl=1, but bitcoin compiled without full openssl libraries.");
2025 ip::tcp::iostream stream(GetArg("-rpcconnect", "127.0.0.1"), GetArg("-rpcport", "8332"));
2027 throw runtime_error("couldn't connect to server");
2031 // HTTP basic authentication
2032 string strUserPass64 = EncodeBase64(mapArgs["-rpcuser"] + ":" + mapArgs["-rpcpassword"]);
2033 map<string, string> mapRequestHeaders;
2034 mapRequestHeaders["Authorization"] = string("Basic ") + strUserPass64;
2037 string strRequest = JSONRPCRequest(strMethod, params, 1);
2038 string strPost = HTTPPost(strRequest, mapRequestHeaders);
2039 stream << strPost << std::flush;
2042 map<string, string> mapHeaders;
2044 int nStatus = ReadHTTP(stream, mapHeaders, strReply);
2046 throw runtime_error("incorrect rpcuser or rpcpassword (authorization failed)");
2047 else if (nStatus >= 400 && nStatus != 400 && nStatus != 404 && nStatus != 500)
2048 throw runtime_error(strprintf("server returned HTTP error %d", nStatus));
2049 else if (strReply.empty())
2050 throw runtime_error("no response from server");
2054 if (!read_string(strReply, valReply))
2055 throw runtime_error("couldn't parse reply from server");
2056 const Object& reply = valReply.get_obj();
2058 throw runtime_error("expected reply to have result, error and id properties");
2066 template<typename T>
2067 void ConvertTo(Value& value)
2069 if (value.type() == str_type)
2071 // reinterpret string as unquoted json value
2073 if (!read_string(value.get_str(), value2))
2074 throw runtime_error("type mismatch");
2075 value = value2.get_value<T>();
2079 value = value.get_value<T>();
2083 int CommandLineRPC(int argc, char *argv[])
2090 while (argc > 1 && IsSwitchChar(argv[1][0]))
2098 throw runtime_error("too few parameters");
2099 string strMethod = argv[1];
2101 // Parameters default to strings
2103 for (int i = 2; i < argc; i++)
2104 params.push_back(argv[i]);
2105 int n = params.size();
2108 // Special case non-string parameter types
2110 if (strMethod == "setgenerate" && n > 0) ConvertTo<bool>(params[0]);
2111 if (strMethod == "setgenerate" && n > 1) ConvertTo<boost::int64_t>(params[1]);
2112 if (strMethod == "sendtoaddress" && n > 1) ConvertTo<double>(params[1]);
2113 if (strMethod == "settxfee" && n > 0) ConvertTo<double>(params[0]);
2114 if (strMethod == "getamountreceived" && n > 1) ConvertTo<boost::int64_t>(params[1]); // deprecated
2115 if (strMethod == "getreceivedbyaddress" && n > 1) ConvertTo<boost::int64_t>(params[1]);
2116 if (strMethod == "getreceivedbyaccount" && n > 1) ConvertTo<boost::int64_t>(params[1]);
2117 if (strMethod == "getreceivedbylabel" && n > 1) ConvertTo<boost::int64_t>(params[1]); // deprecated
2118 if (strMethod == "getallreceived" && n > 0) ConvertTo<boost::int64_t>(params[0]); // deprecated
2119 if (strMethod == "getallreceived" && n > 1) ConvertTo<bool>(params[1]);
2120 if (strMethod == "listreceivedbyaddress" && n > 0) ConvertTo<boost::int64_t>(params[0]);
2121 if (strMethod == "listreceivedbyaddress" && n > 1) ConvertTo<bool>(params[1]);
2122 if (strMethod == "listreceivedbyaccount" && n > 0) ConvertTo<boost::int64_t>(params[0]);
2123 if (strMethod == "listreceivedbyaccount" && n > 1) ConvertTo<bool>(params[1]);
2124 if (strMethod == "listreceivedbylabel" && n > 0) ConvertTo<boost::int64_t>(params[0]); // deprecated
2125 if (strMethod == "listreceivedbylabel" && n > 1) ConvertTo<bool>(params[1]); // deprecated
2126 if (strMethod == "getbalance" && n > 1) ConvertTo<boost::int64_t>(params[1]);
2127 if (strMethod == "move" && n > 2) ConvertTo<double>(params[2]);
2128 if (strMethod == "move" && n > 3) ConvertTo<boost::int64_t>(params[3]);
2129 if (strMethod == "sendfrom" && n > 2) ConvertTo<double>(params[2]);
2130 if (strMethod == "sendfrom" && n > 3) ConvertTo<boost::int64_t>(params[3]);
2131 if (strMethod == "listtransactions" && n > 1) ConvertTo<boost::int64_t>(params[1]);
2132 if (strMethod == "listtransactions" && n > 2) ConvertTo<boost::int64_t>(params[2]);
2133 if (strMethod == "listaccounts" && n > 0) ConvertTo<boost::int64_t>(params[0]);
2134 if (strMethod == "sendmany" && n > 1)
2136 string s = params[1].get_str();
2138 if (!read_string(s, v) || v.type() != obj_type)
2139 throw runtime_error("type mismatch");
2140 params[1] = v.get_obj();
2142 if (strMethod == "sendmany" && n > 2) ConvertTo<boost::int64_t>(params[2]);
2145 Object reply = CallRPC(strMethod, params);
2148 const Value& result = find_value(reply, "result");
2149 const Value& error = find_value(reply, "error");
2150 const Value& id = find_value(reply, "id");
2152 if (error.type() != null_type)
2155 strPrint = "error: " + write_string(error, false);
2156 int code = find_value(error.get_obj(), "code").get_int();
2162 if (result.type() == null_type)
2164 else if (result.type() == str_type)
2165 strPrint = result.get_str();
2167 strPrint = write_string(result, true);
2170 catch (std::exception& e)
2172 strPrint = string("error: ") + e.what();
2177 PrintException(NULL, "CommandLineRPC()");
2182 #if defined(__WXMSW__) && defined(GUI)
2183 // Windows GUI apps can't print to command line,
2184 // so settle for a message box yuck
2185 MyMessageBox(strPrint, "Bitcoin", wxOK);
2187 fprintf((nRet == 0 ? stdout : stderr), "%s\n", strPrint.c_str());
2197 int main(int argc, char *argv[])
2200 // Turn off microsoft heap dump noise
2201 _CrtSetReportMode(_CRT_WARN, _CRTDBG_MODE_FILE);
2202 _CrtSetReportFile(_CRT_WARN, CreateFile("NUL", GENERIC_WRITE, 0, NULL, OPEN_EXISTING, 0, 0));
2204 setbuf(stdin, NULL);
2205 setbuf(stdout, NULL);
2206 setbuf(stderr, NULL);
2210 if (argc >= 2 && string(argv[1]) == "-server")
2212 printf("server ready\n");
2213 ThreadRPCServer(NULL);
2217 return CommandLineRPC(argc, argv);
2220 catch (std::exception& e) {
2221 PrintException(&e, "main()");
2223 PrintException(NULL, "main()");