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>
| Argument | Purpose | Default / values |
|---|---|---|
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani doctorValidate and describe configuration without mutating state
Usage: leani doctor [OPTIONS]
| Argument | Purpose | Default / values |
|---|---|---|
--json | Emit machine-readable JSON | false |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani serveStart configured sources, processors, stores, and serving endpoints
Usage: leani serve [OPTIONS]
| Argument | Purpose | Default / values |
|---|---|---|
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani guidePrint the guide for agents and scripts that matches this binary
Usage: leani guide [OPTIONS] [TOPIC]
| Argument | Purpose | Default / values |
|---|---|---|
topic | Section to print [default: the overview] | processors | config |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani initCreate a configuration
Usage: leani init [OPTIONS] [PROTOCOL] [TARGET]...
| Argument | Purpose | Default / values |
|---|---|---|
protocol | Processor preset to configure; --requirements names its own | blocks | uniswap-v3 |
targets | Optional protocol targets; Uniswap requires one or more markets such as `ETH/USDC` | — |
--network | Chain to follow: a built-in chain entry or its alias, such as `base`, `op`, `arbitrum-one`, `robinhood`, or `hoodi` | ethereum-mainnet |
--data-dir | Data directory for the generated configuration [default: `data` beside it] | — |
--checkpoint-url | Checkpoint 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-quorum | Number of independent checkpoint providers that must agree | 2 |
--yes | Accept a new checkpoint provider quorum without interactive confirmation | false |
--keep | How much to keep for queries or your app | everything | window | latest | result | stream | live |
--window-days | Days `--keep window` keeps [default: 30] | — |
--follow | Which blocks to follow as they arrive | head | finalized | none |
--history-from-block | First block to backfill | — |
--memory | Memory the node may use, such as `1GiB` | — |
--disk | Disk the node may use, such as `20GiB` | — |
--bandwidth | The host's link, in megabits per second | — |
--tuning | Tuning recipes to apply instead of the ones the limits call for (comma-delimited) | limited-memory | less-memory | transactions-from-xatu | slow-disk |
--requirements | Requirements as JSON, as `leani guide config` describes, from a file or `-` for stdin. They replace the preset and the requirement flags | — |
--json | Print what was built as JSON: the configuration, the settings it derived and why, warnings, and next steps | false |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani subscribeStream live processor output from an embedded runtime or a running node
Usage: leani subscribe [OPTIONS] <PROTOCOL> [TARGET]...
| Argument | Purpose | Default / values |
|---|---|---|
protocol | Built-in subscription feed to activate | blocks | uniswap-v3 |
targets | Optional feed targets; Uniswap requires one or more markets such as `ETH/USDC` | — |
--format | Rendering contract for stdout | pretty |
--json | Shorthand for `--format json` | false |
--mode | Where the subscription processor should run | auto |
--endpoint | Base URL of an already running Leani node | — |
--processor | Processor instance or unambiguous processor kind on a running node | — |
--token | Optional bearer token for a running node | — |
--finality | Lowest level that counts as a result: `unattested` (default), `attested`, `confirmed`, or `finalized` | unattested |
--finality-source | Finality transport for the embedded runtime | auto |
--checkpoint-url | Checkpoint 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-quorum | Number of independent checkpoint providers that must agree | 2 |
--yes | Accept a new checkpoint provider quorum without interactive confirmation | false |
--data-dir | Persistent directory for the lightweight embedded runtime | — |
--once | Exit after the first matching update | false |
--timeout | Stop after this long, e.g. `90s`, `5m`, or `300` (seconds); with `--once`, exit 124 if nothing matched | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani resetReset reconstructible local runtime state for cold-start testing
Usage: leani reset [OPTIONS] <COMMAND>
| Argument | Purpose | Default / values |
|---|---|---|
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani reset allDelete all node and embedded-subscription state in the resolved data directory
Usage: leani reset all [OPTIONS]
| Argument | Purpose | Default / values |
|---|---|---|
--data-dir | Runtime data directory to reset instead of the configured/default directory | — |
--yes | Reset without interactive confirmation | false |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani reset subscriptionDelete reconstructible state for one embedded market subscription
Usage: leani reset subscription [OPTIONS] <PROTOCOL> [TARGET]...
| Argument | Purpose | Default / values |
|---|---|---|
protocol | Built-in subscription feed whose embedded state should be reset | blocks | uniswap-v3 |
targets | The exact targets used by `leani subscribe`; empty for `blocks` | — |
--finality | Finality of the subscription state being reset (`unattested`, `attested`, `confirmed` or `finalized`) | unattested |
--data-dir | Exact embedded subscription directory to reset | — |
--yes | Reset without interactive confirmation | false |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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>
| Argument | Purpose | Default / values |
|---|---|---|
--processor | Configured processor instance or kind [default: the only configured processor] | — |
--from-block | First block of the range, inclusive | — |
--to-block | Last block of the range, inclusive | — |
--endpoint | Submit to an already running node, preserving an optional URL prefix | — |
--token | Bearer token for a running node | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani processorCreate Wasm processors and run them over finalized history
Usage: leani processor [OPTIONS] <COMMAND>
| Argument | Purpose | Default / values |
|---|---|---|
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani processor createCreate a Wasm processor as a Rust crate or a TypeScript package
Usage: leani processor create [OPTIONS] <DIRECTORY>
| Argument | Purpose | Default / values |
|---|---|---|
directory | Directory to create; its last component names the project | — |
--spec | The spec as JSON, or `-` for standard input | — |
--template | Start from a bundled template's source instead | — |
--language | The language to write it in; a spec may name one | rust | typescript |
--json | Print the result as JSON | false |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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]
| Argument | Purpose | Default / values |
|---|---|---|
module | A Wasm module built with leani-wasm-guest, or a processor project's directory, which is built first | — |
--template | A bundled template instead of a module file; without parameters it runs with its example parameters | — |
--from-block | First block of the range, inclusive | — |
--to-block | Last block of the range, inclusive | — |
--param | One parameter, as KEY=VALUE (repeatable); VALUE is read as JSON when it parses, else as a string, as are integers past 2^63 | — |
--params | Every parameter as one JSON object; --param entries override its keys | — |
--data-dir | Keep the run's state here instead of in a temporary directory; a later run there must use the same module, parameters, and --from-block | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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>
| Argument | Purpose | Default / values |
|---|---|---|
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani source probeProbe a source without changing processor state
Usage: leani source probe [OPTIONS] <COMMAND>
| Argument | Purpose | Default / values |
|---|---|---|
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani source probe xatuInspect the configured Xatu catalog
Usage: leani source probe xatu [OPTIONS] --from-block <FROM_BLOCK> --to-block <TO_BLOCK>
| Argument | Purpose | Default / values |
|---|---|---|
--network | Xatu network catalog; only mainnet is supported | mainnet |
--from-block | First execution block in the inclusive probe range | — |
--to-block | Last execution block in the inclusive probe range | — |
--processor | Processor projection whose required tables should be inspected | blobs-money |
--from-date | First beacon date, required to inspect daily beacon tables | — |
--to-date | Last beacon date, required to inspect daily beacon tables | — |
--concurrency | Maximum simultaneous footer requests | 4 |
--max-input-bytes | Maximum bytes the projection fetches in all, Parquet footers and merged gaps included, and the most it holds at once | 268435456 |
--batch-rows | Arrow rows decoded in one bounded batch | 8192 |
--report | Optional JSON report destination | — |
--projection-output | Optional destination for normalized projected frames | — |
--expected-export | Read-only blobs.money compatibility export to compare field by field | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani source probe rpcFetch blocks over JSON-RPC and check them against their own roots
Usage: leani source probe rpc [OPTIONS]
| Argument | Purpose | Default / values |
|---|---|---|
--from-block | First block; omitted, 31 blocks before the last | — |
--to-block | Last block; omitted, the endpoint's head minus ten | — |
--endpoint | Endpoint to ask instead of the chain entry's | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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>
| Argument | Purpose | Default / values |
|---|---|---|
--from-block | — | |
--to-block | Last block; one UTC day of the dataset is read per day touched | — |
--address | Keep only logs from these contracts. Blocks whose bloom rules them out are then not read | — |
--endpoint | A mirror of the bucket with the same layout | — |
--max-input-bytes | Bytes the probe may download per day | 4294967296 |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani source probe op-gossipFollow an op-stack chain's sequencer-signed block gossip
Usage: leani source probe op-gossip [OPTIONS]
| Argument | Purpose | Default / values |
|---|---|---|
--seconds | How long to listen | 120 |
--listen-port | TCP port for gossip connections, advertised in the discovery record; 0 picks one and advertises none | 0 |
--discovery-port | UDP port for discovery; 0 picks one | 0 |
--output | Optional JSON lines destination for the verified blocks | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani source probe p2pExercise the recent execution P2P boundary
Usage: leani source probe p2p [OPTIONS] --from-block <FROM_BLOCK> --to-block <TO_BLOCK>
| Argument | Purpose | Default / values |
|---|---|---|
--from-block | First execution block in the inclusive probe range | — |
--to-block | Last execution block in the inclusive probe range (at most 64 blocks) | — |
--expected-tip | Consensus-verified hash expected for `to-block` | — |
--minimum-peers | Minimum connected peers before issuing requests | 3 |
--peer-wait-seconds | Maximum time to wait for peers | 300 |
--request-timeout-seconds | Timeout applied independently to each request | 30 |
--retries | Maximum attempts per header, body, or receipt request | 5 |
--retry-backoff-seconds | Pause between request attempts while the peer pool changes | 1 |
--max-input-bytes | Maximum normalized bytes accepted for the complete range | 268435456 |
--report | Optional destination for a JSON summary | — |
--output | Optional destination for complete normalized frames | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani source probe eraeExercise sparse execution-history archive reads
Usage: leani source probe erae [OPTIONS] --from-block <FROM_BLOCK> --to-block <TO_BLOCK>
| Argument | Purpose | Default / values |
|---|---|---|
--from-block | First execution block in the inclusive probe range | — |
--to-block | Last execution block in the inclusive probe range | — |
--endpoint | Override the public mainnet archive base URL with an https, file, or loopback http URL | — |
--max-input-bytes | Maximum sparse archive and normalized bytes | 268435456 |
--report | Optional destination for a JSON summary | — |
--output | Optional destination for complete normalized frames | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani source probe finalityExercise the configured finality boundary
Usage: leani source probe finality [OPTIONS]
| Argument | Purpose | Default / values |
|---|---|---|
--checkpoint | Override the configured weak-subjectivity checkpoint root | — |
--checkpoint-slot | Override the finalized beacon slot associated with the checkpoint | — |
--endpoint | Override configured Beacon API endpoints (repeatable) | — |
--minimum-agreement | Override the number of endpoints that must return the same verified anchor | — |
--report | Optional JSON report destination | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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>
| Argument | Purpose | Default / values |
|---|---|---|
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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>
| Argument | Purpose | Default / values |
|---|---|---|
--left-source | — | |
--left | — | |
--right-source | — | |
--right | — | |
--capability | Canonical material to compare (repeatable or comma-delimited) | header | body | transactions | calldata | receipts | logs | withdrawals | blob-sidecars | traces | state-diffs | consensus-finality |
--report | Optional JSON report destination | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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>
| Argument | Purpose | Default / values |
|---|---|---|
--processor | Configured built-in processor ID | blobs-money |
--left-source | — | |
--left | — | |
--right-source | — | |
--right | — | |
--report | Optional JSON report destination | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani conformance rpcRender exact Ethereum block/receipt responses from normalized frames
Usage: leani conformance rpc [OPTIONS] --frames <FRAMES>
| Argument | Purpose | Default / values |
|---|---|---|
--frames | Normalized frame export produced by a source probe | — |
--expected | Optional reference snapshot array from an execution client | — |
--output | Optional destination for the reconstructed snapshots | — |
--report | Optional differential JSON report destination | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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]
| Argument | Purpose | Default / values |
|---|---|---|
--mode | Isolated stage or full pipeline to measure | process |
--profile | Product storage/delivery policy measured by the selected stage | acquire-discard | raw-only | materialized | compact-artifact | compact-artifact-segment | compact-artifact-tiered | raw-artifact | raw-materialized | raw-artifact-materialized | externalized | raw-externalized |
--destination | Destination path used by delivery modes | rust-http |
--postgres-schema | `PostgreSQL` schema exercised by the SDK destination | generic-event-log |
--corpus | Deterministic material shape | blobs-like |
--blocks | Number of generated finalized blocks | 10000 |
--seed | Stable corpus seed recorded in the report | 1 |
--chunk-blocks | Physical source chunk size in blocks | 2048 |
--artifact-segment-blocks | Blocks per immutable artifact segment | 8192 |
--artifact-segment-compression | Compression used by immutable artifact segments | snappy |
--artifact-compaction-interval-ms | Background artifact compaction cadence in milliseconds | 100 |
--artifact-compaction-maximum-segments-per-cycle | Maximum artifact segments published per background cycle | 4 |
--warmups | Unreported warm-up runs | 1 |
--runs | Measured runs retained in the report | 3 |
--sample-interval-ms | Resource sample interval in milliseconds | 200 |
--consumer-delay-ms | Optional fixed delay after each destination batch | 0 |
--consumer-reconnect-every-batches | Reopen the SDK/PostgreSQL stream after every N acknowledged batches (zero disables) | 0 |
--consumer-drop-ack-response-once | Simulate losing the first successful SDK/PostgreSQL acknowledgement response | false |
--concurrent-live-blocks | Finalized live blocks committed while history is acquired and delivered | 0 |
--live-block-interval-ms | Delay between synthetic live commits in milliseconds | 10 |
--mapper-concurrency | Parallel processor map tasks | 4 |
--maximum-active-chunks | Node-wide concurrently active physical source chunks | 4 |
--maximum-mapped-bytes | Node-wide mapped-delta byte budget | 134217728 |
--commit-maximum-blocks | Maximum blocks per atomic `SQLite` history commit | 128 |
--commit-maximum-changes | Maximum domain changes per atomic `SQLite` history commit | 10000 |
--commit-maximum-encoded-bytes | Maximum stable-encoded change bytes per history commit | 16777216 |
--commit-maximum-delay-ms | Flush delay for a partially filled history commit | 50 |
--commit-target-writer-hold-ms | Target p95 `SQLite` writer hold time for adaptive history commits | 20 |
--delivery-target-encoded-bytes | Target uncompressed encoded bytes per delivered history batch | 4194304 |
--delivery-maximum-encoded-bytes | Hard maximum uncompressed encoded bytes per delivery batch | 16777216 |
--delivery-maximum-events | Hard maximum domain events per delivery batch | 20000 |
--delivery-maximum-processed-blocks | Hard maximum processed blocks represented by one delivery batch | 8192 |
--delivery-maximum-delay-ms | Flush delay for a partially filled delivery batch | 50 |
--delivery-maximum-buffered-batches | Maximum encoded batches queued per connection | 4 |
--delivery-maximum-buffered-bytes | Maximum encoded bytes queued per connection | 67108864 |
--delivery-compression | Delivery transport compression | gzip |
--report | Optional JSON report destination | — |
--samples-report | Optional immutable NDJSON destination for high-frequency samples | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani benchmark sweepRun or resume a manifest-defined candidate sweep
Usage: leani benchmark sweep [OPTIONS] --manifest <MANIFEST> --output-directory <OUTPUT_DIRECTORY>
| Argument | Purpose | Default / values |
|---|---|---|
--manifest | Versioned JSON sweep manifest | — |
--output-directory | Directory containing immutable candidate reports and the sweep summary | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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>
| Argument | Purpose | Default / values |
|---|---|---|
--processor | Configured processor kind or instance | blobs-money |
--source-policy | Historical source selection policy | history-portfolio |
--from-block | First finalized execution block in the inclusive range | — |
--to-block | Last finalized execution block in the inclusive range | — |
--data-dir | Fresh benchmark directory. Existing node state is rejected | — |
--consumer-delay-ms | Optional delay before acknowledging every delivered batch | 0 |
--timeout-seconds | Overall wall-clock limit for acquisition, processing, and delivery | 7200 |
--sample-interval-ms | Resource/progress sampling interval | 250 |
--source-concurrency | Override configured historical source acquisition concurrency | — |
--mapper-concurrency | Override configured processor mapper concurrency | — |
--maximum-active-chunks | Override the shared historical coordinator active-chunk ceiling | — |
--expected-output-digest | Optional expected BLAKE3 digest of canonical delivered domain events | — |
--delivery-compression | Delivery transport compression. Batch sizing comes from node config | gzip |
--report | Versioned JSON evidence report | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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>
| Argument | Purpose | Default / values |
|---|---|---|
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani e2e fixtureRun a deterministic bounded source/runtime/SQLite fixture with no network
Usage: leani e2e fixture [OPTIONS] --data-dir <DATA_DIR>
| Argument | Purpose | Default / values |
|---|---|---|
--data-dir | Fresh directory for the fixture database | — |
--blocks | Number of deterministic finalized blocks | 128 |
--report | Optional JSON evidence report | — |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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>
| Argument | Purpose | Default / values |
|---|---|---|
--processor | Configured processor to verify | blobs-money |
--from-block | First historical block in the required continuous coverage range | — |
--data-dir | Fresh data directory. Existing state requires `--resume` | — |
--resume | Reuse an existing E2E data directory after an interrupted run | false |
--minimum-follow-blocks | Blocks that must be followed beyond the initial finalized anchor | 16 |
--stable-seconds | Seconds all convergence and head-freshness assertions must remain true | 300 |
--max-head-age-seconds | Maximum permitted age of the latest retained execution block | 60 |
--timeout-seconds | Overall wall-clock limit for the staging run | 7200 |
--report | JSON evidence report written on both success and failure | mainnet-e2e-report.json |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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>
| Argument | Purpose | Default / values |
|---|---|---|
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani db inspect
Usage: leani db inspect [OPTIONS]
| Argument | Purpose | Default / values |
|---|---|---|
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani db verify
Usage: leani db verify [OPTIONS]
| Argument | Purpose | Default / values |
|---|---|---|
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani db backup
Usage: leani db backup [OPTIONS] <DESTINATION>
| Argument | Purpose | Default / values |
|---|---|---|
destination | — | |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print version | — |
leani db compact
Usage: leani db compact [OPTIONS]
| Argument | Purpose | Default / values |
|---|---|---|
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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>
| Argument | Purpose | Default / values |
|---|---|---|
--processor | — | |
--before | — | |
--config | Path to the versioned TOML configuration | — |
--log-format | Log rendering format | pretty |
--log-filter | Tracing filter, e.g. `info,leani=debug` | — |
--help | Print help (see more with '--help') | — |
--version | Print 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
Built by Smart-Byte · Legal notice (Impressum) · Privacy