protocol.h

Go to the documentation of this file.

// Copyright (c) 2010 Satoshi Nakamoto
// Copyright (c) 2009-present The Bitcoin Core developers
// Distributed under the MIT software license, see the accompanying
// file COPYING or http://www.opensource.org/licenses/mit-license.php.
 
#ifndef BITCOIN_RPC_PROTOCOL_H
#define BITCOIN_RPC_PROTOCOL_H
 
#include <string_view>
 
enum HTTPStatusCode : int
{
    HTTP_OK                    = 200,
    HTTP_NO_CONTENT            = 204,
    HTTP_BAD_REQUEST           = 400,
    HTTP_UNAUTHORIZED          = 401,
    HTTP_FORBIDDEN             = 403,
    HTTP_NOT_FOUND             = 404,
    HTTP_BAD_METHOD            = 405,
    HTTP_CONTENT_TOO_LARGE     = 413,
    HTTP_INTERNAL_SERVER_ERROR = 500,
    HTTP_SERVICE_UNAVAILABLE   = 503,
};
 
inline std::string_view HTTPStatusReasonString(HTTPStatusCode code)
{
    switch (code) {
    case HTTP_OK: return "OK";
    case HTTP_NO_CONTENT: return "No Content";
    case HTTP_BAD_REQUEST: return "Bad Request";
    case HTTP_UNAUTHORIZED: return "Unauthorized";
    case HTTP_FORBIDDEN: return "Forbidden";
    case HTTP_NOT_FOUND: return "Not Found";
    case HTTP_BAD_METHOD: return "Method Not Allowed";
    case HTTP_CONTENT_TOO_LARGE: return "Content too large";
    case HTTP_INTERNAL_SERVER_ERROR: return "Internal Server Error";
    case HTTP_SERVICE_UNAVAILABLE: return "Service Unavailable";
    }
 
    // Reason phrases are optional and may be replaced by local variants.
    // https://httpwg.org/specs/rfc9110.html#rfc.section.15.1
    return "";
}
 
enum RPCErrorCode
{
    // RPC_INVALID_REQUEST is internally mapped to HTTP_BAD_REQUEST (400).
    // It should not be used for application-layer errors.
    RPC_INVALID_REQUEST  = -32600,
    // RPC_METHOD_NOT_FOUND is internally mapped to HTTP_NOT_FOUND (404).
    // It should not be used for application-layer errors.
    RPC_METHOD_NOT_FOUND = -32601,
    RPC_INVALID_PARAMS   = -32602,
    // RPC_INTERNAL_ERROR should only be used for genuine errors in bitcoind
    // (for example datadir corruption).
    RPC_INTERNAL_ERROR   = -32603,
    RPC_PARSE_ERROR      = -32700,
 
    RPC_MISC_ERROR                  = -1,  
    RPC_TYPE_ERROR                  = -3,  
    RPC_INVALID_ADDRESS_OR_KEY      = -5,  
    RPC_OUT_OF_MEMORY               = -7,  
    RPC_INVALID_PARAMETER           = -8,  
    RPC_DATABASE_ERROR              = -20, 
    RPC_DESERIALIZATION_ERROR       = -22, 
    RPC_VERIFY_ERROR                = -25, 
    RPC_VERIFY_REJECTED             = -26, 
    RPC_VERIFY_ALREADY_IN_UTXO_SET  = -27, 
    RPC_IN_WARMUP                   = -28, 
    RPC_METHOD_DEPRECATED           = -32, 
    RPC_LIMIT_EXCEEDED              = -37, 
 
    RPC_TRANSACTION_ERROR           = RPC_VERIFY_ERROR,
    RPC_TRANSACTION_REJECTED        = RPC_VERIFY_REJECTED,
 
    RPC_CLIENT_NOT_CONNECTED        = -9,  
    RPC_CLIENT_IN_INITIAL_DOWNLOAD  = -10, 
    RPC_CLIENT_NODE_ALREADY_ADDED   = -23, 
    RPC_CLIENT_NODE_NOT_ADDED       = -24, 
    RPC_CLIENT_NODE_NOT_CONNECTED   = -29, 
    RPC_CLIENT_INVALID_IP_OR_SUBNET = -30, 
    RPC_CLIENT_P2P_DISABLED         = -31, 
    RPC_CLIENT_NODE_CAPACITY_REACHED= -34, 
 
    RPC_CLIENT_MEMPOOL_DISABLED     = -33, 
 
    RPC_WALLET_ERROR                = -4,  
    RPC_WALLET_INSUFFICIENT_FUNDS   = -6,  
    RPC_WALLET_INVALID_LABEL_NAME   = -11, 
    RPC_WALLET_KEYPOOL_RAN_OUT      = -12, 
    RPC_WALLET_UNLOCK_NEEDED        = -13, 
    RPC_WALLET_PASSPHRASE_INCORRECT = -14, 
    RPC_WALLET_WRONG_ENC_STATE      = -15, 
    RPC_WALLET_ENCRYPTION_FAILED    = -16, 
    RPC_WALLET_ALREADY_UNLOCKED     = -17, 
    RPC_WALLET_NOT_FOUND            = -18, 
    RPC_WALLET_NOT_SPECIFIED        = -19, 
    RPC_WALLET_ALREADY_LOADED       = -35, 
    RPC_WALLET_ALREADY_EXISTS       = -36, 
 
    RPC_WALLET_INVALID_ACCOUNT_NAME = RPC_WALLET_INVALID_LABEL_NAME,
 
    RPC_FORBIDDEN_BY_SAFE_MODE      = -2,  
};
 
#endif // BITCOIN_RPC_PROTOCOL_H