zebra_state/service/
read.rs

1//! Shared state reading code.
2//!
3//! Used by [`StateService`][1] and [`ReadStateService`][2] to read from the
4//! best [`Chain`][5] in the [`NonFinalizedState`][3], and the database in the
5//! [`FinalizedState`][4].
6//!
7//! [1]: service::StateService
8//! [2]: service::ReadStateService
9//! [3]: service::non_finalized_state::NonFinalizedState
10//! [4]: service::finalized_state::FinalizedState
11//! [5]: service::non_finalized_state::Chain
12
13// Tidy up some doc links
14#[allow(unused_imports)]
15use crate::service;
16
17pub mod address;
18pub mod block;
19pub mod difficulty;
20pub mod find;
21pub mod tree;
22
23#[cfg(test)]
24mod tests;
25
26pub use address::{
27    balance::transparent_balance,
28    tx_id::transparent_tx_ids,
29    utxo::{address_utxos, AddressUtxos},
30};
31pub use block::{
32    any_block, any_transaction, any_utxo, block, block_and_size, block_header, block_info,
33    mined_transaction, transaction_hashes_for_any_block, transaction_hashes_for_block,
34    unspent_utxo,
35};
36
37#[cfg(feature = "indexer")]
38pub use block::spending_transaction_hash;
39
40pub use find::{
41    best_tip, block_locator, depth, finalized_state_contains_block_hash, find_chain_hashes,
42    find_chain_headers, hash_by_height, height_by_hash, next_median_time_past,
43    non_finalized_state_contains_block_hash, tip, tip_height, tip_with_value_balance,
44};
45pub use tree::{orchard_subtrees, orchard_tree, sapling_subtrees, sapling_tree};
46
47#[cfg(any(test, feature = "proptest-impl"))]
48#[allow(unused_imports)]
49pub use address::utxo::ADDRESS_HEIGHTS_FULL_RANGE;
50
51/// If a finalized state query is interrupted by a new finalized block,
52/// retry this many times.
53///
54/// Once we're at the tip, we expect up to 2 blocks to arrive at the same time.
55/// If any more arrive, the client should wait until we're synchronised with our peers.
56pub const FINALIZED_STATE_QUERY_RETRIES: usize = 3;
zebra_state/service/read.rs

zebra_state/service/
read.rs
