debug namespace
debug_deleteChainSlice
Deletes a slice of a chain from the tree on all branches (Nethermind specific).
- Parameters
- Request
- Response
-
startNumber
: string (hex integer) -
force
: boolean
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_deleteChainSlice",
"params": [startNumber, force]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: string (hex integer)
debug_getBadBlocks
Return list of invalid blocks.
- Request
- Response
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_getBadBlocks",
"params": []
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: array of object
block
: objectauthor
: string (address)baseFeePerGas
: string (hex integer)blobGasUsed
: 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 (hex data)number
: string (hex integer)parentBeaconBlockRoot
: string (hash)parentHash
: string (hash)receiptsRoot
: string (hash)sha3Uncles
: string (hash)signature
: string (hex data)size
: string (hex integer)stateRoot
: string (hash)step
: string (hex integer)timestamp
: string (hex integer)totalDifficulty
: string (hex integer)transactions
: array of objecttransactionsRoot
: string (hash)uncles
: array of string (hash)withdrawals
: array of objectaddress
: string (address)amountInGwei
: string (hex integer)amountInWei
: string (hex integer)index
: string (hex integer)validatorIndex
: string (hex integer)
withdrawalsRoot
: string (hash)
hash
: string (hash)rlp
: string (hex data)
debug_getBlockRlp
Retrieves a block in the RLP-serialized form.
- Parameters
- Request
- Response
number
: string (hex integer)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_getBlockRlp",
"params": [number]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: string (hex data)
debug_getBlockRlpByHash
Retrieves a block in the RLP-serialized form.
- Parameters
- Request
- Response
hash
: string (hash)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_getBlockRlpByHash",
"params": [hash]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: string (hex data)
debug_getChainLevel
Retrieves a representation of tree branches on a given chain level (Nethermind specific).
- Parameters
- Request
- Response
number
: string (hex integer)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_getChainLevel",
"params": [number]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: object
blockInfos
: array of objectblockHash
: string (hash)isFinalized
: booleantotalDifficulty
: string (hex integer)wasProcessed
: boolean
hasBlockOnMainChain
: boolean
debug_getConfigValue
Retrieves the Nethermind configuration value, e.g. JsonRpc.Enabled
- Parameters
- Request
- Response
-
category
: string -
name
: string
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_getConfigValue",
"params": [category, name]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: object
debug_getRawBlock
Get Raw Block format.
- Parameters
- Request
- Response
blockParameter
: string (block number or hash or either ofearliest
,finalized
,latest
,pending
, orsafe
)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_getRawBlock",
"params": [blockParameter]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: string (hex data)
debug_getRawHeader
Get Raw Header format.
- Parameters
- Request
- Response
blockParameter
: string (block number or hash or either ofearliest
,finalized
,latest
,pending
, orsafe
)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_getRawHeader",
"params": [blockParameter]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: string (hex data)
debug_getRawReceipts
Get Raw Receipt format.
- Parameters
- Request
- Response
blockParameter
: string (block number or hash or either ofearliest
,finalized
,latest
,pending
, orsafe
)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_getRawReceipts",
"params": [blockParameter]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: array of string (hex data)
debug_getRawTransaction
Get Raw Transaction format.
- Parameters
- Request
- Response
transactionHash
: string (hash)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_getRawTransaction",
"params": [transactionHash]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: string (hex data)
debug_getSyncStage
Retrives Nethermind Sync Stage, With extra Metadata
- Request
- Response
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_getSyncStage",
"params": []
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: object
currentStage
: string
debug_insertReceipts
Insert receipts for the block after verifying receipts root correctness.
- Parameters
- Request
- Response
-
blockParameter
: string (block number or hash or either ofearliest
,finalized
,latest
,pending
, orsafe
) -
receiptForRpc
: array of object
blobGasPrice
: string (hex integer)blobGasUsed
: string (hex integer)blockHash
: string (hash)blockNumber
: string (hex integer)contractAddress
: string (address)cumulativeGasUsed
: string (hex integer)effectiveGasPrice
: string (hex integer)error
: stringfrom
: string (address)gasUsed
: string (hex integer)logs
: array of objectaddress
: string (address)blockHash
: string (hash)blockNumber
: string (hex integer)data
: string (hex data)logIndex
: string (hex integer)removed
: booleantopics
: array of string (hash)transactionHash
: string (hash)transactionIndex
: string (hex integer)
logsBloom
: string (hex data)root
: string (hash)status
: string (hex integer)to
: string (address)transactionHash
: string (hash)transactionIndex
: string (hex integer)type
: integer
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_insertReceipts",
"params": [blockParameter, receiptForRpc]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: boolean
debug_migrateReceipts
Sets the block number up to which receipts will be migrated to (Nethermind specific).
- Parameters
- Request
- Response
blockNumber
: string (hex integer)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_migrateReceipts",
"params": [blockNumber]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: boolean
debug_resetHead
Updates / resets head block - use only when the node got stuck due to DB / memory corruption (Nethermind specific).
- Parameters
- Request
- Response
blockHash
: string (hash)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_resetHead",
"params": [blockHash]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: boolean
debug_standardTraceBlockToFile
Writes to a file the full stack trace of all invoked opcodes of the transaction specified (or all transactions if not specified) that was included in the block specified. The parent of the block must be present or it will fail.
- Parameters
- Request
- Response
-
blockHash
: string (hash) -
options
: objectdisableMemory
: booleandisableStack
: booleandisableStorage
: booleanenableMemory
: booleantimeout
: stringtracer
: stringtracerConfig
: objecthasValue
: booleanvalue
: objectitem
: objectvalueKind
: integer
txHash
: string (hash)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_standardTraceBlockToFile",
"params": [blockHash, options]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: array of string
debug_traceBlock
Returns the full stack trace of all invoked opcodes of all transactions that were included in the block specified. The parent of the block must be present or it will fail.
- Parameters
- Request
- Response
-
blockRlp
: string (hex data) -
options
: objectdisableMemory
: booleandisableStack
: booleandisableStorage
: booleanenableMemory
: booleantimeout
: stringtracer
: stringtracerConfig
: objecthasValue
: booleanvalue
: objectitem
: objectvalueKind
: integer
txHash
: string (hash)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_traceBlock",
"params": [blockRlp, options]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: array of object
customTracerResult
: objectvalue
: object
entries
: array of objectdepth
: string (hex integer)error
: stringgas
: string (hex integer)gasCost
: string (hex integer)memory
: array of stringopcode
: stringprogramCounter
: string (hex integer)stack
: array of stringstorage
: map of string
failed
: booleangas
: string (hex integer)returnValue
: string (hex data)storagesByDepth
: array of map of string
debug_traceBlockByHash
Similar to debug_traceBlock, this method accepts a block hash and replays the block that is already present in the database.
- Parameters
- Request
- Response
-
blockHash
: string (hash) -
options
: objectdisableMemory
: booleandisableStack
: booleandisableStorage
: booleanenableMemory
: booleantimeout
: stringtracer
: stringtracerConfig
: objecthasValue
: booleanvalue
: objectitem
: objectvalueKind
: integer
txHash
: string (hash)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_traceBlockByHash",
"params": [blockHash, options]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: array of object
customTracerResult
: objectvalue
: object
entries
: array of objectdepth
: string (hex integer)error
: stringgas
: string (hex integer)gasCost
: string (hex integer)memory
: array of stringopcode
: stringprogramCounter
: string (hex integer)stack
: array of stringstorage
: map of string
failed
: booleangas
: string (hex integer)returnValue
: string (hex data)storagesByDepth
: array of map of string
debug_traceBlockByNumber
Similar to debug_traceBlock, this method accepts a block number as well as "latest" or "finalized" and replays the block that is already present in the database.
- Parameters
- Request
- Response
-
blockParameter
: string (block number or hash or either ofearliest
,finalized
,latest
,pending
, orsafe
) -
options
: objectdisableMemory
: booleandisableStack
: booleandisableStorage
: booleanenableMemory
: booleantimeout
: stringtracer
: stringtracerConfig
: objecthasValue
: booleanvalue
: objectitem
: objectvalueKind
: integer
txHash
: string (hash)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_traceBlockByNumber",
"params": [blockParameter, options]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: array of object
customTracerResult
: objectvalue
: object
entries
: array of objectdepth
: string (hex integer)error
: stringgas
: string (hex integer)gasCost
: string (hex integer)memory
: array of stringopcode
: stringprogramCounter
: string (hex integer)stack
: array of stringstorage
: map of string
failed
: booleangas
: string (hex integer)returnValue
: string (hex data)storagesByDepth
: array of map of string
debug_traceCall
This method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The block can be specified either by hash or by number. It takes the same input object as a eth_call. It returns the same output as debug_traceTransaction.
- Parameters
- Request
- Response
-
call
: objectaccessList
: array of objectaddress
: string (address)storageKeys
: array of string (hex integer)
blobVersionedHashes
: array of string (hex data)blockHash
: string (hash)blockNumber
: string (hex integer)chainId
: string (hex integer)data
: string (hex data)from
: string (address)gas
: string (hex integer)gasPrice
: string (hex integer)hash
: string (hash)input
: string (hex data)isSystemTx
: booleanmaxFeePerBlobGas
: string (hex integer)maxFeePerGas
: string (hex integer)maxPriorityFeePerGas
: string (hex integer)mint
: string (hex integer)nonce
: string (hex integer)r
: string (hex integer)s
: string (hex integer)sourceHash
: string (hash)to
: string (address)transactionIndex
: string (hex integer)type
: integerv
: string (hex integer)value
: string (hex integer)yParity
: string (hex integer)
-
blockParameter
: string (block number or hash or either ofearliest
,finalized
,latest
,pending
, orsafe
) -
options
: objectdisableMemory
: booleandisableStack
: booleandisableStorage
: booleanenableMemory
: booleantimeout
: stringtracer
: stringtracerConfig
: objecthasValue
: booleanvalue
: objectitem
: objectvalueKind
: integer
txHash
: string (hash)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_traceCall",
"params": [call, blockParameter, options]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: object
customTracerResult
: objectvalue
: object
entries
: array of objectdepth
: string (hex integer)error
: stringgas
: string (hex integer)gasCost
: string (hex integer)memory
: array of stringopcode
: stringprogramCounter
: string (hex integer)stack
: array of stringstorage
: map of string
failed
: booleangas
: string (hex integer)returnValue
: string (hex data)storagesByDepth
: array of map of string
debug_traceTransaction
This method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
- Parameters
- Request
- Response
-
transactionHash
: string (hash) -
options
: objectdisableMemory
: booleandisableStack
: booleandisableStorage
: booleanenableMemory
: booleantimeout
: stringtracer
: stringtracerConfig
: objecthasValue
: booleanvalue
: objectitem
: objectvalueKind
: integer
txHash
: string (hash)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_traceTransaction",
"params": [transactionHash, options]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: object
customTracerResult
: objectvalue
: object
entries
: array of objectdepth
: string (hex integer)error
: stringgas
: string (hex integer)gasCost
: string (hex integer)memory
: array of stringopcode
: stringprogramCounter
: string (hex integer)stack
: array of stringstorage
: map of string
failed
: booleangas
: string (hex integer)returnValue
: string (hex data)storagesByDepth
: array of map of string
debug_traceTransactionByBlockAndIndex
- Parameters
- Request
- Response
-
blockParameter
: string (block number or hash or either ofearliest
,finalized
,latest
,pending
, orsafe
) -
txIndex
: string (hex integer) -
options
: objectdisableMemory
: booleandisableStack
: booleandisableStorage
: booleanenableMemory
: booleantimeout
: stringtracer
: stringtracerConfig
: objecthasValue
: booleanvalue
: objectitem
: objectvalueKind
: integer
txHash
: string (hash)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_traceTransactionByBlockAndIndex",
"params": [blockParameter, txIndex, options]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: object
customTracerResult
: objectvalue
: object
entries
: array of objectdepth
: string (hex integer)error
: stringgas
: string (hex integer)gasCost
: string (hex integer)memory
: array of stringopcode
: stringprogramCounter
: string (hex integer)stack
: array of stringstorage
: map of string
failed
: booleangas
: string (hex integer)returnValue
: string (hex data)storagesByDepth
: array of map of string
debug_traceTransactionByBlockhashAndIndex
- Parameters
- Request
- Response
-
blockHash
: string (hash) -
txIndex
: string (hex integer) -
options
: objectdisableMemory
: booleandisableStack
: booleandisableStorage
: booleanenableMemory
: booleantimeout
: stringtracer
: stringtracerConfig
: objecthasValue
: booleanvalue
: objectitem
: objectvalueKind
: integer
txHash
: string (hash)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_traceTransactionByBlockhashAndIndex",
"params": [blockHash, txIndex, options]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: object
customTracerResult
: objectvalue
: object
entries
: array of objectdepth
: string (hex integer)error
: stringgas
: string (hex integer)gasCost
: string (hex integer)memory
: array of stringopcode
: stringprogramCounter
: string (hex integer)stack
: array of stringstorage
: map of string
failed
: booleangas
: string (hex integer)returnValue
: string (hex data)storagesByDepth
: array of map of string
debug_traceTransactionInBlockByHash
- Parameters
- Request
- Response
-
blockRlp
: string (hex data) -
transactionHash
: string (hash) -
options
: objectdisableMemory
: booleandisableStack
: booleandisableStorage
: booleanenableMemory
: booleantimeout
: stringtracer
: stringtracerConfig
: objecthasValue
: booleanvalue
: objectitem
: objectvalueKind
: integer
txHash
: string (hash)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_traceTransactionInBlockByHash",
"params": [blockRlp, transactionHash, options]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: object
customTracerResult
: objectvalue
: object
entries
: array of objectdepth
: string (hex integer)error
: stringgas
: string (hex integer)gasCost
: string (hex integer)memory
: array of stringopcode
: stringprogramCounter
: string (hex integer)stack
: array of stringstorage
: map of string
failed
: booleangas
: string (hex integer)returnValue
: string (hex data)storagesByDepth
: array of map of string
debug_traceTransactionInBlockByIndex
- Parameters
- Request
- Response
-
blockRlp
: string (hex data) -
txIndex
: string (hex integer) -
options
: objectdisableMemory
: booleandisableStack
: booleandisableStorage
: booleanenableMemory
: booleantimeout
: stringtracer
: stringtracerConfig
: objecthasValue
: booleanvalue
: objectitem
: objectvalueKind
: integer
txHash
: string (hash)
curl localhost:8545 \
-X POST \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 0,
"method": "debug_traceTransactionInBlockByIndex",
"params": [blockRlp, txIndex, options]
}'
{
"jsonrpc": "2.0",
"id": 0,
"result": result
}
result
: object
customTracerResult
: objectvalue
: object
entries
: array of objectdepth
: string (hex integer)error
: stringgas
: string (hex integer)gasCost
: string (hex integer)memory
: array of stringopcode
: stringprogramCounter
: string (hex integer)stack
: array of stringstorage
: map of string
failed
: booleangas
: string (hex integer)returnValue
: string (hex data)storagesByDepth
: array of map of string