#include <monero_daemon.h>

Inheritance diagram for monero::monero_daemon:

Public Member Functions
virtual	~monero_daemon ()

virtual void	add_listener (monero_daemon_listener &listener)

virtual void	remove_listener (monero_daemon_listener &listener)

virtual std::set< monero_daemon_listener * >	get_listeners ()

virtual void	remove_listeners ()

virtual monero_version	get_version ()

virtual bool	is_trusted ()

virtual uint64_t	get_height ()

virtual std::string	get_block_hash (uint64_t height)

virtual std::shared_ptr< monero_block_template >	get_block_template (const std::string &wallet_address, const boost::optional< int > &reserve_size=boost::none)

virtual std::shared_ptr< monero_miner_data >	get_miner_data ()

virtual std::string	calculate_pow (uint32_t major_version, uint64_t height, const std::string &block_blob, const std::string &seed_hash)

virtual std::shared_ptr< monero_add_auxiliary_pow_result >	add_auxiliary_pow (const std::string &block_template_blob, const std::vector< std::shared_ptr< monero_auxiliary_pow > > &aux_pow)

virtual std::shared_ptr< monero_block_header >	get_last_block_header ()

virtual std::shared_ptr< monero_block_header >	get_block_header_by_hash (const std::string &block_hash)

virtual std::shared_ptr< monero_block_header >	get_block_header_by_height (uint64_t height)

virtual std::vector< std::shared_ptr< monero_block_header > >	get_block_headers_by_range (uint64_t start_height, uint64_t end_height)

virtual std::shared_ptr< monero_block >	get_block_by_hash (const std::string &block_hash)

virtual std::shared_ptr< monero_get_blocks_by_hash_result >	get_blocks_by_hash (const std::vector< std::string > &block_hashes, uint64_t start_height, bool prune, uint64_t max_block_count=0)

virtual std::shared_ptr< monero_block >	get_block_by_height (uint64_t height)

virtual std::vector< std::shared_ptr< monero_block > >	get_blocks_by_height (const std::vector< uint64_t > &heights)

virtual std::vector< std::shared_ptr< monero_block > >	get_blocks_by_range (boost::optional< uint64_t > start_height, boost::optional< uint64_t > end_height)

virtual std::vector< std::shared_ptr< monero_block > >	get_blocks_by_range_chunked (boost::optional< uint64_t > start_height, boost::optional< uint64_t > end_height, boost::optional< uint64_t > max_chunk_size)

virtual std::shared_ptr< monero_get_block_hashes_result >	get_block_hashes (const std::vector< std::string > &block_hashes)

virtual std::shared_ptr< monero_tx >	get_tx (const std::string &tx_hash, bool prune=false)

virtual std::vector< std::shared_ptr< monero_tx > >	get_txs (const std::vector< std::string > &tx_hashes, bool prune=false)

virtual boost::optional< std::string >	get_tx_hex (const std::string &tx_hash, bool prune=false)

virtual std::vector< std::string >	get_tx_hexes (const std::vector< std::string > &tx_hashes, bool prune=false)

virtual std::shared_ptr< monero_miner_tx_sum >	get_miner_tx_sum (uint64_t height, uint64_t num_blocks)

virtual std::shared_ptr< monero_fee_estimate >	get_fee_estimate (uint64_t grace_blocks=0)

virtual std::shared_ptr< monero_submit_tx_result >	submit_tx_hex (const std::string &tx_hex, bool do_not_relay=false)

virtual void	relay_tx_by_hash (const std::string &tx_hash)

virtual void	relay_txs_by_hash (const std::vector< std::string > &tx_hashes)

virtual std::vector< std::shared_ptr< monero_tx > >	get_tx_pool ()

virtual std::vector< std::string >	get_tx_pool_hashes ()

virtual std::vector< monero_tx_backlog_entry >	get_tx_pool_backlog ()

virtual std::shared_ptr< monero_tx_pool_stats >	get_tx_pool_stats ()

virtual void	flush_tx_pool ()

virtual void	flush_tx_pool (const std::vector< std::string > &hashes)

virtual void	flush_tx_pool (const std::string &hash)

virtual monero_key_image_spent_status	get_key_image_spent_status (const std::string &key_image)

virtual std::vector< monero_key_image_spent_status >	get_key_image_spent_statuses (const std::vector< std::string > &key_images)

virtual std::vector< uint64_t >	get_output_indices (const std::string &tx_hash)

virtual std::vector< std::shared_ptr< monero_output > >	get_outputs (const std::vector< monero_output > &outputs)

virtual std::vector< std::shared_ptr< monero_output_histogram_entry > >	get_output_histogram (const std::vector< uint64_t > &amounts, const boost::optional< int > &min_count, const boost::optional< int > &max_count, const boost::optional< bool > &is_unlocked, const boost::optional< int > &recent_cutoff)

virtual std::vector< std::shared_ptr< monero_output_distribution_entry > >	get_output_distribution (const std::vector< uint64_t > &amounts, const boost::optional< bool > &is_cumulative=boost::none, const boost::optional< uint64_t > &start_height=boost::none, const boost::optional< uint64_t > &end_height=boost::none)

virtual std::shared_ptr< monero_daemon_info >	get_info ()

virtual std::shared_ptr< monero_daemon_sync_info >	get_sync_info ()

virtual std::shared_ptr< monero_daemon_network_stats >	get_network_stats ()

virtual std::shared_ptr< monero_hard_fork_info >	get_hard_fork_info ()

virtual std::vector< std::shared_ptr< monero_alt_chain > >	get_alt_chains ()

virtual std::vector< std::string >	get_alt_block_hashes ()

virtual int	get_download_limit ()

virtual int	set_download_limit (int limit)

virtual int	reset_download_limit ()

virtual int	get_upload_limit ()

virtual int	set_upload_limit (int limit)

virtual int	reset_upload_limit ()

virtual std::vector< std::shared_ptr< monero_peer > >	get_peers ()

virtual std::vector< std::shared_ptr< monero_peer > >	get_known_peers ()

virtual std::vector< std::shared_ptr< monero_peer > >	get_public_peers (bool include_offline=false)

virtual void	set_outgoing_peer_limit (int limit)

virtual void	set_incoming_peer_limit (int limit)

virtual std::vector< std::shared_ptr< monero_ban > >	get_peer_bans ()

virtual void	set_peer_bans (const std::vector< std::shared_ptr< monero_ban > > &bans)

virtual void	set_peer_ban (const std::shared_ptr< monero_ban > &ban)

virtual std::shared_ptr< monero_ban >	get_peer_ban (const std::string &address)

virtual void	start_mining (const std::string &address, boost::optional< uint64_t > num_threads, boost::optional< bool > is_background, boost::optional< bool > ignore_battery)

virtual void	stop_mining ()

virtual std::shared_ptr< monero_mining_status >	get_mining_status ()

virtual std::shared_ptr< monero_generate_blocks_result >	generate_blocks (const std::string &wallet_address, uint64_t num_blocks, const boost::optional< std::string > &prev_block_hash=boost::none, const boost::optional< uint32_t > &starting_nonce=boost::none)

virtual void	submit_block (const std::string &block_blob)

virtual void	submit_blocks (const std::vector< std::string > &block_blobs)

virtual std::shared_ptr< monero_prune_result >	prune_blockchain (bool check)

virtual void	save_blockchain ()

virtual uint64_t	pop_blocks (uint64_t num_blocks)

virtual void	flush_cache (bool bad_blocks=false)

virtual void	set_bootstrap_daemon (const std::string &address, const std::string &username="", const std::string &password="", const std::string &proxy="")

virtual void	remove_bootstrap_daemon ()

virtual void	set_log_hash_rate (bool is_visible)

virtual void	set_log_level (int level)

virtual std::string	set_log_categories (const std::string &categories="")

virtual std::shared_ptr< monero_daemon_update_check_result >	check_for_update ()

virtual std::shared_ptr< monero_daemon_update_download_result >	download_update (const std::string &path="")

virtual void	stop ()

virtual std::shared_ptr< monero_block_header >	wait_for_next_block_header ()

Detailed Description

Monero daemon interface.

Constructor & Destructor Documentation

◆ ~monero_daemon()

virtual monero::monero_daemon::~monero_daemon ( )

inlinevirtual

Virtual destructor.

Member Function Documentation

◆ add_auxiliary_pow()

virtual std::shared_ptr< monero_add_auxiliary_pow_result > monero::monero_daemon::add_auxiliary_pow	(	const std::string &	block_template_blob,
		const std::vector< std::shared_ptr< monero_auxiliary_pow > > &	aux_pow )

inlinevirtual

Add auxiliary proof-of-work to a block template for merge mining, returning an updated block template whose Merkle root commits to the given auxiliary blocks.

Parameters

block_template_blob	is the block template blob to add auxiliary PoW to
aux_pow	identifies each auxiliary chain by id and its block's PoW hash

Returns: the updated block template along with the (possibly reordered) auxiliary PoW

Reimplemented in monero::monero_daemon_rpc.

◆ add_listener()

virtual void monero::monero_daemon::add_listener ( monero_daemon_listener & listener )

inlinevirtual

Register a listener receive daemon notifications.

Parameters

listener is the listener to receive daemon notifications

Reimplemented in monero::monero_daemon_rpc.

◆ calculate_pow()

virtual std::string monero::monero_daemon::calculate_pow	(	uint32_t	major_version,
		uint64_t	height,
		const std::string &	block_blob,
		const std::string &	seed_hash )

inlinevirtual

Calculate the proof-of-work hash of a mined block.

Parameters

major_version	is the block's major version
height	is the block's height
block_blob	is the block's blob to hash
seed_hash	is the seed hash used to select the RandomX dataset/cache

Returns: the block's proof-of-work hash

Reimplemented in monero::monero_daemon_rpc.

◆ check_for_update()

virtual std::shared_ptr< monero_daemon_update_check_result > monero::monero_daemon::check_for_update ( )

inlinevirtual

Check for update.

Returns: the result of the update check

Reimplemented in monero::monero_daemon_rpc.

◆ download_update()

virtual std::shared_ptr< monero_daemon_update_download_result > monero::monero_daemon::download_update ( const std::string & path = "" )

inlinevirtual

Download an update.

Parameters

path	is the path to download the update (optional)

Returns: the result of the update download

Reimplemented in monero::monero_daemon_rpc.

◆ flush_cache()

virtual void monero::monero_daemon::flush_cache ( bool bad_blocks = false )

inlinevirtual

Flush the daemon's invalid block and transaction caches.

Parameters

bad_blocks specifies to flush the bad blocks cache (default false)

Reimplemented in monero::monero_daemon_rpc.

◆ flush_tx_pool() [1/3]

virtual void monero::monero_daemon::flush_tx_pool ( )

inlinevirtual

Flushes all transactions from the tx pool.

Reimplemented in monero::monero_daemon_rpc.

◆ flush_tx_pool() [2/3]

virtual void monero::monero_daemon::flush_tx_pool ( const std::string & hash )

inlinevirtual

Flush a single transaction from the tx pool.

Parameters

hash	is the hash of transaction to flush

Reimplemented in monero::monero_daemon_rpc.

◆ flush_tx_pool() [3/3]

virtual void monero::monero_daemon::flush_tx_pool ( const std::vector< std::string > & hashes )

inlinevirtual

Flush transactions from the tx pool.

Parameters

hashes are hashes of transactions to flush

Reimplemented in monero::monero_daemon_rpc.

◆ generate_blocks()

virtual std::shared_ptr< monero_generate_blocks_result > monero::monero_daemon::generate_blocks	(	const std::string &	wallet_address,
		uint64_t	num_blocks,
		const boost::optional< std::string > &	prev_block_hash = boost::none,
		const boost::optional< uint32_t > &	starting_nonce = boost::none )

inlinevirtual

Generate blocks to a wallet address (regtest only).

Parameters

wallet_address	is the address of the wallet to receive miner transactions if block is successfully mined
num_blocks	is the number of blocks to generate
prev_block_hash	is the hash of the previous block to build on top of (optional, builds on the current tip if not given)
starting_nonce	is the starting nonce to use (optional)

Returns: the result of generating blocks; height is the height of the last block generated

Reimplemented in monero::monero_daemon_rpc.

◆ get_alt_block_hashes()

virtual std::vector< std::string > monero::monero_daemon::get_alt_block_hashes ( )

inlinevirtual

Get known block hashes which are not on the main chain.

Returns: known block hashes which are not on the main chain

Reimplemented in monero::monero_daemon_rpc.

◆ get_alt_chains()

virtual std::vector< std::shared_ptr< monero_alt_chain > > monero::monero_daemon::get_alt_chains ( )

inlinevirtual

Get alternative chains seen by the node.

Returns: alternative chains seen by the node

Reimplemented in monero::monero_daemon_rpc.

◆ get_block_by_hash()

virtual std::shared_ptr< monero_block > monero::monero_daemon::get_block_by_hash ( const std::string & block_hash )

inlinevirtual

Get a block by hash.

Parameters

block_hash is the hash of the block to get

Returns: the block with the given hash

Reimplemented in monero::monero_daemon_rpc.

◆ get_block_by_height()

virtual std::shared_ptr< monero_block > monero::monero_daemon::get_block_by_height ( uint64_t height )

inlinevirtual

Get a block by height.

Parameters

height is the height of the block to get

Returns: the block at the given height

Reimplemented in monero::monero_daemon_rpc.

◆ get_block_hash()

virtual std::string monero::monero_daemon::get_block_hash ( uint64_t height )

inlinevirtual

Get a block's hash by its height.

Parameters

height is the height of the block hash to get

Returns: tthe block's hash at the given height

Reimplemented in monero::monero_daemon_rpc.

◆ get_block_hashes()

virtual std::shared_ptr< monero_get_block_hashes_result > monero::monero_daemon::get_block_hashes ( const std::vector< std::string > & block_hashes )

inlinevirtual

Get block hashes as a binary request to the daemon.

Parameters

block_hashes is a short chain history; first 10 blocks hash goes sequential, next goes in pow(2,n) offset, like 2, 4, 8, 16, 32, 64 and so on, and the last one is always genesis block which is required, or the request fails.

Returns: the requested hashes plus their start height and the daemon's current chain height; the hash range starts at and includes the last one the daemon has in common with block_hashes (not the one after it); if block_hashes[0] already matches the daemon's tip, exactly one hash (the tip itself) comes back

Reimplemented in monero::monero_daemon_rpc.

◆ get_block_header_by_hash()

virtual std::shared_ptr< monero_block_header > monero::monero_daemon::get_block_header_by_hash ( const std::string & block_hash )

inlinevirtual

Get a block header by its hash.

Parameters

block_hash is the hash of the block to get the header of

Returns: the block's header

Reimplemented in monero::monero_daemon_rpc.

◆ get_block_header_by_height()

virtual std::shared_ptr< monero_block_header > monero::monero_daemon::get_block_header_by_height ( uint64_t height )

inlinevirtual

Get a block header by its height.

Parameters

height is the height of the block to get the header of

Returns: the block's header

Reimplemented in monero::monero_daemon_rpc.

◆ get_block_headers_by_range()

virtual std::vector< std::shared_ptr< monero_block_header > > monero::monero_daemon::get_block_headers_by_range	(	uint64_t	start_height,
		uint64_t	end_height )

inlinevirtual

Get block headers for the given range.

Parameters

start_height	is the start height lower bound inclusive (optional)
end_height	is the end height upper bound inclusive (optional)

Returns: block headers in the given range

Reimplemented in monero::monero_daemon_rpc.

◆ get_block_template()

virtual std::shared_ptr< monero_block_template > monero::monero_daemon::get_block_template	(	const std::string &	wallet_address,
		const boost::optional< int > &	reserve_size = boost::none )

inlinevirtual

Get a block template for mining a new block.

Parameters

wallet_address	is the address of the wallet to receive miner transactions if block is successfully mined
reserve_size	is the reserve size (optional)

Returns: a block template for mining a new block

Reimplemented in monero::monero_daemon_rpc.

◆ get_blocks_by_hash()

virtual std::shared_ptr< monero_get_blocks_by_hash_result > monero::monero_daemon::get_blocks_by_hash	(	const std::vector< std::string > &	block_hashes,
		uint64_t	start_height,
		bool	prune,
		uint64_t	max_block_count = 0 )

inlinevirtual

Get blocks by hash.

Parameters

block_hashes	is a short chain history; first 10 blocks hash goes sequential, next goes in pow(2,n) offset, like 2, 4, 8, 16, 32, 64 and so on, and the last one is always genesis block
start_height	is the start height to resume from; when non-zero, daemon skips the search to find the last block and is used as-is, ignoring block_hashes — except when block_hashes[0] already matches the daemon's tip, which short-circuits to an empty result (see

Returns: ) before start_height is ever consulted

Parameters

prune	specifies if returned blocks should be pruned (defaults to false)
max_block_count	caps how many blocks the daemon returns in one call (0 leaves it to the daemon's own default limit); use this to chunk large ranges instead of taking whatever the daemon hands back

Returns: the retrieved blocks plus the daemon's current chain height; the blocks are not a lookup of block_hashes, so their heights won't line up with block_hashes 1:1; the range starts at and includes the resume point (the common block found, or start_height itself when non-zero), not the block after it; if block_hashes[0] already matches the daemon's tip, an empty block list comes back (this noop check runs before start_height is consulted)

Reimplemented in monero::monero_daemon_rpc.

◆ get_blocks_by_height()

virtual std::vector< std::shared_ptr< monero_block > > monero::monero_daemon::get_blocks_by_height ( const std::vector< uint64_t > & heights )

inlinevirtual

Get blocks at the given heights.

Parameters

heights are the heights of the blocks to get

Returns: blocks at the given heights

Reimplemented in monero::monero_daemon_rpc.

◆ get_blocks_by_range()

virtual std::vector< std::shared_ptr< monero_block > > monero::monero_daemon::get_blocks_by_range	(	boost::optional< uint64_t >	start_height,
		boost::optional< uint64_t >	end_height )

inlinevirtual

Get blocks in the given height range.

Parameters

start_height	is the start height lower bound inclusive (optional)
end_height	is the end height upper bound inclusive (optional)

Returns: blocks in the given height range

Reimplemented in monero::monero_daemon_rpc.

◆ get_blocks_by_range_chunked()

virtual std::vector< std::shared_ptr< monero_block > > monero::monero_daemon::get_blocks_by_range_chunked	(	boost::optional< uint64_t >	start_height,
		boost::optional< uint64_t >	end_height,
		boost::optional< uint64_t >	max_chunk_size )

inlinevirtual

Get blocks in the given height range as chunked requests so that each request is not too big.

Parameters

start_height	is the start height lower bound inclusive (optional)
end_height	is the end height upper bound inclusive (optional)

Returns: blocks in the given height range

Reimplemented in monero::monero_daemon_rpc.

◆ get_download_limit()

virtual int monero::monero_daemon::get_download_limit ( )

inlinevirtual

Get the download bandwidth limit.

Returns: is the download bandwidth limit

Reimplemented in monero::monero_daemon_rpc.

◆ get_fee_estimate()

virtual std::shared_ptr< monero_fee_estimate > monero::monero_daemon::get_fee_estimate ( uint64_t grace_blocks = 0 )

inlinevirtual

Get mining fee estimates per kB.

Parameters

grace_blocks TODO

Returns: mining fee estimates per kB

Reimplemented in monero::monero_daemon_rpc.

◆ get_hard_fork_info()

virtual std::shared_ptr< monero_hard_fork_info > monero::monero_daemon::get_hard_fork_info ( )

inlinevirtual

Look up information regarding hard fork voting and readiness.

Returns: hard fork information

Reimplemented in monero::monero_daemon_rpc.

◆ get_height()

virtual uint64_t monero::monero_daemon::get_height ( )

inlinevirtual

Get the number of blocks in the longest chain known to the node.

Returns: the number of blocks

Reimplemented in monero::monero_daemon_rpc.

◆ get_info()

virtual std::shared_ptr< monero_daemon_info > monero::monero_daemon::get_info ( )

inlinevirtual

Get general information about the state of the node and the network.

Returns: general information about the node and network

Reimplemented in monero::monero_daemon_rpc.

◆ get_key_image_spent_status()

virtual monero_key_image_spent_status monero::monero_daemon::get_key_image_spent_status ( const std::string & key_image )

inlinevirtual

Get the spent status of the given key image.

Parameters

key_image is key image hex to get the status of

Returns: the status of the key image

◆ get_key_image_spent_statuses()

virtual std::vector< monero_key_image_spent_status > monero::monero_daemon::get_key_image_spent_statuses ( const std::vector< std::string > & key_images )

inlinevirtual

Get the spent status of each given key image.

Parameters

key_image are hex key images to get the statuses of

Returns: the spent status for each key image

Reimplemented in monero::monero_daemon_rpc.

◆ get_known_peers()

virtual std::vector< std::shared_ptr< monero_peer > > monero::monero_daemon::get_known_peers ( )

inlinevirtual

Get all known peers including their last known online status.

Returns: the daemon's known peers

Reimplemented in monero::monero_daemon_rpc.

◆ get_last_block_header()

virtual std::shared_ptr< monero_block_header > monero::monero_daemon::get_last_block_header ( )

inlinevirtual

Get the last block's header.

Returns: the last block's header

Reimplemented in monero::monero_daemon_rpc.

◆ get_listeners()

virtual std::set< monero_daemon_listener * > monero::monero_daemon::get_listeners ( )

inlinevirtual

Get the listeners registered with the daemon.

Reimplemented in monero::monero_daemon_rpc.

◆ get_miner_data()

virtual std::shared_ptr< monero_miner_data > monero::monero_daemon::get_miner_data ( )

inlinevirtual

Get the data needed to construct a block template for mining, e.g. for use by a pool that assembles its own block templates.

Returns: the current data for mining a new block

Reimplemented in monero::monero_daemon_rpc.

◆ get_miner_tx_sum()

virtual std::shared_ptr< monero_miner_tx_sum > monero::monero_daemon::get_miner_tx_sum	(	uint64_t	height,
		uint64_t	num_blocks )

inlinevirtual

Gets the total emissions and fees from the genesis block to the current height.

Parameters

height	is the height to start computing the miner sum
num_blocks	are the number of blocks to include in the sum

Returns: the sum emission and fees since the geneis block

Reimplemented in monero::monero_daemon_rpc.

◆ get_mining_status()

virtual std::shared_ptr< monero_mining_status > monero::monero_daemon::get_mining_status ( )

inlinevirtual

Get the daemon's mining status.

Returns: the daemon's mining status

Reimplemented in monero::monero_daemon_rpc.

◆ get_network_stats()

virtual std::shared_ptr< monero_daemon_network_stats > monero::monero_daemon::get_network_stats ( )

inlinevirtual

Get network (bandwidth) statistics since the daemon started.

Returns: the daemon's network statistics

Reimplemented in monero::monero_daemon_rpc.

◆ get_output_distribution()

virtual std::vector< std::shared_ptr< monero_output_distribution_entry > > monero::monero_daemon::get_output_distribution	(	const std::vector< uint64_t > &	amounts,
		const boost::optional< bool > &	is_cumulative = boost::none,
		const boost::optional< uint64_t > &	start_height = boost::none,
		const boost::optional< uint64_t > &	end_height = boost::none )

inlinevirtual

Creates an output distribution.

Parameters

amounts	are amounts of outputs to make the distribution with
is_cumulative	specifies if the results should be cumulative (defaults to TODO)
start_height	is the start height lower bound inclusive (optional)
end_height	is the end height upper bound inclusive (optional)

Returns: output distribution entries meeting the parameters

Reimplemented in monero::monero_daemon_rpc.

◆ get_output_histogram()

virtual std::vector< std::shared_ptr< monero_output_histogram_entry > > monero::monero_daemon::get_output_histogram	(	const std::vector< uint64_t > &	amounts,
		const boost::optional< int > &	min_count,
		const boost::optional< int > &	max_count,
		const boost::optional< bool > &	is_unlocked,
		const boost::optional< int > &	recent_cutoff )

inlinevirtual

Get a histogram of output amounts. For all amounts (possibly filtered by parameters), gives the number of outputs on the chain for that amount. RingCT outputs counts as 0 amount.

Parameters

amounts	are amounts of outputs to make the histogram with
min_count	TODO
max_count	TODO
is_unlocked	makes a histogram with outputs with the specified lock state
recent_cutoff	TODO

Returns: output histogram entries meeting the parameters

Reimplemented in monero::monero_daemon_rpc.

◆ get_output_indices()

virtual std::vector< uint64_t > monero::monero_daemon::get_output_indices ( const std::string & tx_hash )

inlinevirtual

Get the global output index of each output in a transaction.

Parameters

tx_hash is the hash of the transaction to get output indices for

Returns: the global output index of each output in the transaction, in order

Reimplemented in monero::monero_daemon_rpc.

◆ get_outputs()

virtual std::vector< std::shared_ptr< monero_output > > monero::monero_daemon::get_outputs ( const std::vector< monero_output > & outputs )

inlinevirtual

Get outputs identified by a list of output amounts and indices as a binary request.

Parameters

outputs identify each output by amount and index

Returns: the identified outputs

Reimplemented in monero::monero_daemon_rpc.

◆ get_peer_ban()

virtual std::shared_ptr< monero_ban > monero::monero_daemon::get_peer_ban ( const std::string & address )

inlinevirtual

Get the ban status of a peer node.

Parameters

address is the address of the peer node to check, e.g. "1.2.3.4" or "1.2.3.4:18080"

Returns: the peer's ban status

Reimplemented in monero::monero_daemon_rpc.

◆ get_peer_bans()

virtual std::vector< std::shared_ptr< monero_ban > > monero::monero_daemon::get_peer_bans ( )

inlinevirtual

Get peer bans.

Returns: entries about banned peers

Reimplemented in monero::monero_daemon_rpc.

◆ get_peers()

virtual std::vector< std::shared_ptr< monero_peer > > monero::monero_daemon::get_peers ( )

inlinevirtual

Get peers with active incoming or outgoing connections to the node.

Returns: the daemon's peers

Reimplemented in monero::monero_daemon_rpc.

◆ get_public_peers()

virtual std::vector< std::shared_ptr< monero_peer > > monero::monero_daemon::get_public_peers ( bool include_offline = false )

inlinevirtual

Get public nodes known to the daemon.

Parameters

include_offline specifies if offline nodes should be included (default false)

Returns: the daemon's known public nodes

Reimplemented in monero::monero_daemon_rpc.

◆ get_sync_info()

virtual std::shared_ptr< monero_daemon_sync_info > monero::monero_daemon::get_sync_info ( )

inlinevirtual

Get synchronization information.

Returns: contains sync information

Reimplemented in monero::monero_daemon_rpc.

◆ get_tx()

virtual std::shared_ptr< monero_tx > monero::monero_daemon::get_tx	(	const std::string &	tx_hash,
		bool	prune = false )

inlinevirtual

Get a transaction by hash.

Parameters

tx_hash	is the hash of the transaction to get
prune	specifies if the returned tx should be pruned (defaults to false)

Returns: the transaction with the given hash or null if not found

◆ get_tx_hex()

virtual boost::optional< std::string > monero::monero_daemon::get_tx_hex	(	const std::string &	tx_hash,
		bool	prune = false )

inlinevirtual

Get a transaction hex by hash.

Parameters

tx_hash	is the hash of the transaction to get hex from
prune	specifies if the returned tx hex should be pruned (defaults to false)

Returns: the tx hex with the given hash

◆ get_tx_hexes()

virtual std::vector< std::string > monero::monero_daemon::get_tx_hexes	(	const std::vector< std::string > &	tx_hashes,
		bool	prune = false )

inlinevirtual

Get transaction hexes by hashes.

Parameters

tx_hashes	are hashes of transactions to get hexes from
prune	specifies if the returned tx hexes should be pruned (defaults to false)

Returns: are the tx hexes

Reimplemented in monero::monero_daemon_rpc.

◆ get_tx_pool()

virtual std::vector< std::shared_ptr< monero_tx > > monero::monero_daemon::get_tx_pool ( )

inlinevirtual

Get valid transactions seen by the node but not yet mined into a block, as well as spent key image information for the tx pool.

Returns: transactions in the transaction pool

Reimplemented in monero::monero_daemon_rpc.

◆ get_tx_pool_backlog()

virtual std::vector< monero_tx_backlog_entry > monero::monero_daemon::get_tx_pool_backlog ( )

inlinevirtual

Get all transaction pool backlog.

Returns: transaction pool backlog entries

◆ get_tx_pool_hashes()

virtual std::vector< std::string > monero::monero_daemon::get_tx_pool_hashes ( )

inlinevirtual

Get hashes of transactions in the transaction pool.

Returns: hashes of transactions in the transaction pool

Reimplemented in monero::monero_daemon_rpc.

◆ get_tx_pool_stats()

virtual std::shared_ptr< monero_tx_pool_stats > monero::monero_daemon::get_tx_pool_stats ( )

inlinevirtual

Get transaction pool statistics.

Returns: statistics about the transaction pool

Reimplemented in monero::monero_daemon_rpc.

◆ get_txs()

virtual std::vector< std::shared_ptr< monero_tx > > monero::monero_daemon::get_txs	(	const std::vector< std::string > &	tx_hashes,
		bool	prune = false )

inlinevirtual

Get transactions by hashes.

Parameters

tx_hashes	are hashes of transactions to get
prune	specifies if the returned txs should be pruned (defaults to false)

Returns: found transactions with the given hashes

Reimplemented in monero::monero_daemon_rpc.

◆ get_upload_limit()

virtual int monero::monero_daemon::get_upload_limit ( )

inlinevirtual

Get the upload bandwidth limit.

Returns: is the upload bandwidth limit

Reimplemented in monero::monero_daemon_rpc.

◆ get_version()

virtual monero_version monero::monero_daemon::get_version ( )

inlinevirtual

Get the daemon's version.

Returns: the daemon's version

Reimplemented in monero::monero_daemon_rpc.

◆ is_trusted()

virtual bool monero::monero_daemon::is_trusted ( )

inlinevirtual

Indicates if the daemon is trusted or untrusted.

Returns: true if the daemon is trusted, false otherwise

Reimplemented in monero::monero_daemon_rpc.

◆ pop_blocks()

virtual uint64_t monero::monero_daemon::pop_blocks ( uint64_t num_blocks )

inlinevirtual

Pop (remove) blocks from the top of the blockchain.

Parameters

num_blocks is the number of blocks to pop

Returns: the blockchain height after popping the blocks

Reimplemented in monero::monero_daemon_rpc.

◆ prune_blockchain()

virtual std::shared_ptr< monero_prune_result > monero::monero_daemon::prune_blockchain ( bool check )

inlinevirtual

Prune the blockchain.

Parameters

check specifies to check the pruning (default false)

Returns: the prune result

Reimplemented in monero::monero_daemon_rpc.

◆ relay_tx_by_hash()

virtual void monero::monero_daemon::relay_tx_by_hash ( const std::string & tx_hash )

inlinevirtual

Relays a transaction by hash.

Parameters

tx_hash identifies the transaction to relay

◆ relay_txs_by_hash()

virtual void monero::monero_daemon::relay_txs_by_hash ( const std::vector< std::string > & tx_hashes )

inlinevirtual

Relays transactions by hash.

Parameters

tx_hashes identify the transactions to relay

Reimplemented in monero::monero_daemon_rpc.

◆ remove_bootstrap_daemon()

virtual void monero::monero_daemon::remove_bootstrap_daemon ( )

inlinevirtual

Disable the bootstrap daemon so the daemon no longer falls back to it.

◆ remove_listener()

virtual void monero::monero_daemon::remove_listener ( monero_daemon_listener & listener )

inlinevirtual

Unregister a listener to receive daemon notifications.

Parameters

listener is the listener to unregister

Reimplemented in monero::monero_daemon_rpc.

◆ remove_listeners()

virtual void monero::monero_daemon::remove_listeners ( )

inlinevirtual

Remove all listeners registered with the daemon.

Reimplemented in monero::monero_daemon_rpc.

◆ reset_download_limit()

virtual int monero::monero_daemon::reset_download_limit ( )

inlinevirtual

Reset the download bandwidth limit.

Returns: the download bandwidth limit after resetting

Reimplemented in monero::monero_daemon_rpc.

◆ reset_upload_limit()

virtual int monero::monero_daemon::reset_upload_limit ( )

inlinevirtual

Reset the upload bandwidth limit.

Returns: the upload bandwidth limit after resetting

Reimplemented in monero::monero_daemon_rpc.

◆ save_blockchain()

virtual void monero::monero_daemon::save_blockchain ( )

inlinevirtual

Save (flush) the blockchain to disk.

Reimplemented in monero::monero_daemon_rpc.

◆ set_bootstrap_daemon()

virtual void monero::monero_daemon::set_bootstrap_daemon	(	const std::string &	address,
		const std::string &	username = "",
		const std::string &	password = "",
		const std::string &	proxy = "" )

inlinevirtual

Set the bootstrap daemon used by the daemon to serve requests while it is not fully synced, e.g. a remote node.

Parameters

address	is the bootstrap daemon's address (host:port), "auto" to select a public node automatically, or an empty string to disable the bootstrap daemon
username	is the username to authenticate with the bootstrap daemon (optional)
password	is the password to authenticate with the bootstrap daemon (optional)
proxy	is the proxy used to reach the bootstrap daemon, e.g. a SOCKS proxy (optional)

Reimplemented in monero::monero_daemon_rpc.

◆ set_download_limit()

virtual int monero::monero_daemon::set_download_limit ( int limit )

inlinevirtual

Set the download bandwidth limit.

Parameters

limit is the download limit to set (-1 to reset to default)

Returns: int is the new download limit after setting

Reimplemented in monero::monero_daemon_rpc.

◆ set_incoming_peer_limit()

virtual void monero::monero_daemon::set_incoming_peer_limit ( int limit )

inlinevirtual

Limit number of incoming peers.

Parameters

limit is the maximum number of incoming peers

Reimplemented in monero::monero_daemon_rpc.

◆ set_log_categories()

virtual std::string monero::monero_daemon::set_log_categories ( const std::string & categories = "" )

inlinevirtual

Set the daemon's log categories.

Parameters

categories are the log categories to set, e.g. "*:WARNING,net.p2p:DEBUG" (an empty string resets categories to the default)

Returns: the daemon's resulting log categories

Reimplemented in monero::monero_daemon_rpc.

◆ set_log_hash_rate()

virtual void monero::monero_daemon::set_log_hash_rate ( bool is_visible )

inlinevirtual

Show or hide the mining hash rate in the daemon's console log.

Parameters

is_visible specifies if the hash rate should be logged

Reimplemented in monero::monero_daemon_rpc.

◆ set_log_level()

virtual void monero::monero_daemon::set_log_level ( int level )

inlinevirtual

Set the daemon's log level.

Parameters

level is the log level to set, from 0 (least verbose) to 4 (most verbose)

Reimplemented in monero::monero_daemon_rpc.

◆ set_outgoing_peer_limit()

virtual void monero::monero_daemon::set_outgoing_peer_limit ( int limit )

inlinevirtual

Limit number of outgoing peers.

Parameters

limit is the maximum number of outgoing peers

Reimplemented in monero::monero_daemon_rpc.

◆ set_peer_ban()

virtual void monero::monero_daemon::set_peer_ban ( const std::shared_ptr< monero_ban > & ban )

inlinevirtual

Ban a peer node.

Parameters

ban	contains information about a node to ban

◆ set_peer_bans()

virtual void monero::monero_daemon::set_peer_bans ( const std::vector< std::shared_ptr< monero_ban > > & bans )

inlinevirtual

Ban peers nodes.

Parameters

bans	are bans to apply against peer nodes

Reimplemented in monero::monero_daemon_rpc.

◆ set_upload_limit()

virtual int monero::monero_daemon::set_upload_limit ( int limit )

inlinevirtual

Set the upload bandwidth limit.

Parameters

limit is the upload limit to set (-1 to reset to default)

Returns: int is the new upload limit after setting

Reimplemented in monero::monero_daemon_rpc.

◆ start_mining()

virtual void monero::monero_daemon::start_mining	(	const std::string &	address,
		boost::optional< uint64_t >	num_threads,
		boost::optional< bool >	is_background,
		boost::optional< bool >	ignore_battery )

inlinevirtual

Start mining.

Parameters

address	is the address given miner rewards if the daemon mines a block
num_threads	is the number of mining threads to run
is_background	specifies if the miner should run in the background or not
ignore_battery	specifies if the battery state (e.g. on laptop) should be ignored or not

Reimplemented in monero::monero_daemon_rpc.

◆ stop()

virtual void monero::monero_daemon::stop ( )

inlinevirtual

Safely disconnect and shut down the daemon.

Reimplemented in monero::monero_daemon_rpc.

◆ stop_mining()

virtual void monero::monero_daemon::stop_mining ( )

inlinevirtual

Stop mining.

Reimplemented in monero::monero_daemon_rpc.

◆ submit_block()

virtual void monero::monero_daemon::submit_block ( const std::string & block_blob )

inlinevirtual

Submit a mined block to the network.

Parameters

block_blob is the mined block to submit

◆ submit_blocks()

virtual void monero::monero_daemon::submit_blocks ( const std::vector< std::string > & block_blobs )

inlinevirtual

Submit mined blocks to the network.

Parameters

block_blobs are the mined blocks to submit

Reimplemented in monero::monero_daemon_rpc.

◆ submit_tx_hex()

virtual std::shared_ptr< monero_submit_tx_result > monero::monero_daemon::submit_tx_hex	(	const std::string &	tx_hex,
		bool	do_not_relay = false )

inlinevirtual

Submits a transaction to the daemon's pool.

Parameters

tx_hex	is the raw transaction hex to submit
do_not_relay	specifies if the tx should be relayed (optional)

Returns: the submission results

Reimplemented in monero::monero_daemon_rpc.

◆ wait_for_next_block_header()

virtual std::shared_ptr< monero_block_header > monero::monero_daemon::wait_for_next_block_header ( )

inlinevirtual

Get the header of the next block added to the chain.

Returns: the header of the next block added to the chain

Reimplemented in monero::monero_daemon_rpc.

The documentation for this class was generated from the following file:

daemon/monero_daemon.h

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~monero_daemon()

Member Function Documentation

◆ add_auxiliary_pow()

◆ add_listener()

◆ calculate_pow()

◆ check_for_update()

◆ download_update()

◆ flush_cache()

◆ flush_tx_pool() [1/3]

◆ flush_tx_pool() [2/3]

◆ flush_tx_pool() [3/3]

◆ generate_blocks()

◆ get_alt_block_hashes()

◆ get_alt_chains()

◆ get_block_by_hash()

◆ get_block_by_height()

◆ get_block_hash()

◆ get_block_hashes()

◆ get_block_header_by_hash()

◆ get_block_header_by_height()

◆ get_block_headers_by_range()

◆ get_block_template()

◆ get_blocks_by_hash()

◆ get_blocks_by_height()

◆ get_blocks_by_range()

◆ get_blocks_by_range_chunked()

◆ get_download_limit()

◆ get_fee_estimate()

◆ get_hard_fork_info()

◆ get_height()

◆ get_info()

◆ get_key_image_spent_status()

◆ get_key_image_spent_statuses()

◆ get_known_peers()

◆ get_last_block_header()

◆ get_listeners()

◆ get_miner_data()

◆ get_miner_tx_sum()

◆ get_mining_status()

◆ get_network_stats()

◆ get_output_distribution()

◆ get_output_histogram()

◆ get_output_indices()

◆ get_outputs()

◆ get_peer_ban()

◆ get_peer_bans()

◆ get_peers()

◆ get_public_peers()

◆ get_sync_info()

◆ get_tx()

◆ get_tx_hex()

◆ get_tx_hexes()

◆ get_tx_pool()

◆ get_tx_pool_backlog()

◆ get_tx_pool_hashes()

◆ get_tx_pool_stats()

◆ get_txs()

◆ get_upload_limit()

◆ get_version()

◆ is_trusted()

◆ pop_blocks()

◆ prune_blockchain()

◆ relay_tx_by_hash()

◆ relay_txs_by_hash()

◆ remove_bootstrap_daemon()

◆ remove_listener()

◆ remove_listeners()

◆ reset_download_limit()

◆ reset_upload_limit()

◆ save_blockchain()

◆ set_bootstrap_daemon()

◆ set_download_limit()

◆ set_incoming_peer_limit()

◆ set_log_categories()

◆ set_log_hash_rate()

◆ set_log_level()

◆ set_outgoing_peer_limit()