Module get_block_template

Types and functions for the getblocktemplate RPC.

Re-exports

pub use constants::CAPABILITIES_FIELD;

pub use constants::DEFAULT_SOLUTION_RATE_WINDOW_SIZE;

pub use constants::MAX_ESTIMATED_DISTANCE_TO_NETWORK_CHAIN_TIP;

pub use constants::MEMPOOL_LONG_POLL_INTERVAL;

pub use constants::MUTABLE_FIELD;

pub use constants::NONCE_RANGE_FIELD;

pub use constants::NOT_SYNCED_ERROR_CODE;

pub use constants::ZCASHD_FUNDING_STREAM_ORDER;

pub use parameters::GetBlockTemplateRequestMode;

pub use parameters::JsonParameters;

pub use proposal::ProposalResponse;

pub use proposal::TimeSource;

Modules

constants

Constant values used in mining rpcs methods.

parameters

Parameter types for the getblocktemplate RPC.

proposal

getblocktemplate proposal mode implementation.

zip317

The ZIP-317 block production algorithm.

Structs

GetBlockTemplate

A serialized getblocktemplate RPC response in template mode.

GetBlockTemplateHandler

Handler for the getblocktemplate RPC.

Enums

Response

A getblocktemplate RPC response.

Functions

calculate_default_root_hashes

Returns the default block roots for the supplied coinbase and mempool transactions, and the supplied history tree.

calculate_miner_fee

Returns the total miner fee for mempool_txs.

check_parameters

Checks that data is omitted in Template mode or provided in Proposal mode,

check_synced_to_tip

Returns an error if Zebra is not synced to the consensus chain tip. Returns early with Ok(()) if Proof-of-Work is disabled on the provided network. This error might be incorrect if the local clock is skewed.

fetch_mempool_transactions

Returns the transactions that are currently in mempool, or None if the last_seen_tip_hash from the mempool response doesn’t match the tip hash from the state.

fetch_state_tip_and_local_time

Returns the state data for the block template.

generate_coinbase_and_roots

Generates and returns the coinbase transaction and default roots.

standard_coinbase_outputs

Returns the standard funding stream and miner reward transparent output scripts for network, height and miner_fee.

validate_block_proposal

Attempts to validate block proposal against all of the server’s usual acceptance rules (except proof-of-work).

Type Aliases

InBlockTxDependenciesDepth

An alias to indicate that a usize value represents the depth of in-block dependencies of a transaction.