CLI options

This reference describes the command-line interface of the native zesu binary. You can install the native binary and build it from source to:

• Debug a failing block.
• Validate a zkVM integration's commitment against a known-correct value.

note

Zesu's standalone debug mode is being refactored. The options and behavior on this page may change.

Specify options

You can specify Zesu options on the command line:

zesu [OPTIONS]

The binary reads one environment variable, ZESU_INPUT, which controls where it reads input bytes from when no input flag is provided.

Options

ssz

Syntax

--ssz [<FILE>]

Example

--ssz ./block.bin

Reads SSZ-encoded input from a binary file. If supplied without an argument, Zesu falls back to standard input or ZESU_INPUT.

Environment variables

ZESU_INPUT

Syntax

ZESU_INPUT=<FILE>

Example

ZESU_INPUT=./block.bin zesu

Path to a file containing SSZ-encoded input bytes. Used only when you don't pass a file to --ssz. If ZESU_INPUT is not set, Zesu reads from standard input.

Output streams

Zesu writes its public output (the 43-byte SSZ commitment) to standard output. Diagnostic messages go to standard error. See Inputs and outputs for the output format.

Exit codes

Code	Meaning
0	Block executed successfully and the post-state root and receipts root match the expected values.
1	Argument parsing failed, the input could not be loaded, execution returned an error, or the resulting state root or receipts root did not match the expected values.