protocol.h
1 // Copyright (c) 2010 Satoshi Nakamoto 2 // Copyright (c) 2009-2021 The Bitcoin Core developers 3 // Distributed under the MIT software license, see the accompanying 4 // file COPYING or http://www.opensource.org/licenses/mit-license.php. 5 6 #ifndef BITCOIN_RPC_PROTOCOL_H 7 #define BITCOIN_RPC_PROTOCOL_H 8 9 //! HTTP status codes 10 enum HTTPStatusCode 11 { 12 HTTP_OK = 200, 13 HTTP_BAD_REQUEST = 400, 14 HTTP_UNAUTHORIZED = 401, 15 HTTP_FORBIDDEN = 403, 16 HTTP_NOT_FOUND = 404, 17 HTTP_BAD_METHOD = 405, 18 HTTP_INTERNAL_SERVER_ERROR = 500, 19 HTTP_SERVICE_UNAVAILABLE = 503, 20 }; 21 22 //! Bitcoin RPC error codes 23 enum RPCErrorCode 24 { 25 //! Standard JSON-RPC 2.0 errors 26 // RPC_INVALID_REQUEST is internally mapped to HTTP_BAD_REQUEST (400). 27 // It should not be used for application-layer errors. 28 RPC_INVALID_REQUEST = -32600, 29 // RPC_METHOD_NOT_FOUND is internally mapped to HTTP_NOT_FOUND (404). 30 // It should not be used for application-layer errors. 31 RPC_METHOD_NOT_FOUND = -32601, 32 RPC_INVALID_PARAMS = -32602, 33 // RPC_INTERNAL_ERROR should only be used for genuine errors in bitcoind 34 // (for example datadir corruption). 35 RPC_INTERNAL_ERROR = -32603, 36 RPC_PARSE_ERROR = -32700, 37 38 //! General application defined errors 39 RPC_MISC_ERROR = -1, //!< std::exception thrown in command handling 40 RPC_TYPE_ERROR = -3, //!< Unexpected type was passed as parameter 41 RPC_INVALID_ADDRESS_OR_KEY = -5, //!< Invalid address or key 42 RPC_OUT_OF_MEMORY = -7, //!< Ran out of memory during operation 43 RPC_INVALID_PARAMETER = -8, //!< Invalid, missing or duplicate parameter 44 RPC_DATABASE_ERROR = -20, //!< Database error 45 RPC_DESERIALIZATION_ERROR = -22, //!< Error parsing or validating structure in raw format 46 RPC_VERIFY_ERROR = -25, //!< General error during transaction or block submission 47 RPC_VERIFY_REJECTED = -26, //!< Transaction or block was rejected by network rules 48 RPC_VERIFY_ALREADY_IN_CHAIN = -27, //!< Transaction already in chain 49 RPC_IN_WARMUP = -28, //!< Client still warming up 50 RPC_METHOD_DEPRECATED = -32, //!< RPC method is deprecated 51 52 //! Aliases for backward compatibility 53 RPC_TRANSACTION_ERROR = RPC_VERIFY_ERROR, 54 RPC_TRANSACTION_REJECTED = RPC_VERIFY_REJECTED, 55 RPC_TRANSACTION_ALREADY_IN_CHAIN= RPC_VERIFY_ALREADY_IN_CHAIN, 56 57 //! P2P client errors 58 RPC_CLIENT_NOT_CONNECTED = -9, //!< Bitcoin is not connected 59 RPC_CLIENT_IN_INITIAL_DOWNLOAD = -10, //!< Still downloading initial blocks 60 RPC_CLIENT_NODE_ALREADY_ADDED = -23, //!< Node is already added 61 RPC_CLIENT_NODE_NOT_ADDED = -24, //!< Node has not been added before 62 RPC_CLIENT_NODE_NOT_CONNECTED = -29, //!< Node to disconnect not found in connected nodes 63 RPC_CLIENT_INVALID_IP_OR_SUBNET = -30, //!< Invalid IP/Subnet 64 RPC_CLIENT_P2P_DISABLED = -31, //!< No valid connection manager instance found 65 RPC_CLIENT_NODE_CAPACITY_REACHED= -34, //!< Max number of outbound or block-relay connections already open 66 67 //! Chain errors 68 RPC_CLIENT_MEMPOOL_DISABLED = -33, //!< No mempool instance found 69 70 //! Wallet errors 71 RPC_WALLET_ERROR = -4, //!< Unspecified problem with wallet (key not found etc.) 72 RPC_WALLET_INSUFFICIENT_FUNDS = -6, //!< Not enough funds in wallet or account 73 RPC_WALLET_INVALID_LABEL_NAME = -11, //!< Invalid label name 74 RPC_WALLET_KEYPOOL_RAN_OUT = -12, //!< Keypool ran out, call keypoolrefill first 75 RPC_WALLET_UNLOCK_NEEDED = -13, //!< Enter the wallet passphrase with walletpassphrase first 76 RPC_WALLET_PASSPHRASE_INCORRECT = -14, //!< The wallet passphrase entered was incorrect 77 RPC_WALLET_WRONG_ENC_STATE = -15, //!< Command given in wrong wallet encryption state (encrypting an encrypted wallet etc.) 78 RPC_WALLET_ENCRYPTION_FAILED = -16, //!< Failed to encrypt the wallet 79 RPC_WALLET_ALREADY_UNLOCKED = -17, //!< Wallet is already unlocked 80 RPC_WALLET_NOT_FOUND = -18, //!< Invalid wallet specified 81 RPC_WALLET_NOT_SPECIFIED = -19, //!< No wallet specified (error when there are multiple wallets loaded) 82 RPC_WALLET_ALREADY_LOADED = -35, //!< This same wallet is already loaded 83 RPC_WALLET_ALREADY_EXISTS = -36, //!< There is already a wallet with the same name 84 85 //! Backwards compatible aliases 86 RPC_WALLET_INVALID_ACCOUNT_NAME = RPC_WALLET_INVALID_LABEL_NAME, 87 88 //! Unused reserved codes, kept around for backwards compatibility. Do not reuse. 89 RPC_FORBIDDEN_BY_SAFE_MODE = -2, //!< Server is in safe mode, and command is not allowed in safe mode 90 }; 91 92 #endif // BITCOIN_RPC_PROTOCOL_H