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)
​See also CLI trace.block​
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
MaxFeePerDataGas
Quantity
BlobVersionedHashes
Data
V
Quantity
S
Quantity
R
Quantity
YParity
Quantity
TxType
​EIP2718 transaction type
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
​See also CLI trace.call​
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
​See also CLI trace.filter​
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
​See also CLI trace.rawTransaction​
trace_replayBlockTransactions
Replays all transactions in a block returning the requested traces for each transaction.
Invocation
{"method":"trace_replayBlockTransactions","params":[blockParameter, traceTypes]}
Parameter
Type
Description
blockParameter
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":[blockParameter, 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)
​See also CLI trace.replayBlockTransactions​
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
​See also CLI trace.replayTransaction​
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
}
​See also CLI trace.transaction​

Invocation
`{"method":"trace_block","params":[numberOrTag]}`

Parameter	Type	Description
numberOrTag	`BlockParameter object`

Returned type	Description
`Array`

Field name	Type
Type	`BlockParameterType object`
BlockNumber	`Quantity`
BlockHash	`Hash`
RequireCanonical	`Boolean`

Invocation
`{"method":"trace_call","params":[call, traceTypes, blockParameter]}`

Parameter	Type	Description
call	`TransactionForRpc object`
traceTypes	`Array`
blockParameter	`BlockParameter object`

Returned type	Description
`ParityTxTraceFromReplay object`

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`
MaxFeePerDataGas	`Quantity`
BlobVersionedHashes	`Data`
V	`Quantity`
S	`Quantity`
R	`Quantity`
YParity	`Quantity`

Field name	Type
Address	`Address`
StorageKeys	`Array`

Field name	Type
Type	`BlockParameterType object`
BlockNumber	`Quantity`
BlockHash	`Hash`
RequireCanonical	`Boolean`

Field name	Type
Output	`Data`
TransactionHash	`Hash`
VmTrace	`ParityVmTrace object`
Action	`ParityTraceAction object`
StateChanges	`Array`

Field name	Type
Code	`Data`
Operations	`ParityVmOperationTrace[] object`

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`

Invocation
`{"method":"trace_filter","params":[traceFilterForRpc]}`

Parameter	Type	Description
traceFilterForRpc	`TraceFilterForRpc object`

Returned type	Description
`Array`

Field name	Type
FromBlock	`BlockParameter object`
ToBlock	`BlockParameter object`
FromAddress	`Address[] object`
ToAddress	`Address[] object`
After	`Quantity`
Count	`Quantity`

Field name	Type
Type	`BlockParameterType object`
BlockNumber	`Quantity`
BlockHash	`Hash`
RequireCanonical	`Boolean`

Field name	Type
Zero	`Address`
SystemUser	`Address`
Bytes	`Data`
Item	`Data`

Invocation
`{"method":"trace_rawTransaction","params":[data, traceTypes]}`

Parameter	Type	Description
data	`Data`
traceTypes	`Array`

Returned type	Description
`ParityTxTraceFromReplay object`

Field name	Type
Output	`Data`
TransactionHash	`Hash`
VmTrace	`ParityVmTrace object`
Action	`ParityTraceAction object`
StateChanges	`Array`

Field name	Type
Code	`Data`
Operations	`ParityVmOperationTrace[] object`

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`

Invocation
`{"method":"trace_replayBlockTransactions","params":[blockParameter, traceTypes]}`

Parameter	Type	Description
blockParameter	`BlockParameter object`
traceTypes	`Array`

Returned type	Description
`Array`

Field name	Type
Type	`BlockParameterType object`
BlockNumber	`Quantity`
BlockHash	`Hash`
RequireCanonical	`Boolean`

Invocation
`{"method":"trace_replayTransaction","params":[txHash, traceTypes]}`

Parameter	Type	Description
txHash	`Hash`
traceTypes	`Array`

Returned type	Description
`ParityTxTraceFromReplay object`

Field name	Type
Output	`Data`
TransactionHash	`Hash`
VmTrace	`ParityVmTrace object`
Action	`ParityTraceAction object`
StateChanges	`Array`

Field name	Type
Code	`Data`
Operations	`ParityVmOperationTrace[] object`

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`

Invocation
`{"method":"trace_transaction","params":[txHash]}`

Parameter	Type	Description
txHash	`Hash`

Returned type	Description
`Array`

Subscribe module

TxPool module

Last modified 1d ago