github/reth
1
1
Fork 0
mirror of https://github.com/paradigmxyz/reth.git synced 2026-02-19 03:04:27 -05:00
Code Issues Packages Projects Releases Wiki Activity

feat(storage): add use_hashed_state storage setting (#21997)

Browse Source
This commit is contained in:
Dan Cline
2026-02-09 20:15:13 +00:00
committed by GitHub
parent cdcea2bd33
commit a549b4d66d
22 changed files with 324 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
docs/vocs/docs/pages/cli/SUMMARY.mdx
View File

@@ -37,6 +37,7 @@
- [`reth db settings set transaction_hash_numbers`](./reth/db/settings/set/transaction_hash_numbers.mdx)
- [`reth db settings set account_history`](./reth/db/settings/set/account_history.mdx)
- [`reth db settings set storage_changesets`](./reth/db/settings/set/storage_changesets.mdx)
- [`reth db settings set use_hashed_state`](./reth/db/settings/set/use_hashed_state.mdx)
- [`reth db account-storage`](./reth/db/account-storage.mdx)
- [`reth db state`](./reth/db/state.mdx)
- [`reth download`](./reth/download.mdx)

7
docs/vocs/docs/pages/cli/reth/db.mdx
View File

@@ -209,6 +209,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
Logging:
--log.stdout.format <FORMAT>
The format to use for logs written to stdout

1
docs/vocs/docs/pages/cli/reth/db/settings/set.mdx
View File

@@ -16,6 +16,7 @@ Commands:
transaction_hash_numbers Store transaction hash to number mapping in rocksdb instead of MDBX
account_history Store account history in rocksdb instead of MDBX
storage_changesets Store storage changesets in static files instead of the database
use_hashed_state Use hashed state tables (HashedAccounts/HashedStorages) as canonical state
help Print this message or the help of the given subcommand(s)
Options:

170
docs/vocs/docs/pages/cli/reth/db/settings/set/use_hashed_state.mdx Normal file
View File

@@ -0,0 +1,170 @@
# reth db settings set use_hashed_state
Use hashed state tables (HashedAccounts/HashedStorages) as canonical state
```bash
$ reth db settings set use_hashed_state --help
```
```txt
Usage: reth db settings set use_hashed_state [OPTIONS] <VALUE>
Arguments:
<VALUE>
[possible values: true, false]
Options:
-h, --help
Print help (see a summary with '-h')
Datadir:
--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, sepolia, holesky, hoodi, dev
[default: mainnet]
Logging:
--log.stdout.format <FORMAT>
The format to use for logs written to stdout
Possible values:
- json: Represents JSON formatting for logs. This format outputs log records as JSON objects, making it suitable for structured logging
- log-fmt: Represents logfmt (key=value) formatting for logs. This format is concise and human-readable, typically used in command-line applications
- terminal: Represents terminal-friendly formatting for logs
[default: terminal]
--log.stdout.filter <FILTER>
The filter to use for logs written to stdout
[default: ]
--log.file.format <FORMAT>
The format to use for logs written to the log file
Possible values:
- json: Represents JSON formatting for logs. This format outputs log records as JSON objects, making it suitable for structured logging
- log-fmt: Represents logfmt (key=value) formatting for logs. This format is concise and human-readable, typically used in command-line applications
- terminal: Represents terminal-friendly formatting for logs
[default: terminal]
--log.file.filter <FILTER>
The filter to use for logs written to the log file
[default: debug]
--log.file.directory <PATH>
The path to put log files in
[default: <CACHE_DIR>/logs]
--log.file.name <NAME>
The prefix name of the log files
[default: reth.log]
--log.file.max-size <SIZE>
The maximum size (in MB) of one log file
[default: 200]
--log.file.max-files <COUNT>
The maximum amount of log files that will be stored. If set to 0, background file logging is disabled
[default: 5]
--log.journald
Write logs to journald
--log.journald.filter <FILTER>
The filter to use for logs written to journald
[default: error]
--color <COLOR>
Sets whether or not the formatter emits ANSI terminal escape codes for colors and other text formatting
Possible values:
- always: Colors on
- auto: Auto-detect
- never: Colors off
[default: always]
--logs-otlp[=<URL>]
Enable `Opentelemetry` logs export to an OTLP endpoint.
If no value provided, defaults based on protocol: - HTTP: `http://localhost:4318/v1/logs` - gRPC: `http://localhost:4317`
Example: --logs-otlp=http://collector:4318/v1/logs
[env: OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=]
--logs-otlp.filter <FILTER>
Set a filter directive for the OTLP logs exporter. This controls the verbosity of logs sent to the OTLP endpoint. It follows the same syntax as the `RUST_LOG` environment variable.
Example: --logs-otlp.filter=info,reth=debug
Defaults to INFO if not specified.
[default: info]
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
Tracing:
--tracing-otlp[=<URL>]
Enable `Opentelemetry` tracing export to an OTLP endpoint.
If no value provided, defaults based on protocol: - HTTP: `http://localhost:4318/v1/traces` - gRPC: `http://localhost:4317`
Example: --tracing-otlp=http://collector:4318/v1/traces
[env: OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=]
--tracing-otlp-protocol <PROTOCOL>
OTLP transport protocol to use for exporting traces and logs.
- `http`: expects endpoint path to end with `/v1/traces` or `/v1/logs` - `grpc`: expects endpoint without a path
Defaults to HTTP if not specified.
Possible values:
- http: HTTP/Protobuf transport, port 4318, requires `/v1/traces` path
- grpc: gRPC transport, port 4317
[env: OTEL_EXPORTER_OTLP_PROTOCOL=]
[default: http]
--tracing-otlp.filter <FILTER>
Set a filter directive for the OTLP tracer. This controls the verbosity of spans and events sent to the OTLP endpoint. It follows the same syntax as the `RUST_LOG` environment variable.
Example: --tracing-otlp.filter=info,reth=debug,hyper_util=off
Defaults to TRACE if not specified.
[default: debug]
--tracing-otlp.sample-ratio <RATIO>
Trace sampling ratio to control the percentage of traces to export.
Valid range: 0.0 to 1.0 - 1.0, default: Sample all traces - 0.01: Sample 1% of traces - 0.0: Disable sampling
Example: --tracing-otlp.sample-ratio=0.0.
[env: OTEL_TRACES_SAMPLER_ARG=]
```

7
docs/vocs/docs/pages/cli/reth/download.mdx
View File

@@ -192,6 +192,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
-u, --url <URL>
Specify a snapshot URL or let the command propose a default one.

7
docs/vocs/docs/pages/cli/reth/export-era.mdx
View File

@@ -192,6 +192,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
--first-block-number <first-block-number>
Optional first block number to export from the db.
It is by default 0.

7
docs/vocs/docs/pages/cli/reth/import-era.mdx
View File

@@ -192,6 +192,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
--path <IMPORT_ERA_PATH>
The path to a directory for import.

7
docs/vocs/docs/pages/cli/reth/import.mdx
View File

@@ -192,6 +192,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
--no-state
Disables stages that require state.

7
docs/vocs/docs/pages/cli/reth/init-state.mdx
View File

@@ -192,6 +192,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
--without-evm
Specifies whether to initialize the state without relying on EVM historical data.

7
docs/vocs/docs/pages/cli/reth/init.mdx
View File

@@ -192,6 +192,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
Logging:
--log.stdout.format <FORMAT>
The format to use for logs written to stdout

7
docs/vocs/docs/pages/cli/reth/node.mdx
View File

@@ -1110,6 +1110,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
Ress:
--ress.enable
Enable support for `ress` subprotocol

7
docs/vocs/docs/pages/cli/reth/prune.mdx
View File

@@ -192,6 +192,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
Metrics:
--metrics <PROMETHEUS>
Enable Prometheus metrics.

7
docs/vocs/docs/pages/cli/reth/re-execute.mdx
View File

@@ -192,6 +192,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
--from <FROM>
The height to start at

7
docs/vocs/docs/pages/cli/reth/stage/drop.mdx
View File

@@ -192,6 +192,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
<STAGE>
Possible values:
- headers: The headers stage within the pipeline

7
docs/vocs/docs/pages/cli/reth/stage/dump.mdx
View File

@@ -199,6 +199,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
Logging:
--log.stdout.format <FORMAT>
The format to use for logs written to stdout

7
docs/vocs/docs/pages/cli/reth/stage/run.mdx
View File

@@ -192,6 +192,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
--metrics <SOCKET>
Enable Prometheus metrics.

7
docs/vocs/docs/pages/cli/reth/stage/unwind.mdx
View File

@@ -197,6 +197,13 @@ Storage:
Individual settings can still be overridden with `--static-files.*` and `--rocksdb.*` flags.
--storage.use-hashed-state
Use hashed state tables (`HashedAccounts`/`HashedStorages`) as canonical state representation instead of plain state tables.
When enabled, execution writes directly to hashed tables, eliminating the need for separate hashing stages. This should only be enabled for new databases.
WARNING: Changing this setting on an existing database requires a full resync.
--offline
If this is enabled, then all stages except headers, bodies, and sender recovery will be unwound

4
docs/vocs/sidebar-cli-reth.ts
View File

@@ -171,6 +171,10 @@ export const rethCliSidebar: SidebarItem = {
{
text: "reth db settings set storage_changesets",
link: "/cli/reth/db/settings/set/storage_changesets"
},
{
text: "reth db settings set use_hashed_state",
link: "/cli/reth/db/settings/set/use_hashed_state"
}
]
}