Skip to content

Command-line interface

The tracked CLI fixture is rendered by a Rust test from the actual Clap command tree. The Bun-only site consumes that reviewed fixture without compiling Leani.

Exit codes

Code Meaning
0 Success. A subscribe stopped by a signal or --timeout also exits 0, unless --once had not printed a match yet.
1 Runtime failure.
2 Usage error: an unknown command, flag, or value.
3 doctor found the configuration unreadable or invalid.
124 subscribe --once reached --timeout before a match.
130 subscribe --once was stopped by SIGINT or SIGTERM before a match, or a second signal cut a shutdown short.

Commands

leaniLow-storage, source-interchangeable Ethereum indexing node

Usage: leani [OPTIONS] <COMMAND>

ArgumentPurposeDefault / values
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani doctorValidate and describe configuration without mutating state

Usage: leani doctor [OPTIONS]

ArgumentPurposeDefault / values
--jsonEmit machine-readable JSONfalse
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani serveStart configured sources, processors, stores, and serving endpoints

Usage: leani serve [OPTIONS]

ArgumentPurposeDefault / values
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani guidePrint the guide for agents and scripts that matches this binary

Usage: leani guide [OPTIONS] [TOPIC]

ArgumentPurposeDefault / values
topicSection to print [default: the overview]processors | config
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani initCreate a configuration

Usage: leani init [OPTIONS] [PROTOCOL] [TARGET]...

ArgumentPurposeDefault / values
protocolProcessor preset to configure; --requirements names its ownblocks | uniswap-v3
targetsOptional protocol targets; Uniswap requires one or more markets such as `ETH/USDC`—
--networkChain to follow: a built-in chain entry or its alias, such as `base`, `op`, `arbitrum-one`, `robinhood`, or `hoodi`ethereum-mainnet
--data-dirData directory for the generated configuration [default: `data` beside it]—
--checkpoint-urlCheckpoint provider used for weak-subjectivity quorum (repeatable or comma-delimited) [default: the providers the chain entry names; a rollup's L1 anchor uses Ethereum Mainnet's]—
--checkpoint-quorumNumber of independent checkpoint providers that must agree2
--yesAccept a new checkpoint provider quorum without interactive confirmationfalse
--keepHow much to keep for queries or your appeverything | window | latest | result | stream | live
--window-daysDays `--keep window` keeps [default: 30]—
--followWhich blocks to follow as they arrivehead | finalized | none
--history-from-blockFirst block to backfill—
--memoryMemory the node may use, such as `1GiB`—
--diskDisk the node may use, such as `20GiB`—
--bandwidthThe host's link, in megabits per second—
--tuningTuning recipes to apply instead of the ones the limits call for (comma-delimited)limited-memory | less-memory | transactions-from-xatu | slow-disk
--requirementsRequirements as JSON, as `leani guide config` describes, from a file or `-` for stdin. They replace the preset and the requirement flags—
--jsonPrint what was built as JSON: the configuration, the settings it derived and why, warnings, and next stepsfalse
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani subscribeStream live processor output from an embedded runtime or a running node

Usage: leani subscribe [OPTIONS] <PROTOCOL> [TARGET]...

ArgumentPurposeDefault / values
protocolBuilt-in subscription feed to activateblocks | uniswap-v3
targetsOptional feed targets; Uniswap requires one or more markets such as `ETH/USDC`—
--formatRendering contract for stdoutpretty
--jsonShorthand for `--format json`false
--modeWhere the subscription processor should runauto
--endpointBase URL of an already running Leani node—
--processorProcessor instance or unambiguous processor kind on a running node—
--tokenOptional bearer token for a running node—
--finalityLowest level that counts as a result: `unattested` (default), `attested`, `confirmed`, or `finalized`unattested
--finality-sourceFinality transport for the embedded runtimeauto
--checkpoint-urlCheckpoint provider used for weak-subjectivity quorum (repeatable or comma-delimited)https://ethereum-beacon-api.publicnode.com/, https://mainnet.checkpoint.sigp.io/, https://beaconstate-mainnet.chainsafe.io/
--checkpoint-quorumNumber of independent checkpoint providers that must agree2
--yesAccept a new checkpoint provider quorum without interactive confirmationfalse
--data-dirPersistent directory for the lightweight embedded runtime—
--onceExit after the first matching updatefalse
--timeoutStop after this long, e.g. `90s`, `5m`, or `300` (seconds); with `--once`, exit 124 if nothing matched—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani resetReset reconstructible local runtime state for cold-start testing

Usage: leani reset [OPTIONS] <COMMAND>

ArgumentPurposeDefault / values
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani reset allDelete all node and embedded-subscription state in the resolved data directory

Usage: leani reset all [OPTIONS]

ArgumentPurposeDefault / values
--data-dirRuntime data directory to reset instead of the configured/default directory—
--yesReset without interactive confirmationfalse
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani reset subscriptionDelete reconstructible state for one embedded market subscription

Usage: leani reset subscription [OPTIONS] <PROTOCOL> [TARGET]...

ArgumentPurposeDefault / values
protocolBuilt-in subscription feed whose embedded state should be resetblocks | uniswap-v3
targetsThe exact targets used by `leani subscribe`; empty for `blocks`—
--finalityFinality of the subscription state being reset (`unattested`, `attested`, `confirmed` or `finalized`)unattested
--data-dirExact embedded subscription directory to reset—
--yesReset without interactive confirmationfalse
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani reset helpPrint this message or the help of the given subcommand(s)

Usage: leani reset help [COMMAND]

leani reset help allDelete all node and embedded-subscription state in the resolved data directory

Usage: leani reset help all

leani reset help subscriptionDelete reconstructible state for one embedded market subscription

Usage: leani reset help subscription

leani reset help helpPrint this message or the help of the given subcommand(s)

Usage: leani reset help help

leani backfillProcess a historical block range and then exit

Usage: leani backfill [OPTIONS] --from-block <FROM_BLOCK> --to-block <TO_BLOCK>

ArgumentPurposeDefault / values
--processorConfigured processor instance or kind [default: the only configured processor]—
--from-blockFirst block of the range, inclusive—
--to-blockLast block of the range, inclusive—
--endpointSubmit to an already running node, preserving an optional URL prefix—
--tokenBearer token for a running node—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani processorCreate Wasm processors and run them over finalized history

Usage: leani processor [OPTIONS] <COMMAND>

ArgumentPurposeDefault / values
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani processor createCreate a Wasm processor as a Rust crate or a TypeScript package

Usage: leani processor create [OPTIONS] <DIRECTORY>

ArgumentPurposeDefault / values
directoryDirectory to create; its last component names the project—
--specThe spec as JSON, or `-` for standard input—
--templateStart from a bundled template's source instead—
--languageThe language to write it in; a spec may name onerust | typescript
--jsonPrint the result as JSONfalse
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani processor runRun a Wasm processor over finalized history and print its changes

Usage: leani processor run [OPTIONS] --from-block <FROM_BLOCK> --to-block <TO_BLOCK> [MODULE|PROJECT]

ArgumentPurposeDefault / values
moduleA Wasm module built with leani-wasm-guest, or a processor project's directory, which is built first—
--templateA bundled template instead of a module file; without parameters it runs with its example parameters—
--from-blockFirst block of the range, inclusive—
--to-blockLast block of the range, inclusive—
--paramOne parameter, as KEY=VALUE (repeatable); VALUE is read as JSON when it parses, else as a string, as are integers past 2^63—
--paramsEvery parameter as one JSON object; --param entries override its keys—
--data-dirKeep the run's state here instead of in a temporary directory; a later run there must use the same module, parameters, and --from-block—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani processor helpPrint this message or the help of the given subcommand(s)

Usage: leani processor help [COMMAND]

leani processor help createCreate a Wasm processor as a Rust crate or a TypeScript package

Usage: leani processor help create

leani processor help runRun a Wasm processor over finalized history and print its changes

Usage: leani processor help run

leani processor help helpPrint this message or the help of the given subcommand(s)

Usage: leani processor help help

leani sourceInspect or probe configured data sources

Usage: leani source [OPTIONS] <COMMAND>

ArgumentPurposeDefault / values
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani source probeProbe a source without changing processor state

Usage: leani source probe [OPTIONS] <COMMAND>

ArgumentPurposeDefault / values
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani source probe xatuInspect the configured Xatu catalog

Usage: leani source probe xatu [OPTIONS] --from-block <FROM_BLOCK> --to-block <TO_BLOCK>

ArgumentPurposeDefault / values
--networkXatu network catalog; only mainnet is supportedmainnet
--from-blockFirst execution block in the inclusive probe range—
--to-blockLast execution block in the inclusive probe range—
--processorProcessor projection whose required tables should be inspectedblobs-money
--from-dateFirst beacon date, required to inspect daily beacon tables—
--to-dateLast beacon date, required to inspect daily beacon tables—
--concurrencyMaximum simultaneous footer requests4
--max-input-bytesMaximum bytes the projection fetches in all, Parquet footers and merged gaps included, and the most it holds at once268435456
--batch-rowsArrow rows decoded in one bounded batch8192
--reportOptional JSON report destination—
--projection-outputOptional destination for normalized projected frames—
--expected-exportRead-only blobs.money compatibility export to compare field by field—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani source probe rpcFetch blocks over JSON-RPC and check them against their own roots

Usage: leani source probe rpc [OPTIONS]

ArgumentPurposeDefault / values
--from-blockFirst block; omitted, 31 blocks before the last—
--to-blockLast block; omitted, the endpoint's head minus ten—
--endpointEndpoint to ask instead of the chain entry's—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani source probe awsRead blocks from the chain's AWS public dataset and check their rows against the receipts root, and the block hash where the dataset carries every header field

Usage: leani source probe aws [OPTIONS] --from-block <FROM_BLOCK> --to-block <TO_BLOCK>

ArgumentPurposeDefault / values
--from-block—
--to-blockLast block; one UTC day of the dataset is read per day touched—
--addressKeep only logs from these contracts. Blocks whose bloom rules them out are then not read—
--endpointA mirror of the bucket with the same layout—
--max-input-bytesBytes the probe may download per day4294967296
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani source probe op-gossipFollow an op-stack chain's sequencer-signed block gossip

Usage: leani source probe op-gossip [OPTIONS]

ArgumentPurposeDefault / values
--secondsHow long to listen120
--listen-portTCP port for gossip connections, advertised in the discovery record; 0 picks one and advertises none0
--discovery-portUDP port for discovery; 0 picks one0
--outputOptional JSON lines destination for the verified blocks—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani source probe p2pExercise the recent execution P2P boundary

Usage: leani source probe p2p [OPTIONS] --from-block <FROM_BLOCK> --to-block <TO_BLOCK>

ArgumentPurposeDefault / values
--from-blockFirst execution block in the inclusive probe range—
--to-blockLast execution block in the inclusive probe range (at most 64 blocks)—
--expected-tipConsensus-verified hash expected for `to-block`—
--minimum-peersMinimum connected peers before issuing requests3
--peer-wait-secondsMaximum time to wait for peers300
--request-timeout-secondsTimeout applied independently to each request30
--retriesMaximum attempts per header, body, or receipt request5
--retry-backoff-secondsPause between request attempts while the peer pool changes1
--max-input-bytesMaximum normalized bytes accepted for the complete range268435456
--reportOptional destination for a JSON summary—
--outputOptional destination for complete normalized frames—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani source probe eraeExercise sparse execution-history archive reads

Usage: leani source probe erae [OPTIONS] --from-block <FROM_BLOCK> --to-block <TO_BLOCK>

ArgumentPurposeDefault / values
--from-blockFirst execution block in the inclusive probe range—
--to-blockLast execution block in the inclusive probe range—
--endpointOverride the public mainnet archive base URL with an https, file, or loopback http URL—
--max-input-bytesMaximum sparse archive and normalized bytes268435456
--reportOptional destination for a JSON summary—
--outputOptional destination for complete normalized frames—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani source probe finalityExercise the configured finality boundary

Usage: leani source probe finality [OPTIONS]

ArgumentPurposeDefault / values
--checkpointOverride the configured weak-subjectivity checkpoint root—
--checkpoint-slotOverride the finalized beacon slot associated with the checkpoint—
--endpointOverride configured Beacon API endpoints (repeatable)—
--minimum-agreementOverride the number of endpoints that must return the same verified anchor—
--reportOptional JSON report destination—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani source probe helpPrint this message or the help of the given subcommand(s)

Usage: leani source probe help [COMMAND]

leani source probe help xatuInspect the configured Xatu catalog

Usage: leani source probe help xatu

leani source probe help rpcFetch blocks over JSON-RPC and check them against their own roots

Usage: leani source probe help rpc

leani source probe help awsRead blocks from the chain's AWS public dataset and check their rows against the receipts root, and the block hash where the dataset carries every header field

Usage: leani source probe help aws

leani source probe help op-gossipFollow an op-stack chain's sequencer-signed block gossip

Usage: leani source probe help op-gossip

leani source probe help p2pExercise the recent execution P2P boundary

Usage: leani source probe help p2p

leani source probe help eraeExercise sparse execution-history archive reads

Usage: leani source probe help erae

leani source probe help finalityExercise the configured finality boundary

Usage: leani source probe help finality

leani source probe help helpPrint this message or the help of the given subcommand(s)

Usage: leani source probe help help

leani source helpPrint this message or the help of the given subcommand(s)

Usage: leani source help [COMMAND]

leani source help probeProbe a source without changing processor state

Usage: leani source help probe [COMMAND]

leani source help probe xatuInspect the configured Xatu catalog

Usage: leani source help probe xatu

leani source help probe rpcFetch blocks over JSON-RPC and check them against their own roots

Usage: leani source help probe rpc

leani source help probe awsRead blocks from the chain's AWS public dataset and check their rows against the receipts root, and the block hash where the dataset carries every header field

Usage: leani source help probe aws

leani source help probe op-gossipFollow an op-stack chain's sequencer-signed block gossip

Usage: leani source help probe op-gossip

leani source help probe p2pExercise the recent execution P2P boundary

Usage: leani source help probe p2p

leani source help probe eraeExercise sparse execution-history archive reads

Usage: leani source help probe erae

leani source help probe finalityExercise the configured finality boundary

Usage: leani source help probe finality

leani source help helpPrint this message or the help of the given subcommand(s)

Usage: leani source help help

leani conformanceCompare normalized source exports or render exact RPC response vectors

Usage: leani conformance [OPTIONS] <COMMAND>

ArgumentPurposeDefault / values
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani conformance framesCompare canonical material in two normalized frame exports

Usage: leani conformance frames [OPTIONS] --left-source <LEFT_SOURCE> --left <LEFT> --right-source <RIGHT_SOURCE> --right <RIGHT> --capability <CAPABILITY>

ArgumentPurposeDefault / values
--left-source—
--left—
--right-source—
--right—
--capabilityCanonical material to compare (repeatable or comma-delimited)header | body | transactions | calldata | receipts | logs | withdrawals | blob-sidecars | traces | state-diffs | consensus-finality
--reportOptional JSON report destination—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani conformance processorCompare deterministic processor deltas from two source exports

Usage: leani conformance processor [OPTIONS] --left-source <LEFT_SOURCE> --left <LEFT> --right-source <RIGHT_SOURCE> --right <RIGHT>

ArgumentPurposeDefault / values
--processorConfigured built-in processor IDblobs-money
--left-source—
--left—
--right-source—
--right—
--reportOptional JSON report destination—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani conformance rpcRender exact Ethereum block/receipt responses from normalized frames

Usage: leani conformance rpc [OPTIONS] --frames <FRAMES>

ArgumentPurposeDefault / values
--framesNormalized frame export produced by a source probe—
--expectedOptional reference snapshot array from an execution client—
--outputOptional destination for the reconstructed snapshots—
--reportOptional differential JSON report destination—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani conformance helpPrint this message or the help of the given subcommand(s)

Usage: leani conformance help [COMMAND]

leani conformance help framesCompare canonical material in two normalized frame exports

Usage: leani conformance help frames

leani conformance help processorCompare deterministic processor deltas from two source exports

Usage: leani conformance help processor

leani conformance help rpcRender exact Ethereum block/receipt responses from normalized frames

Usage: leani conformance help rpc

leani conformance help helpPrint this message or the help of the given subcommand(s)

Usage: leani conformance help help

leani benchmarkRun a reproducible historical throughput and storage measurement

Usage: leani benchmark [OPTIONS] [COMMAND]

ArgumentPurposeDefault / values
--modeIsolated stage or full pipeline to measureprocess
--profileProduct storage/delivery policy measured by the selected stageacquire-discard | raw-only | materialized | compact-artifact | compact-artifact-segment | compact-artifact-tiered | raw-artifact | raw-materialized | raw-artifact-materialized | externalized | raw-externalized
--destinationDestination path used by delivery modesrust-http
--postgres-schema`PostgreSQL` schema exercised by the SDK destinationgeneric-event-log
--corpusDeterministic material shapeblobs-like
--blocksNumber of generated finalized blocks10000
--seedStable corpus seed recorded in the report1
--chunk-blocksPhysical source chunk size in blocks2048
--artifact-segment-blocksBlocks per immutable artifact segment8192
--artifact-segment-compressionCompression used by immutable artifact segmentssnappy
--artifact-compaction-interval-msBackground artifact compaction cadence in milliseconds100
--artifact-compaction-maximum-segments-per-cycleMaximum artifact segments published per background cycle4
--warmupsUnreported warm-up runs1
--runsMeasured runs retained in the report3
--sample-interval-msResource sample interval in milliseconds200
--consumer-delay-msOptional fixed delay after each destination batch0
--consumer-reconnect-every-batchesReopen the SDK/PostgreSQL stream after every N acknowledged batches (zero disables)0
--consumer-drop-ack-response-onceSimulate losing the first successful SDK/PostgreSQL acknowledgement responsefalse
--concurrent-live-blocksFinalized live blocks committed while history is acquired and delivered0
--live-block-interval-msDelay between synthetic live commits in milliseconds10
--mapper-concurrencyParallel processor map tasks4
--maximum-active-chunksNode-wide concurrently active physical source chunks4
--maximum-mapped-bytesNode-wide mapped-delta byte budget134217728
--commit-maximum-blocksMaximum blocks per atomic `SQLite` history commit128
--commit-maximum-changesMaximum domain changes per atomic `SQLite` history commit10000
--commit-maximum-encoded-bytesMaximum stable-encoded change bytes per history commit16777216
--commit-maximum-delay-msFlush delay for a partially filled history commit50
--commit-target-writer-hold-msTarget p95 `SQLite` writer hold time for adaptive history commits20
--delivery-target-encoded-bytesTarget uncompressed encoded bytes per delivered history batch4194304
--delivery-maximum-encoded-bytesHard maximum uncompressed encoded bytes per delivery batch16777216
--delivery-maximum-eventsHard maximum domain events per delivery batch20000
--delivery-maximum-processed-blocksHard maximum processed blocks represented by one delivery batch8192
--delivery-maximum-delay-msFlush delay for a partially filled delivery batch50
--delivery-maximum-buffered-batchesMaximum encoded batches queued per connection4
--delivery-maximum-buffered-bytesMaximum encoded bytes queued per connection67108864
--delivery-compressionDelivery transport compressiongzip
--reportOptional JSON report destination—
--samples-reportOptional immutable NDJSON destination for high-frequency samples—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani benchmark sweepRun or resume a manifest-defined candidate sweep

Usage: leani benchmark sweep [OPTIONS] --manifest <MANIFEST> --output-directory <OUTPUT_DIRECTORY>

ArgumentPurposeDefault / values
--manifestVersioned JSON sweep manifest—
--output-directoryDirectory containing immutable candidate reports and the sweep summary—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani benchmark real-sourceMeasure a pinned Mainnet range through real history sources, processor, HTTP delivery, acknowledgement, and pruning

Usage: leani benchmark real-source [OPTIONS] --from-block <FROM_BLOCK> --to-block <TO_BLOCK> --data-dir <DATA_DIR> --report <REPORT>

ArgumentPurposeDefault / values
--processorConfigured processor kind or instanceblobs-money
--source-policyHistorical source selection policyhistory-portfolio
--from-blockFirst finalized execution block in the inclusive range—
--to-blockLast finalized execution block in the inclusive range—
--data-dirFresh benchmark directory. Existing node state is rejected—
--consumer-delay-msOptional delay before acknowledging every delivered batch0
--timeout-secondsOverall wall-clock limit for acquisition, processing, and delivery7200
--sample-interval-msResource/progress sampling interval250
--source-concurrencyOverride configured historical source acquisition concurrency—
--mapper-concurrencyOverride configured processor mapper concurrency—
--maximum-active-chunksOverride the shared historical coordinator active-chunk ceiling—
--expected-output-digestOptional expected BLAKE3 digest of canonical delivered domain events—
--delivery-compressionDelivery transport compression. Batch sizing comes from node configgzip
--reportVersioned JSON evidence report—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani benchmark helpPrint this message or the help of the given subcommand(s)

Usage: leani benchmark help [COMMAND]

leani benchmark help sweepRun or resume a manifest-defined candidate sweep

Usage: leani benchmark help sweep

leani benchmark help real-sourceMeasure a pinned Mainnet range through real history sources, processor, HTTP delivery, acknowledgement, and pruning

Usage: leani benchmark help real-source

leani benchmark help helpPrint this message or the help of the given subcommand(s)

Usage: leani benchmark help help

leani e2eRun explicit end-to-end verification gates

Usage: leani e2e [OPTIONS] <COMMAND>

ArgumentPurposeDefault / values
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani e2e fixtureRun a deterministic bounded source/runtime/SQLite fixture with no network

Usage: leani e2e fixture [OPTIONS] --data-dir <DATA_DIR>

ArgumentPurposeDefault / values
--data-dirFresh directory for the fixture database—
--blocksNumber of deterministic finalized blocks128
--reportOptional JSON evidence report—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani e2e mainnetBackfill and follow Ethereum Mainnet using production source adapters

Usage: leani e2e mainnet [OPTIONS] --from-block <FROM_BLOCK> --data-dir <DATA_DIR>

ArgumentPurposeDefault / values
--processorConfigured processor to verifyblobs-money
--from-blockFirst historical block in the required continuous coverage range—
--data-dirFresh data directory. Existing state requires `--resume`—
--resumeReuse an existing E2E data directory after an interrupted runfalse
--minimum-follow-blocksBlocks that must be followed beyond the initial finalized anchor16
--stable-secondsSeconds all convergence and head-freshness assertions must remain true300
--max-head-age-secondsMaximum permitted age of the latest retained execution block60
--timeout-secondsOverall wall-clock limit for the staging run7200
--reportJSON evidence report written on both success and failuremainnet-e2e-report.json
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani e2e helpPrint this message or the help of the given subcommand(s)

Usage: leani e2e help [COMMAND]

leani e2e help fixtureRun a deterministic bounded source/runtime/SQLite fixture with no network

Usage: leani e2e help fixture

leani e2e help mainnetBackfill and follow Ethereum Mainnet using production source adapters

Usage: leani e2e help mainnet

leani e2e help helpPrint this message or the help of the given subcommand(s)

Usage: leani e2e help help

leani dbInspect and maintain the durable store

Usage: leani db [OPTIONS] <COMMAND>

ArgumentPurposeDefault / values
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani db inspect

Usage: leani db inspect [OPTIONS]

ArgumentPurposeDefault / values
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani db verify

Usage: leani db verify [OPTIONS]

ArgumentPurposeDefault / values
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani db backup

Usage: leani db backup [OPTIONS] <DESTINATION>

ArgumentPurposeDefault / values
destination—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani db compact

Usage: leani db compact [OPTIONS]

ArgumentPurposeDefault / values
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani db prune-changesPrune durable changes older than a sequence while respecting active consumer leases

Usage: leani db prune-changes [OPTIONS] --processor <PROCESSOR> --before <BEFORE>

ArgumentPurposeDefault / values
--processor—
--before—
--configPath to the versioned TOML configuration—
--log-formatLog rendering formatpretty
--log-filterTracing filter, e.g. `info,leani=debug`—
--helpPrint help (see more with '--help')—
--versionPrint version—
leani db helpPrint this message or the help of the given subcommand(s)

Usage: leani db help [COMMAND]

leani db help inspect

Usage: leani db help inspect

leani db help verify

Usage: leani db help verify

leani db help backup

Usage: leani db help backup

leani db help compact

Usage: leani db help compact

leani db help prune-changesPrune durable changes older than a sequence while respecting active consumer leases

Usage: leani db help prune-changes

leani db help helpPrint this message or the help of the given subcommand(s)

Usage: leani db help help

leani helpPrint this message or the help of the given subcommand(s)

Usage: leani help [COMMAND]

leani help doctorValidate and describe configuration without mutating state

Usage: leani help doctor

leani help serveStart configured sources, processors, stores, and serving endpoints

Usage: leani help serve

leani help guidePrint the guide for agents and scripts that matches this binary

Usage: leani help guide

leani help initCreate a configuration

Usage: leani help init

leani help subscribeStream live processor output from an embedded runtime or a running node

Usage: leani help subscribe

leani help resetReset reconstructible local runtime state for cold-start testing

Usage: leani help reset [COMMAND]

leani help reset allDelete all node and embedded-subscription state in the resolved data directory

Usage: leani help reset all

leani help reset subscriptionDelete reconstructible state for one embedded market subscription

Usage: leani help reset subscription

leani help backfillProcess a historical block range and then exit

Usage: leani help backfill

leani help processorCreate Wasm processors and run them over finalized history

Usage: leani help processor [COMMAND]

leani help processor createCreate a Wasm processor as a Rust crate or a TypeScript package

Usage: leani help processor create

leani help processor runRun a Wasm processor over finalized history and print its changes

Usage: leani help processor run

leani help sourceInspect or probe configured data sources

Usage: leani help source [COMMAND]

leani help source probeProbe a source without changing processor state

Usage: leani help source probe [COMMAND]

leani help source probe xatuInspect the configured Xatu catalog

Usage: leani help source probe xatu

leani help source probe rpcFetch blocks over JSON-RPC and check them against their own roots

Usage: leani help source probe rpc

leani help source probe awsRead blocks from the chain's AWS public dataset and check their rows against the receipts root, and the block hash where the dataset carries every header field

Usage: leani help source probe aws

leani help source probe op-gossipFollow an op-stack chain's sequencer-signed block gossip

Usage: leani help source probe op-gossip

leani help source probe p2pExercise the recent execution P2P boundary

Usage: leani help source probe p2p

leani help source probe eraeExercise sparse execution-history archive reads

Usage: leani help source probe erae

leani help source probe finalityExercise the configured finality boundary

Usage: leani help source probe finality

leani help conformanceCompare normalized source exports or render exact RPC response vectors

Usage: leani help conformance [COMMAND]

leani help conformance framesCompare canonical material in two normalized frame exports

Usage: leani help conformance frames

leani help conformance processorCompare deterministic processor deltas from two source exports

Usage: leani help conformance processor

leani help conformance rpcRender exact Ethereum block/receipt responses from normalized frames

Usage: leani help conformance rpc

leani help benchmarkRun a reproducible historical throughput and storage measurement

Usage: leani help benchmark [COMMAND]

leani help benchmark sweepRun or resume a manifest-defined candidate sweep

Usage: leani help benchmark sweep

leani help benchmark real-sourceMeasure a pinned Mainnet range through real history sources, processor, HTTP delivery, acknowledgement, and pruning

Usage: leani help benchmark real-source

leani help e2eRun explicit end-to-end verification gates

Usage: leani help e2e [COMMAND]

leani help e2e fixtureRun a deterministic bounded source/runtime/SQLite fixture with no network

Usage: leani help e2e fixture

leani help e2e mainnetBackfill and follow Ethereum Mainnet using production source adapters

Usage: leani help e2e mainnet

leani help dbInspect and maintain the durable store

Usage: leani help db [COMMAND]

leani help db inspect

Usage: leani help db inspect

leani help db verify

Usage: leani help db verify

leani help db backup

Usage: leani help db backup

leani help db compact

Usage: leani help db compact

leani help db prune-changesPrune durable changes older than a sequence while respecting active consumer leases

Usage: leani help db prune-changes

leani help helpPrint this message or the help of the given subcommand(s)

Usage: leani help help