Module scenarios

Expand description

§Mina Testing Scenarios

This module contains scenario-based tests for the Mina Rust node implementation. Scenarios are deterministic, ordered sequences of steps that test complex multi-node blockchain interactions.

§Documentation

For comprehensive documentation on the testing framework and available scenarios, see:

Scenario Tests - Main scenario testing documentation
Testing Framework - Overall testing architecture
Network Connectivity - Network connectivity testing details

§Usage

List available scenarios:

cargo run --release --bin mina-node-testing -- scenarios-list

Run a specific scenario:

cargo run --release --bin mina-node-testing -- scenarios-run --name scenario-name

§Test Categories

§Directory Structure and CI Integration

The directory structure in this module maps to specific test execution contexts:

solo_node/ - Single node scenarios, often testing OCaml interoperability
multi_node/ - Multi-node Rust network scenarios
p2p/ - Low-level P2P networking and protocol tests
record_replay/ - Scenario recording and replay functionality
simulation/ - Large-scale network simulations

In CI environments, these directories determine which specialized test binaries are used for execution, while locally all scenarios are accessible through the unified mina-node-testing CLI using scenario names.

§Basic Connectivity Tests

Ensure new nodes can discover peers and establish initial connections.
Test how nodes handle scenarios when they are overwhelmed with too many connections or data requests.

TODO(vlad9486):

Reconnection: Validate that nodes can reconnect after both intentional and unintentional disconnections.
Handling Latency: Nodes should remain connected and synchronize even under high latency conditions.
Intermittent Connections: Nodes should be resilient to sporadic network dropouts and still maintain synchronization.
Dynamic IP Handling: Nodes with frequently changing IP addresses should maintain stable connections.