Nockchain Testkit/E2E Trace

scenario-yaml-schema

Defines the YAML scenario grammar that upstream E2E tests use for nodes, actions, wallet captures, and assertions.

The schema names node topology, fakenet options, wallet operations, partitions, upgrades, gRPC waits, transaction checks, and assertion contracts.

runner-scenario-lifecycle

Loads a scenario, seeds runtime ports and env vars, manages a run directory, executes actions/assertions, and writes the final report.

run_scenario creates run_id/run_dir/report state, run_inner starts and shuts down nodes, and run_steps records action and assertion outcomes.

node-manager-process-docker

Controls process-mode and Docker-mode Nockchain nodes with resolved public/private gRPC and p2p ports.

NodeManager starts, stops, and restarts nodes, writes stdout/stderr logs, and maps Docker ports while keeping node ids and data directories explicit.

node-command-args

Materializes scenario node specs into CLI args for fakenet, mining, topology peers, force peers, v1/bythos phases, and genesis/update options.

The builder covers public/private gRPC binds, --fakenet, --new, --mine, --mining-pkh, --no-default-peers, peer flags, and phase-specific fakenet parameters.

grpc-readiness-height

Polls public/private gRPC readiness and height so a scenario can distinguish boot, sync, and endpoint failures.

The helpers retry endpoint probes with deadlines and return observed height/readiness state instead of treating startup timing as a test result.

grpc-transaction-lifecycle

Separates raw transaction submission, node acceptance, and observed block inclusion.

The code records submit ack/error, accepted transaction state, and tx-in-block waits as distinct scenario outcomes.

private-poke-mining-controls

Exercises private gRPC pokes for live mining key and mining-enabled controls.

The helpers send private pokes to mutate local mining behavior without making public endpoint state or wallet secrets part of the receipt.

report-json-contract

Defines the upstream JSON report vocabulary for scenario status, steps, assertions, node summaries, and timestamps.

Report::write_json persists a pretty JSON report with scenario, seed, run id, status/error, started/finished epoch fields, step records, assert outcomes, and node summaries.

peer-speedup-report

Produces gen1/gen2 peer request/response comparison reports for throughput, request count, and latency ratios.

assert_peer_speedup writes a JSON report and fails when gen2 ratios do not meet the configured threshold.

upgrade-cluster-harness

Builds upgrade-focused fakenet clusters and wallet clients around activation height, phase flags, mining pkh, and private wallet commands.

The harness constructs a single-node fakenet with bythos/v1 phase settings and runs wallet commands against private gRPC ports.

nous-gen2-scenarios

Shows upstream testnet-style scenarios for gen2 request/response sends, wallet setup, partition, and reorg behavior.

The YAML scenarios combine miners, full nodes, fakenet ports, gen2 env flags, wallet captures, mining pkh updates, block stuffer commands, and partition/reorg waits.