Module state 

Implementations of the v1 API traits and the v2 tonic service traits, both reading the one data source this type wraps.

Structs

NodeApiStateImpl

Node API state implementation

Constants

FETCH_TIMEOUT 🔒

Timeout for failing requests due to missing data.

MAX_NAMESPACES_PER_REQUEST 🔒

Bounds the namespace list of a v2 multi-namespace light-client request, as the URL length bounds v1’s, since every namespace costs a lookup in every block of the range.

NAMESPACE_PROOF_RANGE_LIMIT 🔒

Traits

StateSignatureDataSourceErased 🔒

SubmitDataSourceErased 🔒

Network-agnostic submit hook used by the axum wrapper. The original SubmitDataSource<N, P> trait is parameterized by the network type; this erased trait lets NodeApiStateImpl avoid carrying those parameters.

Functions

bad_request 🔒

block_id_from_query 🔒

block_id_to_hs 🔒

block_ident 🔒

v1 spells the three ways of naming a block as separate routes, so v2’s optional parameters carry the same choice, with neither given meaning the latest block.

catchup_at 🔒

The (height, view) the catchup routes over a merkle tree are asked for.

classify_query_error 🔒

end_at_first_error 🔒

A conversion error is sent as an event: error frame. Ending the stream there means a subscriber that skips the frame cannot miss a height without noticing.

enforce_range 🔒

explorer_error 🔒

Like lc_error, for explorer data source errors.

fetch_supply_inputs 🔒

header_query 🔒

large_object_range_limit 🔒

lc_error 🔒

Convert a query-service error to an AvailabilityError-carrying anyhow error so the HTTP layer returns the status carried by the error (400/404) instead of 500.

lc_large_object_range_limit 🔒

lc_leaf_proof_chain_limit 🔒

Bounds the leaves in a single leaf proof, and so the memory to build and serialize it.

leaf_query 🔒

namespace_from_query 🔒

namespace_id 🔒

Namespace ids are 32 bits on chain but travel as uint64 so they round-trip with the responses’ namespace fields. Anything wider is a client error, not a truncation.

node_window_limit 🔒

not_found 🔒

payload_id_to_hs 🔒

range_exceeded 🔒

range_from_query 🔒

ranges_from_body 🔒

required 🔒

serialize_tree 🔒

A tree travels as bincode, the encoding peers already decode from v1 and from the v2 reward tree route.

small_object_range_limit 🔒

snapshot_from_query 🔒

state_cert_error 🔒

transaction_ident 🔒

As block_ident, except that naming a transaction by position takes both height and offset, so half of that pair is a bad request rather than a fallback to the latest.

validate_ranges 🔒

Check a ranges request against the same per-request object limit the range endpoints enforce, and convert it for the data source.