trace namespace

trace_block

Parameters

1. numberOrTag: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

2. fork: string

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "trace_block",
      "params": [numberOrTag, fork]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of object

• action: object
  • author: string (address)
  • callType: string
  • creationMethod: string
  • error: string
  • from: string (address)
  • gas: string (hex integer)
  • includeInTrace: boolean
  • input: string (hex data)
  • isPrecompiled: boolean
  • result: object
    • address: string (address)
    • code: string (hex data)
    • gasUsed: string (hex integer)
    • output: string (hex data)
  • rewardType: string
  • subtraces: array of object
  • to: string (address)
  • traceAddress: array of integer
  • type: string
  • value: string (hex integer)
• blockHash: string (hash)
• blockNumber: integer
• error: string
• result: object
  • address: string (address)
  • code: string (hex data)
  • gasUsed: string (hex integer)
  • output: string (hex data)
• subtraces: integer
• traceAddress: array of integer
• transactionHash: string (hash)
• transactionPosition: integer
• type: string

trace_call

Parameters

1. call: 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)

2. traceTypes: array of string

3. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

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)
• stateDiff: map of string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "trace_call",
      "params": [call, traceTypes, blockParameter, stateOverride]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

• action: object
  • author: string (address)
  • callType: string
  • creationMethod: string
  • error: string
  • from: string (address)
  • gas: string (hex integer)
  • includeInTrace: boolean
  • input: string (hex data)
  • isPrecompiled: boolean
  • result: object
    • address: string (address)
    • code: string (hex data)
    • gasUsed: string (hex integer)
    • output: string (hex data)
  • rewardType: string
  • subtraces: array of object
  • to: string (address)
  • traceAddress: array of integer
  • type: string
  • value: string (hex integer)
• output: string (hex data)
• stateDiff: map of object
  • balance: object
    • after: string (hex integer)
    • before: string (hex integer)
  • code: object
    • after: string (hex data)
    • before: string (hex data)
  • nonce: object
    • after: string (hex integer)
    • before: string (hex integer)
  • storage: map of object
    • after: string (hex data)
    • before: string (hex data)
• transactionHash: string (hash)
• vmTrace: object
  • code: string (hex data)
  • operations: array of object
    • cost: string (hex integer)
    • memory: object
      • data: string (hex data)
      • offset: string (hex integer)
    • pc: integer
    • push: array of string (hex data)
    • store: object
      • key: string (hex data)
      • value: string (hex data)
    • sub: object
    • used: string (hex integer)

trace_callMany

Performs multiple traces on top of a block

Parameters

1. calls: object

   • calls: array of object
     • traceTypes: array of string
     • transaction: 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)

2. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "trace_callMany",
      "params": [calls, blockParameter]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of object

• action: object
  • author: string (address)
  • callType: string
  • creationMethod: string
  • error: string
  • from: string (address)
  • gas: string (hex integer)
  • includeInTrace: boolean
  • input: string (hex data)
  • isPrecompiled: boolean
  • result: object
    • address: string (address)
    • code: string (hex data)
    • gasUsed: string (hex integer)
    • output: string (hex data)
  • rewardType: string
  • subtraces: array of object
  • to: string (address)
  • traceAddress: array of integer
  • type: string
  • value: string (hex integer)
• output: string (hex data)
• stateDiff: map of object
  • balance: object
    • after: string (hex integer)
    • before: string (hex integer)
  • code: object
    • after: string (hex data)
    • before: string (hex data)
  • nonce: object
    • after: string (hex integer)
    • before: string (hex integer)
  • storage: map of object
    • after: string (hex data)
    • before: string (hex data)
• transactionHash: string (hash)
• vmTrace: object
  • code: string (hex data)
  • operations: array of object
    • cost: string (hex integer)
    • memory: object
      • data: string (hex data)
      • offset: string (hex integer)
    • pc: integer
    • push: array of string (hex data)
    • store: object
      • key: string (hex data)
      • value: string (hex data)
    • sub: object
    • used: string (hex integer)

trace_filter

Parameters

1. traceFilterForRpc: object
   • 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)
   • toBlock: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "trace_filter",
      "params": [traceFilterForRpc]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of object

• action: object
  • author: string (address)
  • callType: string
  • creationMethod: string
  • error: string
  • from: string (address)
  • gas: string (hex integer)
  • includeInTrace: boolean
  • input: string (hex data)
  • isPrecompiled: boolean
  • result: object
    • address: string (address)
    • code: string (hex data)
    • gasUsed: string (hex integer)
    • output: string (hex data)
  • rewardType: string
  • subtraces: array of object
  • to: string (address)
  • traceAddress: array of integer
  • type: string
  • value: string (hex integer)
• blockHash: string (hash)
• blockNumber: integer
• error: string
• result: object
  • address: string (address)
  • code: string (hex data)
  • gasUsed: string (hex integer)
  • output: string (hex data)
• subtraces: integer
• traceAddress: array of integer
• transactionHash: string (hash)
• transactionPosition: integer
• type: string

trace_get

Returns trace at given position.

Parameters

1. txHash: string (hash)

2. positions: array of string (hex integer)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "trace_get",
      "params": [txHash, positions]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of object

• action: object
  • author: string (address)
  • callType: string
  • creationMethod: string
  • error: string
  • from: string (address)
  • gas: string (hex integer)
  • includeInTrace: boolean
  • input: string (hex data)
  • isPrecompiled: boolean
  • result: object
    • address: string (address)
    • code: string (hex data)
    • gasUsed: string (hex integer)
    • output: string (hex data)
  • rewardType: string
  • subtraces: array of object
  • to: string (address)
  • traceAddress: array of integer
  • type: string
  • value: string (hex integer)
• blockHash: string (hash)
• blockNumber: integer
• error: string
• result: object
  • address: string (address)
  • code: string (hex data)
  • gasUsed: string (hex integer)
  • output: string (hex data)
• subtraces: integer
• traceAddress: array of integer
• transactionHash: string (hash)
• transactionPosition: integer
• type: string

trace_rawTransaction

Traces a call to eth_sendRawTransaction without making the call, returning the traces

Parameters

1. data: string (hex data)

2. traceTypes: array of string

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "trace_rawTransaction",
      "params": [data, traceTypes]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

• action: object
  • author: string (address)
  • callType: string
  • creationMethod: string
  • error: string
  • from: string (address)
  • gas: string (hex integer)
  • includeInTrace: boolean
  • input: string (hex data)
  • isPrecompiled: boolean
  • result: object
    • address: string (address)
    • code: string (hex data)
    • gasUsed: string (hex integer)
    • output: string (hex data)
  • rewardType: string
  • subtraces: array of object
  • to: string (address)
  • traceAddress: array of integer
  • type: string
  • value: string (hex integer)
• output: string (hex data)
• stateDiff: map of object
  • balance: object
    • after: string (hex integer)
    • before: string (hex integer)
  • code: object
    • after: string (hex data)
    • before: string (hex data)
  • nonce: object
    • after: string (hex integer)
    • before: string (hex integer)
  • storage: map of object
    • after: string (hex data)
    • before: string (hex data)
• transactionHash: string (hash)
• vmTrace: object
  • code: string (hex data)
  • operations: array of object
    • cost: string (hex integer)
    • memory: object
      • data: string (hex data)
      • offset: string (hex integer)
    • pc: integer
    • push: array of string (hex data)
    • store: object
      • key: string (hex data)
      • value: string (hex data)
    • sub: object
    • used: string (hex integer)

trace_replayBlockTransactions

Parameters

1. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

2. traceTypes: array of string

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "trace_replayBlockTransactions",
      "params": [blockParameter, traceTypes]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of object

• action: object
  • author: string (address)
  • callType: string
  • creationMethod: string
  • error: string
  • from: string (address)
  • gas: string (hex integer)
  • includeInTrace: boolean
  • input: string (hex data)
  • isPrecompiled: boolean
  • result: object
    • address: string (address)
    • code: string (hex data)
    • gasUsed: string (hex integer)
    • output: string (hex data)
  • rewardType: string
  • subtraces: array of object
  • to: string (address)
  • traceAddress: array of integer
  • type: string
  • value: string (hex integer)
• output: string (hex data)
• stateDiff: map of object
  • balance: object
    • after: string (hex integer)
    • before: string (hex integer)
  • code: object
    • after: string (hex data)
    • before: string (hex data)
  • nonce: object
    • after: string (hex integer)
    • before: string (hex integer)
  • storage: map of object
    • after: string (hex data)
    • before: string (hex data)
• transactionHash: string (hash)
• vmTrace: object
  • code: string (hex data)
  • operations: array of object
    • cost: string (hex integer)
    • memory: object
      • data: string (hex data)
      • offset: string (hex integer)
    • pc: integer
    • push: array of string (hex data)
    • store: object
      • key: string (hex data)
      • value: string (hex data)
    • sub: object
    • used: string (hex integer)

trace_replayTransaction

Parameters

1. txHash: string (hash)

2. traceTypes: array of string

3. traceNonCanonical: boolean

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "trace_replayTransaction",
      "params": [txHash, traceTypes, traceNonCanonical]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

• action: object
  • author: string (address)
  • callType: string
  • creationMethod: string
  • error: string
  • from: string (address)
  • gas: string (hex integer)
  • includeInTrace: boolean
  • input: string (hex data)
  • isPrecompiled: boolean
  • result: object
    • address: string (address)
    • code: string (hex data)
    • gasUsed: string (hex integer)
    • output: string (hex data)
  • rewardType: string
  • subtraces: array of object
  • to: string (address)
  • traceAddress: array of integer
  • type: string
  • value: string (hex integer)
• output: string (hex data)
• stateDiff: map of object
  • balance: object
    • after: string (hex integer)
    • before: string (hex integer)
  • code: object
    • after: string (hex data)
    • before: string (hex data)
  • nonce: object
    • after: string (hex integer)
    • before: string (hex integer)
  • storage: map of object
    • after: string (hex data)
    • before: string (hex data)
• transactionHash: string (hash)
• vmTrace: object
  • code: string (hex data)
  • operations: array of object
    • cost: string (hex integer)
    • memory: object
      • data: string (hex data)
      • offset: string (hex integer)
    • pc: integer
    • push: array of string (hex data)
    • store: object
      • key: string (hex data)
      • value: string (hex data)
    • sub: object
    • used: string (hex integer)

trace_simulateV1

Returns parity like traces for simulated blocks

Parameters

1. payload: object

   • blockStateCalls: array of object
     • blockOverrides: object
       • baseFeePerGas: string (hex integer)
       • blobBaseFee: string (hex integer)
       • feeRecipient: string (address)
       • gasLimit: string (hex integer)
       • number: string (hex integer)
       • prevRandao: string (hash)
       • time: string (hex integer)
     • calls: array of 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)
     • 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)
   • returnFullTransactionObjects: boolean
   • returnFullTransactions: boolean
   • traceTransfers: boolean
   • validation: boolean

2. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

3. traceTypes: array of string

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "trace_simulateV1",
      "params": [payload, blockParameter, traceTypes]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

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)
    • callType: string
    • creationMethod: string
    • error: string
    • from: string (address)
    • gas: string (hex integer)
    • includeInTrace: boolean
    • input: string (hex data)
    • isPrecompiled: boolean
    • result: object
      • address: string (address)
      • code: string (hex data)
      • gasUsed: string (hex integer)
      • output: string (hex data)
    • rewardType: string
    • subtraces: array of object
    • to: string (address)
    • traceAddress: array of integer
    • type: string
    • value: string (hex integer)
  • blockHash: string (hash)
  • blockNumber: integer
  • output: string (hex data)
  • stateDiff: map of object
    • balance: object
      • after: string (hex integer)
      • before: string (hex integer)
    • code: object
      • after: string (hex data)
      • before: string (hex data)
    • nonce: object
      • after: string (hex integer)
      • before: string (hex integer)
    • storage: map of object
      • after: string (hex data)
      • before: string (hex data)
  • transactionHash: string (hash)
  • transactionPosition: integer
  • vmTrace: object
    • code: string (hex data)
    • operations: array of object
      • cost: string (hex integer)
      • memory: object
        • data: string (hex data)
        • offset: string (hex integer)
      • pc: integer
      • push: array of string (hex data)
      • store: object
        • key: string (hex data)
        • value: string (hex data)
      • 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)
    • callType: string
    • creationMethod: string
    • error: string
    • from: string (address)
    • gas: string (hex integer)
    • includeInTrace: boolean
    • input: string (hex data)
    • isPrecompiled: boolean
    • result: object
      • address: string (address)
      • code: string (hex data)
      • gasUsed: string (hex integer)
      • output: string (hex data)
    • rewardType: string
    • subtraces: array of object
    • to: string (address)
    • traceAddress: array of integer
    • type: string
    • value: string (hex integer)
  • blockHash: string (hash)
  • blockNumber: integer
  • output: string (hex data)
  • stateDiff: map of object
    • balance: object
      • after: string (hex integer)
      • before: string (hex integer)
    • code: object
      • after: string (hex data)
      • before: string (hex data)
    • nonce: object
      • after: string (hex integer)
      • before: string (hex integer)
    • storage: map of object
      • after: string (hex data)
      • before: string (hex data)
  • transactionHash: string (hash)
  • transactionPosition: integer
  • vmTrace: object
    • code: string (hex data)
    • operations: array of object
      • cost: string (hex integer)
      • memory: object
        • data: string (hex data)
        • offset: string (hex integer)
      • pc: integer
      • push: array of string (hex data)
      • store: object
        • key: string (hex data)
        • value: string (hex data)
      • 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)

trace_transaction

Parameters

1. txHash: string (hash)

2. traceNonCanonical: boolean

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "trace_transaction",
      "params": [txHash, traceNonCanonical]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of object

• action: object
  • author: string (address)
  • callType: string
  • creationMethod: string
  • error: string
  • from: string (address)
  • gas: string (hex integer)
  • includeInTrace: boolean
  • input: string (hex data)
  • isPrecompiled: boolean
  • result: object
    • address: string (address)
    • code: string (hex data)
    • gasUsed: string (hex integer)
    • output: string (hex data)
  • rewardType: string
  • subtraces: array of object
  • to: string (address)
  • traceAddress: array of integer
  • type: string
  • value: string (hex integer)
• blockHash: string (hash)
• blockNumber: integer
• error: string
• result: object
  • address: string (address)
  • code: string (hex data)
  • gasUsed: string (hex integer)
  • output: string (hex data)
• subtraces: integer
• traceAddress: array of integer
• transactionHash: string (hash)
• transactionPosition: integer
• type: string