From 18ad1068aaae57a7171b1c56416c38c3729192aa Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 2 Sep 2026 14:04:39 +0000 Subject: [PATCH] docs: generated from v2.0.0-rc --- docs/fundamentals/configuration.md | 1373 ++++++++++++++++----- docs/interacting/json-rpc-ns/admin.md | 278 ++++- docs/interacting/json-rpc-ns/clique.md | 6 +- docs/interacting/json-rpc-ns/debug.md | 699 ++++------- docs/interacting/json-rpc-ns/eth.md | 472 ++++--- docs/interacting/json-rpc-ns/flashbots.md | 32 +- docs/interacting/json-rpc-ns/logindex.md | 181 +-- docs/interacting/json-rpc-ns/parity.md | 36 +- docs/interacting/json-rpc-ns/proof.md | 24 +- docs/interacting/json-rpc-ns/rbuilder.md | 10 +- docs/interacting/json-rpc-ns/trace.md | 394 ++---- docs/interacting/json-rpc-ns/txpool.md | 8 +- docs/monitoring/metrics/metrics.md | 298 +++-- 13 files changed, 2059 insertions(+), 1752 deletions(-) diff --git a/docs/fundamentals/configuration.md b/docs/fundamentals/configuration.md index 4b2c351a94..e31d133310 100644 --- a/docs/fundamentals/configuration.md +++ b/docs/fundamentals/configuration.md @@ -262,7 +262,6 @@ The configuration options are case-sensitive and can be defined only once unless The address of the transaction priority contract to use when selecting transactions from the transaction pool. Defaults to `null`. - ### BalRecorder - #### `BalRecorder.Path` \{#balrecorder-path\} @@ -346,7 +345,6 @@ The configuration options are case-sensitive and can be defined only once unless Whether to replay recorded block access lists during block processing. Allowed values: `true` `false`. Defaults to `false`. - ### Blocks - #### `Blocks.BlockProductionBlobLimit` \{#blocks-blockproductionbloblimit\} @@ -565,32 +563,39 @@ The configuration options are case-sensitive and can be defined only once unless Use parallel state reads when Block Level Access Lists are available. Experimental Amsterdam/BAL path; disabling falls back to sequential reads and the option is ignored for blocks without BAL bodies. Allowed values: `true` `false`. Defaults to `true`. -- #### `Blocks.PreWarmStateOnBlockProcessing` \{#blocks-prewarmstateonblockprocessing\} +- #### `Blocks.PreWarming` \{#blocks-prewarming\} ``` - --blocks-prewarmstateonblockprocessing [true|false] - --Blocks.PreWarmStateOnBlockProcessing [true|false] + --blocks-prewarming + --Blocks.PreWarming ``` ``` - NETHERMIND_BLOCKSCONFIG_PREWARMSTATEONBLOCKPROCESSING=true|false + NETHERMIND_BLOCKSCONFIG_PREWARMING= ``` ```json { "Blocks": { - "PreWarmStateOnBlockProcessing": true|false + "PreWarming": } } ``` - Whether to pre-warm the state when processing blocks. This can lead to an up to 2x speed-up in the main loop block processing. Allowed values: `true` `false`. Defaults to `True`. + State pre-warming level while processing blocks: `None`, `Block` (warm the block's own transactions), or `BlockAndMempool` (also speculatively warm from the mempool between blocks). + + Allowed values: + - `None` + - `Block` + - `BlockAndMempool` + + Defaults to `BlockAndMempool`. - #### `Blocks.RandomizedBlocks` \{#blocks-randomizedblocks\} @@ -727,7 +732,6 @@ The configuration options are case-sensitive and can be defined only once unless The block gas limit that the block producer should try to reach in the fastest possible way based on the protocol rules. If not specified, then the block producer should follow others. Defaults to `null`. - ### CensorshipDetector - #### `CensorshipDetector.AddressesForCensorshipDetection` \{#censorshipdetector-addressesforcensorshipdetection\} @@ -811,10 +815,8 @@ The configuration options are case-sensitive and can be defined only once unless Whether to enable censorship detection. Allowed values: `true` `false`. Defaults to `false`. - ### Clique - ### Era - #### `Era.ExportDirectory` \{#era-exportdirectory\} @@ -952,7 +954,6 @@ The configuration options are case-sensitive and can be defined only once unless Accumulator file to be used for trusting era files. Defaults to `null`. - ### EraE - #### `EraE.BeaconNodeUrl` \{#erae-beaconnodeurl\} @@ -1088,7 +1089,7 @@ The configuration options are case-sensitive and can be defined only once unless - Base URL of a remote EraE archive server (e.g. https://data.ethpandaops.io/erae/{network}/). When set, missing local epoch files are downloaded on demand. Defaults to `null`. + Base URL of a remote EraE archive server (e.g. https://data.ethpandaops.io/erae/\{network}/). When set, missing local epoch files are downloaded on demand. Defaults to `null`. - #### `EraE.RemoteDownloadDirectory` \{#erae-remotedownloaddirectory\} @@ -1171,7 +1172,6 @@ The configuration options are case-sensitive and can be defined only once unless Accumulator file for trusting EraE archives. Defaults to `null`. - ### EthStats - #### `EthStats.Contact` \{#ethstats-contact\} @@ -1336,7 +1336,6 @@ The configuration options are case-sensitive and can be defined only once unless The Ethstats server URL. Defaults to `ws://localhost:3000/api`. - ### Flashbots - #### `Flashbots.EnablePreWarmer` \{#flashbots-enableprewarmer\} @@ -1502,9 +1501,35 @@ The configuration options are case-sensitive and can be defined only once unless Whether to calculate the proposer payment as a balance difference of the fee recipient. Allowed values: `true` `false`. Defaults to `false`. - ### FlatDb +- #### `FlatDb.ArenaFileSizeBytes` \{#flatdb-arenafilesizebytes\} + + + + ``` + --flatdb-arenafilesizebytes + --FlatDb.ArenaFileSizeBytes + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_ARENAFILESIZEBYTES= + ``` + + + ```json + { + "FlatDb": { + "ArenaFileSizeBytes": + } + } + ``` + + + + Maximum size in bytes for a single arena file before a new one is started. Defaults to `1073741824`. + - #### `FlatDb.BlockCacheSizeBudget` \{#flatdb-blockcachesizebudget\} @@ -1586,6 +1611,33 @@ The configuration options are case-sensitive and can be defined only once unless Fixed compaction schedule offset in blocks. When 0 or greater, overrides the per-instance offset in the metadata DB, which is neither read nor updated. Only the value modulo CompactSize matters. -1 to use the stored offset, generating a random one when absent. Defaults to `-1`. +- #### `FlatDb.EnableLongFinality` \{#flatdb-enablelongfinality\} + + + + ``` + --flatdb-enablelongfinality [true|false] + --FlatDb.EnableLongFinality [true|false] + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_ENABLELONGFINALITY=true|false + ``` + + + ```json + { + "FlatDb": { + "EnableLongFinality": true|false + } + } + ``` + + + + Enable long finality support with persisted snapshots Allowed values: `true` `false`. Defaults to `true`. + - #### `FlatDb.EnablePreimageRecording` \{#flatdb-enablepreimagerecording\} @@ -1597,218 +1649,650 @@ The configuration options are case-sensitive and can be defined only once unless ``` - NETHERMIND_FLATDBCONFIG_ENABLEPREIMAGERECORDING=true|false + NETHERMIND_FLATDBCONFIG_ENABLEPREIMAGERECORDING=true|false + ``` + + + ```json + { + "FlatDb": { + "EnablePreimageRecording": true|false + } + } + ``` + + + + Enable recording of preimages (address/slot hash to original bytes) Allowed values: `true` `false`. Defaults to `false`. + +- #### `FlatDb.Enabled` \{#flatdb-enabled\} + + + + ``` + --flatdb-enabled [true|false] + --FlatDb.Enabled [true|false] + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_ENABLED=true|false + ``` + + + ```json + { + "FlatDb": { + "Enabled": true|false + } + } + ``` + + + + Enabled Allowed values: `true` `false`. Defaults to `false`. + +- #### `FlatDb.HistoryEnabled` \{#flatdb-historyenabled\} + + + + ``` + --flatdb-historyenabled [true|false] + --FlatDb.HistoryEnabled [true|false] + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_HISTORYENABLED=true|false + ``` + + + ```json + { + "FlatDb": { + "HistoryEnabled": true|false + } + } + ``` + + + + Capture finalized per-block account/storage changesets into the history columns for archival queries. Off by default; when off the persist path does no extra work. Allowed values: `true` `false`. Defaults to `false`. + +- #### `FlatDb.HistoryPruneIntervalBlocks` \{#flatdb-historypruneintervalblocks\} + + + + ``` + --flatdb-historypruneintervalblocks + --FlatDb.HistoryPruneIntervalBlocks + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_HISTORYPRUNEINTERVALBLOCKS= + ``` + + + ```json + { + "FlatDb": { + "HistoryPruneIntervalBlocks": + } + } + ``` + + + + How many blocks the watermark must advance before an idle history window pruner wakes and re-evaluates the floor. A pruner still owing sweep work paces itself on its pass budget instead. Only consulted when HistoryRetentionBlocks is set. Defaults to `1024`. + +- #### `FlatDb.HistoryPrunePassBudgetSeconds` \{#flatdb-historyprunepassbudgetseconds\} + + + + ``` + --flatdb-historyprunepassbudgetseconds + --FlatDb.HistoryPrunePassBudgetSeconds + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_HISTORYPRUNEPASSBUDGETSECONDS= + ``` + + + ```json + { + "FlatDb": { + "HistoryPrunePassBudgetSeconds": + } + } + ``` + + + + Per-pass wall-clock budget, in seconds, for the history window pruner's incremental scan-and-delete. A pass yields at the budget and resumes from its persisted cursor on the next pass rather than running unbounded. Must exceed the longest historical query the node serves: deletes wait for in-flight historical reads, and a read that outlives every pass blocks reclamation until it finishes. Defaults to `5`. + +- #### `FlatDb.HistoryRetentionBlocks` \{#flatdb-historyretentionblocks\} + + + + ``` + --flatdb-historyretentionblocks + --FlatDb.HistoryRetentionBlocks + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_HISTORYRETENTIONBLOCKS= + ``` + + + ```json + { + "FlatDb": { + "HistoryRetentionBlocks": + } + } + ``` + + + + Bounded rolling-window retention for flat history, in blocks below the watermark. 0 disables windowing: history is retained unbounded from genesis/pivot, today's shipped behavior. Defaults to `0`. + +- #### `FlatDb.HistorySliceAddresses` \{#flatdb-historysliceaddresses\} + + + + ``` + --flatdb-historysliceaddresses + --FlatDb.HistorySliceAddresses + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_HISTORYSLICEADDRESSES= + ``` + + + ```json + { + "FlatDb": { + "HistorySliceAddresses": + } + } + ``` + + + + A comma-separated list of contract addresses to retain unbounded (or far deeper than HistoryRetentionBlocks) flat history for, independent of the general rolling window. Static allow-list only - an address is never added or removed except by editing this config and restarting. Both the receipts and the whole block body are retained for every block one of these addresses appears in, so those heights keep their transactions queryable and not just their logs. The cost is body disk: a contract busy enough to match most blocks means most of those bodies are kept, and history pruning stops reclaiming body space over that range. An entry with a retention suffix keeps bodies and receipts only while a height is within that many blocks of the head; a cleanup cursor reclaims them after they fall out. An entry without a retention suffix retains forever and pins the whole clears column and the per-block markers (~40 bytes per block the window never reclaims). Answering below a previously pruned boundary requires History.Pruning to stay enabled: the pruner is what validates, at startup, from which depth each slice's logs are provably retained, and without it those reads fail closed. Defaults to `null`. + +- #### `FlatDb.HistoryVerifyEveryBlock` \{#flatdb-historyverifyeveryblock\} + + + + ``` + --flatdb-historyverifyeveryblock [true|false] + --FlatDb.HistoryVerifyEveryBlock [true|false] + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_HISTORYVERIFYEVERYBLOCK=true|false + ``` + + + ```json + { + "FlatDb": { + "HistoryVerifyEveryBlock": true|false + } + } + ``` + + + + Rebuild the state root from flat history rows at every covered block and compare against this node's own headers, once, in the background. Unwindowed archives only; memory-heavy on large ranges. Allowed values: `true` `false`. Defaults to `false`. + +- #### `FlatDb.HistoryVerifyMaxRows` \{#flatdb-historyverifymaxrows\} + + + + ``` + --flatdb-historyverifymaxrows + --FlatDb.HistoryVerifyMaxRows + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_HISTORYVERIFYMAXROWS= + ``` + + + ```json + { + "FlatDb": { + "HistoryVerifyMaxRows": + } + } + ``` + + + + Rows the every-block history verification may hold in memory before it declines the run. Its working set follows state size rather than range length, so a full archive needs a large value and a machine to match. 0 uses the built-in ceiling. Defaults to `0`. + +- #### `FlatDb.HistoryVerifySegments` \{#flatdb-historyverifysegments\} + + + + ``` + --flatdb-historyverifysegments + --FlatDb.HistoryVerifySegments + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_HISTORYVERIFYSEGMENTS= + ``` + + + ```json + { + "FlatDb": { + "HistoryVerifySegments": + } + } + ``` + + + + Concurrent segments the every-block history verification splits its range into. Each segment is independently anchored to its own start header, so segments share nothing but the read-only columns. 0 means half the processor count. Defaults to `0`. + +- #### `FlatDb.ImportFromPruningTrieState` \{#flatdb-importfrompruningtriestate\} + + + + ``` + --flatdb-importfrompruningtriestate [true|false] + --FlatDb.ImportFromPruningTrieState [true|false] + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_IMPORTFROMPRUNINGTRIESTATE=true|false + ``` + + + ```json + { + "FlatDb": { + "ImportFromPruningTrieState": true|false + } + } + ``` + + + + Import from pruning trie state db Allowed values: `true` `false`. Defaults to `false`. + +- #### `FlatDb.InlineCompaction` \{#flatdb-inlinecompaction\} + + + + ``` + --flatdb-inlinecompaction [true|false] + --FlatDb.InlineCompaction [true|false] + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_INLINECOMPACTION=true|false + ``` + + + ```json + { + "FlatDb": { + "InlineCompaction": true|false + } + } + ``` + + + + Inline compaction Allowed values: `true` `false`. Defaults to `false`. + +- #### `FlatDb.Layout` \{#flatdb-layout\} + + + + ``` + --flatdb-layout + --FlatDb.Layout + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_LAYOUT= + ``` + + + ```json + { + "FlatDb": { + "Layout": + } + } + ``` + + + + Flat db layout + + Allowed values: + - `Flat` + - `FlatInTrie` + - `PreimageFlatV1` + - `PreimageFlat` + + Defaults to `Flat`. + +- #### `FlatDb.LongFinalityMaxReorgDepth` \{#flatdb-longfinalitymaxreorgdepth\} + + + + ``` + --flatdb-longfinalitymaxreorgdepth + --FlatDb.LongFinalityMaxReorgDepth + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_LONGFINALITYMAXREORGDEPTH= + ``` + + + ```json + { + "FlatDb": { + "LongFinalityMaxReorgDepth": + } + } + ``` + + + + Force-persist backstop used when EnableLongFinality is on, in place of MaxReorgDepth. The persisted-snapshot tier serves deep reorgs, so this is much larger than the non-long-finality backstop. Defaults to `90000`. + +- #### `FlatDb.MaxInFlightCompactJob` \{#flatdb-maxinflightcompactjob\} + + + + ``` + --flatdb-maxinflightcompactjob + --FlatDb.MaxInFlightCompactJob + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_MAXINFLIGHTCOMPACTJOB= + ``` + + + ```json + { + "FlatDb": { + "MaxInFlightCompactJob": + } + } + ``` + + + + Max in flight compact job Defaults to `32`. + +- #### `FlatDb.MaxInMemoryBaseSnapshotCount` \{#flatdb-maxinmemorybasesnapshotcount\} + + + + ``` + --flatdb-maxinmemorybasesnapshotcount + --FlatDb.MaxInMemoryBaseSnapshotCount + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_MAXINMEMORYBASESNAPSHOTCOUNT= + ``` + + + ```json + { + "FlatDb": { + "MaxInMemoryBaseSnapshotCount": + } + } + ``` + + + + Maximum number of in-memory base snapshots before conversion to the persisted-snapshot tier kicks in. Counted as `SnapshotCount` of the in-memory repository, not a block-distance depth. Sized as a ~128 target plus one CompactSize of headroom, since a bulk (CompactSize-wide) conversion drops the in-memory count by up to CompactSize at a boundary — so the tier still retains ~128 base snapshots after each conversion. Defaults to `160`. + +- #### `FlatDb.MaxReorgDepth` \{#flatdb-maxreorgdepth\} + + + + ``` + --flatdb-maxreorgdepth + --FlatDb.MaxReorgDepth + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_MAXREORGDEPTH= ``` ```json { "FlatDb": { - "EnablePreimageRecording": true|false + "MaxReorgDepth": } } ``` - Enable recording of preimages (address/slot hash to original bytes) Allowed values: `true` `false`. Defaults to `false`. + Max reorg depth — the force-persist backstop used when EnableLongFinality is off: once the in-memory depth exceeds it while finality is stalled, persistence is forced to bound memory. Defaults to `256`. -- #### `FlatDb.Enabled` \{#flatdb-enabled\} +- #### `FlatDb.MinReorgDepth` \{#flatdb-minreorgdepth\} ``` - --flatdb-enabled [true|false] - --FlatDb.Enabled [true|false] + --flatdb-minreorgdepth + --FlatDb.MinReorgDepth ``` ``` - NETHERMIND_FLATDBCONFIG_ENABLED=true|false + NETHERMIND_FLATDBCONFIG_MINREORGDEPTH= ``` ```json { "FlatDb": { - "Enabled": true|false + "MinReorgDepth": } } ``` - Enabled Allowed values: `true` `false`. Defaults to `false`. + Minimum reorg depth Defaults to `128`. -- #### `FlatDb.ImportFromPruningTrieState` \{#flatdb-importfrompruningtriestate\} +- #### `FlatDb.PersistedSnapshotArenaPageCacheBytes` \{#flatdb-persistedsnapshotarenapagecachebytes\} ``` - --flatdb-importfrompruningtriestate [true|false] - --FlatDb.ImportFromPruningTrieState [true|false] + --flatdb-persistedsnapshotarenapagecachebytes + --FlatDb.PersistedSnapshotArenaPageCacheBytes ``` ``` - NETHERMIND_FLATDBCONFIG_IMPORTFROMPRUNINGTRIESTATE=true|false + NETHERMIND_FLATDBCONFIG_PERSISTEDSNAPSHOTARENAPAGECACHEBYTES= ``` ```json { "FlatDb": { - "ImportFromPruningTrieState": true|false + "PersistedSnapshotArenaPageCacheBytes": } } ``` - Import from pruning trie state db Allowed values: `true` `false`. Defaults to `false`. + Page-cache budget (bytes) for the persisted-snapshot arena. Backs the PageResidencyTracker that drives madvise(DONTNEED) eviction on mmap'd arena files. 0 disables the tracker. Defaults to `4294967296`. -- #### `FlatDb.InlineCompaction` \{#flatdb-inlinecompaction\} +- #### `FlatDb.PersistedSnapshotBloomBitsPerKey` \{#flatdb-persistedsnapshotbloombitsperkey\} ``` - --flatdb-inlinecompaction [true|false] - --FlatDb.InlineCompaction [true|false] + --flatdb-persistedsnapshotbloombitsperkey + --FlatDb.PersistedSnapshotBloomBitsPerKey ``` ``` - NETHERMIND_FLATDBCONFIG_INLINECOMPACTION=true|false + NETHERMIND_FLATDBCONFIG_PERSISTEDSNAPSHOTBLOOMBITSPERKEY= ``` ```json { "FlatDb": { - "InlineCompaction": true|false + "PersistedSnapshotBloomBitsPerKey": } } ``` - Inline compaction Allowed values: `true` `false`. Defaults to `false`. + Bits per key for the per-snapshot in-memory bloom filter. One unified filter covers address/slot/self-destruct keys plus state-trie and storage-trie node paths. Higher = lower false-positive rate but more RAM. 0 disables the filter (lookups behave as full sweeps). Defaults to `14.0`. -- #### `FlatDb.Layout` \{#flatdb-layout\} +- #### `FlatDb.PersistedSnapshotDedicatedArenaThresholdBytes` \{#flatdb-persistedsnapshotdedicatedarenathresholdbytes\} ``` - --flatdb-layout - --FlatDb.Layout + --flatdb-persistedsnapshotdedicatedarenathresholdbytes + --FlatDb.PersistedSnapshotDedicatedArenaThresholdBytes ``` ``` - NETHERMIND_FLATDBCONFIG_LAYOUT= + NETHERMIND_FLATDBCONFIG_PERSISTEDSNAPSHOTDEDICATEDARENATHRESHOLDBYTES= ``` ```json { "FlatDb": { - "Layout": + "PersistedSnapshotDedicatedArenaThresholdBytes": } } ``` - Flat db layout - - Allowed values: - - - `Flat` - - `FlatInTrie` - - `PreimageFlat` + Estimated-size threshold (bytes) at or above which a persisted-snapshot arena write goes to its own dedicated file instead of being packed into a shared arena. Defaults to `1073741824`. - Defaults to `Flat`. - -- #### `FlatDb.MaxInFlightCompactJob` \{#flatdb-maxinflightcompactjob\} +- #### `FlatDb.PersistedSnapshotMaxCompactSize` \{#flatdb-persistedsnapshotmaxcompactsize\} ``` - --flatdb-maxinflightcompactjob - --FlatDb.MaxInFlightCompactJob + --flatdb-persistedsnapshotmaxcompactsize + --FlatDb.PersistedSnapshotMaxCompactSize ``` ``` - NETHERMIND_FLATDBCONFIG_MAXINFLIGHTCOMPACTJOB= + NETHERMIND_FLATDBCONFIG_PERSISTEDSNAPSHOTMAXCOMPACTSIZE= ``` ```json { "FlatDb": { - "MaxInFlightCompactJob": + "PersistedSnapshotMaxCompactSize": } } ``` - Max in flight compact job Defaults to `32`. + Max persisted snapshot compaction size (hierarchical compaction ceiling for persisted layer), in blocks Defaults to `1048576`. -- #### `FlatDb.MaxReorgDepth` \{#flatdb-maxreorgdepth\} +- #### `FlatDb.PersistedSnapshotPunchHoleOnReclaim` \{#flatdb-persistedsnapshotpunchholeonreclaim\} ``` - --flatdb-maxreorgdepth - --FlatDb.MaxReorgDepth + --flatdb-persistedsnapshotpunchholeonreclaim [true|false] + --FlatDb.PersistedSnapshotPunchHoleOnReclaim [true|false] ``` ``` - NETHERMIND_FLATDBCONFIG_MAXREORGDEPTH= + NETHERMIND_FLATDBCONFIG_PERSISTEDSNAPSHOTPUNCHHOLEONRECLAIM=true|false ``` ```json { "FlatDb": { - "MaxReorgDepth": + "PersistedSnapshotPunchHoleOnReclaim": true|false } } ``` - Max reorg depth Defaults to `256`. + When reclaiming dead persisted-snapshot arena ranges — metadata reservation cleanup and blob-file frontier reset — call fallocate(FALLOC_FL_PUNCH_HOLE) to free the underlying disk blocks. Linux-only; automatically and permanently disabled per arena pool if the filesystem reports the operation unsupported. Set false to skip hole-punching entirely (the page-cache posix_fadvise still runs). Allowed values: `true` `false`. Defaults to `true`. -- #### `FlatDb.MinReorgDepth` \{#flatdb-minreorgdepth\} +- #### `FlatDb.PersistenceWriteBufferFloor` \{#flatdb-persistencewritebufferfloor\} ``` - --flatdb-minreorgdepth - --FlatDb.MinReorgDepth + --flatdb-persistencewritebufferfloor + --FlatDb.PersistenceWriteBufferFloor ``` ``` - NETHERMIND_FLATDBCONFIG_MINREORGDEPTH= + NETHERMIND_FLATDBCONFIG_PERSISTENCEWRITEBUFFERFLOOR= ``` ```json { "FlatDb": { - "MinReorgDepth": + "PersistenceWriteBufferFloor": } } ``` - Minimum reorg depth Defaults to `128`. + Lower bound, in bytes, for the RocksDB write buffer (memtable) size of the flat-state columns. The per-batch adjuster never shrinks a column's memtable below this value. Raising it lets frequent small persistence batches (small CompactSize) coalesce and deduplicate in the memtable instead of churning L0, decoupling write amplification from CompactSize. Defaults to `16777216`. - #### `FlatDb.RegenerateCompactionOffset` \{#flatdb-regeneratecompactionoffset\} @@ -1889,7 +2373,34 @@ The configuration options are case-sensitive and can be defined only once unless - Trie warmer worker count (-1 for processor count - 1, 0 to disable) Defaults to `-1`. + Trie warmer worker count (-1 for 3/4 of processor count, 0 to disable) Defaults to `-1`. + +- #### `FlatDb.ValidatePersistedSnapshot` \{#flatdb-validatepersistedsnapshot\} + + + + ``` + --flatdb-validatepersistedsnapshot [true|false] + --FlatDb.ValidatePersistedSnapshot [true|false] + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_VALIDATEPERSISTEDSNAPSHOT=true|false + ``` + + + ```json + { + "FlatDb": { + "ValidatePersistedSnapshot": true|false + } + } + ``` + + + + Validate persisted snapshots against in-memory snapshots after conversion (debug/diagnostic only) Allowed values: `true` `false`. Defaults to `false`. - #### `FlatDb.VerifyWithTrie` \{#flatdb-verifywithtrie\} @@ -1918,6 +2429,32 @@ The configuration options are case-sensitive and can be defined only once unless Verify with trie Allowed values: `true` `false`. Defaults to `false`. +- #### `FlatDb.WarmReadConcurrency` \{#flatdb-warmreadconcurrency\} + + + + ``` + --flatdb-warmreadconcurrency + --FlatDb.WarmReadConcurrency + ``` + + + ``` + NETHERMIND_FLATDBCONFIG_WARMREADCONCURRENCY= + ``` + + + ```json + { + "FlatDb": { + "WarmReadConcurrency": + } + } + ``` + + + + Persistent dedicated reader threads used to resolve hinted BAL read sets into the pre-block cache. -1 for 4x logical processor count capped at 64. Values below 1 are clamped to 1. Use --Blocks.ParallelExecutionBatchRead=false to disable BAL warming entirely. Defaults to `-1`. ### HealthChecks @@ -2349,7 +2886,6 @@ The configuration options are case-sensitive and can be defined only once unless The web hook URL. Defaults to `null`. - ### History - #### `History.Pruning` \{#history-pruning\} @@ -2380,10 +2916,9 @@ The configuration options are case-sensitive and can be defined only once unless Pruning mode. Allowed values: - - - `Disabled`: No history pruning. - - `Rolling`: Prune outside of rolling window. - - `UseAncientBarriers`: Prune up to ancient barriers. + - `Disabled`: No history pruning. + - `Rolling`: Prune outside of rolling window. + - `UseAncientBarriers`: Prune up to ancient barriers. Defaults to `Disabled`. @@ -2466,8 +3001,7 @@ The configuration options are case-sensitive and can be defined only once unless - The number of epochs to retain historical blocks and receipts when using 'Rolling' pruning mode. For mainnet this must be at least 82125. Defaults to `82125`. - + The number of epochs to retain historical blocks and receipts when using 'Rolling' pruning mode. Must be at least the chain's minHistoryRetentionEpochs chainspec parameter. Defaults to `82125`. ### Hive @@ -2606,7 +3140,6 @@ The configuration options are case-sensitive and can be defined only once unless The path to the keystore directory. Defaults to `/keys`. - ### Init - #### `Init.AutoDump` \{#init-autodump\} @@ -2637,15 +3170,14 @@ The configuration options are case-sensitive and can be defined only once unless Auto-dump on bad blocks for diagnostics. Allowed values: - - - `None`: None. - - `Receipts`: Dumps block receipts traces. - - `Parity`: Dumps Parity-like traces. - - `Geth`: Dumps Geth-like traces. - - `Rlp`: Dumps RLP data to a `.rlp` file with the block hash in the file name. - - `RlpLog`: Dumps RLP data to the log output. - - `Default`: Combines the `Receipts` `Rlp` options. - - `All`: Combines the `Geth` `Parity` `Receipts` `Rlp` options. + - `None`: None. + - `Receipts`: Dumps block receipts traces. + - `Parity`: Dumps Parity-like traces. + - `Geth`: Dumps Geth-like traces. + - `Rlp`: Dumps RLP data to a `.rlp` file with the block hash in the file name. + - `RlpLog`: Dumps RLP data to the log output. + - `Default`: Combines the `Receipts` `Rlp` options. + - `All`: Combines the `Geth` `Parity` `Receipts` `Rlp` options. Defaults to `Default`. @@ -2758,14 +3290,13 @@ The configuration options are case-sensitive and can be defined only once unless The diagnostic mode. Allowed values: - - - `None`: None. - - `MemDb`: Uses an in-memory DB. - - `RpcDb`: Uses a remote DB. - - `ReadOnlyDb`: Uses a read-only DB. - - `VerifyRewards`: Scans rewards for blocks and genesis. - - `VerifySupply`: Scans and sums supply on all accounts. - - `VerifyTrie`: Verifies if full state trie is stored. + - `None`: None. + - `MemDb`: Uses an in-memory DB. + - `RpcDb`: Uses a remote DB. + - `ReadOnlyDb`: Uses a read-only DB. + - `VerifyRewards`: Scans rewards for blocks and genesis. + - `VerifySupply`: Scans and sums supply on all accounts. + - `VerifyTrie`: Verifies if full state trie is stored. Defaults to `None`. @@ -3174,7 +3705,6 @@ The configuration options are case-sensitive and can be defined only once unless Whether to enable WebSocket service for the default JSON-RPC port on startup. Allowed values: `true` `false`. Defaults to `true`. - ### JsonRpc - #### `JsonRpc.AdditionalRpcUrls` \{#jsonrpc-additionalrpcurls\} @@ -3943,7 +4473,7 @@ The configuration options are case-sensitive and can be defined only once unless The max number of concurrent in-flight requests on the shared (sharable) singleton handler. Caps heavy methods promoted to sharable — `eth_call`, `eth_estimateGas`, `eth_createAccessList` — preventing unbounded concurrency from exhausting memory. - Light sharable methods (e.g. `eth_blockNumber`, `eth_getBalance`) complete in <1 ms and + Light sharable methods (e.g. `eth_blockNumber`, `eth_getBalance`) complete in \<1 ms and effectively never approach this limit. `0` to lift the limit. Defaults to `10000`. - #### `JsonRpc.MaxLoggedRequestParametersCharacters` \{#jsonrpc-maxloggedrequestparameterscharacters\} @@ -4306,11 +4836,10 @@ The configuration options are case-sensitive and can be defined only once unless The diagnostic recording mode. Allowed values: - - - `None`: None. - - `Request`: Records requests. - - `Response`: Records responses. - - `All`: Records both requests and responses. + - `None`: None. + - `Request`: Records requests. + - `Response`: Records responses. + - `All`: Records both requests and responses. Defaults to `None`. @@ -4503,7 +5032,6 @@ The configuration options are case-sensitive and can be defined only once unless Concurrency level of websocket connection. Defaults to `1`. - ### KeyStore - #### `KeyStore.BlockAuthorAccount` \{#keystore-blockauthoraccount\} @@ -5019,7 +5547,6 @@ The configuration options are case-sensitive and can be defined only once unless An array of accounts to unlock on startup using passwords either in `PasswordFiles` and `Passwords`. Defaults to `[]`. - ### LogIndex - #### `LogIndex.Enabled` \{#logindex-enabled\} @@ -5076,7 +5603,6 @@ The configuration options are case-sensitive and can be defined only once unless Log index is reset on startup if enabled. Allowed values: `true` `false`. Defaults to `false`. - ### Merge - #### `Merge.BuilderRelayUrl` \{#merge-builderrelayurl\} @@ -5169,10 +5695,9 @@ The configuration options are case-sensitive and can be defined only once unless The memory compaction mode. When set to `Full`, compacts the large object heap (LOH) if `SweepMemory` is set to `Gen2`. Allowed values: - - - `No`: Disables memory compaction. - - `Yes`: Enables memory compaction. - - `Full`: Enables memory compaction with the large object heap (LOH) if `SweepMemory` is set to `Gen2`. + - `No`: Disables memory compaction. + - `Yes`: Enables memory compaction. + - `Full`: Enables memory compaction with the large object heap (LOH) if `SweepMemory` is set to `Gen2`. Defaults to `Yes`. @@ -5285,11 +5810,10 @@ The configuration options are case-sensitive and can be defined only once unless The garbage collection (GC) mode between Engine API calls. Allowed values: - - - `NoGC`: Disables garbage collection. - - `Gen0`: Enables garbage collection of generation 0. - - `Gen1`: Enables garbage collection of generation 1. - - `Gen2`: Enables garbage collection of generation 2. + - `NoGC`: Disables garbage collection. + - `Gen0`: Enables garbage collection of generation 0. + - `Gen1`: Enables garbage collection of generation 1. + - `Gen2`: Enables garbage collection of generation 2. Defaults to `Gen1`. @@ -5374,7 +5898,6 @@ The configuration options are case-sensitive and can be defined only once unless The terminal total difficulty (TTD) used for the transition. Defaults to `null`. - ### Metrics - #### `Metrics.CountersEnabled` \{#metrics-countersenabled\} @@ -5699,7 +6222,34 @@ The configuration options are case-sensitive and can be defined only once unless - Pause db metric collection during block processing to prevent overhead. Allowed values: `true` `false`. Defaults to `true`. + Defer db metric collection while blocks are being processed to prevent overhead. A deferred update still runs once the data is older than 10 times DbMetricIntervalSeconds. Set EnableDbSizeMetrics to false to disable collection entirely. Allowed values: `true` `false`. Defaults to `true`. + +- #### `Metrics.PushGatewayPassword` \{#metrics-pushgatewaypassword\} + + + + ``` + --metrics-pushgatewaypassword + --Metrics.PushGatewayPassword + ``` + + + ``` + NETHERMIND_METRICSCONFIG_PUSHGATEWAYPASSWORD= + ``` + + + ```json + { + "Metrics": { + "PushGatewayPassword": + } + } + ``` + + + + The Pushgateway basic authentication password. Both the username and password must be set to enable authentication. - #### `Metrics.PushGatewayUrl` \{#metrics-pushgatewayurl\} @@ -5728,6 +6278,32 @@ The configuration options are case-sensitive and can be defined only once unless The Prometheus Pushgateway instance URL. +- #### `Metrics.PushGatewayUsername` \{#metrics-pushgatewayusername\} + + + + ``` + --metrics-pushgatewayusername + --Metrics.PushGatewayUsername + ``` + + + ``` + NETHERMIND_METRICSCONFIG_PUSHGATEWAYUSERNAME= + ``` + + + ```json + { + "Metrics": { + "PushGatewayUsername": + } + } + ``` + + + + The Pushgateway basic authentication username. Both the username and password must be set to enable authentication. ### Mining @@ -5785,7 +6361,6 @@ The configuration options are case-sensitive and can be defined only once unless The URL of an external signer like [Clef](https://github.com/ethereum/go-ethereum/blob/master/cmd/clef/tutorial.md). Defaults to `null`. - ### Network - #### `Network.Bootnodes` \{#network-bootnodes\} @@ -5950,6 +6525,60 @@ The configuration options are case-sensitive and can be defined only once unless The external IP. Use only when the external IP cannot be resolved automatically. Defaults to `null`. +- #### `Network.ExternalIpV4` \{#network-externalipv4\} + + + + ``` + --network-externalipv4 + --Network.ExternalIpV4 + ``` + + + ``` + NETHERMIND_NETWORKCONFIG_EXTERNALIPV4= + ``` + + + ```json + { + "Network": { + "ExternalIpV4": + } + } + ``` + + + + The external IPv4 address to advertise. Use with `ExternalIpV6` when the node should advertise both IPv4 and IPv6 addresses. Defaults to `null`. + +- #### `Network.ExternalIpV6` \{#network-externalipv6\} + + + + ``` + --network-externalipv6 + --Network.ExternalIpV6 + ``` + + + ``` + NETHERMIND_NETWORKCONFIG_EXTERNALIPV6= + ``` + + + ```json + { + "Network": { + "ExternalIpV6": + } + } + ``` + + + + The external IPv6 address to advertise. Use with `ExternalIpV4` when the node should advertise both IPv4 and IPv6 addresses. Defaults to `null`. + - #### `Network.FilterDiscoveryNodesByRecentIp` \{#network-filterdiscoverynodesbyrecentip\} @@ -6272,7 +6901,7 @@ The configuration options are case-sensitive and can be defined only once unless - A template string for the public client id provided to external clients. Allowed placeholders: `{name}` `{version}` `{os}` `{runtime}`. Defaults to `{name}/{version}/{os}/{runtime}`. + A template string for the public client id provided to external clients. Allowed placeholders: `{name}` `{version}` `{versionPostfix}` `{os}` `{runtime}`. Defaults to `{name}/{version}{versionPostfix}/{os}/{runtime}`. - #### `Network.StaticPeers` \{#network-staticpeers\} @@ -6301,7 +6930,6 @@ The configuration options are case-sensitive and can be defined only once unless A list of peers to keep connection for. Static peers are affected by `MaxActivePeers`. Defaults to `null`. - ### OpcodeTracing - #### `OpcodeTracing.Enabled` \{#opcodetracing-enabled\} @@ -6466,63 +7094,117 @@ The configuration options are case-sensitive and can be defined only once unless Number of recent blocks to trace from chain tip. Alternative to StartBlock/EndBlock. Defaults to `null`. -- #### `OpcodeTracing.StartBlock` \{#opcodetracing-startblock\} +- #### `OpcodeTracing.StartBlock` \{#opcodetracing-startblock\} + + + + ``` + --opcodetracing-startblock + --OpcodeTracing.StartBlock + ``` + + + ``` + NETHERMIND_OPCODETRACINGCONFIG_STARTBLOCK= + ``` + + + ```json + { + "OpcodeTracing": { + "StartBlock": + } + } + ``` + + + + Start block number for tracing (inclusive). Used with EndBlock to define explicit range. Defaults to `null`. + +### Optimism + +- #### `Optimism.SequencerUrl` \{#optimism-sequencerurl\} + + + + ``` + --optimism-sequencerurl + --Optimism.SequencerUrl + ``` + + + ``` + NETHERMIND_OPTIMISMCONFIG_SEQUENCERURL= + ``` + + + ```json + { + "Optimism": { + "SequencerUrl": + } + } + ``` + + + + The Optimism sequencer URL. Defaults to `null`. + +### PortfolioViewer + +- #### `PortfolioViewer.Enabled` \{#portfolioviewer-enabled\} ``` - --opcodetracing-startblock - --OpcodeTracing.StartBlock + --portfolioviewer-enabled [true|false] + --PortfolioViewer.Enabled [true|false] ``` ``` - NETHERMIND_OPCODETRACINGCONFIG_STARTBLOCK= + NETHERMIND_PORTFOLIOVIEWERCONFIG_ENABLED=true|false ``` ```json { - "OpcodeTracing": { - "StartBlock": + "PortfolioViewer": { + "Enabled": true|false } } ``` - Start block number for tracing (inclusive). Used with EndBlock to define explicit range. Defaults to `null`. - - -### Optimism + Whether to serve the portfolio viewer UI (balances + NFTs) at the `/portfolio` path of the JSON-RPC HTTP endpoint. Allowed values: `true` `false`. Defaults to `false`. -- #### `Optimism.SequencerUrl` \{#optimism-sequencerurl\} +- #### `PortfolioViewer.SiblingProbePorts` \{#portfolioviewer-siblingprobeports\} ``` - --optimism-sequencerurl - --Optimism.SequencerUrl + --portfolioviewer-siblingprobeports + --PortfolioViewer.SiblingProbePorts ``` ``` - NETHERMIND_OPTIMISMCONFIG_SEQUENCERURL= + NETHERMIND_PORTFOLIOVIEWERCONFIG_SIBLINGPROBEPORTS= ``` ```json { - "Optimism": { - "SequencerUrl": + "PortfolioViewer": { + "SiblingProbePorts": } } ``` - The Optimism sequencer URL. Defaults to `null`. - + Comma-separated localhost ports probed to discover sibling Nethermind nodes on other chains for the multi-chain portfolio viewer. Defaults to `8545,8546,8547,8548,8549,8550`. ### Pruning @@ -6632,7 +7314,7 @@ The configuration options are case-sensitive and can be defined only once unless - Dirty node shard count Defaults to `8`. + Number of dirty node shards as a base-2 exponent; the shard count is 2^DirtyNodeShardBit. Must be between 1 and 30. Defaults to `8`. - #### `Pruning.FullPruningCompletionBehavior` \{#pruning-fullpruningcompletionbehavior\} @@ -6662,10 +7344,9 @@ The configuration options are case-sensitive and can be defined only once unless The action to take on pruning completion. Allowed values: - - - `None`: No action. - - `ShutdownOnSuccess`: Shuts Nethermind down when pruning succeeds but leaves it running when fails. - - `AlwaysShutdown`: Shuts Nethermind down when pruning completes, regardless of its status. + - `None`: No action. + - `ShutdownOnSuccess`: Shuts Nethermind down when pruning succeeds but leaves it running when fails. + - `AlwaysShutdown`: Shuts Nethermind down when pruning completes, regardless of its status. Defaults to `None`. @@ -6844,10 +7525,9 @@ The configuration options are case-sensitive and can be defined only once unless The full pruning trigger. Allowed values: - - - `Manual`: Does not trigger. Pruning can be triggered manually. - - `StateDbSize`: Triggers when the state DB size is above the specified threshold. - - `VolumeFreeSpace`: Triggers when the free disk space where the state DB is stored is below the specified threshold. + - `Manual`: Does not trigger. Pruning can be triggered manually. + - `StateDbSize`: Triggers when the state DB size is above the specified threshold. + - `VolumeFreeSpace`: Triggers when the free disk space where the state DB is stored is below the specified threshold. Defaults to `Manual`. @@ -6933,11 +7613,10 @@ The configuration options are case-sensitive and can be defined only once unless The pruning mode. Allowed values: - - - `None`: No pruning (archive). - - `Memory`: In-memory pruning. - - `Full`: Full pruning. - - `Hybrid`: Combined in-memory and full pruning. + - `None`: No pruning (archive). + - `Memory`: In-memory pruning. + - `Full`: Full pruning. + - `Hybrid`: Combined in-memory and full pruning. Defaults to `Hybrid`. @@ -7076,7 +7755,6 @@ The configuration options are case-sensitive and can be defined only once unless Enable tracking of past key to reduce database and pruning cache growth Allowed values: `true` `false`. Defaults to `true`. - ### Receipt - #### `Receipt.CompactReceiptStore` \{#receipt-compactreceiptstore\} @@ -7133,6 +7811,89 @@ The configuration options are case-sensitive and can be defined only once unless Whether to compact receipts transaction index database size at the expense of RPC performance. Allowed values: `true` `false`. Defaults to `true`. +- #### `Receipt.DeferredPersistence` \{#receipt-deferredpersistence\} + + + + ``` + --receipt-deferredpersistence [true|false] + --Receipt.DeferredPersistence [true|false] + ``` + + + ``` + NETHERMIND_RECEIPTCONFIG_DEFERREDPERSISTENCE=true|false + ``` + + + ```json + { + "Receipt": { + "DeferredPersistence": true|false + } + } + ``` + + + + Whether receipt, canonical transaction-index, block-body, and block-access-list writes are persisted by a background writer instead of synchronously on the block-processing and engine API paths. Reads are served from an in-memory overlay until flushed, and a state-persistence barrier makes a block's data durable before its state, so an unclean shutdown never leaves persisted state without it. Allowed values: `true` `false`. Defaults to `true`. + +- #### `Receipt.DeriveFromState` \{#receipt-derivefromstate\} + + + + ``` + --receipt-derivefromstate [true|false] + --Receipt.DeriveFromState [true|false] + ``` + + + ``` + NETHERMIND_RECEIPTCONFIG_DERIVEFROMSTATE=true|false + ``` + + + ```json + { + "Receipt": { + "DeriveFromState": true|false + } + } + ``` + + + + Whether receipt bodies are derived from state instead of persisted: their write is skipped, and a query re-executes the block over its parent state, serving the result only when it reproduces the block header's receipts root. Bodies already on disk are still served; pre-Byzantium bodies and the transaction index are always written. A skipped body is retained in memory until history capture durably covers its block, and is persisted if capture permanently stops (see the error log then), so a capture breakdown does not lose receipts. Intended for archive nodes: requires state history for the queried block, and peers are told no receipts are available. A query that misses the cache costs a full block execution, so a public endpoint should be rate limited; concurrency is bounded by JsonRpc.EthModuleConcurrentInstances. Allowed values: `true` `false`. Defaults to `false`. + +- #### `Receipt.MaxBlockDepth` \{#receipt-maxblockdepth\} + + + + ``` + --receipt-maxblockdepth + --Receipt.MaxBlockDepth + ``` + + + ``` + NETHERMIND_RECEIPTCONFIG_MAXBLOCKDEPTH= + ``` + + + ```json + { + "Receipt": { + "MaxBlockDepth": + } + } + ``` + + + + The maximum block range (toBlock - fromBlock + 1) allowed in a single `eth_getLogs` request. + Requests exceeding this range are rejected with an "invalid params" (-32602) error. + Set to 0 to disable the limit. Value is ignored (no limits) if log index is enabled. Defaults to `1000`. + - #### `Receipt.ReceiptsMigration` \{#receipt-receiptsmigration\} @@ -7212,8 +7973,7 @@ The configuration options are case-sensitive and can be defined only once unless - The number of recent blocks to maintain transaction index for. `0` to never remove indices, `-1` to never index. Defaults to `2350000`. - + The number of recent blocks to maintain transaction index for. `0` to never remove indices, `18446744073709551615` to never index. Defaults to `2350000`. ### Seq @@ -7298,7 +8058,6 @@ The configuration options are case-sensitive and can be defined only once unless The Seq instance URL. Defaults to `http://localhost:5341`. - ### Shutter - #### `Shutter.BootnodeP2PAddresses` \{#shutter-bootnodep2paddresses\} @@ -7571,7 +8330,6 @@ The configuration options are case-sensitive and can be defined only once unless The address of the Shutter validator registry contract. Defaults to `null`. - ### Snapshot - #### `Snapshot.Checksum` \{#snapshot-checksum\} @@ -7709,279 +8467,169 @@ The configuration options are case-sensitive and can be defined only once unless The name of the snapshot file. Defaults to `snapshot.zip`. -- #### `Snapshot.StripComponents` \{#snapshot-stripcomponents\} +- #### `Snapshot.Streaming` \{#snapshot-streaming\} ``` - --snapshot-stripcomponents - --Snapshot.StripComponents + --snapshot-streaming [true|false] + --Snapshot.Streaming [true|false] ``` ``` - NETHERMIND_SNAPSHOTCONFIG_STRIPCOMPONENTS= + NETHERMIND_SNAPSHOTCONFIG_STREAMING=true|false ``` ```json { "Snapshot": { - "StripComponents": - } - } - ``` - - - - Number of leading path components to strip when extracting a tar archive (passed as --strip-components to tar). Must be non-negative. Set this to match the depth of the snapshot path embedded in the archive. Defaults to `1`. - - -### StateComposition - -- #### `StateComposition.Enabled` \{#statecomposition-enabled\} - - - - ``` - --statecomposition-enabled [true|false] - --StateComposition.Enabled [true|false] - ``` - - - ``` - NETHERMIND_STATECOMPOSITIONCONFIG_ENABLED=true|false - ``` - - - ```json - { - "StateComposition": { - "Enabled": true|false - } - } - ``` - - - - Enable state composition plugin Allowed values: `true` `false`. Defaults to `false`. - -- #### `StateComposition.ExcludeStorage` \{#statecomposition-excludestorage\} - - - - ``` - --statecomposition-excludestorage [true|false] - --StateComposition.ExcludeStorage [true|false] - ``` - - - ``` - NETHERMIND_STATECOMPOSITIONCONFIG_EXCLUDESTORAGE=true|false - ``` - - - ```json - { - "StateComposition": { - "ExcludeStorage": true|false - } - } - ``` - - - - Skip storage trie traversal during scans Allowed values: `true` `false`. Defaults to `false`. - -- #### `StateComposition.InspectContractTimeoutSeconds` \{#statecomposition-inspectcontracttimeoutseconds\} - - - - ``` - --statecomposition-inspectcontracttimeoutseconds - --StateComposition.InspectContractTimeoutSeconds - ``` - - - ``` - NETHERMIND_STATECOMPOSITIONCONFIG_INSPECTCONTRACTTIMEOUTSECONDS= - ``` - - - ```json - { - "StateComposition": { - "InspectContractTimeoutSeconds": + "Streaming": true|false } } ``` - Timeout in seconds for a single statecomp_inspectContract RPC call. Long storage-trie walks that exceed this deadline are cancelled so the RPC worker is not pinned indefinitely. 0 or negative disables the timeout. Defaults to `30`. + Whether to stream the snapshot directly into the database directory without storing the archive file, reducing peak disk usage to the extracted size. Interrupted connections are resumed automatically within a run, but a node restart discards all progress and starts the download over, since no archive is kept on disk. Supported for tar-based archives only. Allowed values: `true` `false`. Defaults to `false`. -- #### `StateComposition.PersistSnapshots` \{#statecomposition-persistsnapshots\} +- #### `Snapshot.StreamingConnections` \{#snapshot-streamingconnections\} ``` - --statecomposition-persistsnapshots [true|false] - --StateComposition.PersistSnapshots [true|false] + --snapshot-streamingconnections + --Snapshot.StreamingConnections ``` ``` - NETHERMIND_STATECOMPOSITIONCONFIG_PERSISTSNAPSHOTS=true|false + NETHERMIND_SNAPSHOTCONFIG_STREAMINGCONNECTIONS= ``` ```json { - "StateComposition": { - "PersistSnapshots": true|false + "Snapshot": { + "StreamingConnections": } } ``` - Persist incremental stats snapshots to disk for warm restart Allowed values: `true` `false`. Defaults to `true`. + The number of parallel connections the streaming snapshot download uses when the server supports range requests. Peak buffer memory is (connections + 1) x 64 MiB. Allowed range: 1-16. Defaults to `4`. -- #### `StateComposition.ScanMemoryBudgetBytes` \{#statecomposition-scanmemorybudgetbytes\} +- #### `Snapshot.StripComponents` \{#snapshot-stripcomponents\} ``` - --statecomposition-scanmemorybudgetbytes - --StateComposition.ScanMemoryBudgetBytes + --snapshot-stripcomponents + --Snapshot.StripComponents ``` ``` - NETHERMIND_STATECOMPOSITIONCONFIG_SCANMEMORYBUDGETBYTES= + NETHERMIND_SNAPSHOTCONFIG_STRIPCOMPONENTS= ``` ```json { - "StateComposition": { - "ScanMemoryBudgetBytes": + "Snapshot": { + "StripComponents": } } ``` - Memory budget for baseline scan in raw bytes (no suffix parsing). Minimum useful value ~1 MiB (1048576). Default 1 GB. Defaults to `1000000000`. - -- #### `StateComposition.ScanParallelism` \{#statecomposition-scanparallelism\} - - - - ``` - --statecomposition-scanparallelism - --StateComposition.ScanParallelism - ``` - - - ``` - NETHERMIND_STATECOMPOSITIONCONFIG_SCANPARALLELISM= - ``` - - - ```json - { - "StateComposition": { - "ScanParallelism": - } - } - ``` - - + Number of leading path components to strip when extracting a tar archive (passed as --strip-components to tar). Must be non-negative. Set this to match the depth of the snapshot path embedded in the archive. Defaults to `1`. - Max parallel threads for baseline trie scan. Clamped to [1, 16]. Defaults to `ProcessorCount/2`. +### StateDiffsWriter -- #### `StateComposition.ScanQueueTimeoutSeconds` \{#statecomposition-scanqueuetimeoutseconds\} +- #### `StateDiffsWriter.Enabled` \{#statediffswriter-enabled\} ``` - --statecomposition-scanqueuetimeoutseconds - --StateComposition.ScanQueueTimeoutSeconds + --statediffswriter-enabled [true|false] + --StateDiffsWriter.Enabled [true|false] ``` ``` - NETHERMIND_STATECOMPOSITIONCONFIG_SCANQUEUETIMEOUTSECONDS= + NETHERMIND_STATEDIFFSWRITERCONFIG_ENABLED=true|false ``` ```json { - "StateComposition": { - "ScanQueueTimeoutSeconds": + "StateDiffsWriter": { + "Enabled": true|false } } ``` - Timeout in seconds to wait for a queued scan to acquire the lock. 0 or negative means fail-fast (no wait). Defaults to `5`. + Enable the per-block state-diff writer. Allowed values: `true` `false`. Defaults to `false`. -- #### `StateComposition.TopNContracts` \{#statecomposition-topncontracts\} +- #### `StateDiffsWriter.KeepLastNBlocks` \{#statediffswriter-keeplastnblocks\} ``` - --statecomposition-topncontracts - --StateComposition.TopNContracts + --statediffswriter-keeplastnblocks + --StateDiffsWriter.KeepLastNBlocks ``` ``` - NETHERMIND_STATECOMPOSITIONCONFIG_TOPNCONTRACTS= + NETHERMIND_STATEDIFFSWRITERCONFIG_KEEPLASTNBLOCKS= ``` ```json { - "StateComposition": { - "TopNContracts": + "StateDiffsWriter": { + "KeepLastNBlocks": } } ``` - Number of top contracts to track per ranking category. Clamped to [1, 10000]. Defaults to `20`. + Number of most-recent blocks to retain in the BlockDiffs column family. Older entries are pruned by the background pruner. A consumer's catch-up should never need a window larger than this; lower for tighter disk budgets, raise if catch-up windows can exceed the default. Must be >= 0 (0 keeps nothing); a negative value disables pruning entirely. Defaults to `1000000`. -- #### `StateComposition.TrackDepthIncrementally` \{#statecomposition-trackdepthincrementally\} +- #### `StateDiffsWriter.PruneIntervalSeconds` \{#statediffswriter-pruneintervalseconds\} ``` - --statecomposition-trackdepthincrementally [true|false] - --StateComposition.TrackDepthIncrementally [true|false] + --statediffswriter-pruneintervalseconds + --StateDiffsWriter.PruneIntervalSeconds ``` ``` - NETHERMIND_STATECOMPOSITIONCONFIG_TRACKDEPTHINCREMENTALLY=true|false + NETHERMIND_STATEDIFFSWRITERCONFIG_PRUNEINTERVALSECONDS= ``` ```json { - "StateComposition": { - "TrackDepthIncrementally": true|false + "StateDiffsWriter": { + "PruneIntervalSeconds": } } ``` - Track per-depth trie distribution incrementally on every new head block Allowed values: `true` `false`. Defaults to `true`. - + Interval in seconds between background pruner sweeps. The pruner removes BlockDiffs rows whose block number is older than (currentHead - KeepLastNBlocks). 0 or negative disables pruning. Defaults to `600`. ### Surge @@ -8444,7 +9092,6 @@ The configuration options are case-sensitive and can be defined only once unless Enable TDX attestation support. Allowed values: `true` `false`. Defaults to `false`. - ### SurgeTdx - #### `SurgeTdx.ConfigPath` \{#surgetdx-configpath\} @@ -8501,7 +9148,6 @@ The configuration options are case-sensitive and can be defined only once unless Path to the tdxs Unix socket. Defaults to `/var/tdxs.sock`. - ### Sync - #### `Sync.AncientBlockAccessListsBarrier` \{#sync-ancientblockaccesslistsbarrier\} @@ -8815,7 +9461,61 @@ The configuration options are case-sensitive and can be defined only once unless - Whether to enable receipts validation that checks for receipts that might be missing because of a bug. If needed, receipts are downloaded from the network. If `true`, the pivot number must be same one used originally as it's used as a cut-off point. Allowed values: `true` `false`. Defaults to `false`. + Whether to enable receipts validation that checks for receipts that might be missing because of a bug. If needed, receipts are downloaded from the network. The range to verify is `FixReceiptsStartingBlock`..`FixReceiptsLastBlock`. Allowed values: `true` `false`. Defaults to `false`. + +- #### `Sync.FixReceiptsLastBlock` \{#sync-fixreceiptslastblock\} + + + + ``` + --sync-fixreceiptslastblock + --Sync.FixReceiptsLastBlock + ``` + + + ``` + NETHERMIND_SYNCCONFIG_FIXRECEIPTSLASTBLOCK= + ``` + + + ```json + { + "Sync": { + "FixReceiptsLastBlock": + } + } + ``` + + + + The last block (inclusive) to verify/fix receipts for. When not set, defaults to the chain head minus 2, to which it's always clamped. Defaults to `null`. + +- #### `Sync.FixReceiptsStartingBlock` \{#sync-fixreceiptsstartingblock\} + + + + ``` + --sync-fixreceiptsstartingblock + --Sync.FixReceiptsStartingBlock + ``` + + + ``` + NETHERMIND_SYNCCONFIG_FIXRECEIPTSSTARTINGBLOCK= + ``` + + + ```json + { + "Sync": { + "FixReceiptsStartingBlock": + } + } + ``` + + + + The first block (inclusive) to verify/fix receipts for. When not set, defaults to the ancient receipts barrier, which depends on the pivot number; in that case the pivot number must be the same one used originally as it's the cut-off point. Defaults to `null`. - #### `Sync.FixTotalDifficulty` \{#sync-fixtotaldifficulty\} @@ -9223,7 +9923,6 @@ The configuration options are case-sensitive and can be defined only once unless Whether to make smaller requests, in Fast Blocks mode, to avoid Geth from disconnecting. On the Geth-heavy networks (e.g., Mainnet), it's a desired behavior while on Nethermind- or OpenEthereum-heavy networks (Aura), it slows down the sync by a factor of ~4. Allowed values: `true` `false`. Defaults to `true`. - ### TraceStore - #### `TraceStore.BlocksToKeep` \{#tracestore-blockstokeep\} @@ -9335,17 +10034,15 @@ The configuration options are case-sensitive and can be defined only once unless The type of traces to store. Allowed values: - - - `None`: None. - - `VmTrace`: Provides a full trace of the EVM state throughout the execution of transactions at each op-code, including subcalls. - - `StateDiff`: Provides Ethereum state difference detailing all altered portions of the state made due to the execution of transactions. - - `Trace`: Provides transaction trace, including subcalls. - - `Rewards`: Includes block rewards in the trace when tracing full blocks. - - `All`: Combines the `Rewards` `StateDiff` `Trace` `VmTrace` options. + - `None`: None. + - `VmTrace`: Provides a full trace of the EVM state throughout the execution of transactions at each op-code, including subcalls. + - `StateDiff`: Provides Ethereum state difference detailing all altered portions of the state made due to the execution of transactions. + - `Trace`: Provides transaction trace, including subcalls. + - `Rewards`: Includes block rewards in the trace when tracing full blocks. + - `All`: Combines the `Rewards` `StateDiff` `Trace` `VmTrace` options. Defaults to `Trace, Rewards`. - ### TxPool - #### `TxPool.AcceptTxWhenNotSynced` \{#txpool-accepttxwhennotsynced\} @@ -9430,11 +10127,10 @@ The configuration options are case-sensitive and can be defined only once unless The blobs support mode. Allowed values: - - - `Disabled`: Disables support for blob transactions. - - `InMemory`: Stores the blob transactions in memory only. - - `Storage`: Stores the blob transactions in the permanent storage. - - `StorageWithReorgs`: Stores the blob transactions in the permanent storage with support for restoring reorganized transactions to the blob pool. + - `Disabled`: Disables support for blob transactions. + - `InMemory`: Stores the blob transactions in memory only. + - `Storage`: Stores the blob transactions in the permanent storage. + - `StorageWithReorgs`: Stores the blob transactions in the permanent storage with support for restoring reorganized transactions to the blob pool. Defaults to `StorageWithReorgs`. @@ -9843,6 +10539,32 @@ The configuration options are case-sensitive and can be defined only once unless The max number of transactions held in the mempool (the more transactions in the mempool, the more memory used). Defaults to `2048`. +- #### `TxPool.SparseBlobProviderProbabilityPercent` \{#txpool-sparseblobproviderprobabilitypercent\} + + + + ``` + --txpool-sparseblobproviderprobabilitypercent + --TxPool.SparseBlobProviderProbabilityPercent + ``` + + + ``` + NETHERMIND_TXPOOLCONFIG_SPARSEBLOBPROVIDERPROBABILITYPERCENT= + ``` + + + ```json + { + "TxPool": { + "SparseBlobProviderProbabilityPercent": + } + } + ``` + + + + The EIP-8070 full-provider selection probability for normal sparse blob-pool nodes, in percent. Values are clamped to the protocol-compliant range `15..100`. Nodes with at least 64 custody columns act as supernodes and request every announced cell. Defaults to `15`. ### Wallet @@ -9873,7 +10595,6 @@ The configuration options are case-sensitive and can be defined only once unless The number of autogenerated developer accounts to work with. Developer accounts have private keys from `00...01` to `00...n`. Defaults to `10`. - ## Environment variables diff --git a/docs/interacting/json-rpc-ns/admin.md b/docs/interacting/json-rpc-ns/admin.md index 5ae1e3c4a7..ca2b12acde 100644 --- a/docs/interacting/json-rpc-ns/admin.md +++ b/docs/interacting/json-rpc-ns/admin.md @@ -134,9 +134,9 @@ The data directory path as a string. -### admin_exportHistory +### admin_exportEraHistory -Exports a range of historic block in era1 format. +Exports a range of historic blocks in erae format. @@ -148,6 +148,51 @@ Exports a range of historic block in era1 format. 3. `to`: _string_ (hex integer) + + + +```bash +curl localhost:8545 \ + -X POST \ + -H "Content-Type: application/json" \ + --data '{ + "jsonrpc": "2.0", + "id": 0, + "method": "admin_exportEraHistory", + "params": [destinationPath, from, to] + }' +``` + + + + +```json +{ + "jsonrpc": "2.0", + "id": 0, + "result": result +} +``` + +`result`: _string_ + + + + +### admin_exportHistory + +Exports a range of historic block in era1 format. + + + + +1. `destinationPath`: _string_ + +2. `from`: _integer_ + +3. `to`: _integer_ + + @@ -179,9 +224,9 @@ curl localhost:8545 \ -### admin_importHistory +### admin_importEraHistory -Import a range of historic block from era1 directory. +Imports a range of historic blocks from an erae directory. @@ -195,6 +240,53 @@ Import a range of historic block from era1 directory. 4. `accumulatorFile`: _string_ + + + +```bash +curl localhost:8545 \ + -X POST \ + -H "Content-Type: application/json" \ + --data '{ + "jsonrpc": "2.0", + "id": 0, + "method": "admin_importEraHistory", + "params": [sourcePath, from, to, accumulatorFile] + }' +``` + + + + +```json +{ + "jsonrpc": "2.0", + "id": 0, + "result": result +} +``` + +`result`: _string_ + + + + +### admin_importHistory + +Import a range of historic block from era1 directory. + + + + +1. `sourcePath`: _string_ + +2. `from`: _integer_ + +3. `to`: _integer_ + +4. `accumulatorFile`: _string_ + + @@ -226,6 +318,43 @@ curl localhost:8545 \ +### admin_isBlockProcessingPaused + +Returns whether local block processing is currently paused. + + + + +```bash +curl localhost:8545 \ + -X POST \ + -H "Content-Type: application/json" \ + --data '{ + "jsonrpc": "2.0", + "id": 0, + "method": "admin_isBlockProcessingPaused", + "params": [] + }' +``` + + + + +`true` if block processing is paused, `false` if running. + +```json +{ + "jsonrpc": "2.0", + "id": 0, + "result": result +} +``` + +`result`: _boolean_ + + + + ### admin_isStateRootAvailable True if state root for the block is available @@ -301,13 +430,14 @@ Information about this node `result`: _object_ - `enode`: _string_ + - `enr`: _string_ - `id`: _string_ - `ip`: _string_ - `listenAddress`: _string_ - `name`: _string_ - `ports`: _object_ - - `discovery`: _string_ (hex integer) - - `listener`: _string_ (hex integer) + - `discovery`: _integer_ + - `listener`: _integer_ - `protocols`: map of _object_ - `chainId`: _string_ (hex integer) - `config`: _object_ @@ -352,10 +482,12 @@ Information about this node - `eip2537Transition`: _string_ (hex integer) - `eip2537TransitionTimestamp`: _string_ (hex integer) - `eip2565Transition`: _string_ (hex integer) + - `eip2780TransitionTimestamp`: _string_ (hex integer) - `eip2929Transition`: _string_ (hex integer) - `eip2930Transition`: _string_ (hex integer) - `eip2935ContractAddress`: _string_ (address) - `eip2935RingBufferSize`: _string_ (hex integer) + - `eip2935Transition`: _string_ (hex integer) - `eip2935TransitionTimestamp`: _string_ (hex integer) - `eip3198Transition`: _string_ (hex integer) - `eip3529Transition`: _string_ (hex integer) @@ -386,17 +518,20 @@ Information about this node - `eip7251ContractAddress`: _string_ (address) - `eip7251TransitionTimestamp`: _string_ (hex integer) - `eip7594TransitionTimestamp`: _string_ (hex integer) + - `eip7623Transition`: _string_ (hex integer) - `eip7623TransitionTimestamp`: _string_ (hex integer) + - `eip7702Transition`: _string_ (hex integer) - `eip7702TransitionTimestamp`: _string_ (hex integer) - `eip7708TransitionTimestamp`: _string_ (hex integer) - `eip7778TransitionTimestamp`: _string_ (hex integer) + - `eip7805TransitionTimestamp`: _string_ (hex integer) - `eip7823TransitionTimestamp`: _string_ (hex integer) - `eip7825TransitionTimestamp`: _string_ (hex integer) - `eip7843TransitionTimestamp`: _string_ (hex integer) - `eip7883TransitionTimestamp`: _string_ (hex integer) - `eip7918TransitionTimestamp`: _string_ (hex integer) - `eip7928TransitionTimestamp`: _string_ (hex integer) - - `eip7934MaxRlpBlockSize`: _string_ (hex integer) + - `eip7934MaxRlpBlockSize`: _integer_ - `eip7934TransitionTimestamp`: _string_ (hex integer) - `eip7939TransitionTimestamp`: _string_ (hex integer) - `eip7951TransitionTimestamp`: _string_ (hex integer) @@ -406,6 +541,9 @@ Information about this node - `eip7Transition`: _string_ (hex integer) - `eip8024TransitionTimestamp`: _string_ (hex integer) - `eip8037TransitionTimestamp`: _string_ (hex integer) + - `eip8038TransitionTimestamp`: _string_ (hex integer) + - `eip8246TransitionTimestamp`: _string_ (hex integer) + - `eip8282TransitionTimestamp`: _string_ (hex integer) - `feeCollector`: _string_ (address) - `forkBlock`: _string_ (hex integer) - `forkCanonHash`: _string_ (hash) @@ -434,9 +572,46 @@ Information about this node +### admin_pauseBlockProcessing + +Pauses local block processing. Blocks received from the network or consensus client are still queued but not processed; call `admin_resumeBlockProcessing` to process the accumulated backlog. Use `admin_isBlockProcessingPaused` to query the state. Intended for testing and diagnostics. + + + + +```bash +curl localhost:8545 \ + -X POST \ + -H "Content-Type: application/json" \ + --data '{ + "jsonrpc": "2.0", + "id": 0, + "method": "admin_pauseBlockProcessing", + "params": [] + }' +``` + + + + +`true` if block processing is paused after the call (the request succeeded); `false` if it did not take effect. + +```json +{ + "jsonrpc": "2.0", + "id": 0, + "result": result +} +``` + +`result`: _boolean_ + + + + ### admin_peers -Displays a list of connected peers including information about them (`clientId`, `host`, `port`, `address`, `isBootnode`, `isStatic`, `enode`). +Displays a list of connected peers including information about them. @@ -473,57 +648,17 @@ List of connected peers including information ``` `result`: array of _object_ - - `caps`: array of _object_ - - `protocolCode`: _string_ - - `version`: _string_ (hex integer) + - `caps`: array of _string_ (protocol/version) - `clientType`: _integer_ - `enode`: _string_ - `enr`: _string_ - `ethDetails`: _string_ - - `id`: _object_ - - `address`: _string_ (address) - - `bytes`: _string_ (hex data) - - `hash`: _string_ (hash) - - `prefixedBytes`: _string_ (hex data) - - `lastSignal`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `date`: _object_ - - - `day`: _string_ (hex integer) - - `dayOfWeek`: _integer_ - - `dayOfYear`: _string_ (hex integer) - - `hour`: _string_ (hex integer) - - `kind`: _integer_ - - `microsecond`: _string_ (hex integer) - - `millisecond`: _string_ (hex integer) - - `minute`: _string_ (hex integer) - - `month`: _string_ (hex integer) - - `nanosecond`: _string_ (hex integer) - - `second`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `timeOfDay`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ - - `year`: _string_ (hex integer) + - `id`: _string_ (node id, no "0x" prefix) + - `lastSignal`: _string_ (date-time) - `name`: _string_ - `network`: _object_ - `inbound`: _boolean_ - `localAddress`: _string_ - - `localHost`: _string_ - `remoteAddress`: _string_ - `static`: _boolean_ - `trusted`: _boolean_ @@ -562,7 +697,7 @@ curl localhost:8545 \ } ``` -`result`: _integer_ +`result`: _string_ @@ -657,6 +792,43 @@ curl localhost:8545 \ +### admin_resumeBlockProcessing + +Resumes local block processing previously paused via `admin_pauseBlockProcessing`, processing any blocks accumulated in the queue. Intended for testing and diagnostics. + + + + +```bash +curl localhost:8545 \ + -X POST \ + -H "Content-Type: application/json" \ + --data '{ + "jsonrpc": "2.0", + "id": 0, + "method": "admin_resumeBlockProcessing", + "params": [] + }' +``` + + + + +`true` when the resume request was accepted. + +```json +{ + "jsonrpc": "2.0", + "id": 0, + "result": result +} +``` + +`result`: _boolean_ + + + + ### admin_subscribe Subscribes to a particular event over WebSocket. For every event that matches the subscription, a notification with event details and subscription id is sent to a client. @@ -702,7 +874,7 @@ curl localhost:8545 \ ### admin_unsubscribe -Unsubscribes from a subscription. +Unsubscribes from a subscription. Returns true on success; if the subscription does not exist, a 'subscription not found' error is returned. diff --git a/docs/interacting/json-rpc-ns/clique.md b/docs/interacting/json-rpc-ns/clique.md index 757d97e2ea..9aac35bfd0 100644 --- a/docs/interacting/json-rpc-ns/clique.md +++ b/docs/interacting/json-rpc-ns/clique.md @@ -325,7 +325,7 @@ curl localhost:8545 \ - `signers`: map of _string_ (hex integer) - `tally`: map of _object_ - `authorize`: _boolean_ - - `votes`: _string_ (hex integer) + - `votes`: _integer_ - `votes`: array of _object_ - `address`: _string_ (address) - `authorize`: _boolean_ @@ -378,7 +378,7 @@ curl localhost:8545 \ - `signers`: map of _string_ (hex integer) - `tally`: map of _object_ - `authorize`: _boolean_ - - `votes`: _string_ (hex integer) + - `votes`: _integer_ - `votes`: array of _object_ - `address`: _string_ (address) - `authorize`: _boolean_ @@ -459,7 +459,7 @@ curl localhost:8545 \ } ``` -`result`: array of _boolean_ +`result`: map of _boolean_ diff --git a/docs/interacting/json-rpc-ns/debug.md b/docs/interacting/json-rpc-ns/debug.md index 66b2a0f243..c051fe33c8 100644 --- a/docs/interacting/json-rpc-ns/debug.md +++ b/docs/interacting/json-rpc-ns/debug.md @@ -45,7 +45,7 @@ curl localhost:8545 \ } ``` -`result`: _string_ (hex integer) +`result`: _integer_ @@ -130,13 +130,6 @@ curl localhost:8545 \ - `author`: _string_ (address) - `baseFeePerGas`: _string_ (hex integer) - `blobGasUsed`: _string_ (hex integer) - - `blockAccessList`: _object_ - - `accountChanges`: _object_ - - `count`: _string_ (hex integer) - - `itemCount`: _string_ (hex integer) - - `totalStorageChangeEvents`: _string_ (hex integer) - - `totalStorageReads`: _string_ (hex integer) - - `wireHash`: _string_ (hash) - `blockAccessListHash`: _string_ (hash) - `difficulty`: _string_ (hex integer) - `excessBlobGas`: _string_ (hex integer) @@ -147,7 +140,7 @@ curl localhost:8545 \ - `logsBloom`: _string_ (hex data) - `miner`: _string_ (address) - `mixHash`: _string_ (hash) - - `nonce`: _string_ (hex data) + - `nonce`: _string_ (8-byte hex data) - `number`: _string_ (hex integer) - `parentBeaconBlockRoot`: _string_ (hash) - `parentHash`: _string_ (hash) @@ -158,7 +151,7 @@ curl localhost:8545 \ - `size`: _string_ (hex integer) - `slotNumber`: _string_ (hex integer) - `stateRoot`: _string_ (hash) - - `step`: _string_ (hex integer) + - `step`: _integer_ - `timestamp`: _string_ (hex integer) - `totalDifficulty`: _string_ (hex integer) - `transactions`: array of _object_ @@ -166,15 +159,31 @@ curl localhost:8545 \ - `uncles`: array of _string_ (hash) - `withdrawals`: array of _object_ - `address`: _string_ (address) - - `amountInGwei`: _string_ (hex integer) - - `amountInWei`: _string_ (hex integer) + - `amount`: _string_ (hex integer) - `index`: _string_ (hex integer) - `validatorIndex`: _string_ (hex integer) - `withdrawalsRoot`: _string_ (hash) - `generatedBlockAccessList`: _object_ - - `accountChanges`: _object_ - - `count`: _string_ (hex integer) - - `itemCount`: _string_ (hex integer) + - `accountChanges`: array of _object_ + - `address`: _string_ (address) + - `balanceChanges`: array of _object_ + - `index`: _integer_ + - `value`: _string_ (hex integer) + - `codeChanges`: array of _object_ + - `code`: _string_ (hex data) + - `codeHash`: _string_ (hash) + - `index`: _integer_ + - `nonceChanges`: array of _object_ + - `index`: _integer_ + - `value`: _string_ (hex integer) + - `storageChanges`: array of _object_ + - `changes`: array of _object_ + - `index`: _integer_ + - `value`: _object_ + - `item`: _integer_ + - `key`: _string_ (hex integer) + - `storageReads`: array of _string_ (hex integer) + - `itemCount`: _integer_ - `hash`: _string_ (hash) - `rlp`: _string_ (hex data) @@ -268,6 +277,8 @@ curl localhost:8545 \ `result`: _object_ +`result` may be `null` in a successful response. + @@ -349,13 +360,7 @@ curl localhost:8545 \ ``` `result`: _object_ - - `memory`: _object_ - - `isEmpty`: _boolean_ - - `length`: _string_ (hex integer) - - `span`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) + - `memory`: _string_ (hex data) @@ -437,7 +442,7 @@ curl localhost:8545 \ } ``` -`result`: array of _string_ (hex data) +`result`: _object_ @@ -478,7 +483,9 @@ curl localhost:8545 \ } ``` -`result`: _string_ +`result`: _string_ (hex data) + +`result` may be `null` in a successful response. @@ -555,7 +562,7 @@ Insert receipts for the block after verifying receipts root correctness. - `to`: _string_ (address) - `transactionHash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) @@ -611,39 +618,19 @@ Replays a block and returns the world-state root after each transaction in execu - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -786,10 +773,11 @@ Retrieves geth like traces of the simulated blocks - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) @@ -814,39 +802,19 @@ Retrieves geth like traces of the simulated blocks - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -877,42 +845,80 @@ curl localhost:8545 \ ``` `result`: array of _object_ + - `author`: _string_ (address) + - `baseFeePerGas`: _string_ (hex integer) + - `blobGasUsed`: _string_ (hex integer) + - `blockAccessListHash`: _string_ (hash) - `calls`: array of _object_ - `customTracerResult`: _object_ - `value`: _object_ - `entries`: array of _object_ - - `depth`: _string_ (hex integer) + - `depth`: _integer_ - `error`: _string_ - - `gas`: _string_ (hex integer) - - `gasCost`: _string_ (hex integer) - - `memory`: array of _string_ - - `opcode`: _string_ - - `programCounter`: _string_ (hex integer) - - `stack`: array of _string_ - - `storage`: map of _string_ + - `gas`: _integer_ + - `gasCost`: _integer_ + - `memory`: array of _string_ (32-byte hex data) + - `op`: _string_ + - `pc`: _integer_ + - `refund`: _integer_ + - `returnData`: _string_ + - `stack`: array of _string_ (hex integer) + - `storage`: map of _string_ (32-byte hex data) - `failed`: _boolean_ - `gas`: _string_ (hex integer) - `returnValue`: _string_ (hex data) - - `storagesByDepth`: array of map of _string_ - `txHash`: _string_ (hash) + - `difficulty`: _string_ (hex integer) + - `excessBlobGas`: _string_ (hex integer) + - `extraData`: _string_ (hex data) + - `gasLimit`: _string_ (hex integer) + - `gasUsed`: _string_ (hex integer) + - `hash`: _string_ (hash) + - `logsBloom`: _string_ (hex data) + - `miner`: _string_ (address) + - `mixHash`: _string_ (hash) + - `nonce`: _string_ (8-byte hex data) + - `number`: _string_ (hex integer) + - `parentBeaconBlockRoot`: _string_ (hash) + - `parentHash`: _string_ (hash) + - `receiptsRoot`: _string_ (hash) + - `requestsHash`: _string_ (hash) + - `sha3Uncles`: _string_ (hash) + - `signature`: _string_ (hex data) + - `size`: _string_ (hex integer) + - `slotNumber`: _string_ (hex integer) + - `stateRoot`: _string_ (hash) + - `step`: _integer_ + - `timestamp`: _string_ (hex integer) + - `totalDifficulty`: _string_ (hex integer) - `traces`: array of _object_ - `customTracerResult`: _object_ - `value`: _object_ - `entries`: array of _object_ - - `depth`: _string_ (hex integer) + - `depth`: _integer_ - `error`: _string_ - - `gas`: _string_ (hex integer) - - `gasCost`: _string_ (hex integer) - - `memory`: array of _string_ - - `opcode`: _string_ - - `programCounter`: _string_ (hex integer) - - `stack`: array of _string_ - - `storage`: map of _string_ + - `gas`: _integer_ + - `gasCost`: _integer_ + - `memory`: array of _string_ (32-byte hex data) + - `op`: _string_ + - `pc`: _integer_ + - `refund`: _integer_ + - `returnData`: _string_ + - `stack`: array of _string_ (hex integer) + - `storage`: map of _string_ (32-byte hex data) - `failed`: _boolean_ - `gas`: _string_ (hex integer) - `returnValue`: _string_ (hex data) - - `storagesByDepth`: array of map of _string_ - `txHash`: _string_ (hash) + - `transactions`: array of _object_ + - `transactionsRoot`: _string_ (hash) + - `uncles`: array of _string_ (hash) + - `withdrawals`: array of _object_ + - `address`: _string_ (address) + - `amount`: _string_ (hex integer) + - `index`: _string_ (hex integer) + - `validatorIndex`: _string_ (hex integer) + - `withdrawalsRoot`: _string_ (hash) @@ -939,39 +945,19 @@ This method is similar to the `debug_standardTraceBlockToFile` method, but can b - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -1028,39 +1014,19 @@ Writes to a file the full stack trace of all invoked opcodes of the transaction - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -1117,39 +1083,19 @@ Returns the full stack trace of all invoked opcodes of all transactions that wer - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -1183,19 +1129,20 @@ curl localhost:8545 \ - `customTracerResult`: _object_ - `value`: _object_ - `entries`: array of _object_ - - `depth`: _string_ (hex integer) + - `depth`: _integer_ - `error`: _string_ - - `gas`: _string_ (hex integer) - - `gasCost`: _string_ (hex integer) - - `memory`: array of _string_ - - `opcode`: _string_ - - `programCounter`: _string_ (hex integer) - - `stack`: array of _string_ - - `storage`: map of _string_ + - `gas`: _integer_ + - `gasCost`: _integer_ + - `memory`: array of _string_ (32-byte hex data) + - `op`: _string_ + - `pc`: _integer_ + - `refund`: _integer_ + - `returnData`: _string_ + - `stack`: array of _string_ (hex integer) + - `storage`: map of _string_ (32-byte hex data) - `failed`: _boolean_ - `gas`: _string_ (hex integer) - `returnValue`: _string_ (hex data) - - `storagesByDepth`: array of map of _string_ - `txHash`: _string_ (hash) @@ -1223,39 +1170,19 @@ Similar to debug_traceBlock, this method accepts a block hash and replays the bl - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -1289,19 +1216,20 @@ curl localhost:8545 \ - `customTracerResult`: _object_ - `value`: _object_ - `entries`: array of _object_ - - `depth`: _string_ (hex integer) + - `depth`: _integer_ - `error`: _string_ - - `gas`: _string_ (hex integer) - - `gasCost`: _string_ (hex integer) - - `memory`: array of _string_ - - `opcode`: _string_ - - `programCounter`: _string_ (hex integer) - - `stack`: array of _string_ - - `storage`: map of _string_ + - `gas`: _integer_ + - `gasCost`: _integer_ + - `memory`: array of _string_ (32-byte hex data) + - `op`: _string_ + - `pc`: _integer_ + - `refund`: _integer_ + - `returnData`: _string_ + - `stack`: array of _string_ (hex integer) + - `storage`: map of _string_ (32-byte hex data) - `failed`: _boolean_ - `gas`: _string_ (hex integer) - `returnValue`: _string_ (hex data) - - `storagesByDepth`: array of map of _string_ - `txHash`: _string_ (hash) @@ -1329,39 +1257,19 @@ Similar to debug_traceBlock, this method accepts a block number as well as "late - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -1395,19 +1303,20 @@ curl localhost:8545 \ - `customTracerResult`: _object_ - `value`: _object_ - `entries`: array of _object_ - - `depth`: _string_ (hex integer) + - `depth`: _integer_ - `error`: _string_ - - `gas`: _string_ (hex integer) - - `gasCost`: _string_ (hex integer) - - `memory`: array of _string_ - - `opcode`: _string_ - - `programCounter`: _string_ (hex integer) - - `stack`: array of _string_ - - `storage`: map of _string_ + - `gas`: _integer_ + - `gasCost`: _integer_ + - `memory`: array of _string_ (32-byte hex data) + - `op`: _string_ + - `pc`: _integer_ + - `refund`: _integer_ + - `returnData`: _string_ + - `stack`: array of _string_ (hex integer) + - `storage`: map of _string_ (32-byte hex data) - `failed`: _boolean_ - `gas`: _string_ (hex integer) - `returnValue`: _string_ (hex data) - - `storagesByDepth`: array of map of _string_ - `txHash`: _string_ (hash) @@ -1427,7 +1336,7 @@ This method lets you run an eth_call within the context of the given block execu - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) 2. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) @@ -1444,39 +1353,19 @@ This method lets you run an eth_call within the context of the given block execu - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -1510,19 +1399,20 @@ curl localhost:8545 \ - `customTracerResult`: _object_ - `value`: _object_ - `entries`: array of _object_ - - `depth`: _string_ (hex integer) + - `depth`: _integer_ - `error`: _string_ - - `gas`: _string_ (hex integer) - - `gasCost`: _string_ (hex integer) - - `memory`: array of _string_ - - `opcode`: _string_ - - `programCounter`: _string_ (hex integer) - - `stack`: array of _string_ - - `storage`: map of _string_ + - `gas`: _integer_ + - `gasCost`: _integer_ + - `memory`: array of _string_ (32-byte hex data) + - `op`: _string_ + - `pc`: _integer_ + - `refund`: _integer_ + - `returnData`: _string_ + - `stack`: array of _string_ (hex integer) + - `storage`: map of _string_ (32-byte hex data) - `failed`: _boolean_ - `gas`: _string_ (hex integer) - `returnValue`: _string_ (hex data) - - `storagesByDepth`: array of map of _string_ - `txHash`: _string_ (hash) @@ -1547,6 +1437,7 @@ Executes a list of bundles of transactions without creating transactions on the - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) @@ -1558,7 +1449,7 @@ Executes a list of bundles of transactions without creating transactions on the - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) 2. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) @@ -1575,39 +1466,19 @@ Executes a list of bundles of transactions without creating transactions on the - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -1641,19 +1512,20 @@ curl localhost:8545 \ - `customTracerResult`: _object_ - `value`: _object_ - `entries`: array of _object_ - - `depth`: _string_ (hex integer) + - `depth`: _integer_ - `error`: _string_ - - `gas`: _string_ (hex integer) - - `gasCost`: _string_ (hex integer) - - `memory`: array of _string_ - - `opcode`: _string_ - - `programCounter`: _string_ (hex integer) - - `stack`: array of _string_ - - `storage`: map of _string_ + - `gas`: _integer_ + - `gasCost`: _integer_ + - `memory`: array of _string_ (32-byte hex data) + - `op`: _string_ + - `pc`: _integer_ + - `refund`: _integer_ + - `returnData`: _string_ + - `stack`: array of _string_ (hex integer) + - `storage`: map of _string_ (32-byte hex data) - `failed`: _boolean_ - `gas`: _string_ (hex integer) - `returnValue`: _string_ (hex data) - - `storagesByDepth`: array of map of _string_ - `txHash`: _string_ (hash) @@ -1681,39 +1553,19 @@ This method will attempt to run the transaction in the exact same manner as it w - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -1747,19 +1599,20 @@ curl localhost:8545 \ - `customTracerResult`: _object_ - `value`: _object_ - `entries`: array of _object_ - - `depth`: _string_ (hex integer) + - `depth`: _integer_ - `error`: _string_ - - `gas`: _string_ (hex integer) - - `gasCost`: _string_ (hex integer) - - `memory`: array of _string_ - - `opcode`: _string_ - - `programCounter`: _string_ (hex integer) - - `stack`: array of _string_ - - `storage`: map of _string_ + - `gas`: _integer_ + - `gasCost`: _integer_ + - `memory`: array of _string_ (32-byte hex data) + - `op`: _string_ + - `pc`: _integer_ + - `refund`: _integer_ + - `returnData`: _string_ + - `stack`: array of _string_ (hex integer) + - `storage`: map of _string_ (32-byte hex data) - `failed`: _boolean_ - `gas`: _string_ (hex integer) - `returnValue`: _string_ (hex data) - - `storagesByDepth`: array of map of _string_ - `txHash`: _string_ (hash) @@ -1772,7 +1625,7 @@ curl localhost:8545 \ 1. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) -2. `txIndex`: _string_ (hex integer) +2. `txIndex`: _integer_ 3. `options`: _object_ - `blockOverrides`: _object_ @@ -1787,39 +1640,19 @@ curl localhost:8545 \ - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -1853,19 +1686,20 @@ curl localhost:8545 \ - `customTracerResult`: _object_ - `value`: _object_ - `entries`: array of _object_ - - `depth`: _string_ (hex integer) + - `depth`: _integer_ - `error`: _string_ - - `gas`: _string_ (hex integer) - - `gasCost`: _string_ (hex integer) - - `memory`: array of _string_ - - `opcode`: _string_ - - `programCounter`: _string_ (hex integer) - - `stack`: array of _string_ - - `storage`: map of _string_ + - `gas`: _integer_ + - `gasCost`: _integer_ + - `memory`: array of _string_ (32-byte hex data) + - `op`: _string_ + - `pc`: _integer_ + - `refund`: _integer_ + - `returnData`: _string_ + - `stack`: array of _string_ (hex integer) + - `storage`: map of _string_ (32-byte hex data) - `failed`: _boolean_ - `gas`: _string_ (hex integer) - `returnValue`: _string_ (hex data) - - `storagesByDepth`: array of map of _string_ - `txHash`: _string_ (hash) @@ -1878,7 +1712,7 @@ curl localhost:8545 \ 1. `blockHash`: _string_ (hash) -2. `txIndex`: _string_ (hex integer) +2. `txIndex`: _integer_ 3. `options`: _object_ - `blockOverrides`: _object_ @@ -1893,39 +1727,19 @@ curl localhost:8545 \ - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -1959,19 +1773,20 @@ curl localhost:8545 \ - `customTracerResult`: _object_ - `value`: _object_ - `entries`: array of _object_ - - `depth`: _string_ (hex integer) + - `depth`: _integer_ - `error`: _string_ - - `gas`: _string_ (hex integer) - - `gasCost`: _string_ (hex integer) - - `memory`: array of _string_ - - `opcode`: _string_ - - `programCounter`: _string_ (hex integer) - - `stack`: array of _string_ - - `storage`: map of _string_ + - `gas`: _integer_ + - `gasCost`: _integer_ + - `memory`: array of _string_ (32-byte hex data) + - `op`: _string_ + - `pc`: _integer_ + - `refund`: _integer_ + - `returnData`: _string_ + - `stack`: array of _string_ (hex integer) + - `storage`: map of _string_ (32-byte hex data) - `failed`: _boolean_ - `gas`: _string_ (hex integer) - `returnValue`: _string_ (hex data) - - `storagesByDepth`: array of map of _string_ - `txHash`: _string_ (hash) @@ -1999,39 +1814,19 @@ curl localhost:8545 \ - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -2065,19 +1860,20 @@ curl localhost:8545 \ - `customTracerResult`: _object_ - `value`: _object_ - `entries`: array of _object_ - - `depth`: _string_ (hex integer) + - `depth`: _integer_ - `error`: _string_ - - `gas`: _string_ (hex integer) - - `gasCost`: _string_ (hex integer) - - `memory`: array of _string_ - - `opcode`: _string_ - - `programCounter`: _string_ (hex integer) - - `stack`: array of _string_ - - `storage`: map of _string_ + - `gas`: _integer_ + - `gasCost`: _integer_ + - `memory`: array of _string_ (32-byte hex data) + - `op`: _string_ + - `pc`: _integer_ + - `refund`: _integer_ + - `returnData`: _string_ + - `stack`: array of _string_ (hex integer) + - `storage`: map of _string_ (32-byte hex data) - `failed`: _boolean_ - `gas`: _string_ (hex integer) - `returnValue`: _string_ (hex data) - - `storagesByDepth`: array of map of _string_ - `txHash`: _string_ (hash) @@ -2090,7 +1886,7 @@ curl localhost:8545 \ 1. `blockRlp`: _string_ (hex data) -2. `txIndex`: _string_ (hex integer) +2. `txIndex`: _integer_ 3. `options`: _object_ - `blockOverrides`: _object_ @@ -2105,39 +1901,19 @@ curl localhost:8545 \ - `disableStack`: _boolean_ - `disableStorage`: _boolean_ - `enableMemory`: _boolean_ + - `enableReturnData`: _boolean_ - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) - `stateDiff`: map of _string_ (hash) - `streamMode`: _boolean_ - - `timeout`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ + - `timeout`: _string_ (duration) - `tracer`: _string_ - `tracerConfig`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `item`: _object_ - - - `valueKind`: _integer_ - `txHash`: _string_ (hash) @@ -2171,19 +1947,20 @@ curl localhost:8545 \ - `customTracerResult`: _object_ - `value`: _object_ - `entries`: array of _object_ - - `depth`: _string_ (hex integer) + - `depth`: _integer_ - `error`: _string_ - - `gas`: _string_ (hex integer) - - `gasCost`: _string_ (hex integer) - - `memory`: array of _string_ - - `opcode`: _string_ - - `programCounter`: _string_ (hex integer) - - `stack`: array of _string_ - - `storage`: map of _string_ + - `gas`: _integer_ + - `gasCost`: _integer_ + - `memory`: array of _string_ (32-byte hex data) + - `op`: _string_ + - `pc`: _integer_ + - `refund`: _integer_ + - `returnData`: _string_ + - `stack`: array of _string_ (hex integer) + - `storage`: map of _string_ (32-byte hex data) - `failed`: _boolean_ - `gas`: _string_ (hex integer) - `returnValue`: _string_ (hex data) - - `storagesByDepth`: array of map of _string_ - `txHash`: _string_ (hash) diff --git a/docs/interacting/json-rpc-ns/eth.md b/docs/interacting/json-rpc-ns/eth.md index b41abb7fc5..3da9b41618 100644 --- a/docs/interacting/json-rpc-ns/eth.md +++ b/docs/interacting/json-rpc-ns/eth.md @@ -74,6 +74,8 @@ curl localhost:8545 \ `result`: _string_ (hex integer) +`result` may be `null` in a successful response. + @@ -109,6 +111,8 @@ curl localhost:8545 \ `result`: _string_ (hex integer) +`result` may be `null` in a successful response. + @@ -161,13 +165,14 @@ Executes a tx call (does not create a transaction) - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) 2. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) 3. `stateOverride`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) @@ -209,14 +214,7 @@ curl localhost:8545 \ } ``` -`result`: _object_ - - `bytes`: _object_ - - `isEmpty`: _boolean_ - - `length`: _string_ (hex integer) - - `span`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) +`result`: _string_ (hex data) @@ -254,10 +252,8 @@ curl localhost:8545 \ `result`: _object_ - `blocks`: _object_ - `deleteStrategy`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `retentionBlocks`: _string_ (hex integer) - - `type`: _string_ + - `retentionBlocks`: _string_ (hex integer) + - `type`: _string_ - `disabled`: _boolean_ - `oldestBlock`: _string_ (hex integer) - `head`: _object_ @@ -265,42 +261,32 @@ curl localhost:8545 \ - `number`: _string_ (hex integer) - `logs`: _object_ - `deleteStrategy`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `retentionBlocks`: _string_ (hex integer) - - `type`: _string_ + - `retentionBlocks`: _string_ (hex integer) + - `type`: _string_ - `disabled`: _boolean_ - `oldestBlock`: _string_ (hex integer) - `receipts`: _object_ - `deleteStrategy`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `retentionBlocks`: _string_ (hex integer) - - `type`: _string_ + - `retentionBlocks`: _string_ (hex integer) + - `type`: _string_ - `disabled`: _boolean_ - `oldestBlock`: _string_ (hex integer) - `state`: _object_ - `deleteStrategy`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `retentionBlocks`: _string_ (hex integer) - - `type`: _string_ + - `retentionBlocks`: _string_ (hex integer) + - `type`: _string_ - `disabled`: _boolean_ - `oldestBlock`: _string_ (hex integer) - `stateproofs`: _object_ - `deleteStrategy`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `retentionBlocks`: _string_ (hex integer) - - `type`: _string_ + - `retentionBlocks`: _string_ (hex integer) + - `type`: _string_ - `disabled`: _boolean_ - `oldestBlock`: _string_ (hex integer) - `tx`: _object_ - `deleteStrategy`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `retentionBlocks`: _string_ (hex integer) - - `type`: _string_ + - `retentionBlocks`: _string_ (hex integer) + - `type`: _string_ - `disabled`: _boolean_ - `oldestBlock`: _string_ (hex integer) @@ -373,18 +359,6 @@ curl localhost:8545 \ ``` `result`: _object_ - - `item`: _object_ - - - `item`: _object_ - - - `options`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `propertyNameCaseInsensitive`: _boolean_ - - `parent`: _object_ - - - `root`: _object_ - @@ -403,13 +377,14 @@ Creates an [EIP2930](https://eips.ethereum.org/EIPS/eip-2930) type AccessList fo - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) 2. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) 3. `stateOverride`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) @@ -466,13 +441,14 @@ Executes a tx call and returns gas used (does not create a transaction) - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) 2. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) 3. `stateOverride`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) @@ -530,7 +506,7 @@ Returns block fee history. 2. `newestBlock`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) -3. `rewardPercentiles`: array of _object_ +3. `rewardPercentiles`: array of _number_ @@ -562,19 +538,32 @@ curl localhost:8545 \ `result`: _object_ - `baseFeePerBlobGas`: array of _string_ (hex integer) - `baseFeePerGas`: array of _string_ (hex integer) - - `blobGasUsedRatio`: array of _object_ - - `gasUsedRatio`: array of _object_ + - `blobGasUsedRatio`: array of _number_ + - `gasUsedRatio`: array of _number_ - `oldestBlock`: _string_ (hex integer) - `reward`: array of array of _string_ (hex integer) -### eth_gasPrice +### eth_fillTransaction -Returns miner's gas price +Fills in the missing fields of a transaction (nonce, gas, fees and chain id) and returns the unsigned transaction, ready to be signed and submitted. + + +1. `rpcTx`: _object_ + - `blockHash`: _string_ (hash) + - `blockNumber`: _string_ (hex integer) + - `blockTimestamp`: _string_ (hex integer) + - `gas`: _string_ (hex integer) + - `hash`: _string_ (hash) + - `transactionIndex`: _string_ (hex integer) + - `type`: _string_ (transaction type) + + + ```bash @@ -584,8 +573,8 @@ curl localhost:8545 \ --data '{ "jsonrpc": "2.0", "id": 0, - "method": "eth_gasPrice", - "params": [] + "method": "eth_fillTransaction", + "params": [rpcTx] }' ``` @@ -600,24 +589,24 @@ curl localhost:8545 \ } ``` -`result`: _string_ (hex integer) +`result`: _object_ + - `tx`: _object_ + - `blockHash`: _string_ (hash) + - `blockNumber`: _string_ (hex integer) + - `blockTimestamp`: _string_ (hex integer) + - `gas`: _string_ (hex integer) + - `hash`: _string_ (hash) + - `transactionIndex`: _string_ (hex integer) + - `type`: _string_ (transaction type) -### eth_getAccount +### eth_gasPrice -Retrieves Accounts via Address and Blocknumber +Returns miner's gas price - - -1. `accountAddress`: _string_ (address) - -2. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) - - - ```bash @@ -627,8 +616,8 @@ curl localhost:8545 \ --data '{ "jsonrpc": "2.0", "id": 0, - "method": "eth_getAccount", - "params": [accountAddress, blockParameter] + "method": "eth_gasPrice", + "params": [] }' ``` @@ -643,34 +632,14 @@ curl localhost:8545 \ } ``` -`result`: _object_ - - `balance`: _string_ (hex integer) - - `codeHash`: _object_ - - `bytes`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) - - `bytesAsSpan`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) - - `nonce`: _string_ (hex integer) - - `storageRoot`: _object_ - - `bytes`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) - - `bytesAsSpan`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) +`result`: _string_ (hex integer) -### eth_getAccountInfo +### eth_getAccount -Retrieves Account with code and no storageRoot via Address and Blocknumber +Retrieves Accounts via Address and Blocknumber @@ -690,7 +659,7 @@ curl localhost:8545 \ --data '{ "jsonrpc": "2.0", "id": 0, - "method": "eth_getAccountInfo", + "method": "eth_getAccount", "params": [accountAddress, blockParameter] }' ``` @@ -708,20 +677,23 @@ curl localhost:8545 \ `result`: _object_ - `balance`: _string_ (hex integer) - - `code`: _string_ (hex data) + - `codeHash`: _string_ (hash) - `nonce`: _string_ (hex integer) + - `storageRoot`: _string_ (hash) + +`result` may be `null` in a successful response. -### eth_getBalance +### eth_getAccountInfo -Returns account balance +Retrieves Account with code and no storageRoot via Address and Blocknumber -1. `address`: _string_ (address) +1. `accountAddress`: _string_ (address) 2. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) @@ -736,8 +708,8 @@ curl localhost:8545 \ --data '{ "jsonrpc": "2.0", "id": 0, - "method": "eth_getBalance", - "params": [address, blockParameter] + "method": "eth_getAccountInfo", + "params": [accountAddress, blockParameter] }' ``` @@ -752,19 +724,24 @@ curl localhost:8545 \ } ``` -`result`: _string_ (hex integer) +`result`: _object_ + - `balance`: _string_ (hex integer) + - `code`: _string_ (hex data) + - `nonce`: _string_ (hex integer) -### eth_getBlockAccessListByHash +### eth_getBalance -Retrieves block access list for a block by hash. +Returns account balance -1. `blockHash`: _string_ (hash) +1. `address`: _string_ (address) + +2. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) @@ -777,8 +754,8 @@ curl localhost:8545 \ --data '{ "jsonrpc": "2.0", "id": 0, - "method": "eth_getBlockAccessListByHash", - "params": [blockHash] + "method": "eth_getBalance", + "params": [address, blockParameter] }' ``` @@ -793,25 +770,19 @@ curl localhost:8545 \ } ``` -`result`: _object_ - - `accountChanges`: _object_ - - `count`: _string_ (hex integer) - - `itemCount`: _string_ (hex integer) - - `totalStorageChangeEvents`: _string_ (hex integer) - - `totalStorageReads`: _string_ (hex integer) - - `wireHash`: _string_ (hash) +`result`: _string_ (hex integer) -### eth_getBlockAccessListByNumber +### eth_getBlockAccessList -Retrieves block access list for a block by number. +Returns the block access list for a given block. -1. `number`: _string_ (hex integer) +1. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) @@ -824,8 +795,8 @@ curl localhost:8545 \ --data '{ "jsonrpc": "2.0", "id": 0, - "method": "eth_getBlockAccessListByNumber", - "params": [number] + "method": "eth_getBlockAccessList", + "params": [blockParameter] }' ``` @@ -840,13 +811,25 @@ curl localhost:8545 \ } ``` -`result`: _object_ - - `accountChanges`: _object_ - - `count`: _string_ (hex integer) - - `itemCount`: _string_ (hex integer) - - `totalStorageChangeEvents`: _string_ (hex integer) - - `totalStorageReads`: _string_ (hex integer) - - `wireHash`: _string_ (hash) +`result`: array of _object_ + - `address`: _string_ (address) + - `balanceChanges`: array of _object_ + - `index`: _string_ (hex integer) + - `value`: _string_ (hex integer) + - `codeChanges`: array of _object_ + - `code`: _string_ (hex data) + - `index`: _string_ (hex integer) + - `nonceChanges`: array of _object_ + - `index`: _string_ (hex integer) + - `value`: _string_ (hex integer) + - `storageChanges`: array of _object_ + - `changes`: array of _object_ + - `index`: _string_ (hex integer) + - `value`: _string_ (hash) + - `key`: _string_ (hash) + - `storageReads`: array of _string_ (hash) + +`result` may be `null` in a successful response. @@ -893,13 +876,6 @@ curl localhost:8545 \ - `author`: _string_ (address) - `baseFeePerGas`: _string_ (hex integer) - `blobGasUsed`: _string_ (hex integer) - - `blockAccessList`: _object_ - - `accountChanges`: _object_ - - `count`: _string_ (hex integer) - - `itemCount`: _string_ (hex integer) - - `totalStorageChangeEvents`: _string_ (hex integer) - - `totalStorageReads`: _string_ (hex integer) - - `wireHash`: _string_ (hash) - `blockAccessListHash`: _string_ (hash) - `difficulty`: _string_ (hex integer) - `excessBlobGas`: _string_ (hex integer) @@ -910,7 +886,7 @@ curl localhost:8545 \ - `logsBloom`: _string_ (hex data) - `miner`: _string_ (address) - `mixHash`: _string_ (hash) - - `nonce`: _string_ (hex data) + - `nonce`: _string_ (8-byte hex data) - `number`: _string_ (hex integer) - `parentBeaconBlockRoot`: _string_ (hash) - `parentHash`: _string_ (hash) @@ -921,7 +897,7 @@ curl localhost:8545 \ - `size`: _string_ (hex integer) - `slotNumber`: _string_ (hex integer) - `stateRoot`: _string_ (hash) - - `step`: _string_ (hex integer) + - `step`: _integer_ - `timestamp`: _string_ (hex integer) - `totalDifficulty`: _string_ (hex integer) - `transactions`: array of _object_ @@ -929,12 +905,13 @@ curl localhost:8545 \ - `uncles`: array of _string_ (hash) - `withdrawals`: array of _object_ - `address`: _string_ (address) - - `amountInGwei`: _string_ (hex integer) - - `amountInWei`: _string_ (hex integer) + - `amount`: _string_ (hex integer) - `index`: _string_ (hex integer) - `validatorIndex`: _string_ (hex integer) - `withdrawalsRoot`: _string_ (hash) +`result` may be `null` in a successful response. + @@ -980,13 +957,6 @@ curl localhost:8545 \ - `author`: _string_ (address) - `baseFeePerGas`: _string_ (hex integer) - `blobGasUsed`: _string_ (hex integer) - - `blockAccessList`: _object_ - - `accountChanges`: _object_ - - `count`: _string_ (hex integer) - - `itemCount`: _string_ (hex integer) - - `totalStorageChangeEvents`: _string_ (hex integer) - - `totalStorageReads`: _string_ (hex integer) - - `wireHash`: _string_ (hash) - `blockAccessListHash`: _string_ (hash) - `difficulty`: _string_ (hex integer) - `excessBlobGas`: _string_ (hex integer) @@ -997,7 +967,7 @@ curl localhost:8545 \ - `logsBloom`: _string_ (hex data) - `miner`: _string_ (address) - `mixHash`: _string_ (hash) - - `nonce`: _string_ (hex data) + - `nonce`: _string_ (8-byte hex data) - `number`: _string_ (hex integer) - `parentBeaconBlockRoot`: _string_ (hash) - `parentHash`: _string_ (hash) @@ -1008,7 +978,7 @@ curl localhost:8545 \ - `size`: _string_ (hex integer) - `slotNumber`: _string_ (hex integer) - `stateRoot`: _string_ (hash) - - `step`: _string_ (hex integer) + - `step`: _integer_ - `timestamp`: _string_ (hex integer) - `totalDifficulty`: _string_ (hex integer) - `transactions`: array of _object_ @@ -1016,12 +986,13 @@ curl localhost:8545 \ - `uncles`: array of _string_ (hash) - `withdrawals`: array of _object_ - `address`: _string_ (address) - - `amountInGwei`: _string_ (hex integer) - - `amountInWei`: _string_ (hex integer) + - `amount`: _string_ (hex integer) - `index`: _string_ (hex integer) - `validatorIndex`: _string_ (hex integer) - `withdrawalsRoot`: _string_ (hash) +`result` may be `null` in a successful response. + @@ -1088,7 +1059,9 @@ curl localhost:8545 \ - `to`: _string_ (address) - `transactionHash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) + +`result` may be `null` in a successful response. @@ -1131,6 +1104,8 @@ curl localhost:8545 \ `result`: _string_ (hex integer) +`result` may be `null` in a successful response. + @@ -1172,6 +1147,8 @@ curl localhost:8545 \ `result`: _string_ (hex integer) +`result` may be `null` in a successful response. + @@ -1360,7 +1337,7 @@ curl localhost:8545 \ - `logsBloom`: _string_ (hex data) - `miner`: _string_ (address) - `mixHash`: _string_ (hash) - - `nonce`: _string_ (hex data) + - `nonce`: _string_ (8-byte hex data) - `number`: _string_ (hex integer) - `parentBeaconBlockRoot`: _string_ (hash) - `parentHash`: _string_ (hash) @@ -1370,11 +1347,13 @@ curl localhost:8545 \ - `signature`: _string_ (hex data) - `slotNumber`: _string_ (hex integer) - `stateRoot`: _string_ (hash) - - `step`: _string_ (hex integer) + - `step`: _integer_ - `timestamp`: _string_ (hex integer) - `transactionsRoot`: _string_ (hash) - `withdrawalsRoot`: _string_ (hash) +`result` may be `null` in a successful response. + @@ -1428,7 +1407,7 @@ curl localhost:8545 \ - `logsBloom`: _string_ (hex data) - `miner`: _string_ (address) - `mixHash`: _string_ (hash) - - `nonce`: _string_ (hex data) + - `nonce`: _string_ (8-byte hex data) - `number`: _string_ (hex integer) - `parentBeaconBlockRoot`: _string_ (hash) - `parentHash`: _string_ (hash) @@ -1438,11 +1417,13 @@ curl localhost:8545 \ - `signature`: _string_ (hex data) - `slotNumber`: _string_ (hex integer) - `stateRoot`: _string_ (hash) - - `step`: _string_ (hex integer) + - `step`: _integer_ - `timestamp`: _string_ (hex integer) - `transactionsRoot`: _string_ (hash) - `withdrawalsRoot`: _string_ (hash) +`result` may be `null` in a successful response. + @@ -1454,8 +1435,7 @@ Reads logs 1. `filter`: _object_ - - `address`: array of _object_ - - `value`: _string_ (address) + - `address`: array of _string_ (address) - `fromBlock`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) - `toBlock`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) - `topics`: array of array of _string_ (hash) @@ -1512,7 +1492,8 @@ https://github.com/ethereum/EIPs/issues/1186 1. `accountAddress`: _string_ (address) -2. `storageKeys`: array of _string_ (hex integer) +2. `storageKeys`: _object_ + - `count`: _integer_ 3. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) @@ -1552,15 +1533,7 @@ curl localhost:8545 \ - `storageProofs`: array of _object_ - `key`: _string_ - `proof`: array of _string_ (hex data) - - `value`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `isEmpty`: _boolean_ - - `length`: _string_ (hex integer) - - `span`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) + - `value`: _string_ (hex data) - `storageRoot`: _string_ (hash) @@ -1604,7 +1577,9 @@ curl localhost:8545 \ } ``` -`result`: _string_ +`result`: _string_ (hex data) + +`result` may be `null` in a successful response. @@ -1647,7 +1622,9 @@ curl localhost:8545 \ } ``` -`result`: _string_ +`result`: _string_ (hex data) + +`result` may be `null` in a successful response. @@ -1688,7 +1665,9 @@ curl localhost:8545 \ } ``` -`result`: _string_ +`result`: _string_ (hex data) + +`result` may be `null` in a successful response. @@ -1702,7 +1681,8 @@ Returns storage data at address. storage_index 1. `address`: _string_ (address) -2. `positionIndex`: _string_ (hex integer) +2. `positionIndex`: _object_ + - `value`: _string_ (hex integer) 3. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) @@ -1748,7 +1728,7 @@ Returns storage values for multiple slots across multiple accounts in a single r 1. `requests`: _object_ - `entries`: map of array of _string_ (hex integer) - `tooManySlots`: _boolean_ - - `totalSlots`: _string_ (hex integer) + - `totalSlots`: _integer_ 2. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) @@ -1780,14 +1760,7 @@ curl localhost:8545 \ ``` `result`: _object_ - - `slots`: map of array of _object_ -array of _object_ - - `isEmpty`: _boolean_ - - `length`: _string_ (hex integer) - - `span`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) + - `slots`: map of array of _string_ (hex data) @@ -1837,7 +1810,9 @@ curl localhost:8545 \ - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) + +`result` may be `null` in a successful response. @@ -1887,7 +1862,9 @@ curl localhost:8545 \ - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) + +`result` may be `null` in a successful response. @@ -1935,7 +1912,9 @@ curl localhost:8545 \ - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) + +`result` may be `null` in a successful response. @@ -2046,7 +2025,9 @@ curl localhost:8545 \ - `to`: _string_ (address) - `transactionHash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) + +`result` may be `null` in a successful response. @@ -2093,13 +2074,6 @@ curl localhost:8545 \ - `author`: _string_ (address) - `baseFeePerGas`: _string_ (hex integer) - `blobGasUsed`: _string_ (hex integer) - - `blockAccessList`: _object_ - - `accountChanges`: _object_ - - `count`: _string_ (hex integer) - - `itemCount`: _string_ (hex integer) - - `totalStorageChangeEvents`: _string_ (hex integer) - - `totalStorageReads`: _string_ (hex integer) - - `wireHash`: _string_ (hash) - `blockAccessListHash`: _string_ (hash) - `difficulty`: _string_ (hex integer) - `excessBlobGas`: _string_ (hex integer) @@ -2110,7 +2084,7 @@ curl localhost:8545 \ - `logsBloom`: _string_ (hex data) - `miner`: _string_ (address) - `mixHash`: _string_ (hash) - - `nonce`: _string_ (hex data) + - `nonce`: _string_ (8-byte hex data) - `number`: _string_ (hex integer) - `parentBeaconBlockRoot`: _string_ (hash) - `parentHash`: _string_ (hash) @@ -2121,7 +2095,7 @@ curl localhost:8545 \ - `size`: _string_ (hex integer) - `slotNumber`: _string_ (hex integer) - `stateRoot`: _string_ (hash) - - `step`: _string_ (hex integer) + - `step`: _integer_ - `timestamp`: _string_ (hex integer) - `totalDifficulty`: _string_ (hex integer) - `transactions`: array of _object_ @@ -2129,12 +2103,13 @@ curl localhost:8545 \ - `uncles`: array of _string_ (hash) - `withdrawals`: array of _object_ - `address`: _string_ (address) - - `amountInGwei`: _string_ (hex integer) - - `amountInWei`: _string_ (hex integer) + - `amount`: _string_ (hex integer) - `index`: _string_ (hex integer) - `validatorIndex`: _string_ (hex integer) - `withdrawalsRoot`: _string_ (hash) +`result` may be `null` in a successful response. + @@ -2180,13 +2155,6 @@ curl localhost:8545 \ - `author`: _string_ (address) - `baseFeePerGas`: _string_ (hex integer) - `blobGasUsed`: _string_ (hex integer) - - `blockAccessList`: _object_ - - `accountChanges`: _object_ - - `count`: _string_ (hex integer) - - `itemCount`: _string_ (hex integer) - - `totalStorageChangeEvents`: _string_ (hex integer) - - `totalStorageReads`: _string_ (hex integer) - - `wireHash`: _string_ (hash) - `blockAccessListHash`: _string_ (hash) - `difficulty`: _string_ (hex integer) - `excessBlobGas`: _string_ (hex integer) @@ -2197,7 +2165,7 @@ curl localhost:8545 \ - `logsBloom`: _string_ (hex data) - `miner`: _string_ (address) - `mixHash`: _string_ (hash) - - `nonce`: _string_ (hex data) + - `nonce`: _string_ (8-byte hex data) - `number`: _string_ (hex integer) - `parentBeaconBlockRoot`: _string_ (hash) - `parentHash`: _string_ (hash) @@ -2208,7 +2176,7 @@ curl localhost:8545 \ - `size`: _string_ (hex integer) - `slotNumber`: _string_ (hex integer) - `stateRoot`: _string_ (hash) - - `step`: _string_ (hex integer) + - `step`: _integer_ - `timestamp`: _string_ (hex integer) - `totalDifficulty`: _string_ (hex integer) - `transactions`: array of _object_ @@ -2216,12 +2184,13 @@ curl localhost:8545 \ - `uncles`: array of _string_ (hash) - `withdrawals`: array of _object_ - `address`: _string_ (address) - - `amountInGwei`: _string_ (hex integer) - - `amountInWei`: _string_ (hex integer) + - `amount`: _string_ (hex integer) - `index`: _string_ (hex integer) - `validatorIndex`: _string_ (hex integer) - `withdrawalsRoot`: _string_ (hash) +`result` may be `null` in a successful response. + @@ -2263,6 +2232,8 @@ curl localhost:8545 \ `result`: _string_ (hex integer) +`result` may be `null` in a successful response. + @@ -2304,6 +2275,8 @@ curl localhost:8545 \ `result`: _string_ (hex integer) +`result` may be `null` in a successful response. + @@ -2350,8 +2323,7 @@ Creates an update filter 1. `filter`: _object_ - - `address`: array of _object_ - - `value`: _string_ (address) + - `address`: array of _string_ (address) - `fromBlock`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) - `toBlock`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) - `topics`: array of array of _string_ (hash) @@ -2461,7 +2433,7 @@ curl localhost:8545 \ - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) @@ -2607,7 +2579,7 @@ curl localhost:8545 \ - `to`: _string_ (address) - `transactionHash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) @@ -2626,7 +2598,7 @@ Send a transaction to the tx pool and broadcasting - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) @@ -2698,44 +2670,7 @@ curl localhost:8545 \ } ``` -`result`: _object_ - - `bytes`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) - - `bytesWithRecovery`: _string_ (hex data) - - `chainId`: _string_ (hex integer) - - `memory`: _object_ - - `isEmpty`: _boolean_ - - `length`: _string_ (hex integer) - - `span`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) - - `r`: _object_ - - `isEmpty`: _boolean_ - - `length`: _string_ (hex integer) - - `span`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) - - `rAsSpan`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) - - `recoveryId`: _string_ (hex data) - - `s`: _object_ - - `isEmpty`: _boolean_ - - `length`: _string_ (hex integer) - - `span`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) - - `sAsSpan`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) - - `v`: _string_ (hex integer) +`result`: _string_ (hex data) @@ -2754,7 +2689,7 @@ Signs the transaction using the unlocked sender account and returns the RLP-enco - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) @@ -2784,7 +2719,7 @@ curl localhost:8545 \ ``` `result`: _object_ - - `raw`: array of _string_ (hex data) + - `raw`: _string_ (hex data) - `tx`: _object_ - `blockHash`: _string_ (hash) - `blockNumber`: _string_ (hex integer) @@ -2792,7 +2727,7 @@ curl localhost:8545 \ - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) @@ -2821,10 +2756,11 @@ Executes a simulation across multiple blocks (does not create a transaction or b - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) @@ -2864,11 +2800,14 @@ curl localhost:8545 \ ``` `result`: array of _object_ + - `author`: _string_ (address) + - `baseFeePerGas`: _string_ (hex integer) + - `blobGasUsed`: _string_ (hex integer) + - `blockAccessListHash`: _string_ (hash) - `calls`: array of _object_ - `error`: _object_ - - `code`: _string_ (hex integer) + - `code`: _integer_ - `data`: _string_ (hex data) - - `evmException`: _integer_ - `message`: _string_ - `gasUsed`: _string_ (hex integer) - `logs`: array of _object_ @@ -2885,11 +2824,33 @@ curl localhost:8545 \ - `maxUsedGas`: _string_ (hex integer) - `returnData`: _string_ (hex data) - `status`: _string_ (hex integer) + - `difficulty`: _string_ (hex integer) + - `excessBlobGas`: _string_ (hex integer) + - `extraData`: _string_ (hex data) + - `gasLimit`: _string_ (hex integer) + - `gasUsed`: _string_ (hex integer) + - `hash`: _string_ (hash) + - `logsBloom`: _string_ (hex data) + - `miner`: _string_ (address) + - `mixHash`: _string_ (hash) + - `nonce`: _string_ (8-byte hex data) + - `number`: _string_ (hex integer) + - `parentBeaconBlockRoot`: _string_ (hash) + - `parentHash`: _string_ (hash) + - `receiptsRoot`: _string_ (hash) + - `requestsHash`: _string_ (hash) + - `sha3Uncles`: _string_ (hash) + - `signature`: _string_ (hex data) + - `size`: _string_ (hex integer) + - `slotNumber`: _string_ (hex integer) + - `stateRoot`: _string_ (hash) + - `step`: _integer_ + - `timestamp`: _string_ (hex integer) + - `totalDifficulty`: _string_ (hex integer) - `traces`: array of _object_ - `error`: _object_ - - `code`: _string_ (hex integer) + - `code`: _integer_ - `data`: _string_ (hex data) - - `evmException`: _integer_ - `message`: _string_ - `gasUsed`: _string_ (hex integer) - `logs`: array of _object_ @@ -2906,6 +2867,15 @@ curl localhost:8545 \ - `maxUsedGas`: _string_ (hex integer) - `returnData`: _string_ (hex data) - `status`: _string_ (hex integer) + - `transactions`: array of _object_ + - `transactionsRoot`: _string_ (hash) + - `uncles`: array of _string_ (hash) + - `withdrawals`: array of _object_ + - `address`: _string_ (address) + - `amount`: _string_ (hex integer) + - `index`: _string_ (hex integer) + - `validatorIndex`: _string_ (hex integer) + - `withdrawalsRoot`: _string_ (hash) diff --git a/docs/interacting/json-rpc-ns/flashbots.md b/docs/interacting/json-rpc-ns/flashbots.md index 661d5db509..711832ea4e 100644 --- a/docs/interacting/json-rpc-ns/flashbots.md +++ b/docs/interacting/json-rpc-ns/flashbots.md @@ -15,11 +15,11 @@ import TabItem from "@theme/TabItem"; 1. `params`: _object_ - - `blobsBundle`: _object_ + - `blobs_bundle`: _object_ - `blobs`: array of _string_ (hex data) - `commitments`: array of _string_ (hex data) - `proofs`: array of _string_ (hex data) - - `executionPayload`: _object_ + - `execution_payload`: _object_ - `base_fee_per_gas`: _string_ (hex integer) - `blob_gas_used`: _string_ (hex integer) - `block_hash`: _string_ (hash) @@ -38,29 +38,21 @@ import TabItem from "@theme/TabItem"; - `transactions`: array of _string_ (hex data) - `withdrawals`: array of _object_ - `address`: _string_ (address) - - `amount_in_gwei`: _string_ (hex integer) + - `amount`: _string_ (hex integer) - `index`: _string_ (hex integer) - `validator_index`: _string_ (hex integer) - `message`: _object_ - - `blockHash`: _string_ (hash) - - `builderPublicKey`: _object_ - - `address`: _string_ (address) - - `bytes`: _string_ (hex data) - - `hash`: _string_ (hash) - - `prefixedBytes`: _string_ (hex data) - - `gasLimit`: _string_ (hex integer) - - `gasUsed`: _string_ (hex integer) - - `parentHash`: _string_ (hash) - - `proposerFeeRecipient`: _string_ (address) - - `proposerPublicKey`: _object_ - - `address`: _string_ (address) - - `bytes`: _string_ (hex data) - - `hash`: _string_ (hash) - - `prefixedBytes`: _string_ (hex data) + - `block_hash`: _string_ (hash) + - `builder_public_key`: _string_ (hex data) + - `gas_limit`: _string_ (hex integer) + - `gas_used`: _string_ (hex integer) + - `parent_hash`: _string_ (hash) + - `proposer_fee_recipient`: _string_ (address) + - `proposer_public_key`: _string_ (hex data) - `slot`: _string_ (hex integer) - `value`: _string_ (hex integer) - - `parentBeaconBlockRoot`: _string_ (hash) - - `registeredGasLimit`: _string_ (hex integer) + - `parent_beacon_block_root`: _string_ (hash) + - `registered_gas_limit`: _string_ (hex integer) - `signature`: _string_ (hex data) diff --git a/docs/interacting/json-rpc-ns/logindex.md b/docs/interacting/json-rpc-ns/logindex.md index d5aa4077a2..c35100e57e 100644 --- a/docs/interacting/json-rpc-ns/logindex.md +++ b/docs/interacting/json-rpc-ns/logindex.md @@ -15,8 +15,7 @@ Retrieves log index block number for the given filter. 1. `filter`: _object_ - - `address`: array of _object_ - - `value`: _string_ (address) + - `address`: array of _string_ (address) - `fromBlock`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) - `toBlock`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) - `topics`: array of array of _string_ (hash) @@ -91,183 +90,7 @@ curl localhost:8545 \ - `dbSize`: _string_ - `isRunning`: _boolean_ - `lastError`: _string_ - - `lastUpdate`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `date`: _object_ - - `date`: _object_ - - - `day`: _string_ (hex integer) - - `dayOfWeek`: _integer_ - - `dayOfYear`: _string_ (hex integer) - - `hour`: _string_ (hex integer) - - `kind`: _integer_ - - `microsecond`: _string_ (hex integer) - - `millisecond`: _string_ (hex integer) - - `minute`: _string_ (hex integer) - - `month`: _string_ (hex integer) - - `nanosecond`: _string_ (hex integer) - - `second`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `timeOfDay`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ - - `year`: _string_ (hex integer) - - `dateTime`: _object_ - - `date`: _object_ - - - `day`: _string_ (hex integer) - - `dayOfWeek`: _integer_ - - `dayOfYear`: _string_ (hex integer) - - `hour`: _string_ (hex integer) - - `kind`: _integer_ - - `microsecond`: _string_ (hex integer) - - `millisecond`: _string_ (hex integer) - - `minute`: _string_ (hex integer) - - `month`: _string_ (hex integer) - - `nanosecond`: _string_ (hex integer) - - `second`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `timeOfDay`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ - - `year`: _string_ (hex integer) - - `day`: _string_ (hex integer) - - `dayOfWeek`: _integer_ - - `dayOfYear`: _string_ (hex integer) - - `hour`: _string_ (hex integer) - - `localDateTime`: _object_ - - `date`: _object_ - - - `day`: _string_ (hex integer) - - `dayOfWeek`: _integer_ - - `dayOfYear`: _string_ (hex integer) - - `hour`: _string_ (hex integer) - - `kind`: _integer_ - - `microsecond`: _string_ (hex integer) - - `millisecond`: _string_ (hex integer) - - `minute`: _string_ (hex integer) - - `month`: _string_ (hex integer) - - `nanosecond`: _string_ (hex integer) - - `second`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `timeOfDay`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ - - `year`: _string_ (hex integer) - - `microsecond`: _string_ (hex integer) - - `millisecond`: _string_ (hex integer) - - `minute`: _string_ (hex integer) - - `month`: _string_ (hex integer) - - `nanosecond`: _string_ (hex integer) - - `offset`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ - - `second`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `timeOfDay`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ - - `totalOffsetMinutes`: _string_ (hex integer) - - `utcDateTime`: _object_ - - `date`: _object_ - - - `day`: _string_ (hex integer) - - `dayOfWeek`: _integer_ - - `dayOfYear`: _string_ (hex integer) - - `hour`: _string_ (hex integer) - - `kind`: _integer_ - - `microsecond`: _string_ (hex integer) - - `millisecond`: _string_ (hex integer) - - `minute`: _string_ (hex integer) - - `month`: _string_ (hex integer) - - `nanosecond`: _string_ (hex integer) - - `second`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `timeOfDay`: _object_ - - `days`: _string_ (hex integer) - - `hours`: _string_ (hex integer) - - `microseconds`: _string_ (hex integer) - - `milliseconds`: _string_ (hex integer) - - `minutes`: _string_ (hex integer) - - `nanoseconds`: _string_ (hex integer) - - `seconds`: _string_ (hex integer) - - `ticks`: _string_ (hex integer) - - `totalDays`: _object_ - - `totalHours`: _object_ - - `totalMicroseconds`: _object_ - - `totalMilliseconds`: _object_ - - `totalMinutes`: _object_ - - `totalNanoseconds`: _object_ - - `totalSeconds`: _object_ - - `year`: _string_ (hex integer) - - `utcTicks`: _string_ (hex integer) - - `year`: _string_ (hex integer) + - `lastUpdate`: _string_ (date-time) - `target`: _object_ - `fromBlock`: _string_ (hex integer) - `toBlock`: _string_ (hex integer) diff --git a/docs/interacting/json-rpc-ns/parity.md b/docs/interacting/json-rpc-ns/parity.md index 38ae66cb97..8d5385ca00 100644 --- a/docs/interacting/json-rpc-ns/parity.md +++ b/docs/interacting/json-rpc-ns/parity.md @@ -138,7 +138,9 @@ curl localhost:8545 \ - `to`: _string_ (address) - `transactionHash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) + +`result` may be `null` in a successful response. @@ -174,9 +176,9 @@ curl localhost:8545 \ ``` `result`: _object_ - - `active`: _string_ (hex integer) - - `connected`: _string_ (hex integer) - - `max`: _string_ (hex integer) + - `active`: _integer_ + - `connected`: _integer_ + - `max`: _integer_ - `peers`: array of _object_ - `caps`: array of _string_ - `id`: _string_ @@ -186,8 +188,8 @@ curl localhost:8545 \ - `remoteAddress`: _string_ - `protocols`: map of _object_ - `difficulty`: _string_ (hex integer) - - `headHash`: _string_ (hash) - - `version`: _string_ (hex data) + - `head`: _string_ (hash) + - `version`: _integer_ @@ -240,26 +242,10 @@ curl localhost:8545 \ - `hash`: _string_ (hash) - `input`: _string_ (hex data) - `nonce`: _string_ (hex integer) - - `publicKey`: _object_ - - `address`: _string_ (address) - - `bytes`: _string_ (hex data) - - `hash`: _string_ (hash) - - `prefixedBytes`: _string_ (hex data) - - `r`: _object_ - - `isEmpty`: _boolean_ - - `length`: _string_ (hex integer) - - `span`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) + - `publicKey`: _string_ (hex data) + - `r`: _string_ (hex data) - `raw`: _string_ (hex data) - - `s`: _object_ - - `isEmpty`: _boolean_ - - `length`: _string_ (hex integer) - - `span`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) + - `s`: _string_ (hex data) - `standardV`: _string_ (hex integer) - `to`: _string_ (address) - `transactionIndex`: _string_ (hex integer) diff --git a/docs/interacting/json-rpc-ns/proof.md b/docs/interacting/json-rpc-ns/proof.md index d7586d4d01..61d2bbbbd1 100644 --- a/docs/interacting/json-rpc-ns/proof.md +++ b/docs/interacting/json-rpc-ns/proof.md @@ -21,7 +21,7 @@ Executes a call against the state at the given block (analogous to `eth_call`) a - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) 2. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) @@ -54,10 +54,9 @@ curl localhost:8545 \ `result`: _object_ - `error`: _object_ - - `code`: _string_ (hex integer) + - `code`: _integer_ - `data`: _object_ - `message`: _string_ - - `suppressWarning`: _boolean_ - `result`: _string_ (hex data) - `witness`: _object_ - `codes`: array of _string_ (hex data) @@ -77,7 +76,8 @@ Returns the same payload as `eth_getProof` plus per-call diagnostics: `nodeLooku 1. `accountAddress`: _string_ (address) -2. `storageKeys`: array of _string_ (hex integer) +2. `storageKeys`: _object_ + - `count`: _integer_ 3. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) @@ -111,7 +111,7 @@ curl localhost:8545 \ `result`: _object_ - `meta`: _object_ - `cacheHits`: _string_ (hex integer) - - `maxDepth`: _string_ (hex integer) + - `maxDepth`: _integer_ - `nodeLookups`: _string_ (hex integer) - `proof`: _object_ - `address`: _string_ (address) @@ -122,15 +122,7 @@ curl localhost:8545 \ - `storageProofs`: array of _object_ - `key`: _string_ - `proof`: array of _string_ (hex data) - - `value`: _object_ - - `hasValue`: _boolean_ - - `value`: _object_ - - `isEmpty`: _boolean_ - - `length`: _string_ (hex integer) - - `span`: _object_ - - `isEmpty`: _boolean_ - - `item`: _object_ - - `length`: _string_ (hex integer) + - `value`: _string_ (hex data) - `storageRoot`: _string_ (hash) @@ -183,7 +175,7 @@ curl localhost:8545 \ - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) - `txProof`: array of _string_ (hex data) @@ -256,7 +248,7 @@ curl localhost:8545 \ - `to`: _string_ (address) - `transactionHash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) - `receiptProof`: array of _string_ (hex data) - `txProof`: array of _string_ (hex data) diff --git a/docs/interacting/json-rpc-ns/rbuilder.md b/docs/interacting/json-rpc-ns/rbuilder.md index 8acda83d7c..87dcfba7d0 100644 --- a/docs/interacting/json-rpc-ns/rbuilder.md +++ b/docs/interacting/json-rpc-ns/rbuilder.md @@ -18,10 +18,10 @@ Calculate the state root on top of the state trie at specified block given a set 2. `accountDiff`: map of _object_ - `balance`: _string_ (hex integer) - - `changedSlots`: map of _string_ (hex integer) - - `codeHash`: _string_ (hash) + - `changed_slots`: map of _string_ (hex integer) + - `code_hash`: _string_ (hash) - `nonce`: _string_ (hex integer) - - `selfDestructed`: _boolean_ + - `self_destructed`: _boolean_ @@ -95,9 +95,11 @@ curl localhost:8545 \ `result`: _object_ - `balance`: _string_ (hex integer) - - `codeHash`: _string_ (hash) + - `code_hash`: _string_ (hash) - `nonce`: _string_ (hex integer) +`result` may be `null` in a successful response. + diff --git a/docs/interacting/json-rpc-ns/trace.md b/docs/interacting/json-rpc-ns/trace.md index 5b3ed8b11f..3db7ec39f9 100644 --- a/docs/interacting/json-rpc-ns/trace.md +++ b/docs/interacting/json-rpc-ns/trace.md @@ -52,16 +52,7 @@ curl localhost:8545 \ - `from`: _string_ (address) - `gas`: _string_ (hex integer) - `includeInTrace`: _boolean_ - - `input`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex data) - - `length`: _string_ (hex integer) - - `underlyingArray`: _string_ (hex data) - - `underlyingLength`: _string_ (hex integer) + - `input`: _string_ (hex data) - `isPrecompiled`: _boolean_ - `result`: _object_ - `address`: _string_ (address) @@ -72,39 +63,21 @@ curl localhost:8545 \ - `subtraces`: array of _object_ - `to`: _string_ (address) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `traceAddress`: array of _integer_ - `type`: _string_ - `value`: _string_ (hex integer) - `blockHash`: _string_ (hash) - - `blockNumber`: _string_ (hex integer) + - `blockNumber`: _integer_ - `error`: _string_ - `result`: _object_ - `address`: _string_ (address) - `code`: _string_ (hex data) - `gasUsed`: _string_ (hex integer) - `output`: _string_ (hex data) - - `subtraces`: _string_ (hex integer) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `subtraces`: _integer_ + - `traceAddress`: array of _integer_ - `transactionHash`: _string_ (hash) - - `transactionPosition`: _string_ (hex integer) + - `transactionPosition`: _integer_ - `type`: _string_ @@ -122,7 +95,7 @@ curl localhost:8545 \ - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) 2. `traceTypes`: array of _string_ @@ -131,6 +104,7 @@ curl localhost:8545 \ 4. `stateOverride`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) @@ -172,16 +146,7 @@ curl localhost:8545 \ - `from`: _string_ (address) - `gas`: _string_ (hex integer) - `includeInTrace`: _boolean_ - - `input`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex data) - - `length`: _string_ (hex integer) - - `underlyingArray`: _string_ (hex data) - - `underlyingLength`: _string_ (hex integer) + - `input`: _string_ (hex data) - `isPrecompiled`: _boolean_ - `result`: _object_ - `address`: _string_ (address) @@ -192,20 +157,11 @@ curl localhost:8545 \ - `subtraces`: array of _object_ - `to`: _string_ (address) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `traceAddress`: array of _integer_ - `type`: _string_ - `value`: _string_ (hex integer) - `output`: _string_ (hex data) - - `stateChanges`: map of _object_ + - `stateDiff`: map of _object_ - `balance`: _object_ - `after`: _string_ (hex integer) - `before`: _string_ (hex integer) @@ -226,7 +182,7 @@ curl localhost:8545 \ - `memory`: _object_ - `data`: _string_ (hex data) - `offset`: _string_ (hex integer) - - `pc`: _string_ (hex integer) + - `pc`: _integer_ - `push`: array of _string_ (hex data) - `store`: _object_ - `key`: _string_ (hex data) @@ -255,7 +211,7 @@ Performs multiple traces on top of a block - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) 2. `blockParameter`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) @@ -295,16 +251,7 @@ curl localhost:8545 \ - `from`: _string_ (address) - `gas`: _string_ (hex integer) - `includeInTrace`: _boolean_ - - `input`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex data) - - `length`: _string_ (hex integer) - - `underlyingArray`: _string_ (hex data) - - `underlyingLength`: _string_ (hex integer) + - `input`: _string_ (hex data) - `isPrecompiled`: _boolean_ - `result`: _object_ - `address`: _string_ (address) @@ -315,20 +262,11 @@ curl localhost:8545 \ - `subtraces`: array of _object_ - `to`: _string_ (address) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `traceAddress`: array of _integer_ - `type`: _string_ - `value`: _string_ (hex integer) - `output`: _string_ (hex data) - - `stateChanges`: map of _object_ + - `stateDiff`: map of _object_ - `balance`: _object_ - `after`: _string_ (hex integer) - `before`: _string_ (hex integer) @@ -349,7 +287,7 @@ curl localhost:8545 \ - `memory`: _object_ - `data`: _string_ (hex data) - `offset`: _string_ (hex integer) - - `pc`: _string_ (hex integer) + - `pc`: _integer_ - `push`: array of _string_ (hex data) - `store`: _object_ - `key`: _string_ (hex data) @@ -367,8 +305,8 @@ curl localhost:8545 \ 1. `traceFilterForRpc`: _object_ - - `after`: _string_ (hex integer) - - `count`: _string_ (hex integer) + - `after`: _integer_ + - `count`: _integer_ - `fromAddress`: array of _string_ (address) - `fromBlock`: _string_ (block number or hash or either of `earliest`, `finalized`, `latest`, `pending`, or `safe`) - `toAddress`: array of _string_ (address) @@ -410,16 +348,7 @@ curl localhost:8545 \ - `from`: _string_ (address) - `gas`: _string_ (hex integer) - `includeInTrace`: _boolean_ - - `input`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex data) - - `length`: _string_ (hex integer) - - `underlyingArray`: _string_ (hex data) - - `underlyingLength`: _string_ (hex integer) + - `input`: _string_ (hex data) - `isPrecompiled`: _boolean_ - `result`: _object_ - `address`: _string_ (address) @@ -430,39 +359,21 @@ curl localhost:8545 \ - `subtraces`: array of _object_ - `to`: _string_ (address) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `traceAddress`: array of _integer_ - `type`: _string_ - `value`: _string_ (hex integer) - `blockHash`: _string_ (hash) - - `blockNumber`: _string_ (hex integer) + - `blockNumber`: _integer_ - `error`: _string_ - `result`: _object_ - `address`: _string_ (address) - `code`: _string_ (hex data) - `gasUsed`: _string_ (hex integer) - `output`: _string_ (hex data) - - `subtraces`: _string_ (hex integer) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `subtraces`: _integer_ + - `traceAddress`: array of _integer_ - `transactionHash`: _string_ (hash) - - `transactionPosition`: _string_ (hex integer) + - `transactionPosition`: _integer_ - `type`: _string_ @@ -515,16 +426,7 @@ curl localhost:8545 \ - `from`: _string_ (address) - `gas`: _string_ (hex integer) - `includeInTrace`: _boolean_ - - `input`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex data) - - `length`: _string_ (hex integer) - - `underlyingArray`: _string_ (hex data) - - `underlyingLength`: _string_ (hex integer) + - `input`: _string_ (hex data) - `isPrecompiled`: _boolean_ - `result`: _object_ - `address`: _string_ (address) @@ -535,39 +437,21 @@ curl localhost:8545 \ - `subtraces`: array of _object_ - `to`: _string_ (address) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `traceAddress`: array of _integer_ - `type`: _string_ - `value`: _string_ (hex integer) - `blockHash`: _string_ (hash) - - `blockNumber`: _string_ (hex integer) + - `blockNumber`: _integer_ - `error`: _string_ - `result`: _object_ - `address`: _string_ (address) - `code`: _string_ (hex data) - `gasUsed`: _string_ (hex integer) - `output`: _string_ (hex data) - - `subtraces`: _string_ (hex integer) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `subtraces`: _integer_ + - `traceAddress`: array of _integer_ - `transactionHash`: _string_ (hash) - - `transactionPosition`: _string_ (hex integer) + - `transactionPosition`: _integer_ - `type`: _string_ @@ -620,16 +504,7 @@ curl localhost:8545 \ - `from`: _string_ (address) - `gas`: _string_ (hex integer) - `includeInTrace`: _boolean_ - - `input`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex data) - - `length`: _string_ (hex integer) - - `underlyingArray`: _string_ (hex data) - - `underlyingLength`: _string_ (hex integer) + - `input`: _string_ (hex data) - `isPrecompiled`: _boolean_ - `result`: _object_ - `address`: _string_ (address) @@ -640,20 +515,11 @@ curl localhost:8545 \ - `subtraces`: array of _object_ - `to`: _string_ (address) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `traceAddress`: array of _integer_ - `type`: _string_ - `value`: _string_ (hex integer) - `output`: _string_ (hex data) - - `stateChanges`: map of _object_ + - `stateDiff`: map of _object_ - `balance`: _object_ - `after`: _string_ (hex integer) - `before`: _string_ (hex integer) @@ -674,7 +540,7 @@ curl localhost:8545 \ - `memory`: _object_ - `data`: _string_ (hex data) - `offset`: _string_ (hex integer) - - `pc`: _string_ (hex integer) + - `pc`: _integer_ - `push`: array of _string_ (hex data) - `store`: _object_ - `key`: _string_ (hex data) @@ -731,16 +597,7 @@ curl localhost:8545 \ - `from`: _string_ (address) - `gas`: _string_ (hex integer) - `includeInTrace`: _boolean_ - - `input`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex data) - - `length`: _string_ (hex integer) - - `underlyingArray`: _string_ (hex data) - - `underlyingLength`: _string_ (hex integer) + - `input`: _string_ (hex data) - `isPrecompiled`: _boolean_ - `result`: _object_ - `address`: _string_ (address) @@ -751,20 +608,11 @@ curl localhost:8545 \ - `subtraces`: array of _object_ - `to`: _string_ (address) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `traceAddress`: array of _integer_ - `type`: _string_ - `value`: _string_ (hex integer) - `output`: _string_ (hex data) - - `stateChanges`: map of _object_ + - `stateDiff`: map of _object_ - `balance`: _object_ - `after`: _string_ (hex integer) - `before`: _string_ (hex integer) @@ -785,7 +633,7 @@ curl localhost:8545 \ - `memory`: _object_ - `data`: _string_ (hex data) - `offset`: _string_ (hex integer) - - `pc`: _string_ (hex integer) + - `pc`: _integer_ - `push`: array of _string_ (hex data) - `store`: _object_ - `key`: _string_ (hex data) @@ -844,16 +692,7 @@ curl localhost:8545 \ - `from`: _string_ (address) - `gas`: _string_ (hex integer) - `includeInTrace`: _boolean_ - - `input`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex data) - - `length`: _string_ (hex integer) - - `underlyingArray`: _string_ (hex data) - - `underlyingLength`: _string_ (hex integer) + - `input`: _string_ (hex data) - `isPrecompiled`: _boolean_ - `result`: _object_ - `address`: _string_ (address) @@ -864,20 +703,11 @@ curl localhost:8545 \ - `subtraces`: array of _object_ - `to`: _string_ (address) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `traceAddress`: array of _integer_ - `type`: _string_ - `value`: _string_ (hex integer) - `output`: _string_ (hex data) - - `stateChanges`: map of _object_ + - `stateDiff`: map of _object_ - `balance`: _object_ - `after`: _string_ (hex integer) - `before`: _string_ (hex integer) @@ -898,7 +728,7 @@ curl localhost:8545 \ - `memory`: _object_ - `data`: _string_ (hex data) - `offset`: _string_ (hex integer) - - `pc`: _string_ (hex integer) + - `pc`: _integer_ - `push`: array of _string_ (hex data) - `store`: _object_ - `key`: _string_ (hex data) @@ -934,10 +764,11 @@ Returns parity like traces for simulated blocks - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) - `stateOverrides`: map of _object_ - `balance`: _string_ (hex integer) - `code`: _string_ (hex data) + - `hasStateChanges`: _boolean_ - `movePrecompileToAddress`: _string_ (address) - `nonce`: _string_ (hex integer) - `state`: map of _string_ (hash) @@ -979,6 +810,10 @@ curl localhost:8545 \ ``` `result`: array of _object_ + - `author`: _string_ (address) + - `baseFeePerGas`: _string_ (hex integer) + - `blobGasUsed`: _string_ (hex integer) + - `blockAccessListHash`: _string_ (hash) - `calls`: array of _object_ - `action`: _object_ - `author`: _string_ (address) @@ -988,16 +823,7 @@ curl localhost:8545 \ - `from`: _string_ (address) - `gas`: _string_ (hex integer) - `includeInTrace`: _boolean_ - - `input`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex data) - - `length`: _string_ (hex integer) - - `underlyingArray`: _string_ (hex data) - - `underlyingLength`: _string_ (hex integer) + - `input`: _string_ (hex data) - `isPrecompiled`: _boolean_ - `result`: _object_ - `address`: _string_ (address) @@ -1008,22 +834,13 @@ curl localhost:8545 \ - `subtraces`: array of _object_ - `to`: _string_ (address) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `traceAddress`: array of _integer_ - `type`: _string_ - `value`: _string_ (hex integer) - `blockHash`: _string_ (hash) - - `blockNumber`: _string_ (hex integer) + - `blockNumber`: _integer_ - `output`: _string_ (hex data) - - `stateChanges`: map of _object_ + - `stateDiff`: map of _object_ - `balance`: _object_ - `after`: _string_ (hex integer) - `before`: _string_ (hex integer) @@ -1037,7 +854,7 @@ curl localhost:8545 \ - `after`: _string_ (hex data) - `before`: _string_ (hex data) - `transactionHash`: _string_ (hash) - - `transactionPosition`: _string_ (hex integer) + - `transactionPosition`: _integer_ - `vmTrace`: _object_ - `code`: _string_ (hex data) - `operations`: array of _object_ @@ -1045,7 +862,7 @@ curl localhost:8545 \ - `memory`: _object_ - `data`: _string_ (hex data) - `offset`: _string_ (hex integer) - - `pc`: _string_ (hex integer) + - `pc`: _integer_ - `push`: array of _string_ (hex data) - `store`: _object_ - `key`: _string_ (hex data) @@ -1053,6 +870,29 @@ curl localhost:8545 \ - `sub`: _object_ - `used`: _string_ (hex integer) + - `difficulty`: _string_ (hex integer) + - `excessBlobGas`: _string_ (hex integer) + - `extraData`: _string_ (hex data) + - `gasLimit`: _string_ (hex integer) + - `gasUsed`: _string_ (hex integer) + - `hash`: _string_ (hash) + - `logsBloom`: _string_ (hex data) + - `miner`: _string_ (address) + - `mixHash`: _string_ (hash) + - `nonce`: _string_ (8-byte hex data) + - `number`: _string_ (hex integer) + - `parentBeaconBlockRoot`: _string_ (hash) + - `parentHash`: _string_ (hash) + - `receiptsRoot`: _string_ (hash) + - `requestsHash`: _string_ (hash) + - `sha3Uncles`: _string_ (hash) + - `signature`: _string_ (hex data) + - `size`: _string_ (hex integer) + - `slotNumber`: _string_ (hex integer) + - `stateRoot`: _string_ (hash) + - `step`: _integer_ + - `timestamp`: _string_ (hex integer) + - `totalDifficulty`: _string_ (hex integer) - `traces`: array of _object_ - `action`: _object_ - `author`: _string_ (address) @@ -1062,16 +902,7 @@ curl localhost:8545 \ - `from`: _string_ (address) - `gas`: _string_ (hex integer) - `includeInTrace`: _boolean_ - - `input`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex data) - - `length`: _string_ (hex integer) - - `underlyingArray`: _string_ (hex data) - - `underlyingLength`: _string_ (hex integer) + - `input`: _string_ (hex data) - `isPrecompiled`: _boolean_ - `result`: _object_ - `address`: _string_ (address) @@ -1082,22 +913,13 @@ curl localhost:8545 \ - `subtraces`: array of _object_ - `to`: _string_ (address) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `traceAddress`: array of _integer_ - `type`: _string_ - `value`: _string_ (hex integer) - `blockHash`: _string_ (hash) - - `blockNumber`: _string_ (hex integer) + - `blockNumber`: _integer_ - `output`: _string_ (hex data) - - `stateChanges`: map of _object_ + - `stateDiff`: map of _object_ - `balance`: _object_ - `after`: _string_ (hex integer) - `before`: _string_ (hex integer) @@ -1111,7 +933,7 @@ curl localhost:8545 \ - `after`: _string_ (hex data) - `before`: _string_ (hex data) - `transactionHash`: _string_ (hash) - - `transactionPosition`: _string_ (hex integer) + - `transactionPosition`: _integer_ - `vmTrace`: _object_ - `code`: _string_ (hex data) - `operations`: array of _object_ @@ -1119,7 +941,7 @@ curl localhost:8545 \ - `memory`: _object_ - `data`: _string_ (hex data) - `offset`: _string_ (hex integer) - - `pc`: _string_ (hex integer) + - `pc`: _integer_ - `push`: array of _string_ (hex data) - `store`: _object_ - `key`: _string_ (hex data) @@ -1127,6 +949,15 @@ curl localhost:8545 \ - `sub`: _object_ - `used`: _string_ (hex integer) + - `transactions`: array of _object_ + - `transactionsRoot`: _string_ (hash) + - `uncles`: array of _string_ (hash) + - `withdrawals`: array of _object_ + - `address`: _string_ (address) + - `amount`: _string_ (hex integer) + - `index`: _string_ (hex integer) + - `validatorIndex`: _string_ (hex integer) + - `withdrawalsRoot`: _string_ (hash) @@ -1176,16 +1007,7 @@ curl localhost:8545 \ - `from`: _string_ (address) - `gas`: _string_ (hex integer) - `includeInTrace`: _boolean_ - - `input`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex data) - - `length`: _string_ (hex integer) - - `underlyingArray`: _string_ (hex data) - - `underlyingLength`: _string_ (hex integer) + - `input`: _string_ (hex data) - `isPrecompiled`: _boolean_ - `result`: _object_ - `address`: _string_ (address) @@ -1196,39 +1018,21 @@ curl localhost:8545 \ - `subtraces`: array of _object_ - `to`: _string_ (address) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `traceAddress`: array of _integer_ - `type`: _string_ - `value`: _string_ (hex integer) - `blockHash`: _string_ (hash) - - `blockNumber`: _string_ (hex integer) + - `blockNumber`: _integer_ - `error`: _string_ - `result`: _object_ - `address`: _string_ (address) - `code`: _string_ (hex data) - `gasUsed`: _string_ (hex integer) - `output`: _string_ (hex data) - - `subtraces`: _string_ (hex integer) - - `traceAddress`: _object_ - - `isNotNull`: _boolean_ - - `isNotNullOrEmpty`: _boolean_ - - `isNull`: _boolean_ - - `isNullOrEmpty`: _boolean_ - - `isUncapped`: _boolean_ - - `item`: _string_ (hex integer) - - `length`: _string_ (hex integer) - - `underlyingArray`: array of _string_ (hex integer) - - `underlyingLength`: _string_ (hex integer) + - `subtraces`: _integer_ + - `traceAddress`: array of _integer_ - `transactionHash`: _string_ (hash) - - `transactionPosition`: _string_ (hex integer) + - `transactionPosition`: _integer_ - `type`: _string_ diff --git a/docs/interacting/json-rpc-ns/txpool.md b/docs/interacting/json-rpc-ns/txpool.md index b2d4c7e607..536f26366e 100644 --- a/docs/interacting/json-rpc-ns/txpool.md +++ b/docs/interacting/json-rpc-ns/txpool.md @@ -46,7 +46,7 @@ map of _object_ - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) - `queued`: map of map of _object_ map of _object_ - `blockHash`: _string_ (hash) @@ -55,7 +55,7 @@ map of _object_ - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) @@ -104,7 +104,7 @@ curl localhost:8545 \ - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) - `queued`: map of _object_ - `blockHash`: _string_ (hash) - `blockNumber`: _string_ (hex integer) @@ -112,7 +112,7 @@ curl localhost:8545 \ - `gas`: _string_ (hex integer) - `hash`: _string_ (hash) - `transactionIndex`: _string_ (hex integer) - - `type`: _integer_ + - `type`: _string_ (transaction type) diff --git a/docs/monitoring/metrics/metrics.md b/docs/monitoring/metrics/metrics.md index 5f0da7a28e..55ab07c1bc 100644 --- a/docs/monitoring/metrics/metrics.md +++ b/docs/monitoring/metrics/metrics.md @@ -109,6 +109,14 @@ Currently, Nethermind provides the following options to monitor and collect metr Total number of chain reorganizations +- #### `nethermind_retained_receipt_bodies` \{#retained_receipt_bodies\} + + Number of receipt bodies retained in memory while awaiting durable state-history capture (receipt derivation only). + +- #### `nethermind_retained_receipt_body_bytes` \{#retained_receipt_body_bytes\} + + Estimated bytes held by the receipt bodies retained while awaiting durable state-history capture (receipt derivation only). + - #### `nethermind_state_merkleization_time` \{#state_merkleization_time\} State root calculation time @@ -157,6 +165,30 @@ Currently, Nethermind provides the following options to monitor and collect metr Database writes per database - #### `nethermind_detailed_metrics_enabled` \{#detailed_metrics_enabled\} +- #### `nethermind_full_pruning_count` \{#full_pruning_count\} + + Number of full prunings completed since the node started. + +- #### `nethermind_full_pruning_last_duration_seconds` \{#full_pruning_last_duration_seconds\} + + Duration of the last full pruning's trie copy and commit (excludes waiting for a suitable state root), in seconds. + +- #### `nethermind_pre_block_cache_account_hits` \{#pre_block_cache_account_hits\} + + Number of pre-block (prewarmer-shared) cache hits for accounts, counted on the consumer scope only (populator probes excluded); first-in-block touches, so hits/(hits+misses) = prewarm coverage. + +- #### `nethermind_pre_block_cache_account_misses` \{#pre_block_cache_account_misses\} + + Number of pre-block (prewarmer-shared) cache misses for accounts, counted on the consumer scope only (populator probes excluded). + +- #### `nethermind_pre_block_cache_storage_hits` \{#pre_block_cache_storage_hits\} + + Number of pre-block (prewarmer-shared) cache hits for storage slots, counted on the consumer scope only (populator probes excluded); first-in-block touches, so hits/(hits+misses) = prewarm coverage. + +- #### `nethermind_pre_block_cache_storage_misses` \{#pre_block_cache_storage_misses\} + + Number of pre-block (prewarmer-shared) cache misses for storage slots, counted on the consumer scope only (populator probes excluded). + - #### `nethermind_prewarmer_get_time` \{#prewarmer_get_time\} Prewarmer get operation times @@ -264,10 +296,6 @@ Currently, Nethermind provides the following options to monitor and collect metr Number of EVM exceptions thrown by contracts. -- #### `nethermind_exp_opcode` \{#exp_opcode\} - - Number of EXP opcodes executed. - - #### `nethermind_gas_price_ave` \{#gas_price_ave\} Mean tx gas price in block @@ -284,10 +312,6 @@ Currently, Nethermind provides the following options to monitor and collect metr Minimum tx gas price in block -- #### `nethermind_m_copy_opcode` \{#m_copy_opcode\} - - Number of MCOPY opcodes executed. - - #### `nethermind_main_thread_calls` \{#main_thread_calls\} Number of calls to other contracts on main processing thread. @@ -368,10 +392,6 @@ Currently, Nethermind provides the following options to monitor and collect metr Number of storage slot writes during execution. -- #### `nethermind_tload_opcode` \{#tload_opcode\} - - Number of TLOAD opcodes executed. - - #### `nethermind_total_background_tasks_dropped` \{#total_background_tasks_dropped\} Total number of background tasks dropped because queue was full. @@ -384,10 +404,6 @@ Currently, Nethermind provides the following options to monitor and collect metr Total number of tasks queued for background execution. -- #### `nethermind_tstore_opcode` \{#tstore_opcode\} - - Number of TSTORE opcodes executed. - ### Evm.Precompiles @@ -458,17 +474,17 @@ Currently, Nethermind provides the following options to monitor and collect metr ### History -- #### `nethermind_block_access_list_pruning_cutoff_blocknumber` \{#block_access_list_pruning_cutoff_blocknumber\} +- #### `nethermind_block_access_list_heights_reclaimed` \{#block_access_list_heights_reclaimed\} - The cutoff block number from which historical block access lists will be pruned. + The number of historical block access list heights reclaimed by pruning (since restart). Heights, not stored access lists - see BlockHeightsReclaimed. -- #### `nethermind_block_access_lists_pruned` \{#block_access_lists_pruned\} +- #### `nethermind_block_access_list_pruning_cutoff_blocknumber` \{#block_access_list_pruning_cutoff_blocknumber\} - The number of the historical block access lists that have been pruned (since restart). + The cutoff block number from which historical block access lists will be pruned. -- #### `nethermind_blocks_pruned` \{#blocks_pruned\} +- #### `nethermind_block_heights_reclaimed` \{#block_heights_reclaimed\} - The number of the historical blocks that have been pruned (since restart). + The number of historical block heights reclaimed by pruning (since restart). Heights, not stored blocks: a range is dropped in one operation and never learns how many of its heights held one. - #### `nethermind_oldest_stored_block_access_list_block_number` \{#oldest_stored_block_access_list_block_number\} @@ -482,6 +498,14 @@ Currently, Nethermind provides the following options to monitor and collect metr The cutoff block number from which historical blocks will be pruned. +- #### `nethermind_sliced_receipts_retained` \{#sliced_receipts_retained\} + + The number of historical heights kept past the pruning cutoff, with both their receipts and their body, because a configured slice address appeared in them (since restart). Counted from the bloom candidates, so a false positive is included. + +- #### `nethermind_transaction_index_entries_pruned` \{#transaction_index_entries_pruned\} + + The number of transaction index entries dropped because the block they name is no longer retained (since restart). + ### JsonRpc @@ -501,6 +525,10 @@ Currently, Nethermind provides the following options to monitor and collect metr Number of JSON RPC requests that were invalid. +- #### `nethermind_json_rpc_overload_rejections` \{#json_rpc_overload_rejections\} + + Number of JSON RPC requests rejected or timed out at a concurrency cap (module pool or override-environment limit). A nonzero rate means callers receive 'Too many requests' — consider raising JsonRpc.EthModuleConcurrentInstances. + - #### `nethermind_json_rpc_request_deserialization_failures` \{#json_rpc_request_deserialization_failures\} Number of JSON RPC requests that failed JSON deserialization. @@ -595,6 +623,10 @@ Currently, Nethermind provides the following options to monitor and collect metr Number of sent discovery message +- #### `nethermind_discovery_messages_sent_by_protocol` \{#discovery_messages_sent_by_protocol\} + + Number of sent discovery messages by protocol + - #### `nethermind_handshake_timeouts` \{#handshake_timeouts\} Number of devp2p handshake timeouts @@ -658,9 +690,9 @@ Currently, Nethermind provides the following options to monitor and collect metr Nodes that have been committed since the session start. These nodes may have been pruned, persisted or replaced. -- #### `nethermind_deep_pruning_time` \{#deep_pruning_time\} +- #### `nethermind_deep_pruning_time_ms` \{#deep_pruning_time_ms\} - Time taken by the last deep pruning. + Time taken by the last deep pruning, in milliseconds. - #### `nethermind_dirty_memory_used_by_cache` \{#dirty_memory_used_by_cache\} @@ -694,17 +726,17 @@ Currently, Nethermind provides the following options to monitor and collect metr Nodes that have been persisted since the session start. -- #### `nethermind_persisted_node_pruning_time` \{#persisted_node_pruning_time\} +- #### `nethermind_persisted_node_pruning_time_ms` \{#persisted_node_pruning_time_ms\} - Time taken by the last persisted node pruning. + Time taken by the last persisted node pruning, in milliseconds. - #### `nethermind_pruned_transient_nodes_count` \{#pruned_transient_nodes_count\} Nodes that have been removed from the cache during pruning because they were no longer needed. -- #### `nethermind_pruning_time` \{#pruning_time\} +- #### `nethermind_pruning_time_ms` \{#pruning_time_ms\} - Time taken by the last pruning. + Time taken by the last pruning, in milliseconds. - #### `nethermind_removed_node_count` \{#removed_node_count\} @@ -714,9 +746,9 @@ Currently, Nethermind provides the following options to monitor and collect metr Number of nodes that have been exactly the same as other nodes in the cache when committing. -- #### `nethermind_snapshot_persistence_time` \{#snapshot_persistence_time\} +- #### `nethermind_snapshot_persistence_time_ms` \{#snapshot_persistence_time_ms\} - Time taken by the last snapshot persistence. + Time taken by the last snapshot persistence, in milliseconds. ### Runner @@ -798,6 +830,10 @@ Currently, Nethermind provides the following options to monitor and collect metr ### State.Flat +- #### `nethermind_active_persisted_snapshot_count` \{#active_persisted_snapshot_count\} + + Number of live PersistedSnapshot instances (refcount > 0), by tier + - #### `nethermind_active_pooled_resource` \{#active_pooled_resource\} Active pooled resources by category and type @@ -806,6 +842,30 @@ Currently, Nethermind provides the following options to monitor and collect metr Active snapshot bundles +- #### `nethermind_arena_allocated_bytes` \{#arena_allocated_bytes\} + + Allocated bytes in arena files (sum of per-file Frontier) + +- #### `nethermind_arena_file_count` \{#arena_file_count\} + + Number of arena (mmap metadata) files backing persisted snapshots + +- #### `nethermind_arena_reservation_bytes` \{#arena_reservation_bytes\} + + Live arena reservation bytes + +- #### `nethermind_arena_reservation_count` \{#arena_reservation_count\} + + Live arena reservations + +- #### `nethermind_blob_allocated_bytes` \{#blob_allocated_bytes\} + + Allocated bytes in blob files (sum of per-file Frontier) + +- #### `nethermind_blob_file_count` \{#blob_file_count\} + + Number of blob (pread RLP) files backing persisted snapshots + - #### `nethermind_cached_pooled_resource` \{#cached_pooled_resource\} Cached pooled resources by category and type @@ -822,176 +882,180 @@ Currently, Nethermind provides the following options to monitor and collect metr Estimated memory used by compacted snapshot dictionaries in bytes +- #### `nethermind_compactor_stall_time` \{#compactor_stall_time\} + + Time block processing stalled waiting for the compactor job channel to drain (Stopwatch ticks) + - #### `nethermind_created_pooled_resource` \{#created_pooled_resource\} Created pooled resources by category and type -- #### `nethermind_flat_persistence_snapshot_size` \{#flat_persistence_snapshot_size\} +- #### `nethermind_flat_history_capture_disabled` \{#flat_history_capture_disabled\} - Persistence write size + 1 when history capture has self-disabled (permanent gap, reorged capture, or repeated write failures); as-of reads above the watermark are refused until the flatHistory DB is resynced -- #### `nethermind_flat_persistence_time` \{#flat_persistence_time\} +- #### `nethermind_flat_history_floor` \{#flat_history_floor\} - Time for persistence job + Lowest block still answerable from flat history (the retention floor); 0 when no window is configured or none has been pruned yet -- #### `nethermind_importer_entries_count` \{#importer_entries_count\} +- #### `nethermind_flat_history_poisoned_destructs` \{#flat_history_poisoned_destructs\} - Importer entries count + Number of accounts whose storage history was poisoned because a self-destruct exceeded the per-slot enumeration cap; storage reads below those blocks fail closed for that account -- #### `nethermind_importer_entries_count_flat` \{#importer_entries_count_flat\} +- #### `nethermind_flat_history_prune_passes_yielded` \{#flat_history_prune_passes_yielded\} - Importer entries count flat + Number of history window pruner passes that left work for the next pass - the wall-clock budget expired mid-sweep, a floor drain did not finish inside it, or a completed cycle found the floor had advanced under it and queued the next cycle -- #### `nethermind_read_only_snapshot_bundle_times` \{#read_only_snapshot_bundle_times\} +- #### `nethermind_flat_history_pruned_rows` \{#flat_history_pruned_rows\} - Readonly snapshot bundle times + Number of rows deleted by the history window pruner -- #### `nethermind_snapshot_bundle_size` \{#snapshot_bundle_size\} +- #### `nethermind_flat_history_watermark` \{#flat_history_watermark\} - Average snapshot bundle size in terms of num of snapshot + Highest block whose state history is captured (the contiguous-from-genesis watermark); 0 when history is disabled or empty -- #### `nethermind_snapshot_count` \{#snapshot_count\} +- #### `nethermind_flat_persistence_snapshot_size` \{#flat_persistence_snapshot_size\} - Number of snapshots + Persistence write size -- #### `nethermind_snapshot_memory` \{#snapshot_memory\} +- #### `nethermind_flat_persistence_time` \{#flat_persistence_time\} - Estimated memory used by snapshots in bytes + Time for persistence job -- #### `nethermind_total_snapshot_memory` \{#total_snapshot_memory\} +- #### `nethermind_importer_entries_count` \{#importer_entries_count\} - Total estimated snapshot memory in bytes - - -### StateComposition + Importer entries count -- #### `nethermind_state_comp_account_branch_occupancy` \{#state_comp_account_branch_occupancy\} +- #### `nethermind_importer_entries_count_flat` \{#importer_entries_count_flat\} - Account trie branch nodes grouped by child count + Importer entries count flat -- #### `nethermind_state_comp_account_trie_branches` \{#state_comp_account_trie_branches\} +- #### `nethermind_page_tracker_evictions_dispatched` \{#page_tracker_evictions_dispatched\} - Branch nodes in account trie + Page-tracker evictions dispatched off the drain ring (madvise issued) -- #### `nethermind_state_comp_account_trie_bytes` \{#state_comp_account_trie_bytes\} +- #### `nethermind_page_tracker_evictions_inline_fallback` \{#page_tracker_evictions_inline_fallback\} - Total bytes of account trie nodes + Page-tracker evictions dispatched inline because the drain ring was full -- #### `nethermind_state_comp_account_trie_extensions` \{#state_comp_account_trie_extensions\} +- #### `nethermind_page_tracker_metadata_bytes` \{#page_tracker_metadata_bytes\} - Extension nodes in account trie + Unmanaged metadata bytes used by the page-residency tracker (slot + meta arrays) -- #### `nethermind_state_comp_account_trie_leaves` \{#state_comp_account_trie_leaves\} +- #### `nethermind_page_tracker_pages_refreshed` \{#page_tracker_pages_refreshed\} - Leaf nodes in account trie + Page-tracker resident pages re-touched by the keep-warm hand to hold their page-cache position -- #### `nethermind_state_comp_accounts_total` \{#state_comp_accounts_total\} +- #### `nethermind_page_tracker_resident_bytes` \{#page_tracker_resident_bytes\} - Total accounts in state + Currently-bounded resident bytes in the page-residency tracker -- #### `nethermind_state_comp_avg_account_path_depth` \{#state_comp_avg_account_path_depth\} +- #### `nethermind_persisted_snapshot_bloom_count` \{#persisted_snapshot_bloom_count\} - Weighted average depth of account trie leaf paths + Number of live persisted-snapshot bloom filters (one per RefCountedBloomFilter; a bloom shared across snapshots counts once) -- #### `nethermind_state_comp_avg_branch_occupancy` \{#state_comp_avg_branch_occupancy\} +- #### `nethermind_persisted_snapshot_bloom_memory` \{#persisted_snapshot_bloom_memory\} - Average children per account-trie branch node + Memory used by per-snapshot blooms (address/slot/self-destruct/trie) in bytes -- #### `nethermind_state_comp_avg_storage_path_depth` \{#state_comp_avg_storage_path_depth\} +- #### `nethermind_persisted_snapshot_compact_time` \{#persisted_snapshot_compact_time\} - Weighted average depth of storage trie leaf paths + Persisted-snapshot compaction wall-clock time, by compact size -- #### `nethermind_state_comp_baseline_invalidations` \{#state_comp_baseline_invalidations\} +- #### `nethermind_persisted_snapshot_compacted_size` \{#persisted_snapshot_compacted_size\} - Times the incremental baseline was detected as stale (prevRoot missing from DB) and auto-rescan was scheduled + Persisted-snapshot compaction output size, by compact size -- #### `nethermind_state_comp_code_bytes_total` \{#state_comp_code_bytes_total\} +- #### `nethermind_persisted_snapshot_compactions` \{#persisted_snapshot_compactions\} - Aggregate contract bytecode size, deduplicated by code hash + Number of persisted snapshot compactions performed -- #### `nethermind_state_comp_contracts_total` \{#state_comp_contracts_total\} +- #### `nethermind_persisted_snapshot_convert_time` \{#persisted_snapshot_convert_time\} - Total contracts (accounts with code) + Time to convert one in-memory snapshot into a persisted snapshot -- #### `nethermind_state_comp_contracts_with_storage` \{#state_comp_contracts_with_storage\} +- #### `nethermind_persisted_snapshot_count` \{#persisted_snapshot_count\} - Contracts with non-empty storage + Number of persisted snapshots on disk, by tier -- #### `nethermind_state_comp_diff_errors` \{#state_comp_diff_errors\} +- #### `nethermind_persisted_snapshot_memory` \{#persisted_snapshot_memory\} - Total diff computation errors + Estimated memory used by persisted snapshots in bytes, by tier -- #### `nethermind_state_comp_diffs_applied` \{#state_comp_diffs_applied\} +- #### `nethermind_persisted_snapshot_prunes` \{#persisted_snapshot_prunes\} - Total incremental diffs applied + Number of persisted snapshot prunes -- #### `nethermind_state_comp_diffs_since_baseline` \{#state_comp_diffs_since_baseline\} +- #### `nethermind_persisted_snapshot_size` \{#persisted_snapshot_size\} - Diffs applied since last full scan + Persisted-snapshot byte size -- #### `nethermind_state_comp_empty_accounts` \{#state_comp_empty_accounts\} +- #### `nethermind_read_only_snapshot_bundle_skip_time` \{#read_only_snapshot_bundle_skip_time\} - Accounts with no code and no storage + Time spent skipping accounts/slots/state-rlp/storage-rlp on a read-only snapshot bundle access, by part -- #### `nethermind_state_comp_incremental_block` \{#state_comp_incremental_block\} +- #### `nethermind_read_only_snapshot_bundle_times` \{#read_only_snapshot_bundle_times\} - Block number of latest incremental update + Readonly snapshot bundle times -- #### `nethermind_state_comp_max_account_depth` \{#state_comp_max_account_depth\} +- #### `nethermind_snapshot_bundle_block_number_depth` \{#snapshot_bundle_block_number_depth\} - Deepest occupied level of the account trie + Snapshot-bundle depth in blocks, by part (in_memory / persisted) -- #### `nethermind_state_comp_max_storage_depth` \{#state_comp_max_storage_depth\} +- #### `nethermind_snapshot_bundle_persisted_snapshot_memory` \{#snapshot_bundle_persisted_snapshot_memory\} - Deepest occupied level across all storage tries (Geth convention: raw depth + 1) + Total persisted-snapshot reservation bytes in the most recently assembled read-only snapshot bundle (the bytes a tip reader pays for) -- #### `nethermind_state_comp_scan_block` \{#state_comp_scan_block\} +- #### `nethermind_snapshot_bundle_persisted_snapshot_size` \{#snapshot_bundle_persisted_snapshot_size\} - Block number of last completed full scan + Number of persisted snapshots in the most recently assembled snapshot bundle -- #### `nethermind_state_comp_scan_duration_seconds` \{#state_comp_scan_duration_seconds\} +- #### `nethermind_snapshot_bundle_size` \{#snapshot_bundle_size\} - Duration of last completed full scan in seconds + Average snapshot bundle size in terms of num of snapshot -- #### `nethermind_state_comp_scan_missing_nodes` \{#state_comp_scan_missing_nodes\} +- #### `nethermind_snapshot_count` \{#snapshot_count\} - Times a full or contract scan encountered a missing trie node (pruned/corrupt DB); the resulting stats are incomplete + Number of snapshots -- #### `nethermind_state_comp_scans_completed` \{#state_comp_scans_completed\} +- #### `nethermind_snapshot_memory` \{#snapshot_memory\} - Total full scans completed + Estimated memory used by snapshots in bytes -- #### `nethermind_state_comp_slot_count_histogram` \{#state_comp_slot_count_histogram\} +- #### `nethermind_total_snapshot_memory` \{#total_snapshot_memory\} - Contracts grouped by log2 storage slot count bucket + Total estimated snapshot memory in bytes + + +### StateDiffsWriter -- #### `nethermind_state_comp_storage_slots_total` \{#state_comp_storage_slots_total\} +- #### `nethermind_state_diffs_writer_blocks_written_total` \{#state_diffs_writer_blocks_written_total\} - Total storage slots across all contracts + Total blocks for which a BlockDiffRecord was successfully written -- #### `nethermind_state_comp_storage_trie_branches` \{#state_comp_storage_trie_branches\} +- #### `nethermind_state_diffs_writer_encode_errors_total` \{#state_diffs_writer_encode_errors_total\} - Branch nodes in all storage tries + BlockDiffRecord encode/write failures, broken down by reason -- #### `nethermind_state_comp_storage_trie_bytes` \{#state_comp_storage_trie_bytes\} +- #### `nethermind_state_diffs_writer_head_lag_blocks` \{#state_diffs_writer_head_lag_blocks\} - Total bytes of all storage trie nodes + Difference between chain head and last block written by the diffs writer -- #### `nethermind_state_comp_storage_trie_extensions` \{#state_comp_storage_trie_extensions\} +- #### `nethermind_state_diffs_writer_last_block` \{#state_diffs_writer_last_block\} - Extension nodes in all storage tries + Highest block number written to the BlockDiffs CF -- #### `nethermind_state_comp_storage_trie_leaves` \{#state_comp_storage_trie_leaves\} +- #### `nethermind_state_diffs_writer_payload_bytes_total` \{#state_diffs_writer_payload_bytes_total\} - Leaf nodes in all storage tries + Cumulative bytes of BlockDiffRecord payloads written to RocksDB -- #### `nethermind_state_comp_trie_depth_bytes` \{#state_comp_trie_depth_bytes\} +- #### `nethermind_state_diffs_writer_pruner_rows_removed_total` \{#state_diffs_writer_pruner_rows_removed_total\} - Trie bytes per depth + Total BlockDiffs CF rows removed by the background pruner -- #### `nethermind_state_comp_trie_depth_nodes` \{#state_comp_trie_depth_nodes\} +- #### `nethermind_state_diffs_writer_reorgs_total` \{#state_diffs_writer_reorgs_total\} - Trie nodes per depth, by trie and node kind + New-head events that did not build on the last-written block (reorg or non-contiguous jump) ### Synchronization @@ -1004,6 +1068,10 @@ Currently, Nethermind provides the following options to monitor and collect metr Number of sync peers. +- #### `nethermind_sync_time_in_mode_seconds` \{#sync_time_in_mode_seconds\} + + Cumulative wall-clock seconds spent with each sync mode active. Modes can overlap, so the sum across modes may exceed the total sync time; retained after sync completes. + ### Trie