#include <chain.h>
#include <common/args.h>
#include <common/messages.h>
#include <common/types.h>
#include <consensus/amount.h>
#include <core_io.h>
#include <key_io.h>
#include <node/types.h>
#include <outputtype.h>
#include <pow.h>
#include <rpc/util.h>
#include <script/descriptor.h>
#include <script/interpreter.h>
#include <script/signingprovider.h>
#include <script/solver.h>
#include <tinyformat.h>
#include <uint256.h>
#include <univalue.h>
#include <util/check.h>
#include <util/result.h>
#include <util/strencodings.h>
#include <util/string.h>
#include <util/translation.h>
#include <algorithm>
#include <iterator>
#include <string_view>
#include <tuple>
#include <utility>

Include dependency graph for util.cpp:

Classes
class	DescribeAddressVisitor
struct	Section
	A pair of strings that can be aligned (through padding) with other Sections later on. More...
struct	Sections
	Keeps track of RPCArgs by transforming them into sections for the purpose of serializing everything to a single string. More...

Macros
#define	TMPL_INST(check_param, ret_type, return_code)

Typedefs
using	CheckFn = void(const RPCArg&)

Enumerations
enum class	PSBTError
enum class	TransactionError

Functions
std::string	GetAllOutputTypes ()
	Gets all existing output types formatted for RPC help sections.
void	RPCTypeCheckObj (const UniValue &o, const std::map< std::string, UniValueType > &typesExpected, bool fAllowNull, bool fStrict)
int	ParseVerbosity (const UniValue &arg, int default_verbosity, bool allow_bool)
	Parses verbosity from provided UniValue.
CAmount	AmountFromValue (const UniValue &value, int decimals)
	Validate and return a CAmount from a UniValue number or string.
CFeeRate	ParseFeeRate (const UniValue &json)
	Parse a json number or string, denoting BTC/kvB, into a CFeeRate (sat/kvB).
uint256	ParseHashV (const UniValue &v, std::string_view name)
	Utilities: convert hex-encoded Values (throws error if not hex).
uint256	ParseHashO (const UniValue &o, std::string_view strKey)
std::vector< unsigned char >	ParseHexV (const UniValue &v, std::string_view name)
std::vector< unsigned char >	ParseHexO (const UniValue &o, std::string_view strKey)
std::string	HelpExampleCli (const std::string &methodname, const std::string &args)
std::string	HelpExampleCliNamed (const std::string &methodname, const RPCArgList &args)
std::string	HelpExampleRpc (const std::string &methodname, const std::string &args)
std::string	HelpExampleRpcNamed (const std::string &methodname, const RPCArgList &args)
CPubKey	HexToPubKey (const std::string &hex_in)
CTxDestination	AddAndGetMultisigDestination (const int required, const std::vector< CPubKey > &pubkeys, OutputType type, FlatSigningProvider &keystore, CScript &script_out)
UniValue	DescribeAddress (const CTxDestination &dest)
std::optional< int >	ParseSighashString (const UniValue &sighash)
	Returns a sighash value corresponding to the passed in argument.
unsigned int	ParseConfirmTarget (const UniValue &value, unsigned int max_target)
	Parse a confirm target option and raise an RPC error if it is invalid.
RPCErrorCode	RPCErrorFromPSBTError (PSBTError err)
RPCErrorCode	RPCErrorFromTransactionError (TransactionError terr)
UniValue	JSONRPCPSBTError (PSBTError err)
UniValue	JSONRPCTransactionError (TransactionError terr, const std::string &err_string)
static const UniValue *	DetailMaybeArg (CheckFn check, const std::vector< RPCArg > &params, const JSONRPCRequest req, size_t i)
static void	CheckRequiredOrDefault (const RPCArg &param)
	TMPL_INST (nullptr, const UniValue *, maybe_arg;)
	TMPL_INST (nullptr, std::optional< double >, maybe_arg ? std::optional{maybe_arg->get_real()} :std::nullopt;)
	TMPL_INST (nullptr, std::optional< bool >, maybe_arg ? std::optional{maybe_arg->get_bool()} :std::nullopt;)
	TMPL_INST (nullptr, std::optional< int64_t >, maybe_arg ? std::optional{maybe_arg->getInt< int64_t >()} :std::nullopt;)
	TMPL_INST (nullptr, std::optional< std::string_view >, maybe_arg ? std::optional< std::string_view >{maybe_arg->get_str()} :std::nullopt;)
	TMPL_INST (CheckRequiredOrDefault, const UniValue &, *CHECK_NONFATAL(maybe_arg);)
	TMPL_INST (CheckRequiredOrDefault, bool, CHECK_NONFATAL(maybe_arg) ->get_bool();)
	TMPL_INST (CheckRequiredOrDefault, int, CHECK_NONFATAL(maybe_arg) ->getInt< int >();)
	TMPL_INST (CheckRequiredOrDefault, uint64_t, CHECK_NONFATAL(maybe_arg) ->getInt< uint64_t >();)
	TMPL_INST (CheckRequiredOrDefault, uint32_t, CHECK_NONFATAL(maybe_arg) ->getInt< uint32_t >();)
	TMPL_INST (CheckRequiredOrDefault, std::string_view, CHECK_NONFATAL(maybe_arg) ->get_str();)
static std::optional< UniValue::VType >	ExpectedType (RPCArg::Type type)
static std::optional< UniValue::VType >	ExpectedType (RPCResult::Type type)
static std::pair< int64_t, int64_t >	ParseRange (const UniValue &value)
std::pair< int64_t, int64_t >	ParseDescriptorRange (const UniValue &value)
	Parse a JSON range specified as int64, or [int64, int64].
std::vector< CScript >	EvalDescriptorStringOrObject (const UniValue &scanobject, FlatSigningProvider &provider, const bool expand_priv)
	Evaluate a descriptor given as a string, or as a {"desc":...,"range":...} object, with default range of 1000.
static UniValue	BilingualStringsToUniValue (const std::vector< bilingual_str > &bilingual_strings)
	Convert a vector of bilingual strings to a UniValue::VARR containing their original untranslated values.
void	PushWarnings (const UniValue &warnings, UniValue &obj)
	Push warning messages to an RPC "warnings" field as a JSON array of strings.
void	PushWarnings (const std::vector< bilingual_str > &warnings, UniValue &obj)
std::vector< RPCResult >	ScriptPubKeyDoc ()
uint256	GetTarget (const CBlockIndex &blockindex, const uint256 pow_limit)
bilingual_str	PSBTErrorString (PSBTError err)
bilingual_str	TransactionErrorString (const TransactionError err)
template<typename C, typename S, typename UnaryOp>
auto	Join (const C &container, const S &separator, UnaryOp unary_op)
	Join all container items.
std::vector< std::string >	SplitString (std::string_view str, char sep)
std::string	TrimString (std::string_view str, std::string_view pattern=" \f\n\r\t\v")

Variables
const std::string	UNIX_EPOCH_TIME = "UNIX epoch time"
	String used to describe UNIX epoch time in documentation, factored out to a constant for consistency.
const std::string	EXAMPLE_ADDRESS [2] = {"bc1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl", "bc1q02ad21edsxd23d32dfgqqsz4vv4nmtfzuklhy3"}
	Example bech32 addresses for the RPCExamples help documentation.

Macro Definition Documentation

◆ TMPL_INST

#define TMPL_INST	(	check_param,
		ret_type,
		return_code )

Value:

template <>                                             \
ret_type RPCHelpMan::ArgValue<ret_type>(size_t i) const \
{                                                       \
    const UniValue* maybe_arg{                          \
        DetailMaybeArg(check_param, m_args, m_req, i),  \
    };                                                  \
    return return_code                                  \
}                                                       \
void force_semicolon(ret_type)

Definition at line 707 of file util.cpp.

Typedef Documentation

◆ CheckFn

using CheckFn = void(const RPCArg&)

Definition at line 685 of file util.cpp.

Enumeration Type Documentation

◆ PSBTError

enum class common::PSBTError

strong

Definition at line 17 of file types.h.

◆ TransactionError

enum class node::TransactionError

strong

Definition at line 28 of file types.h.

Function Documentation

◆ AddAndGetMultisigDestination()

CTxDestination AddAndGetMultisigDestination	(	const int	required,
		const std::vector< CPubKey > &	pubkeys,
		OutputType	type,
		FlatSigningProvider &	keystore,
		CScript &	script_out )

Definition at line 235 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ AmountFromValue()

CAmount AmountFromValue	(	const UniValue &	value,
		int	decimals = 8 )

Validate and return a CAmount from a UniValue number or string.

Parameters

[in]	value	UniValue number or string to parse.
[in]	decimals	Number of significant digits (default: 8).

Returns: a CAmount if the various checks pass.

Definition at line 98 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ BilingualStringsToUniValue()

UniValue BilingualStringsToUniValue ( const std::vector< bilingual_str > & bilingual_strings )

staticnodiscard

Convert a vector of bilingual strings to a UniValue::VARR containing their original untranslated values.

Definition at line 1368 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CheckRequiredOrDefault()

void CheckRequiredOrDefault ( const RPCArg & param )

static

Definition at line 698 of file util.cpp.

Here is the caller graph for this function:

◆ DescribeAddress()

UniValue DescribeAddress ( const CTxDestination & dest )

Definition at line 347 of file util.cpp.

Here is the caller graph for this function:

◆ DetailMaybeArg()

const UniValue * DetailMaybeArg	(	CheckFn *	check,
		const std::vector< RPCArg > &	params,
		const JSONRPCRequest *	req,
		size_t	i )

static

Definition at line 686 of file util.cpp.

Here is the call graph for this function:

◆ EvalDescriptorStringOrObject()

std::vector< CScript > EvalDescriptorStringOrObject	(	const UniValue &	scanobject,
		FlatSigningProvider &	provider,
		const bool	expand_priv )

Evaluate a descriptor given as a string, or as a {"desc":...,"range":...} object, with default range of 1000.

Definition at line 1324 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ExpectedType() [1/2]

std::optional< UniValue::VType > ExpectedType ( RPCArg::Type type )

static

Definition at line 865 of file util.cpp.

Here is the caller graph for this function:

◆ ExpectedType() [2/2]

std::optional< UniValue::VType > ExpectedType ( RPCResult::Type type )

static

Definition at line 1095 of file util.cpp.

◆ GetAllOutputTypes()

std::string GetAllOutputTypes ( )

Gets all existing output types formatted for RPC help sections.

Returns: Comma separated string representing output type names.

Definition at line 46 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetTarget()

uint256 GetTarget	(	const CBlockIndex &	blockindex,
		const uint256	pow_limit )

Definition at line 1401 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ HelpExampleCli()

std::string HelpExampleCli	(	const std::string &	methodname,
		const std::string &	args )

Definition at line 183 of file util.cpp.

◆ HelpExampleCliNamed()

std::string HelpExampleCliNamed	(	const std::string &	methodname,
		const RPCArgList &	args )

Definition at line 188 of file util.cpp.

Here is the caller graph for this function:

◆ HelpExampleRpc()

std::string HelpExampleRpc	(	const std::string &	methodname,
		const std::string &	args )

Definition at line 201 of file util.cpp.

◆ HelpExampleRpcNamed()

std::string HelpExampleRpcNamed	(	const std::string &	methodname,
		const RPCArgList &	args )

Definition at line 207 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ HexToPubKey()

CPubKey HexToPubKey ( const std::string & hex_in )

Definition at line 219 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Join()

template<typename C, typename S, typename UnaryOp>

auto util::Join	(	const C &	container,
		const S &	separator,
		UnaryOp	unary_op )

Join all container items.

Typically used to concatenate strings but accepts containers with elements of any type.

Parameters

container	The items to join
separator	The separator
unary_op	Apply this operator to each item

Definition at line 205 of file string.h.

Here is the caller graph for this function:

◆ JSONRPCPSBTError()

UniValue JSONRPCPSBTError ( PSBTError err )

Definition at line 403 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ JSONRPCTransactionError()

UniValue JSONRPCTransactionError	(	TransactionError	terr,
		const std::string &	err_string )

Definition at line 408 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ParseConfirmTarget()

unsigned int ParseConfirmTarget	(	const UniValue &	value,
		unsigned int	max_target )

Parse a confirm target option and raise an RPC error if it is invalid.

Definition at line 369 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ParseDescriptorRange()

std::pair< int64_t, int64_t > ParseDescriptorRange ( const UniValue & value )

Parse a JSON range specified as int64, or [int64, int64].

Definition at line 1308 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ParseFeeRate()

CFeeRate ParseFeeRate ( const UniValue & json )

Parse a json number or string, denoting BTC/kvB, into a CFeeRate (sat/kvB).

Reject negative values or rates larger than 1BTC/kvB.

Definition at line 110 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ParseHashO()

uint256 ParseHashO	(	const UniValue &	o,
		std::string_view	strKey )

Definition at line 126 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ParseHashV()

uint256 ParseHashV	(	const UniValue &	v,
		std::string_view	name )

Utilities: convert hex-encoded Values (throws error if not hex).

Definition at line 117 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ParseHexO()

std::vector< unsigned char > ParseHexO	(	const UniValue &	o,
		std::string_view	strKey )

Definition at line 139 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ParseHexV()

std::vector< unsigned char > ParseHexV	(	const UniValue &	v,
		std::string_view	name )

Definition at line 130 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ParseRange()

std::pair< int64_t, int64_t > ParseRange ( const UniValue & value )

static

Definition at line 1294 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ParseSighashString()

std::optional< int > ParseSighashString ( const UniValue & sighash )

Returns a sighash value corresponding to the passed in argument.

Parse a sighash string representation and raise an RPC error if it is invalid.

Precondition: The sighash argument should be string or null.

Definition at line 357 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ParseVerbosity()

int ParseVerbosity	(	const UniValue &	arg,
		int	default_verbosity,
		bool	allow_bool )

Parses verbosity from provided UniValue.

Parameters

[in]	arg	The verbosity argument as an int (0, 1, 2,...) or bool if allow_bool is set to true
[in]	default_verbosity	The value to return if verbosity argument is null
[in]	allow_bool	If true, allows arg to be a bool and parses it

Returns: An integer describing the verbosity level (e.g. 0, 1, 2, etc.)

Exceptions

JSONRPCError if allow_bool is false but arg provided is boolean

Definition at line 83 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ PSBTErrorString()

bilingual_str common::PSBTErrorString ( PSBTError err )

Definition at line 105 of file messages.cpp.

Here is the caller graph for this function:

◆ PushWarnings() [1/2]

void PushWarnings	(	const std::vector< bilingual_str > &	warnings,
		UniValue &	obj )

Definition at line 1384 of file util.cpp.

Here is the call graph for this function:

◆ PushWarnings() [2/2]

void PushWarnings	(	const UniValue &	warnings,
		UniValue &	obj )

Push warning messages to an RPC "warnings" field as a JSON array of strings.

Parameters

[in]	warnings	Warning messages to push.
[out]	obj	UniValue object to push the warnings array object to.

Definition at line 1378 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RPCErrorFromPSBTError()

RPCErrorCode RPCErrorFromPSBTError ( PSBTError err )

Definition at line 379 of file util.cpp.

Here is the caller graph for this function:

◆ RPCErrorFromTransactionError()

RPCErrorCode RPCErrorFromTransactionError ( TransactionError terr )

Definition at line 391 of file util.cpp.

Here is the caller graph for this function:

◆ RPCTypeCheckObj()

void RPCTypeCheckObj	(	const UniValue &	o,
		const std::map< std::string, UniValueType > &	typesExpected,
		bool	fAllowNull,
		bool	fStrict )

Definition at line 56 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ScriptPubKeyDoc()

std::vector< RPCResult > ScriptPubKeyDoc ( )

Definition at line 1390 of file util.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SplitString()

std::vector< std::string > util::SplitString	(	std::string_view	str,
		char	sep )

inlinenodiscard

Definition at line 149 of file string.h.

◆ TMPL_INST() [1/11]

TMPL_INST	(	CheckRequiredOrDefault	,
		bool	,
		CHECK_NONFATAL(maybe_arg) ->get_bool();	)

Here is the call graph for this function:

◆ TMPL_INST() [2/11]

TMPL_INST	(	CheckRequiredOrDefault	,
		const UniValue &	,
		*CHECK_NONFATAL(maybe_arg);	)

Here is the call graph for this function:

◆ TMPL_INST() [3/11]

TMPL_INST	(	CheckRequiredOrDefault	,
		int	,
		CHECK_NONFATAL(maybe_arg) ->getInt< int >();	)

Here is the call graph for this function:

◆ TMPL_INST() [4/11]

TMPL_INST	(	CheckRequiredOrDefault	,
		std::string_view	,
		CHECK_NONFATAL(maybe_arg) ->get_str();	)

Here is the call graph for this function:

◆ TMPL_INST() [5/11]

TMPL_INST	(	CheckRequiredOrDefault	,
		uint32_t	,
		CHECK_NONFATAL(maybe_arg) ->getInt< uint32_t >();	)

Here is the call graph for this function:

◆ TMPL_INST() [6/11]

TMPL_INST	(	CheckRequiredOrDefault	,
		uint64_t	,
		CHECK_NONFATAL(maybe_arg) ->getInt< uint64_t >();	)

Here is the call graph for this function:

◆ TMPL_INST() [7/11]

TMPL_INST	(	nullptr	,
		const UniValue *	,
		maybe_arg;	)

◆ TMPL_INST() [8/11]

TMPL_INST	(	nullptr	,
		std::optional< bool >	,
		maybe_arg ? std::optional{maybe_arg->get_bool()} :std::nullopt;	)

◆ TMPL_INST() [9/11]

TMPL_INST	(	nullptr	,
		std::optional< double >	,
		maybe_arg ? std::optional{maybe_arg->get_real()} :std::nullopt;	)

◆ TMPL_INST() [10/11]

TMPL_INST	(	nullptr	,
		std::optional< int64_t >	,
		maybe_arg ? std::optional{maybe_arg->getInt< int64_t >()} :std::nullopt;	)

◆ TMPL_INST() [11/11]

TMPL_INST	(	nullptr	,
		std::optional< std::string_view >	,
		maybe_arg ? std::optional< std::string_view >{maybe_arg->get_str()} :std::nullopt;	)

◆ TransactionErrorString()

bilingual_str common::TransactionErrorString ( const TransactionError err )

Definition at line 127 of file messages.cpp.

Here is the caller graph for this function:

◆ TrimString()

std::string util::TrimString	(	std::string_view	str,
		std::string_view	pattern = " \f\n\r\t\v" )

inlinenodiscard

Definition at line 169 of file string.h.

Variable Documentation

◆ EXAMPLE_ADDRESS

const std::string EXAMPLE_ADDRESS[2] = {"bc1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl", "bc1q02ad21edsxd23d32dfgqqsz4vv4nmtfzuklhy3"}

Example bech32 addresses for the RPCExamples help documentation.

They are intentionally invalid to prevent accidental transactions by users.

Definition at line 44 of file util.cpp.

◆ UNIX_EPOCH_TIME

const std::string UNIX_EPOCH_TIME = "UNIX epoch time"

String used to describe UNIX epoch time in documentation, factored out to a constant for consistency.

Definition at line 43 of file util.cpp.

Classes

Macros

Typedefs

Enumerations

Functions

Variables

Macro Definition Documentation

◆ TMPL_INST

Typedef Documentation

◆ CheckFn

Enumeration Type Documentation

◆ PSBTError

◆ TransactionError

Function Documentation

◆ AddAndGetMultisigDestination()

◆ AmountFromValue()

◆ BilingualStringsToUniValue()

◆ CheckRequiredOrDefault()

◆ DescribeAddress()

◆ DetailMaybeArg()

◆ EvalDescriptorStringOrObject()

◆ ExpectedType() [1/2]

◆ ExpectedType() [2/2]

◆ GetAllOutputTypes()

◆ GetTarget()

◆ HelpExampleCli()

◆ HelpExampleCliNamed()

◆ HelpExampleRpc()

◆ HelpExampleRpcNamed()

◆ HexToPubKey()

◆ Join()

◆ JSONRPCPSBTError()

◆ JSONRPCTransactionError()

◆ ParseConfirmTarget()

◆ ParseDescriptorRange()

◆ ParseFeeRate()

◆ ParseHashO()

◆ ParseHashV()

◆ ParseHexO()

◆ ParseHexV()

◆ ParseRange()

◆ ParseSighashString()

◆ ParseVerbosity()

◆ PSBTErrorString()

◆ PushWarnings() [1/2]

◆ PushWarnings() [2/2]

◆ RPCErrorFromPSBTError()

◆ RPCErrorFromTransactionError()

◆ RPCTypeCheckObj()

◆ ScriptPubKeyDoc()

◆ SplitString()

◆ TMPL_INST() [1/11]

◆ TMPL_INST() [2/11]

◆ TMPL_INST() [3/11]

◆ TMPL_INST() [4/11]

◆ TMPL_INST() [5/11]

◆ TMPL_INST() [6/11]

◆ TMPL_INST() [7/11]

◆ TMPL_INST() [8/11]

◆ TMPL_INST() [9/11]

◆ TMPL_INST() [10/11]

◆ TMPL_INST() [11/11]

◆ TransactionErrorString()

◆ TrimString()

Variable Documentation

◆ EXAMPLE_ADDRESS

◆ UNIX_EPOCH_TIME