Bitcoin Core  27.99.0
P2P Digital Currency
Classes | Functions | Variables
rest.cpp File Reference
#include <config/bitcoin-config.h>
#include <rest.h>
#include <blockfilter.h>
#include <chain.h>
#include <chainparams.h>
#include <core_io.h>
#include <flatfile.h>
#include <httpserver.h>
#include <index/blockfilterindex.h>
#include <index/txindex.h>
#include <node/blockstorage.h>
#include <node/context.h>
#include <primitives/block.h>
#include <primitives/transaction.h>
#include <rpc/blockchain.h>
#include <rpc/mempool.h>
#include <rpc/protocol.h>
#include <rpc/server.h>
#include <rpc/server_util.h>
#include <streams.h>
#include <sync.h>
#include <txmempool.h>
#include <util/any.h>
#include <util/check.h>
#include <util/strencodings.h>
#include <validation.h>
#include <any>
#include <vector>
#include <univalue.h>
Include dependency graph for rest.cpp:

Go to the source code of this file.

Classes

struct  CCoin
 

Functions

static bool RESTERR (HTTPRequest *req, enum HTTPStatusCode status, std::string message)
 
static NodeContextGetNodeContext (const std::any &context, HTTPRequest *req)
 Get the node context. More...
 
static CTxMemPoolGetMemPool (const std::any &context, HTTPRequest *req)
 Get the node context mempool. More...
 
static ChainstateManagerGetChainman (const std::any &context, HTTPRequest *req)
 Get the node context chainstatemanager. More...
 
RESTResponseFormat ParseDataFormat (std::string &param, const std::string &strReq)
 Parse a URI to get the data format and URI without data format and query string. More...
 
static std::string AvailableDataFormatsString ()
 
static bool CheckWarmup (HTTPRequest *req)
 
static bool rest_headers (const std::any &context, HTTPRequest *req, const std::string &strURIPart)
 
static bool rest_block (const std::any &context, HTTPRequest *req, const std::string &strURIPart, TxVerbosity tx_verbosity)
 
static bool rest_block_extended (const std::any &context, HTTPRequest *req, const std::string &strURIPart)
 
static bool rest_block_notxdetails (const std::any &context, HTTPRequest *req, const std::string &strURIPart)
 
static bool rest_filter_header (const std::any &context, HTTPRequest *req, const std::string &strURIPart)
 
static bool rest_block_filter (const std::any &context, HTTPRequest *req, const std::string &strURIPart)
 
RPCHelpMan getblockchaininfo ()
 
static bool rest_chaininfo (const std::any &context, HTTPRequest *req, const std::string &strURIPart)
 
RPCHelpMan getdeploymentinfo ()
 
static bool rest_deploymentinfo (const std::any &context, HTTPRequest *req, const std::string &str_uri_part)
 
static bool rest_mempool (const std::any &context, HTTPRequest *req, const std::string &str_uri_part)
 
static bool rest_tx (const std::any &context, HTTPRequest *req, const std::string &strURIPart)
 
static bool rest_getutxos (const std::any &context, HTTPRequest *req, const std::string &strURIPart)
 
static bool rest_blockhash_by_height (const std::any &context, HTTPRequest *req, const std::string &str_uri_part)
 
void StartREST (const std::any &context)
 Start HTTP REST subsystem. More...
 
void InterruptREST ()
 Interrupt RPC REST subsystem. More...
 
void StopREST ()
 Stop HTTP REST subsystem. More...
 

Variables

static const size_t MAX_GETUTXOS_OUTPOINTS = 15
 
static constexpr unsigned int MAX_REST_HEADERS_RESULTS = 2000
 
struct {
   RESTResponseFormat   rf
 
   const char *   name
 
rf_names []
 
struct {
   const char *   prefix
 
   bool(*   handler )(const std::any &context,
      HTTPRequest *req, const
      std::string &strReq)
 
uri_prefixes []
 

Function Documentation

◆ AvailableDataFormatsString()

static std::string AvailableDataFormatsString ( )
static

Definition at line 162 of file rest.cpp.

Here is the caller graph for this function:

◆ CheckWarmup()

static bool CheckWarmup ( HTTPRequest req)
static

Definition at line 179 of file rest.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ getblockchaininfo()

RPCHelpMan getblockchaininfo ( )

Definition at line 1268 of file blockchain.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetChainman()

static ChainstateManager* GetChainman ( const std::any &  context,
HTTPRequest req 
)
static

Get the node context chainstatemanager.

Parameters
[in]reqThe HTTP request, whose status code will be set if node context chainstatemanager is not found.
Returns
Pointer to the chainstatemanager or nullptr if none found.

Definition at line 123 of file rest.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ getdeploymentinfo()

RPCHelpMan getdeploymentinfo ( )

Definition at line 1383 of file blockchain.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetMemPool()

static CTxMemPool* GetMemPool ( const std::any &  context,
HTTPRequest req 
)
static

Get the node context mempool.

Parameters
[in]reqThe HTTP request, whose status code will be set if node context mempool is not found.
Returns
Pointer to the mempool or nullptr if no mempool found.

Definition at line 106 of file rest.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetNodeContext()

static NodeContext* GetNodeContext ( const std::any &  context,
HTTPRequest req 
)
static

Get the node context.

Parameters
[in]reqThe HTTP request, whose status code will be set if node context is not found.
Returns
Pointer to the node context or nullptr if not found.

Definition at line 85 of file rest.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ InterruptREST()

void InterruptREST ( )

Interrupt RPC REST subsystem.

Definition at line 1025 of file rest.cpp.

Here is the caller graph for this function:

◆ ParseDataFormat()

RESTResponseFormat ParseDataFormat ( std::string &  param,
const std::string &  strReq 
)

Parse a URI to get the data format and URI without data format and query string.

Parameters
[out]paramThe strReq without the data format string and without the query string (if any).
[in]strReqThe URI to be parsed.
Returns
RESTResponseFormat that was parsed from the URI.

Definition at line 137 of file rest.cpp.

Here is the caller graph for this function:

◆ rest_block()

static bool rest_block ( const std::any &  context,
HTTPRequest req,
const std::string &  strURIPart,
TxVerbosity  tx_verbosity 
)
static

Definition at line 283 of file rest.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ rest_block_extended()

static bool rest_block_extended ( const std::any &  context,
HTTPRequest req,
const std::string &  strURIPart 
)
static

Definition at line 352 of file rest.cpp.

Here is the call graph for this function:

◆ rest_block_filter()

static bool rest_block_filter ( const std::any &  context,
HTTPRequest req,
const std::string &  strURIPart 
)
static

Definition at line 484 of file rest.cpp.

Here is the call graph for this function:

◆ rest_block_notxdetails()

static bool rest_block_notxdetails ( const std::any &  context,
HTTPRequest req,
const std::string &  strURIPart 
)
static

Definition at line 357 of file rest.cpp.

Here is the call graph for this function:

◆ rest_blockhash_by_height()

static bool rest_blockhash_by_height ( const std::any &  context,
HTTPRequest req,
const std::string &  str_uri_part 
)
static

Definition at line 949 of file rest.cpp.

Here is the call graph for this function:

◆ rest_chaininfo()

static bool rest_chaininfo ( const std::any &  context,
HTTPRequest req,
const std::string &  strURIPart 
)
static

Definition at line 578 of file rest.cpp.

Here is the call graph for this function:

◆ rest_deploymentinfo()

static bool rest_deploymentinfo ( const std::any &  context,
HTTPRequest req,
const std::string &  str_uri_part 
)
static

Definition at line 605 of file rest.cpp.

Here is the call graph for this function:

◆ rest_filter_header()

static bool rest_filter_header ( const std::any &  context,
HTTPRequest req,
const std::string &  strURIPart 
)
static

Definition at line 362 of file rest.cpp.

Here is the call graph for this function:

◆ rest_getutxos()

static bool rest_getutxos ( const std::any &  context,
HTTPRequest req,
const std::string &  strURIPart 
)
static

Definition at line 758 of file rest.cpp.

Here is the call graph for this function:

◆ rest_headers()

static bool rest_headers ( const std::any &  context,
HTTPRequest req,
const std::string &  strURIPart 
)
static

Definition at line 187 of file rest.cpp.

Here is the call graph for this function:

◆ rest_mempool()

static bool rest_mempool ( const std::any &  context,
HTTPRequest req,
const std::string &  str_uri_part 
)
static

Definition at line 644 of file rest.cpp.

Here is the call graph for this function:

◆ rest_tx()

static bool rest_tx ( const std::any &  context,
HTTPRequest req,
const std::string &  strURIPart 
)
static

Definition at line 700 of file rest.cpp.

Here is the call graph for this function:

◆ RESTERR()

static bool RESTERR ( HTTPRequest req,
enum HTTPStatusCode  status,
std::string  message 
)
static

Definition at line 71 of file rest.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ StartREST()

void StartREST ( const std::any &  context)

Start HTTP REST subsystem.

Precondition; HTTP and RPC has been started.

Definition at line 1017 of file rest.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ StopREST()

void StopREST ( )

Stop HTTP REST subsystem.

Precondition; HTTP and RPC has been stopped.

Definition at line 1029 of file rest.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

Variable Documentation

◆ handler

bool(* handler) (const std::any &context, HTTPRequest *req, const std::string &strReq) ( const std::any &  context,
HTTPRequest req,
const std::string &  strReq 
)

Definition at line 1001 of file rest.cpp.

◆ MAX_GETUTXOS_OUTPOINTS

const size_t MAX_GETUTXOS_OUTPOINTS = 15
static

Definition at line 44 of file rest.cpp.

◆ MAX_REST_HEADERS_RESULTS

constexpr unsigned int MAX_REST_HEADERS_RESULTS = 2000
staticconstexpr

Definition at line 45 of file rest.cpp.

◆ name

const char* name

Definition at line 49 of file rest.cpp.

◆ prefix

const char* prefix

Definition at line 1000 of file rest.cpp.

◆ rf

Definition at line 48 of file rest.cpp.

◆ 

const { ... } rf_names[]

◆ 

const { ... } uri_prefixes[]
Initial value:
= {
{"/rest/tx/", rest_tx},
{"/rest/block/notxdetails/", rest_block_notxdetails},
{"/rest/block/", rest_block_extended},
{"/rest/blockfilter/", rest_block_filter},
{"/rest/blockfilterheaders/", rest_filter_header},
{"/rest/chaininfo", rest_chaininfo},
{"/rest/mempool/", rest_mempool},
{"/rest/headers/", rest_headers},
{"/rest/getutxos", rest_getutxos},
{"/rest/deploymentinfo/", rest_deploymentinfo},
{"/rest/deploymentinfo", rest_deploymentinfo},
{"/rest/blockhashbyheight/", rest_blockhash_by_height},
}
static bool rest_blockhash_by_height(const std::any &context, HTTPRequest *req, const std::string &str_uri_part)
Definition: rest.cpp:949
static bool rest_block_filter(const std::any &context, HTTPRequest *req, const std::string &strURIPart)
Definition: rest.cpp:484
static bool rest_getutxos(const std::any &context, HTTPRequest *req, const std::string &strURIPart)
Definition: rest.cpp:758
static bool rest_headers(const std::any &context, HTTPRequest *req, const std::string &strURIPart)
Definition: rest.cpp:187
static bool rest_tx(const std::any &context, HTTPRequest *req, const std::string &strURIPart)
Definition: rest.cpp:700
static bool rest_block_notxdetails(const std::any &context, HTTPRequest *req, const std::string &strURIPart)
Definition: rest.cpp:357
static bool rest_chaininfo(const std::any &context, HTTPRequest *req, const std::string &strURIPart)
Definition: rest.cpp:578
static bool rest_deploymentinfo(const std::any &context, HTTPRequest *req, const std::string &str_uri_part)
Definition: rest.cpp:605
static bool rest_mempool(const std::any &context, HTTPRequest *req, const std::string &str_uri_part)
Definition: rest.cpp:644
static bool rest_block_extended(const std::any &context, HTTPRequest *req, const std::string &strURIPart)
Definition: rest.cpp:352
static bool rest_filter_header(const std::any &context, HTTPRequest *req, const std::string &strURIPart)
Definition: rest.cpp:362