Struct zebra_rpc::methods::get_block_template_rpcs::GetBlockTemplateRpcImpl

pub struct GetBlockTemplateRpcImpl<Mempool, State, Tip, BlockVerifierRouter, SyncStatus, AddressBook>
where
    Mempool: Service<Request, Response = Response, Error = BoxError> + Clone + Send + Sync + 'static,
    Mempool::Future: Send,
    State: Service<ReadRequest, Response = ReadResponse, Error = BoxError> + Clone + Send + Sync + 'static,
    <State as Service<ReadRequest>>::Future: Send,
    Tip: ChainTip + Clone + Send + Sync + 'static,
    BlockVerifierRouter: Service<Request, Response = Hash, Error = BoxError> + Clone + Send + Sync + 'static,
    <BlockVerifierRouter as Service<Request>>::Future: Send,
    SyncStatus: ChainSyncStatus + Clone + Send + Sync + 'static,
    AddressBook: AddressBookPeers + Clone + Send + Sync + 'static,
{
    network: Network,
    miner_address: Option<Address>,
    extra_coinbase_data: Vec<u8>,
    debug_like_zcashd: bool,
    mempool: Mempool,
    state: State,
    latest_chain_tip: Tip,
    block_verifier_router: BlockVerifierRouter,
    sync_status: SyncStatus,
    address_book: AddressBook,
}

RPC method implementations.

Fields

network: Network

The configured network for this RPC service.

miner_address: Option<Address>

The configured miner address for this RPC service.

Zebra currently only supports transparent addresses.

extra_coinbase_data: Vec<u8>

Extra data to include in coinbase transaction inputs. Limited to around 95 bytes by the consensus rules.

debug_like_zcashd: bool

Should Zebra’s block templates try to imitate zcashd? Developer-only config.

mempool: Mempool

A handle to the mempool service.

state: State

A handle to the state service.

latest_chain_tip: Tip

Allows efficient access to the best tip of the blockchain.

block_verifier_router: BlockVerifierRouter

The chain verifier, used for submitting blocks.

sync_status: SyncStatus

The chain sync status, used for checking if Zebra is likely close to the network chain tip.

address_book: AddressBook

Address book of peers, used for getpeerinfo.

Implementations

impl<Mempool, State, Tip, BlockVerifierRouter, SyncStatus, AddressBook> GetBlockTemplateRpcImpl<Mempool, State, Tip, BlockVerifierRouter, SyncStatus, AddressBook>

where Mempool: Service<Request, Response = Response, Error = BoxError> + Clone + Send + Sync + 'static, Mempool::Future: Send, State: Service<ReadRequest, Response = ReadResponse, Error = BoxError> + Clone + Send + Sync + 'static, <State as Service<ReadRequest>>::Future: Send, Tip: ChainTip + Clone + Send + Sync + 'static, BlockVerifierRouter: Service<Request, Response = Hash, Error = BoxError> + Clone + Send + Sync + 'static, <BlockVerifierRouter as Service<Request>>::Future: Send, SyncStatus: ChainSyncStatus + Clone + Send + Sync + 'static, AddressBook: AddressBookPeers + Clone + Send + Sync + 'static,

pub fn new( network: &Network, mining_config: Config, mempool: Mempool, state: State, latest_chain_tip: Tip, block_verifier_router: BlockVerifierRouter, sync_status: SyncStatus, address_book: AddressBook, ) -> Self

Create a new instance of the handler for getblocktemplate RPCs.

Panics

If the mining_config is invalid.

Trait Implementations

impl<Mempool, State, Tip, BlockVerifierRouter, SyncStatus, AddressBook> Clone for GetBlockTemplateRpcImpl<Mempool, State, Tip, BlockVerifierRouter, SyncStatus, AddressBook>

where Mempool: Service<Request, Response = Response, Error = BoxError> + Clone + Send + Sync + 'static + Clone, Mempool::Future: Send, State: Service<ReadRequest, Response = ReadResponse, Error = BoxError> + Clone + Send + Sync + 'static + Clone, <State as Service<ReadRequest>>::Future: Send, Tip: ChainTip + Clone + Send + Sync + 'static + Clone, BlockVerifierRouter: Service<Request, Response = Hash, Error = BoxError> + Clone + Send + Sync + 'static + Clone, <BlockVerifierRouter as Service<Request>>::Future: Send, SyncStatus: ChainSyncStatus + Clone + Send + Sync + 'static + Clone, AddressBook: AddressBookPeers + Clone + Send + Sync + 'static + Clone,

fn clone( &self, ) -> GetBlockTemplateRpcImpl<Mempool, State, Tip, BlockVerifierRouter, SyncStatus, AddressBook>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<Mempool, State, Tip, BlockVerifierRouter, SyncStatus, AddressBook> Debug for GetBlockTemplateRpcImpl<Mempool, State, Tip, BlockVerifierRouter, SyncStatus, AddressBook>

where Mempool: Service<Request, Response = Response, Error = BoxError> + Clone + Send + Sync + 'static, Mempool::Future: Send, State: Service<ReadRequest, Response = ReadResponse, Error = BoxError> + Clone + Send + Sync + 'static, <State as Service<ReadRequest>>::Future: Send, Tip: ChainTip + Clone + Send + Sync + 'static, BlockVerifierRouter: Service<Request, Response = Hash, Error = BoxError> + Clone + Send + Sync + 'static, <BlockVerifierRouter as Service<Request>>::Future: Send, SyncStatus: ChainSyncStatus + Clone + Send + Sync + 'static, AddressBook: AddressBookPeers + Clone + Send + Sync + 'static,

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<Mempool, State, Tip, BlockVerifierRouter, SyncStatus, AddressBook> GetBlockTemplateRpc for GetBlockTemplateRpcImpl<Mempool, State, Tip, BlockVerifierRouter, SyncStatus, AddressBook>

where Mempool: Service<Request, Response = Response, Error = BoxError> + Clone + Send + Sync + 'static, Mempool::Future: Send, State: Service<ReadRequest, Response = ReadResponse, Error = BoxError> + Clone + Send + Sync + 'static, <State as Service<ReadRequest>>::Future: Send, Tip: ChainTip + Clone + Send + Sync + 'static, BlockVerifierRouter: Service<Request, Response = Hash, Error = BoxError> + Clone + Send + Sync + 'static, <BlockVerifierRouter as Service<Request>>::Future: Send, SyncStatus: ChainSyncStatus + Clone + Send + Sync + 'static, AddressBook: AddressBookPeers + Clone + Send + Sync + 'static,

fn get_block_count(&self) -> Result<u32>

Returns the height of the most recent block in the best valid block chain (equivalently, the number of blocks in this chain excluding the genesis block).

fn get_block_hash(&self, index: i32) -> BoxFuture<Result<GetBlockHash>>

Returns the hash of the block of a given height iff the index argument correspond to a block in the best chain.

fn get_block_template( &self, parameters: Option<JsonParameters>, ) -> BoxFuture<Result<Response>>

Returns a block template for mining new Zcash blocks.

fn submit_block( &self, HexData: HexData, _parameters: Option<JsonParameters>, ) -> BoxFuture<Result<Response>>

Submits block to the node to be validated and committed. Returns the submit_block::Response for the operation, as a JSON string.

fn get_mining_info(&self) -> BoxFuture<Result<Response>>

Returns mining-related information.

fn get_network_sol_ps( &self, num_blocks: Option<i32>, height: Option<i32>, ) -> BoxFuture<Result<u64>>

Returns the estimated network solutions per second based on the last num_blocks before height.

fn get_peer_info(&self) -> BoxFuture<Result<Vec<PeerInfo>>>

Returns data about each connected network node.

fn validate_address(&self, raw_address: String) -> BoxFuture<Result<Response>>

Checks if a zcash address is valid. Returns information about the given address if valid.

fn z_validate_address(&self, raw_address: String) -> BoxFuture<Result<Response>>

Checks if a zcash address is valid. Returns information about the given address if valid.

fn get_block_subsidy( &self, height: Option<u32>, ) -> BoxFuture<Result<BlockSubsidy>>

Returns the block subsidy reward of the block at height, taking into account the mining slow start. Returns an error if height is less than the height of the first halving for the current network.

fn get_difficulty(&self) -> BoxFuture<Result<f64>>

Returns the proof-of-work difficulty as a multiple of the minimum difficulty.

fn z_list_unified_receivers( &self, address: String, ) -> BoxFuture<Result<Response>>

Returns the list of individual payment addresses given a unified address.

fn generate(&self, num_blocks: u32) -> BoxFuture<Result<Vec<GetBlockHash>>>

Mine blocks immediately. Returns the block hashes of the generated blocks.

fn get_network_hash_ps( &self, num_blocks: Option<i32>, height: Option<i32>, ) -> BoxFuture<Result<u64>>

Returns the estimated network solutions per second based on the last num_blocks before height.

fn to_delegate<M: Metadata>(self) -> IoDelegate<Self, M>

Create an IoDelegate, wiring rpc calls to the trait methods.