Crate espresso_node 

Re-exports

pub use genesis::Genesis;

pub use genesis::GenesisSource;

pub use options::Options;

pub use run::main;

pub use espresso_keyset as keyset;

Modules

api

catchup

consensus_handle

context

external_event_handler 🔒

Should probably rename this to “external” or something

follower

A query node that follows the chain through the light client instead of taking part in consensus. Verified blocks reach the query API through the same sink a validator hands its decides to, so every API module serves them unchanged.

genesis

options

persistence

Sequencer node persistence.

proposal_fetcher 🔒

request_response 🔒

run

startup_catchup 🔒

Startup stake-table catchup for new-protocol nodes.

state

state_cert

State certificate validation and error handling

state_signature

Utilities for generating and storing the most recent light client state signatures.

util

Structs

CatchupParams

L1Params

NetworkParams

NodeStateParts 🔒

Enums

LoadedNetworkConfig 🔒

Constants

DECAF_TELEMETRY_ENDPOINT 🔒

MAINNET_TELEMETRY_ENDPOINT 🔒

RECENT_STAKE_TABLES_LIMIT

Number of recent per-epoch stake tables kept in memory.

Functions

apply_genesis_overrides 🔒

Orchestrator and peer-fetched configs carry none of these; run before the config is persisted.

check_cliquenet_info_registered 🔒

On the version immediately preceding CLIQUENET, log an error if this validator has a stake-table entry without an x25519 key or p2p address. Skipped unless StakeTableV3 is deployed (otherwise the operator has no actionable path), detected via getVersion() on the proxy.

default_telemetry_endpoint 🔒

Default telemetry endpoint for known networks. Unknown chains have no default; operators set ESPRESSO_NODE_TELEMETRY_ENDPOINT explicitly.

init_node

init_node_state 🔒

The epoch layout is read from genesis, not network_config, so a caller that skips apply_genesis_overrides cannot silently start with epoch_height = 0.

load_or_fetch_network_config 🔒

local_validator_config 🔒

This node’s own validator config, which status/keys reports.

orchestrator_registration 🔒

The config this node registers with the orchestrator. Its public_config() is also what /ready posts, since the orchestrator equality-checks that against known_nodes_with_stake. It carries the node’s cliquenet connect_info so peers can dial us from the stake table, which requires an advertise address to be configured.

prefetch_stake_table_events 🔒

Scans the whole L1 contract history when nothing is persisted yet, keeping every bootstrap_epoch_window step bounded to one epoch instead of loading that scan onto the first step, which silently downgrades the node to a stale epoch window when it exceeds its timeout. Untimed: an unreachable L1 panics after l1_events_max_retry_duration.

Type Aliases

SequencerApiVersion