jleony/nanoreth
1
0
Fork 0
mirror of https://github.com/hl-archive-node/nanoreth.git synced 2025-12-06 10:59:55 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: update CLI reference in book (#3105)

Browse Source
This commit is contained in:
Thomas Coratger
2023-06-12 18:06:58 +02:00
committed by GitHub
parent 43a2d09462
commit c51a222b26
10 changed files with 702 additions and 191 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
book/cli/cli.md
View File

@ -9,12 +9,15 @@ reth --help
``` ```
Some of the most useful commands as a node developer are: Some of the most useful commands as a node developer are:
* [`reth node`](./node.md): Starts the Reth node's components, including the JSON-RPC. * [`reth node`](./node.md): Starts the Reth node's components, including the JSON-RPC.
* [`reth db`](./db.md): Administrative TUI to the key-value store * [`reth init`](./init.md): Initialize the database from a genesis file.
* [`reth p2p`](./p2p.md): P2P-related utilities * [`reth import`](./import.md): This syncs RLP encoded blocks from a file.
* [`reth db`](./db.md): Administrative TUI to the key-value store.
* [`reth stage`](./stage.md): Runs a stage in isolation. Useful for testing and benchmarking. * [`reth stage`](./stage.md): Runs a stage in isolation. Useful for testing and benchmarking.
* [`reth drop-stage`](./drop-stage.md): Drops all the tables associated with a stage. Useful for resetting state. * [`reth p2p`](./p2p.md): P2P-related utilities
* [`reth dump-stage`](./dump-stage.md): Dumps all the tables associated with a stage to a new database. Useful for creating snapshots * [`reth test-vectors`](./test-vectors.md): Generate Test Vectors
* [`reth config`](./config.md): Write config to stdout
* [`reth debug`](./debug.md): Various debug routines
See below for the full list of commands. See below for the full list of commands.
@ -36,21 +39,15 @@ Commands:
db db
Database debugging utilities Database debugging utilities
stage stage
Run a single stage Manipulate individual stages.
dump-stage
Dumps a stage from a range into a new database
drop-stage
Drops a stage's tables from the database
p2p p2p
P2P Debugging utilities P2P Debugging utilities
test-chain
Run Ethereum blockchain tests
test-vectors test-vectors
Generate Test Vectors Generate Test Vectors
config config
Write config to stdout Write config to stdout
merkle-debug debug
Debug state root calculation Various debug routines
help help
Print this message or the help of the given subcommand(s) Print this message or the help of the given subcommand(s)
@ -67,7 +64,7 @@ Logging:
--log.directory <PATH> --log.directory <PATH>
The path to put log files in The path to put log files in
[default: /Users/georgios/Library/Caches/reth/logs] [default: /Users/georgios/Library/Caches/reth/logs]
--log.journald --log.journald
@ -75,13 +72,13 @@ Logging:
--log.filter <FILTER> --log.filter <FILTER>
The filter to use for logs written to the log file The filter to use for logs written to the log file
[default: debug] [default: debug]
Display: Display:
-v, --verbosity... -v, --verbosity...
Set the minimum log level. Set the minimum log level.
-v Errors -v Errors
-vv Warnings -vv Warnings
-vvv Info -vvv Info

46
book/cli/config.md Normal file
View File

@ -0,0 +1,46 @@
# `reth config`
Write config to stdout
```bash
$ reth config --help
Usage: reth config [OPTIONS]
Options:
--config <FILE>
The path to the configuration file to use.
--default
Show the default config
Logging:
--log.persistent
The flag to enable persistent logs
--log.directory <PATH>
The path to put log files in
[default: /Users/georgios/Library/Caches/reth/logs]
--log.journald
Log events to journald
--log.filter <FILTER>
The filter to use for logs written to the log file
[default: debug]
Display:
-v, --verbosity...
Set the minimum log level.
-v Errors
-vv Warnings
-vvv Info
-vvvv Debug
-vvvvv Traces (warning: very verbose!)
-q, --quiet
Silence all log output
```

52
book/cli/db.md
View File

@ -12,6 +12,8 @@ Commands:
Lists all the tables, their entry count and their size Lists all the tables, their entry count and their size
list list
Lists the contents of a table Lists the contents of a table
get
Gets the content of a table for the given key
drop drop
Deletes all database entries Deletes all database entries
help help
@ -20,25 +22,25 @@ Commands:
Options: Options:
--datadir <DATA_DIR> --datadir <DATA_DIR>
The path to the data dir for all reth files and subdirectories. The path to the data dir for all reth files and subdirectories.
Defaults to the OS-specific data directory: Defaults to the OS-specific data directory:
- Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/` - Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/`
- Windows: `{FOLDERID_RoamingAppData}/reth/` - Windows: `{FOLDERID_RoamingAppData}/reth/`
- macOS: `$HOME/Library/Application Support/reth/` - macOS: `$HOME/Library/Application Support/reth/`
[default: default] [default: default]
--chain <CHAIN_OR_PATH> --chain <CHAIN_OR_PATH>
The chain this node is running. The chain this node is running.
Possible values are either a built-in chain or the path to a chain specification file. Possible values are either a built-in chain or the path to a chain specification file.
Built-in chains: Built-in chains:
- mainnet - mainnet
- goerli - goerli
- sepolia - sepolia
[default: mainnet] [default: mainnet]
-h, --help -h, --help
@ -47,7 +49,7 @@ Options:
Display: Display:
-v, --verbosity... -v, --verbosity...
Set the minimum log level. Set the minimum log level.
-v Errors -v Errors
-vv Warnings -vv Warnings
-vvv Info -vvv Info
@ -80,16 +82,44 @@ Arguments:
The table name The table name
Options: Options:
-s, --start <START> -s, --skip <SKIP>
Where to start iterating Skip first N entries
[default: 0] [default: 0]
-r, --reverse <REVERSE>
Reverse the order of the entries. If enabled last table entries are read.
[default: false]
-l, --len <LEN> -l, --len <LEN>
How many items to take from the walker How many items to take from the walker
[default: 5] [default: 5]
-j, --json
Dump as JSON instead of using TUI.
-h, --help
Print help (see a summary with '-h')
```
## `reth db get`
```bash
$ reth db get --help
Gets the content of a table for the given key
Usage: reth db get [OPTIONS] <TABLE>
Arguments:
<TABLE>
The table name
Options:
--key
The key to get content for
-h, --help -h, --help
Print help (see a summary with '-h') Print help (see a summary with '-h')
``` ```

173
book/cli/debug.md Normal file
View File

@ -0,0 +1,173 @@
# `reth debug`
```bash
$ reth debug --help
Various debug routines
Usage: reth debug <COMMAND>
Commands:
execution
Debug the roundtrip execution of blocks as well as the generated data.
merkle
Debug the clean & incremental state root calculations.
help
Print this message or the help of the given subcommand(s)
Logging:
--log.persistent
The flag to enable persistent logs
--log.directory <PATH>
The path to put log files in
[default: /Users/georgios/Library/Caches/reth/logs]
--log.journald
Log events to journald
--log.filter <FILTER>
The filter to use for logs written to the log file
[default: debug]
Display:
-v, --verbosity...
Set the minimum log level.
-v Errors
-vv Warnings
-vvv Info
-vvvv Debug
-vvvvv Traces (warning: very verbose!)
-q, --quiet
Silence all log output
```
## `reth debug execution`
```bash
$ reth debug execution --help
Debug the roundtrip execution of blocks as well as the generated data.
Usage: reth debug execution [OPTIONS]
Options:
--datadir <DATA_DIR>
The path to the data dir for all reth files and subdirectories.
Defaults to the OS-specific data directory:
- Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/`
- Windows: `{FOLDERID_RoamingAppData}/reth/`
- macOS: `$HOME/Library/Application Support/reth/`
--chain <CHAIN_OR_PATH>
The chain this node is running.
Possible values are either a built-in chain or the path to a chain specification file.
Built-in chains:
- mainnet
- goerli
- sepolia
[default: mainnet]
--debug.tip
Set the chain tip manually for testing purposes.
--to
The maximum block height.
--interval
The block interval for sync and unwind.
[default: 1000]
Networking:
-d, --disable-discovery
Disable the discovery service
--disable-dns-discovery
Disable the DNS discovery
--disable-discv4-discovery
Disable Discv4 discovery
--discovery.port <DISCOVERY_PORT>
The UDP port to use for P2P discovery/networking. default: 30303
--trusted-peers <TRUSTED_PEERS>
Target trusted peer enodes --trusted-peers enode://abcd@192.168.0.1:30303
--trusted-only
Connect only to trusted peers
--bootnodes <BOOTNODES>
Bootnodes to connect to initially.
Will fall back to a network-specific default if not specified.
--peers-file <FILE>
The path to the known peers file. Connected peers are dumped to this file on nodes
shutdown, and read on startup. Cannot be used with `--no-persist-peers`.
--identity <IDENTITY>
Custom node identity
--p2p-secret-key <PATH>
Secret key to use for this node.
This will also deterministically set the peer ID. If not specified, it will be set in the data dir for the chain being used.
--no-persist-peers
Do not persist peers.
--nat <NAT>
NAT resolution method
[default: any]
--port <PORT>
Network listening port. default: 30303
```
## `reth debug merkle`
```bash
$ reth debug merkle --help
Debug the clean & incremental state root calculations.
Usage: reth debug merkle [OPTIONS]
Options:
--datadir <DATA_DIR>
The path to the data dir for all reth files and subdirectories.
Defaults to the OS-specific data directory:
- Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/`
- Windows: `{FOLDERID_RoamingAppData}/reth/`
- macOS: `$HOME/Library/Application Support/reth/`
--chain <CHAIN_OR_PATH>
The chain this node is running.
Possible values are either a built-in chain or the path to a chain specification file.
Built-in chains:
- mainnet
- goerli
- sepolia
[default: mainnet]
--to
The height to finish at
--skip-node-depth
The depth after which we should start comparing branch nodes
```

43
book/cli/drop-stage.md → book/cli/import.md
View File

@ -1,45 +1,40 @@
# reth drop-stage # `reth import`
```bash ```bash
$ reth drop-stage --help $ reth import --help
Drops a stage's tables from the database
Usage: reth drop-stage [OPTIONS] <STAGE> Usage: reth import [OPTIONS]
Arguments:
<STAGE>
[possible values: headers, bodies, senders, execution, hashing, merkle, tx-lookup, history]
Options: Options:
--config <FILE>
The path to the configuration file to use.
--datadir <DATA_DIR> --datadir <DATA_DIR>
The path to the data dir for all reth files and subdirectories. The path to the data dir for all reth files and subdirectories.
Defaults to the OS-specific data directory: Defaults to the OS-specific data directory:
- Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/` - Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/`
- Windows: `{FOLDERID_RoamingAppData}/reth/` - Windows: `{FOLDERID_RoamingAppData}/reth/`
- macOS: `$HOME/Library/Application Support/reth/` - macOS: `$HOME/Library/Application Support/reth/`
[default: default]
--db <PATH>
The path to the database folder. If not specified, it will be set in the data dir for the
chain being used.
--chain <CHAIN_OR_PATH> --chain <CHAIN_OR_PATH>
The chain this node is running. The chain this node is running.
Possible values are either a built-in chain or the path to a chain specification file. Possible values are either a built-in chain or the path to a chain specification file.
Built-in chains: Built-in chains:
- mainnet - mainnet
- goerli - goerli
- sepolia - sepolia
[default: mainnet] [default: mainnet]
-h, --help --path <IMPORT_PATH>
Print help (see a summary with '-h') The path to a block file for import.
The online stages (headers and bodies) are replaced by a file import, after which the
remaining stages are executed.
Logging: Logging:
--log.persistent --log.persistent
@ -47,7 +42,7 @@ Logging:
--log.directory <PATH> --log.directory <PATH>
The path to put log files in The path to put log files in
[default: /Users/georgios/Library/Caches/reth/logs] [default: /Users/georgios/Library/Caches/reth/logs]
--log.journald --log.journald
@ -55,13 +50,13 @@ Logging:
--log.filter <FILTER> --log.filter <FILTER>
The filter to use for logs written to the log file The filter to use for logs written to the log file
[default: debug] [default: debug]
Display: Display:
-v, --verbosity... -v, --verbosity...
Set the minimum log level. Set the minimum log level.
-v Errors -v Errors
-vv Warnings -vv Warnings
-vvv Info -vvv Info

45
book/cli/dump-stage.md → book/cli/init.md
View File

@ -1,53 +1,31 @@
# `reth dump-stage` # `reth init`
```bash ```bash
$ reth dump-stage --help $ reth init --help
Dumps a stage from a range into a new database
Usage: reth dump-stage [OPTIONS] <COMMAND> Usage: reth init [OPTIONS]
Commands:
execution
Execution stage
storage-hashing
StorageHashing stage
account-hashing
AccountHashing stage
merkle
Merkle stage
help
Print this message or the help of the given subcommand(s)
Options: Options:
--datadir <DATA_DIR> --datadir <DATA_DIR>
The path to the data dir for all reth files and subdirectories. The path to the data dir for all reth files and subdirectories.
Defaults to the OS-specific data directory: Defaults to the OS-specific data directory:
- Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/` - Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/`
- Windows: `{FOLDERID_RoamingAppData}/reth/` - Windows: `{FOLDERID_RoamingAppData}/reth/`
- macOS: `$HOME/Library/Application Support/reth/` - macOS: `$HOME/Library/Application Support/reth/`
[default: default]
--db <PATH>
The path to the database folder. If not specified, it will be set in the data dir for the
chain being used.
--chain <CHAIN_OR_PATH> --chain <CHAIN_OR_PATH>
The chain this node is running. The chain this node is running.
Possible values are either a built-in chain or the path to a chain specification file. Possible values are either a built-in chain or the path to a chain specification file.
Built-in chains: Built-in chains:
- mainnet - mainnet
- goerli - goerli
- sepolia - sepolia
[default: mainnet]
-h, --help [default: mainnet]
Print help (see a summary with '-h')
Logging: Logging:
--log.persistent --log.persistent
@ -55,7 +33,7 @@ Logging:
--log.directory <PATH> --log.directory <PATH>
The path to put log files in The path to put log files in
[default: /Users/georgios/Library/Caches/reth/logs] [default: /Users/georgios/Library/Caches/reth/logs]
--log.journald --log.journald
@ -63,13 +41,13 @@ Logging:
--log.filter <FILTER> --log.filter <FILTER>
The filter to use for logs written to the log file The filter to use for logs written to the log file
[default: debug] [default: debug]
Display: Display:
-v, --verbosity... -v, --verbosity...
Set the minimum log level. Set the minimum log level.
-v Errors -v Errors
-vv Warnings -vv Warnings
-vvv Info -vvv Info
@ -78,5 +56,4 @@ Display:
-q, --quiet -q, --quiet
Silence all log output Silence all log output
``` ```

88
book/cli/node.md
View File

@ -12,42 +12,40 @@ Usage: reth node [OPTIONS]
Options: Options:
--datadir <DATA_DIR> --datadir <DATA_DIR>
The path to the data dir for all reth files and subdirectories. The path to the data dir for all reth files and subdirectories.
Defaults to the OS-specific data directory: Defaults to the OS-specific data directory:
- Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/` - Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/`
- Windows: `{FOLDERID_RoamingAppData}/reth/` - Windows: `{FOLDERID_RoamingAppData}/reth/`
- macOS: `$HOME/Library/Application Support/reth/` - macOS: `$HOME/Library/Application Support/reth/`
[default: default] [default: default]
--config <FILE> --config <FILE>
The path to the configuration file to use. The path to the configuration file to use.
--p2p-secret-key <PATH>
Secret key to use for this node.
This will also deterministically set the peer ID. If not specified, it will be set in the data dir for the chain being used.
--chain <CHAIN_OR_PATH> --chain <CHAIN_OR_PATH>
The chain this node is running. The chain this node is running.
Possible values are either a built-in chain or the path to a chain specification file. Possible values are either a built-in chain or the path to a chain specification file.
Built-in chains: Built-in chains:
- mainnet - mainnet
- goerli - goerli
- sepolia - sepolia
[default: mainnet] [default: mainnet]
--auto-mine
Automatically mine blocks for new transactions
-h, --help -h, --help
Print help (see a summary with '-h') Print help (see a summary with '-h')
Metrics: Metrics:
--metrics <SOCKET> --metrics <SOCKET>
Enable Prometheus metrics. Enable Prometheus metrics.
The metrics will be served at the given interface and port. The metrics will be served at the given interface and port.
Networking: Networking:
@ -71,19 +69,27 @@ Networking:
--bootnodes <BOOTNODES> --bootnodes <BOOTNODES>
Bootnodes to connect to initially. Bootnodes to connect to initially.
Will fall back to a network-specific default if not specified. Will fall back to a network-specific default if not specified.
--peers-file <FILE> --peers-file <FILE>
The path to the known peers file. Connected peers are dumped to this file on nodes The path to the known peers file. Connected peers are dumped to this file on nodes
shutdown, and read on startup. Cannot be used with `--no-persist-peers`. shutdown, and read on startup. Cannot be used with `--no-persist-peers`.
--identity <IDENTITY>
Custom node identity
--p2p-secret-key <PATH>
Secret key to use for this node.
This will also deterministically set the peer ID. If not specified, it will be set in the data dir for the chain being used.
--no-persist-peers --no-persist-peers
Do not persist peers. Do not persist peers.
--nat <NAT> --nat <NAT>
NAT resolution method NAT resolution method
[default: any] [default: any]
--port <PORT> --port <PORT>
@ -135,13 +141,53 @@ Rpc:
--authrpc.jwtsecret <PATH> --authrpc.jwtsecret <PATH>
Path to a JWT secret to use for authenticated RPC endpoints Path to a JWT secret to use for authenticated RPC endpoints
--auto-mine --rpc-max-request-size
Automatically mine blocks for new transactions Set the maximum RPC request payload size for both HTTP and WS in megabytes.
--rpc-max-response-size
Set the maximum RPC response payload size for both HTTP and WS in megabytes.
--rpc-max-subscriptions-per-connection
Set the the maximum concurrent subscriptions per connection.
--rpc-max-connections
Maximum number of RPC server connections.
--rpc-max-tracing-requests
Maximum number of concurrent tracing requests.
--gas-price-oracle
Gas price oracle configuration.
--block-cache-size
Max size for cached block data in megabytes.
--receipt-cache-size
Max size for cached receipt data in megabytes.
--env-cache-size
Max size for cached evm env data in megabytes.
Builder:
--builder.extradata
Block extra data set by the payload builder.
--builder.gaslimit
Target gas ceiling for built blocks.
--builder.interval
The interval at which the job should build a new payload after the last (in seconds).
--builder.deadline
The deadline for when the payload builder job should resolve.
--builder.max-tasks
Maximum number of tasks to spawn for building a payload.
Debug: Debug:
--debug.continuous --debug.continuous
Prompt the downloader to download blocks one at a time. Prompt the downloader to download blocks one at a time.
NOTE: This is for testing purposes only. NOTE: This is for testing purposes only.
--debug.terminate --debug.terminate
@ -149,7 +195,7 @@ Debug:
--debug.tip <TIP> --debug.tip <TIP>
Set the chain tip manually for testing purposes. Set the chain tip manually for testing purposes.
NOTE: This is a temporary flag NOTE: This is a temporary flag
--debug.max-block <MAX_BLOCK> --debug.max-block <MAX_BLOCK>
@ -173,7 +219,7 @@ Logging:
--log.directory <PATH> --log.directory <PATH>
The path to put log files in The path to put log files in
[default: /Users/georgios/Library/Caches/reth/logs] [default: /Users/georgios/Library/Caches/reth/logs]
--log.journald --log.journald
@ -181,13 +227,13 @@ Logging:
--log.filter <FILTER> --log.filter <FILTER>
The filter to use for logs written to the log file The filter to use for logs written to the log file
[default: debug] [default: debug]
Display: Display:
-v, --verbosity... -v, --verbosity...
Set the minimum log level. Set the minimum log level.
-v Errors -v Errors
-vv Warnings -vv Warnings
-vvv Info -vvv Info

44
book/cli/p2p.md
View File

@ -20,30 +20,30 @@ Options:
--chain <CHAIN_OR_PATH> --chain <CHAIN_OR_PATH>
The chain this node is running. The chain this node is running.
Possible values are either a built-in chain or the path to a chain specification file. Possible values are either a built-in chain or the path to a chain specification file.
Built-in chains: Built-in chains:
- mainnet - mainnet
- goerli - goerli
- sepolia - sepolia
[default: mainnet] [default: mainnet]
--datadir <DATA_DIR> --datadir <DATA_DIR>
The path to the data dir for all reth files and subdirectories. The path to the data dir for all reth files and subdirectories.
Defaults to the OS-specific data directory: Defaults to the OS-specific data directory:
- Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/` - Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/`
- Windows: `{FOLDERID_RoamingAppData}/reth/` - Windows: `{FOLDERID_RoamingAppData}/reth/`
- macOS: `$HOME/Library/Application Support/reth/` - macOS: `$HOME/Library/Application Support/reth/`
[default: default] [default: default]
--p2p-secret-key <PATH> --p2p-secret-key <PATH>
Secret key to use for this node. Secret key to use for this node.
This also will deterministically set the peer ID. This also will deterministically set the peer ID.
-d, --disable-discovery -d, --disable-discovery
@ -66,7 +66,7 @@ Options:
--retries <RETRIES> --retries <RETRIES>
The number of retries per request The number of retries per request
[default: 5] [default: 5]
--nat <NAT> --nat <NAT>
@ -81,7 +81,7 @@ Logging:
--log.directory <PATH> --log.directory <PATH>
The path to put log files in The path to put log files in
[default: /Users/georgios/Library/Caches/reth/logs] [default: /Users/georgios/Library/Caches/reth/logs]
--log.journald --log.journald
@ -89,13 +89,13 @@ Logging:
--log.filter <FILTER> --log.filter <FILTER>
The filter to use for logs written to the log file The filter to use for logs written to the log file
[default: debug] [default: debug]
Display: Display:
-v, --verbosity... -v, --verbosity...
Set the minimum log level. Set the minimum log level.
-v Errors -v Errors
-vv Warnings -vv Warnings
-vvv Info -vvv Info
@ -112,20 +112,11 @@ Display:
$ reth p2p header --help $ reth p2p header --help
Download block header Download block header
Usage: reth p2p header [OPTIONS] <ID> Usage: reth p2p header <ID>
Arguments: Arguments:
<ID> <ID>
The header number or hash The header number or hash
Options:
--p2p-secret-key <PATH>
Secret key to use for this node.
This also will deterministically set the peer ID.
-h, --help
Print help (see a summary with '-h')
``` ```
@ -136,18 +127,9 @@ Options:
$ reth p2p body --help $ reth p2p body --help
Download block body Download block body
Usage: reth p2p body [OPTIONS] <ID> Usage: reth p2p body <ID>
Arguments: Arguments:
<ID> <ID>
The block number or hash The block number or hash
Options:
--p2p-secret-key <PATH>
Secret key to use for this node.
This also will deterministically set the peer ID.
-h, --help
Print help (see a summary with '-h')
``` ```

355
book/cli/stage.md
View File

@ -1,15 +1,68 @@
# `reth stage` # `reth stage`
```bash ```bash
Run a single stage. $ reth stage --help
Usage: reth stage [OPTIONS] --from <FROM> --to <TO> <STAGE> Usage: reth db <COMMAND>
Arguments: Commands:
<STAGE> run
The name of the stage to run Run a single stage.
[possible values: headers, bodies, senders, execution, hashing, merkle, tx-lookup, history] Note that this won't use the Pipeline and as a result runs stages
assuming that all the data can be held in memory. It is not recommended
to run a stage for really large block ranges if your computer does not have
a lot of memory to store all the data.
drop
Drop a stage's tables from the database.
dump
Dumps a stage from a range into a new database.
unwind
Unwinds a certain block range, deleting it from the database.
help
Print this message or the help of the given subcommand(s)
Logging:
--log.persistent
The flag to enable persistent logs
--log.directory <PATH>
The path to put log files in
[default: /Users/georgios/Library/Caches/reth/logs]
--log.journald
Log events to journald
--log.filter <FILTER>
The filter to use for logs written to the log file
[default: debug]
Display:
-v, --verbosity...
Set the minimum log level.
-v Errors
-vv Warnings
-vvv Info
-vvvv Debug
-vvvvv Traces (warning: very verbose!)
-q, --quiet
Silence all log output
```
## `reth stage run`
```bash
Usage: reth stage run [OPTIONS] --from <FROM> --to <TO> --stage <STAGE>
Run a single stage.
Note that this won't use the Pipeline and as a result runs stages
assuming that all the data can be held in memory. It is not recommended
to run a stage for really large block ranges if your computer does not have
a lot of memory to store all the data.
Options: Options:
--config <FILE> --config <FILE>
@ -17,48 +70,56 @@ Options:
--datadir <DATA_DIR> --datadir <DATA_DIR>
The path to the data dir for all reth files and subdirectories. The path to the data dir for all reth files and subdirectories.
Defaults to the OS-specific data directory: Defaults to the OS-specific data directory:
- Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/` - Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/`
- Windows: `{FOLDERID_RoamingAppData}/reth/` - Windows: `{FOLDERID_RoamingAppData}/reth/`
- macOS: `$HOME/Library/Application Support/reth/` - macOS: `$HOME/Library/Application Support/reth/`
[default: default] [default: default]
--chain <CHAIN_OR_PATH> --chain <CHAIN_OR_PATH>
The chain this node is running. The chain this node is running.
Possible values are either a built-in chain or the path to a chain specification file. Possible values are either a built-in chain or the path to a chain specification file.
Built-in chains: Built-in chains:
- mainnet - mainnet
- goerli - goerli
- sepolia - sepolia
[default: mainnet]
--p2p-secret-key <PATH> [default: mainnet]
Secret key to use for this node.
This also will deterministically set the peer ID.
--metrics <SOCKET> --metrics <SOCKET>
Enable Prometheus metrics. Enable Prometheus metrics.
The metrics will be served at the given interface and port. The metrics will be served at the given interface and port.
--stage <STAGE>
The name of the stage to run
[possible values: headers, bodies, senders, execution, account-hashing, storage-hashing, hashing, merkle, tx-lookup, history, account-history, storage-history, total-difficulty]
--from <FROM> --from <FROM>
The height to start at The height to start at
-t, --to <TO> -t, --to <TO>
The end of the stage The end of the stage
--batch-size
Batch size for stage execution and unwind
-s, --skip-unwind -s, --skip-unwind
Normally, running the stage requires unwinding for stages that already have been run, in order to not rewrite to the same database slots. Normally, running the stage requires unwinding for stages that already have been run, in order to not rewrite to the same database slots.
You can optionally skip the unwinding phase if you're syncing a block range that has not been synced before. You can optionally skip the unwinding phase if you're syncing a block range that has not been synced before.
--commit
Commits the changes in the database. WARNING: potentially destructive.
Useful when you want to run diagnostics on the database.
-h, --help -h, --help
Print help (see a summary with '-h') Print help (see a summary with '-h')
@ -83,52 +144,240 @@ Networking:
--bootnodes <BOOTNODES> --bootnodes <BOOTNODES>
Bootnodes to connect to initially. Bootnodes to connect to initially.
Will fall back to a network-specific default if not specified. Will fall back to a network-specific default if not specified.
--peers-file <FILE> --peers-file <FILE>
The path to the known peers file. Connected peers are dumped to this file on nodes The path to the known peers file. Connected peers are dumped to this file on nodes
shutdown, and read on startup. Cannot be used with `--no-persist-peers`. shutdown, and read on startup. Cannot be used with `--no-persist-peers`.
--identity
Custom node identity
--p2p-secret-key
Secret key to use for this node.
This will also deterministically set the peer ID. If not specified, it will be set in the
data dir for the chain being used.
--no-persist-peers --no-persist-peers
Do not persist peers. Do not persist peers.
--nat <NAT> --nat <NAT>
NAT resolution method NAT resolution method
[default: any] [default: any]
--port <PORT> --port <PORT>
Network listening port. default: 30303 Network listening port. default: 30303
```
Logging:
--log.persistent ## `reth stage drop`
The flag to enable persistent logs
```bash
--log.directory <PATH> Usage: reth stage drop [OPTIONS] <STAGE>
The path to put log files in Drop a stage's tables from the database.
[default: /Users/georgios/Library/Caches/reth/logs] Arguments:
<STAGE>
--log.journald The name of the stage to drop
Log events to journald
[possible values: headers, bodies, senders, execution, account-hashing, storage-hashing, hashing, merkle, tx-lookup, history, account-history, storage-history, total-difficulty]
--log.filter <FILTER>
The filter to use for logs written to the log file Options:
--datadir <DATA_DIR>
[default: debug] The path to the data dir for all reth files and subdirectories.
Display: Defaults to the OS-specific data directory:
-v, --verbosity...
Set the minimum log level. - Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/`
- Windows: `{FOLDERID_RoamingAppData}/reth/`
-v Errors - macOS: `$HOME/Library/Application Support/reth/`
-vv Warnings
-vvv Info [default: default]
-vvvv Debug
-vvvvv Traces (warning: very verbose!) --chain <CHAIN_OR_PATH>
The chain this node is running.
-q, --quiet
Silence all log output Possible values are either a built-in chain or the path to a chain specification file.
Built-in chains:
- mainnet
- goerli
- sepolia
[default: mainnet]
```
## `reth stage dump`
```bash
Usage: reth stage dump [OPTIONS] <COMMAND>
Dumps a stage from a range into a new database.
Commands:
execution
Execution stage.
storage-hashing
StorageHashing stage.
account-hashing
AccountHashing stage.
merkle
Merkle stage.
help
Print this message or the help of the given subcommand(s)
Options:
--datadir <DATA_DIR>
The path to the data dir for all reth files and subdirectories.
Defaults to the OS-specific data directory:
- Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/`
- Windows: `{FOLDERID_RoamingAppData}/reth/`
- macOS: `$HOME/Library/Application Support/reth/`
[default: default]
--chain <CHAIN_OR_PATH>
The chain this node is running.
Possible values are either a built-in chain or the path to a chain specification file.
Built-in chains:
- mainnet
- goerli
- sepolia
[default: mainnet]
```
### `reth stage dump execution`
```bash
Usage: reth stage dump execution [OPTIONS]
Execution stage.
Options:
--output_db <OUTPUT_PATH>
The path to the new database folder.
-f, --from <FROM>
From which block.
-t, --to <TO>
To which block.
-d, --dry-run <DRY_RUN>
If passed, it will dry-run a stage execution from the newly created database right after
dumping.
[default: false]
```
### `reth stage dump storage-hashing`
```bash
Usage: reth stage dump storage-hashing [OPTIONS]
StorageHashing stage.
Options:
--output_db <OUTPUT_PATH>
The path to the new database folder.
-f, --from <FROM>
From which block.
-t, --to <TO>
To which block.
-d, --dry-run <DRY_RUN>
If passed, it will dry-run a stage execution from the newly created database right after
dumping.
[default: false]
```
### `reth stage dump account-hashing`
```bash
Usage: reth stage dump account-hashing [OPTIONS]
AccountHashing stage.
Options:
--output_db <OUTPUT_PATH>
The path to the new database folder.
-f, --from <FROM>
From which block.
-t, --to <TO>
To which block.
-d, --dry-run <DRY_RUN>
If passed, it will dry-run a stage execution from the newly created database right after
dumping.
[default: false]
```
### `reth stage dump merkle`
```bash
Usage: reth stage dump merkle [OPTIONS]
Merkle stage.
Options:
--output_db <OUTPUT_PATH>
The path to the new database folder.
-f, --from <FROM>
From which block.
-t, --to <TO>
To which block.
-d, --dry-run <DRY_RUN>
If passed, it will dry-run a stage execution from the newly created database right after
dumping.
[default: false]
```
## `reth stage unwind`
```bash
Usage: reth stage unwind [OPTIONS] <COMMAND>
Unwinds a certain block range, deleting it from the database.
Commands:
to-block
Unwinds the database until the given block number (range is inclusive).
num-blocks
Unwinds the given number of blocks from the database.
help
Print this message or the help of the given subcommand(s)
Options:
--datadir <DATA_DIR>
The path to the data dir for all reth files and subdirectories.
Defaults to the OS-specific data directory:
- Linux: `$XDG_DATA_HOME/reth/` or `$HOME/.local/share/reth/`
- Windows: `{FOLDERID_RoamingAppData}/reth/`
- macOS: `$HOME/Library/Application Support/reth/`
[default: default]
--chain <CHAIN_OR_PATH>
The chain this node is running.
Possible values are either a built-in chain or the path to a chain specification file.
Built-in chains:
- mainnet
- goerli
- sepolia
[default: mainnet]
``` ```

16
book/cli/test-vectors.md Normal file
View File

@ -0,0 +1,16 @@
# `reth test-vectors`
```bash
$ reth test-vectors --help
Generate Test Vectors
Usage: reth test-vectors <COMMAND> <NAMES>
Commands:
tables
Generates test vectors for specified tables. If no table is specified, generate for all.
Arguments:
<NAMES>
List of table names. Case-sensitive.
```