Number of unique validators with pending withdrawals.

Push a pre-built withdrawal directly (for test setup and deserialization).

Start the `simplex` consensus engine. This will also rebuild the state of the engine from provided `Journal`.

Adds an argument to pass to `reth`. Pass any arg that is not supported by the builder.

Set a leaf value and incrementally rehash the path to root.

Create a new mock engine client

Returns the state root (top-level tree root).

Convert a list of ExecutionRequests to Requests # Arguments `execution_requests` - A vector of ExecutionRequest instances # Returns `Requests` - The

Create an EngineConfig with default values for testing # Arguments `engine_client` - Generic engine client implementing the EngineClient trait `parti

Returns a reference to the live SSZ state tree.

Add a withdrawal request. If the pubkey already has a pending withdrawal, merges amounts and balance deductions into the existing entry (keeping the o

Assert that all validators share the same state trie root.

Create a single DepositRequest for testing with valid ED25519 and BLS signatures This function creates a test deposit request with all required field

Whether there are any pending withdrawals.

Create a single WithdrawalRequest for testing # Arguments `source_address` - The address that initiated the withdrawal `validator_pubkey` - The valid

Get all withdrawals from the canonical chain

Registers a new signing scheme for the given epoch. Returns `false` if a scheme was already registered for the epoch.

Helper: build a tree from accounts using rebuild_validators (the reference path).

Commit all pending changes to the database

Generate a Merkle proof for the leaf at `leaf_index`. Returns sibling hashes in bottom-up order (from leaf level to root level). The proof has exactl

Builds the [`Hooks`] collection from the registered hooks.

Notifies the actor that a block has been verified.

Rebuild the validator subtree from the full validator accounts map. Each validator occupies 8 contiguous leaves (one per field) in the subtree, formi

Helper to create a test block with specific parent and height

Sets the `path` to the `reth` executable By default, it's expected that `reth` is in `$PATH`, see also [`std::process::Command::new()`]

Account operations

Initialize the tracing subscriber with an optional critical-event file layer. Replicates the stdout logging behavior of `commonware_runtime::tokio::t

Rebuild the entire SSZ state tree from scratch. Called on deserialization and when bulk-replacing state (e.g. `set_validator_accounts`).

Rebuild the withdrawal queue as per-epoch subtrees. Structure: epoch_tree → per-epoch subtree → 8 field leaves per withdrawal. Each epoch leaf = `mix

Start the actor.

Advances the current epoch. Called by the finalizer at each epoch boundary and at startup from persisted state.

Log a database error and initiate graceful shutdown.

Parse a substring from a metric name using XML-like tags # Arguments `metric` - The metric name to parse from `tag` - The tag name to look for (e.g.,

State variable operations

Parse a human-readable key descriptor into an [`SszStateKey`]. Scalar keys: `"epoch"`, `"view"`, `"latest_height"`, etc. Validator keys: `"validator:

Pop the next withdrawal for the given epoch.

A request to retrieve a block by its commitment. If the block is found available locally, the block will be returned immediately. If the block is no

Added for testing

Insert a new validator at positional `slot`, shifting existing validators right. Grows the tree if needed. Copies shifted validators' subtree nodes v

Remove the validator at positional `slot`, shifting subsequent validators left. O(N) memcpy + O(N/8) SHA256 for the shift, then partial rehash of upp

Takes the stdout contained in the child process. This leaves a `None` in its place, so calling methods that require a stdout to be present will fail

Returns the path to this instances' data directory.

Generate a proof for a validator account (whole account). The proof leaf is `hash_tree_root(ValidatorAccount)`, which is the internal node at the roo

Returns the instance number of this instance.

Keep the handle to reth's stdout in order to read from it. Caution: if the stdout handle isn't used, this can end up blocking.

Registers a new epoch length, taking effect at `current_epoch + 2`. Returns an error if the target epoch is before the latest registered segment's st

Assert that all validators (except those in `skip`) share the same state trie root. Validators that have exited the committee may have stale state, s

Creates a temporary key store directory with test keys

Generate a Merkle proof from an arbitrary node (not just a leaf) to the root. Returns sibling hashes in bottom-up order. The proof length equals the

A best-effort attempt to retrieve a given block from local storage. It is not an indication to go fetch the block from the network.

Compute the SSZ List root: `SHA256(tree_root || little_endian_u64(length))`.