NETSoon

Docs Run a node

Run a local cluster

Run twelve validators in three hubs on one machine with acrux net up, send traffic through it, crash a proposer and read the run report.

acrux net up runs a whole New Constellation net on one machine: twelve validators in three hubs, FRA, NYC and TYO, four in each, every validator its own actor with its own key, message state, executor and Votor. They exchange signed messages over loopback QUIC with the delays of their hubs' geography. Acrux Net runs from the same command.

Terminal
acrux net up

What runs

Validators12, equal stake, four per hub
Proposers3 per window, drawn by the schedule
Slots50 ms ms, 16 per window, 4 per cblock
Delaysinside a hub and between hubs as on Parameters
Traffic50 generated transfers per second, --traffic-rate to change it
GatewayJSON-RPC 127.0.0.1:4930, events ws://127.0.0.1:4931
Metricshttp://127.0.0.1:4989/metrics and /health
TransportQUIC on twelve ports from 127.0.0.1:4950

A 60% certificate needs eight of the twelve validators, so every cblock is decided by at least two hubs.

Point the SDK or /net at the gateway and the cluster is a net like any other.

A bounded run

Terminal
acrux net up --run-seconds 30 --traffic-rate 50

The run stops after 30 seconds. Without --run-seconds it runs until Ctrl+C.

Crash a proposer

Terminal
acrux net up --crash-window 2 --crash-proposer 3 --run-seconds 30

Proposer 3 of window 2 is silent from the window's start. The window continues on P = {1, 2}, and each slot's first vote waits for the attestation deadline. The same case runs as the Crash scenario.

Load a program

Terminal
acrux net up --program CUBR9LNdTwxwp5ARBQj1EopfuH8dr8u4i7DsXcb8HbHN=../chain/target/deploy/demo_pool.so

Each --program ADDRESS=PATH loads an SBF program into every validator's SVM before the first slot. Repeat it for more programs.

Stop and the report

Stop with Ctrl+C, or let --run-seconds end the run. The node closes its transport, writes last-run.json into the store directory and prints one summary line:

FieldMeaning
reportthe path of last-run.json
finalizedCblockscblocks finalized in the run
skipscblocks skipped
slotPacingUsslot start-to-start pacing: count, p50, p99, maximum, µs

The report holds, among the rest:

FieldMeaning
withinWindowPacingUs, windowHandoverGapUspacing inside windows, and the gap at each window boundary
proposerHandoverGapUsthe handover gap per hub link, keyed like FRA-NYC
commitSpreadUsfirst to last commitment of a slot
finalizationUsfirst slot of a cblock to its finalization
finalizedCblocks, skippedCblockscounts
comparedStateHashHeights, mismatchingStateHashHeightsheights whose state hashes were compared across validators, and how many differed
maximumExecutionSkewSlots, maximumExecutionLagSlotshow far validators' execution drifted apart and behind
stateHashes, validatorLastExecutedeach validator's final state hash and last executed slot
generatedTransactionstransfers the traffic generator sent

The store

--store names the run's directory, target/runs/net by default, relative to the working directory. Each start is a fresh genesis.

FileHolds
genesis.jsonthe run's configuration, seed, hubs and their members' identities
net-<start>.redbslot, cblock and transaction records; reads of evicted slots fall back to it
last-run.jsonthe run report, written on stop
profile.jsonphase timings, written on stop

Give each run its own directory to keep its report: --store target/runs/crash-30s.