Nethermind Docs
Github RepositoryHome Page
Search…
English
Welcome to Nethermind
Contact
Social Media
Contact us
First steps with Nethermind
Getting Started
Migrating From Geth
Running Nethermind Post Merge
Supported platforms
Firewall Configuration
Hardware Requirements
Security
Manage Nethermind with systemd
Nodes and The Merge
The Merge
Nethermind Changes
Installing Nethermind
Downloading Releases
Building From Source
Docker
Ethereum client
Engine JsonRpc Configuration Example
Running Nethermind
Sync modes
JSON RPC
Admin module
Clique module
Debug module
Eth module
Net module
Parity module
Personal module
Proof module
Subscribe module
Trace module
TxPool module
Web3 module
JSON RPC WIKI
Using Docker
Networks
Private Networks
Database
Metrics
Logging Configuration
Configuration
Plugins
Monitoring Node's Health
MEV
MEV Plugin
Nethermind utilities
CLI
Guides and Helpers
FAQ
Upgrades
Custom Analytic Tools
Deploy Nethermind with Monitoring stack
Known Issues
Web3.py
Validator setup
ETH2 <-> Nethermind
Coding Style
Powered By GitBook
Trace module

trace_block

Returns traces created at given block.
Invocation
{"method":"trace_block","params":[numberOrTag]}
Parameter
Type
Description
numberOrTag
BlockParameter object
​
Returned type
Description
Array
​
Example request of trace_block
Example response of trace_block
Objects in trace_block
curl --data '{"method":"trace_block","params":[latest],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
{
"jsonrpc": "2.0",
"result": {"action":{"callType":"call","from":"0x31b98d14007bdee637298086988a0bbd31184523","gas":"0x0","input":"0x","to":"0x0e8cda5d7ebda67606a9b296a9dd4351bca1d263","value":"0x1043561a882930000"},"blockHash":"0x6537c92f1fae55d9ea9b0fb25744262114b09e50ac320d7d839830f8c4d723a0","blockNumber":8969312,"result":{"gasUsed":"0x0","output":"0x"},"subtraces":0,"traceAddress":[],"transactionHash":"0xf4860fc1dc22404b85db7d666dfae65dec7cdcb196837a67ffa992d709f78b9e","transactionPosition":11,"type":"call"},{"action":{"callType":"call","from":"0x71c95151c960aa3976b462ff41adb328790f110d","gas":"0x7205","input":"0x095ea7b3000000000000000000000000c5992c0e0a3267c7f75493d0f717201e26be35f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff","to":"0x5592ec0cfb4dbc12d3ab100b257153436a1f0fea","value":"0x0"},"blockHash":"0x6537c92f1fae55d9ea9b0fb25744262114b09e50ac320d7d839830f8c4d723a0","blockNumber":8969312,"result":{"gasUsed":"0x5fdd","output":"0x0000000000000000000000000000000000000000000000000000000000000001"},"subtraces":0,"traceAddress":[],"transactionHash":"0xec216ca7e754ea289dd59fc7f9f2c9a5b90668afb5a52d49ee15c3c5fd559b3b","transactionPosition":12,"type":"call"},
"id": 1
}
BlockParameter
Field name
Type
Type
BlockParameterType object
BlockNumber
Quantity
BlockHash
Hash
RequireCanonical
Boolean
BlockParameterType
  • Quantity or String (latest, earliest, pending)

trace_call

Traces a call, returning the traces
Invocation
{"method":"trace_call","params":[call, traceTypes, blockParameter]}
Parameter
Type
Description
call
TransactionForRpc object
​
traceTypes
Array
​
blockParameter
BlockParameter object
​
Returned type
Description
ParityTxTraceFromReplay object
​
Example request of trace_call
Objects in trace_call
curl --data '{"method":"trace_call","params":[call, traceTypes, blockParameter],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
TransactionForRpc
Field name
Type
Hash
Hash
Nonce
Quantity
BlockHash
Hash
BlockNumber
Quantity
TransactionIndex
Quantity
From
Address
To
Address
Value
Quantity
GasPrice
Quantity
MaxPriorityFeePerGas
Quantity
MaxFeePerGas
Quantity
Gas
Quantity
Data
Data
Input
Data
ChainId
Quantity
Type
TxType object
AccessList
AccessListItemForRpc[] object
V
Quantity
S
Quantity
R
Quantity
YParity
Quantity
TxType
AccessListItemForRpc[]
Field name
Type
Address
Address
StorageKeys
Array
BlockParameter
Field name
Type
Type
BlockParameterType object
BlockNumber
Quantity
BlockHash
Hash
RequireCanonical
Boolean
BlockParameterType
  • Quantity or String (latest, earliest, pending)
ParityTxTraceFromReplay
Field name
Type
Output
Data
TransactionHash
Hash
VmTrace
ParityVmTrace object
Action
ParityTraceAction object
StateChanges
Array
ParityVmTrace
Field name
Type
Code
Data
Operations
ParityVmOperationTrace[] object
ParityTraceAction
Field name
Type
TraceAddress
Array
CallType
String
IncludeInTrace
Boolean
IsPrecompiled
Boolean
Type
String
CreationMethod
String
From
Address
To
Address
Gas
Quantity
Value
Quantity
Input
Data
Result
ParityTraceResult object
Subtraces
Array
Author
Address
RewardType
String
Error
String

trace_filter

Return all traces of the given filter
Invocation
{"method":"trace_filter","params":[traceFilterForRpc]}
Parameter
Type
Description
traceFilterForRpc
TraceFilterForRpc object
​
Returned type
Description
Array
​
Example request of trace_filter
Objects in trace_filter
curl --data '{"method":"trace_filter","params":[traceFilterForRpc],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
TraceFilterForRpc
Field name
Type
FromBlock
BlockParameter object
ToBlock
BlockParameter object
FromAddress
Address[] object
ToAddress
Address[] object
After
Quantity
Count
Quantity
BlockParameter
Field name
Type
Type
BlockParameterType object
BlockNumber
Quantity
BlockHash
Hash
RequireCanonical
Boolean
Address[]
Field name
Type
Zero
Address
SystemUser
Address
Bytes
Data
Item
Data

trace_rawTransaction

Traces a call to eth_sendRawTransaction without making the call, returning the traces
Invocation
{"method":"trace_rawTransaction","params":[data, traceTypes]}
Parameter
Type
Description
data
Data
​
traceTypes
Array
​
Returned type
Description
ParityTxTraceFromReplay object
​
Example request of trace_rawTransaction
Example response of trace_rawTransaction
Objects in trace_rawTransaction
curl --data '{"method":"trace_rawTransaction","params":[data, traceTypes],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
{
"jsonrpc": "2.0",
"result": "output":"0x","stateDiff":null,"trace":[{"action":{"callType":"call","from":"0xc451c26cc24c25e46b148ac4716804c12c34e7d2","gas":"0x0","input":"0x","to":"0xb943b13292086848d8180d75c73361107920bb1a","value":"0x0"},"result":{"gasUsed":"0x0","output":"0x"},"subtraces":0,"traceAddress":[],"type":"call"}],"vmTrace":null,
"id": 1
}
ParityTxTraceFromReplay
Field name
Type
Output
Data
TransactionHash
Hash
VmTrace
ParityVmTrace object
Action
ParityTraceAction object
StateChanges
Array
ParityVmTrace
Field name
Type
Code
Data
Operations
ParityVmOperationTrace[] object
ParityTraceAction
Field name
Type
TraceAddress
Array
CallType
String
IncludeInTrace
Boolean
IsPrecompiled
Boolean
Type
String
CreationMethod
String
From
Address
To
Address
Gas
Quantity
Value
Quantity
Input
Data
Result
ParityTraceResult object
Subtraces
Array
Author
Address
RewardType
String
Error
String

trace_replayBlockTransactions

Replays all transactions in a block returning the requested traces for each transaction.
Invocation
{"method":"trace_replayBlockTransactions","params":[numberOrTag, traceTypes]}
Parameter
Type
Description
numberOrTag
BlockParameter object
​
traceTypes
Array
​
Returned type
Description
Array
​
Example request of trace_replayBlockTransactions
Example response of trace_replayBlockTransactions
Objects in trace_replayBlockTransactions
curl --data '{"method":"trace_replayBlockTransactions","params":[numberOrTag, traceTypes],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
{
"jsonrpc": "2.0",
"result": [{"output":"0x0000000000000000000000000000000000000000000000000000000000000001","stateDiff":null,"trace":[{"action":{"callType":"call","from":"0x37f207b3ebda37de11ad2b6d306464e313c4841a","gas":"0x3c36","input":"0xa9059cbb000000000000000000000000d20d2f4c0b595abedef821a4157b0b990a37dae60000000000000000000000000000000000000000000000008ac7230489e80000","to":"0x59a524d1f5dcbde3224fd42171795283596a8103","value":"0x0"},"result":{"gasUsed":"0x3c36","output":"0x0000000000000000000000000000000000000000000000000000000000000001"},"subtraces":0,"traceAddress":[],"type":"call"}],"transactionHash":"0x17dc0fef36bb997c79ee2a0a126d059227000a2d47c9bbd1f49b5902a4e7385a","vmTrace":null}, (...)],
"id": 1
}
BlockParameter
Field name
Type
Type
BlockParameterType object
BlockNumber
Quantity
BlockHash
Hash
RequireCanonical
Boolean
BlockParameterType
  • Quantity or String (latest, earliest, pending)

trace_replayTransaction

Replays a transaction, returning the traces.
Invocation
{"method":"trace_replayTransaction","params":[txHash, traceTypes]}
Parameter
Type
Description
txHash
Hash
​
traceTypes
Array
​
Returned type
Description
ParityTxTraceFromReplay object
​
Example request of trace_replayTransaction
Example response of trace_replayTransaction
Objects in trace_replayTransaction
curl --data '{"method":"trace_replayTransaction","params":[txHash, traceTypes],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
{
"jsonrpc": "2.0",
"result": {"output":"0x","stateDiff":null,"trace":[{"action":{"callType":"call","from":"0x3c436c8ec40e0679fe64168545812ac13220f150","gas":"0xc118","input":"0xd46eb119","to":"0x9e00de186f33e9fac9e28d69127f7f637b96c177","value":"0xde0b6b3a7640000"},"result":{"gasUsed":"0xc118","output":"0x"},"subtraces":4,"traceAddress":[],"type":"call"},{"action":{"callType":"call","from":"0x9e00de186f33e9fac9e28d69127f7f637b96c177","gas":"0xa965","input":"0x40c10f190000000000000000000000009e00de186f33e9fac9e28d69127f7f637b96c1770000000000000000000000000000000000000000000000000de0b6b3a7640000","to":"0x766cd52cb91f4d2d7ea8b4c175aff0aba3696be1","value":"0x0"},"result":{"gasUsed":"0x76b8","output":"0x"},"subtraces":0,"traceAddress":[0],"type":"call"}, (...)}]},
"id": 1
}
ParityTxTraceFromReplay
Field name
Type
Output
Data
TransactionHash
Hash
VmTrace
ParityVmTrace object
Action
ParityTraceAction object
StateChanges
Array
ParityVmTrace
Field name
Type
Code
Data
Operations
ParityVmOperationTrace[] object
ParityTraceAction
Field name
Type
TraceAddress
Array
CallType
String
IncludeInTrace
Boolean
IsPrecompiled
Boolean
Type
String
CreationMethod
String
From
Address
To
Address
Gas
Quantity
Value
Quantity
Input
Data
Result
ParityTraceResult object
Subtraces
Array
Author
Address
RewardType
String
Error
String

trace_transaction

Returns all traces of given transaction
Invocation
{"method":"trace_transaction","params":[txHash]}
Parameter
Type
Description
txHash
Hash
​
Returned type
Description
Array
​
Example request of trace_transaction
Example response of trace_transaction
curl --data '{"method":"trace_transaction","params":[["0x203abf19610ce15bc509d4b341e907ff8c5a8287ae61186fd4da82146408c28c"]],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545
{
"jsonrpc": "2.0",
"result": [{"action":{"callType":"call","from":"0x3c436c8ec40e0679fe64168545812ac13220f150","gas":"0xc118","input":"0xd46eb119","to":"0x9e00de186f33e9fac9e28d69127f7f637b96c177","value":"0xde0b6b3a7640000"},"blockHash":"0xf40b4c9faaeaf116a50380ce3795297bc02068b062f1797cd507875347c3372e","blockNumber":8970132,"result":{"gasUsed":"0xc118","output":"0x"},"subtraces":4,"traceAddress":[],"transactionHash":"0x203abf19610ce15bc509d4b341e907ff8c5a8287ae61186fd4da82146408c28c","transactionPosition":9,"type":"call"},(...)],
"id": 1
}
Previous
Subscribe module
Next
TxPool module
Last modified 1mo ago
Copy link
On this page
trace_block
trace_call
trace_filter
trace_rawTransaction
trace_replayBlockTransactions
trace_replayTransaction
trace_transaction