2013-11-20 14:18:57 +01:00
|
|
|
// Copyright (c) 2010 Satoshi Nakamoto
|
2015-12-13 14:51:43 +01:00
|
|
|
// Copyright (c) 2009-2015 The Bitcoin Core developers
|
2014-11-20 03:19:29 +01:00
|
|
|
// Distributed under the MIT software license, see the accompanying
|
2013-11-20 14:18:57 +01:00
|
|
|
// file COPYING or http://www.opensource.org/licenses/mit-license.php.
|
|
|
|
|
2014-11-03 16:16:40 +01:00
|
|
|
#ifndef BITCOIN_RPCPROTOCOL_H
|
|
|
|
#define BITCOIN_RPCPROTOCOL_H
|
2013-11-20 14:18:57 +01:00
|
|
|
|
|
|
|
#include <list>
|
|
|
|
#include <map>
|
|
|
|
#include <stdint.h>
|
|
|
|
#include <string>
|
2015-07-07 14:53:48 +02:00
|
|
|
#include <boost/filesystem.hpp>
|
2013-11-20 14:18:57 +01:00
|
|
|
|
2015-09-04 16:11:34 +02:00
|
|
|
#include <univalue.h>
|
2013-11-20 14:18:57 +01:00
|
|
|
|
2014-11-20 03:19:29 +01:00
|
|
|
//! HTTP status codes
|
2013-11-20 14:18:57 +01:00
|
|
|
enum HTTPStatusCode
|
|
|
|
{
|
|
|
|
HTTP_OK = 200,
|
|
|
|
HTTP_BAD_REQUEST = 400,
|
|
|
|
HTTP_UNAUTHORIZED = 401,
|
|
|
|
HTTP_FORBIDDEN = 403,
|
|
|
|
HTTP_NOT_FOUND = 404,
|
evhttpd implementation
- *Replace usage of boost::asio with [libevent2](http://libevent.org/)*.
boost::asio is not part of C++11, so unlike other boost there is no
forwards-compatibility reason to stick with it. Together with #4738 (convert
json_spirit to UniValue), this rids Bitcoin Core of the worst offenders with
regard to compile-time slowness.
- *Replace spit-and-duct-tape http server with evhttp*. Front-end http handling
is handled by libevent, a work queue (with configurable depth and parallelism)
is used to handle application requests.
- *Wrap HTTP request in C++ class*; this makes the application code mostly
HTTP-server-neutral
- *Refactor RPC to move all http-specific code to a separate file*.
Theoreticaly this can allow building without HTTP server but with another RPC
backend, e.g. Qt's debug console (currently not implemented) or future RPC
mechanisms people may want to use.
- *HTTP dispatch mechanism*; services (e.g., RPC, REST) register which URL
paths they want to handle.
By using a proven, high-performance asynchronous networking library (also used
by Tor) and HTTP server, problems such as #5674, #5655, #344 should be avoided.
What works? bitcoind, bitcoin-cli, bitcoin-qt. Unit tests and RPC/REST tests
pass. The aim for now is everything but SSL support.
Configuration options:
- `-rpcthreads`: repurposed as "number of work handler threads". Still
defaults to 4.
- `-rpcworkqueue`: maximum depth of work queue. When this is reached, new
requests will return a 500 Internal Error.
- `-rpctimeout`: inactivity time, in seconds, after which to disconnect a
client.
- `-debug=http`: low-level http activity logging
2015-01-23 07:53:17 +01:00
|
|
|
HTTP_BAD_METHOD = 405,
|
2013-11-20 14:18:57 +01:00
|
|
|
HTTP_INTERNAL_SERVER_ERROR = 500,
|
2014-11-26 13:51:02 +01:00
|
|
|
HTTP_SERVICE_UNAVAILABLE = 503,
|
2013-11-20 14:18:57 +01:00
|
|
|
};
|
|
|
|
|
2015-04-03 00:51:08 +02:00
|
|
|
//! Dash RPC error codes
|
2013-11-20 14:18:57 +01:00
|
|
|
enum RPCErrorCode
|
|
|
|
{
|
2014-11-20 03:19:29 +01:00
|
|
|
//! Standard JSON-RPC 2.0 errors
|
2013-11-20 14:18:57 +01:00
|
|
|
RPC_INVALID_REQUEST = -32600,
|
|
|
|
RPC_METHOD_NOT_FOUND = -32601,
|
|
|
|
RPC_INVALID_PARAMS = -32602,
|
|
|
|
RPC_INTERNAL_ERROR = -32603,
|
|
|
|
RPC_PARSE_ERROR = -32700,
|
|
|
|
|
2014-11-20 03:19:29 +01:00
|
|
|
//! General application defined errors
|
|
|
|
RPC_MISC_ERROR = -1, //! std::exception thrown in command handling
|
|
|
|
RPC_FORBIDDEN_BY_SAFE_MODE = -2, //! Server is in safe mode, and command is not allowed in safe mode
|
|
|
|
RPC_TYPE_ERROR = -3, //! Unexpected type was passed as parameter
|
|
|
|
RPC_INVALID_ADDRESS_OR_KEY = -5, //! Invalid address or key
|
|
|
|
RPC_OUT_OF_MEMORY = -7, //! Ran out of memory during operation
|
|
|
|
RPC_INVALID_PARAMETER = -8, //! Invalid, missing or duplicate parameter
|
|
|
|
RPC_DATABASE_ERROR = -20, //! Database error
|
|
|
|
RPC_DESERIALIZATION_ERROR = -22, //! Error parsing or validating structure in raw format
|
|
|
|
RPC_VERIFY_ERROR = -25, //! General error during transaction or block submission
|
|
|
|
RPC_VERIFY_REJECTED = -26, //! Transaction or block was rejected by network rules
|
|
|
|
RPC_VERIFY_ALREADY_IN_CHAIN = -27, //! Transaction already in chain
|
|
|
|
RPC_IN_WARMUP = -28, //! Client still warming up
|
2013-11-20 14:18:57 +01:00
|
|
|
|
2014-11-20 03:19:29 +01:00
|
|
|
//! Aliases for backward compatibility
|
2014-06-26 16:39:27 +02:00
|
|
|
RPC_TRANSACTION_ERROR = RPC_VERIFY_ERROR,
|
|
|
|
RPC_TRANSACTION_REJECTED = RPC_VERIFY_REJECTED,
|
|
|
|
RPC_TRANSACTION_ALREADY_IN_CHAIN= RPC_VERIFY_ALREADY_IN_CHAIN,
|
2013-11-20 14:18:57 +01:00
|
|
|
|
2014-11-20 03:19:29 +01:00
|
|
|
//! P2P client errors
|
2015-04-03 00:51:08 +02:00
|
|
|
RPC_CLIENT_NOT_CONNECTED = -9, //! Dash is not connected
|
2014-11-20 03:19:29 +01:00
|
|
|
RPC_CLIENT_IN_INITIAL_DOWNLOAD = -10, //! Still downloading initial blocks
|
|
|
|
RPC_CLIENT_NODE_ALREADY_ADDED = -23, //! Node is already added
|
|
|
|
RPC_CLIENT_NODE_NOT_ADDED = -24, //! Node has not been added before
|
2015-06-12 05:20:54 +02:00
|
|
|
RPC_CLIENT_NODE_NOT_CONNECTED = -29, //! Node to disconnect not found in connected nodes
|
2015-06-12 22:27:03 +02:00
|
|
|
RPC_CLIENT_INVALID_IP_OR_SUBNET = -30, //! Invalid IP/Subnet
|
2013-11-20 14:18:57 +01:00
|
|
|
|
2014-11-20 03:19:29 +01:00
|
|
|
//! Wallet errors
|
|
|
|
RPC_WALLET_ERROR = -4, //! Unspecified problem with wallet (key not found etc.)
|
|
|
|
RPC_WALLET_INSUFFICIENT_FUNDS = -6, //! Not enough funds in wallet or account
|
|
|
|
RPC_WALLET_INVALID_ACCOUNT_NAME = -11, //! Invalid account name
|
|
|
|
RPC_WALLET_KEYPOOL_RAN_OUT = -12, //! Keypool ran out, call keypoolrefill first
|
|
|
|
RPC_WALLET_UNLOCK_NEEDED = -13, //! Enter the wallet passphrase with walletpassphrase first
|
|
|
|
RPC_WALLET_PASSPHRASE_INCORRECT = -14, //! The wallet passphrase entered was incorrect
|
|
|
|
RPC_WALLET_WRONG_ENC_STATE = -15, //! Command given in wrong wallet encryption state (encrypting an encrypted wallet etc.)
|
|
|
|
RPC_WALLET_ENCRYPTION_FAILED = -16, //! Failed to encrypt the wallet
|
|
|
|
RPC_WALLET_ALREADY_UNLOCKED = -17, //! Wallet is already unlocked
|
2013-11-20 14:18:57 +01:00
|
|
|
};
|
|
|
|
|
2015-05-13 21:29:19 +02:00
|
|
|
std::string JSONRPCRequest(const std::string& strMethod, const UniValue& params, const UniValue& id);
|
|
|
|
UniValue JSONRPCReplyObj(const UniValue& result, const UniValue& error, const UniValue& id);
|
|
|
|
std::string JSONRPCReply(const UniValue& result, const UniValue& error, const UniValue& id);
|
|
|
|
UniValue JSONRPCError(int code, const std::string& message);
|
2013-11-20 14:18:57 +01:00
|
|
|
|
2015-07-07 14:53:48 +02:00
|
|
|
/** Get name of RPC authentication cookie file */
|
|
|
|
boost::filesystem::path GetAuthCookieFile();
|
|
|
|
/** Generate a new RPC authentication cookie and write it to disk */
|
|
|
|
bool GenerateAuthCookie(std::string *cookie_out);
|
|
|
|
/** Read the RPC authentication cookie from disk */
|
|
|
|
bool GetAuthCookie(std::string *cookie_out);
|
|
|
|
/** Delete RPC authentication cookie from disk */
|
|
|
|
void DeleteAuthCookie();
|
2013-11-20 14:18:57 +01:00
|
|
|
|
2014-11-03 16:16:40 +01:00
|
|
|
#endif // BITCOIN_RPCPROTOCOL_H
|