[Trace] debug_traceTransaction

The traceTransaction debugging 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.

JSONRPC: debug_traceTransaction

Request

application/json

Body

method stringrequired

Default value: debug_traceTransaction

Method name

id int64required

Default value: 1

Request ID, Random or Auto incrementation

jsonrpc stringrequired

Default value: 2.0

JSON-RPC Version (2.0)

params

undefined[]

Array [

TxHash TxHash

The hash of the transaction.

TracingOptions

object

disableStorage boolean

Setting this to true will disable storage capture (default = false).

disableMemory boolean

Setting this to true will disable memory capture (default = false).

disableStack boolean

Setting this to true will disable stack capture (default = false).

timeout string

Overrides the default timeout of 5 seconds for JavaScript-based tracing calls. A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".

trace string

Possible values: [4byteTracer, callTracer, fastCallTracer, evmdisTracer, noopTracer, opcountTracer, prestateTracer, revertTracer, unigramTracer, bigramTracer, trigramTracer]

Setting this will enable JavaScript-based transaction tracing, described in the next section. If set, the previous four arguments will be ignored. The predefined tracers can also be used as the following table. | Tracer Name | Description | |-----|-----| | 4byteTracer | 4byteTracer searches for 4byte-identifiers, and collects them for post-processing. It collects the methods identifiers along with the size of the supplied data, so a reversed signature can be matched against the size of the data. | | callTracer | callTracer is a full-blown transaction tracer that extracts and reports all the internal calls made by a transaction, along with any useful information. | | fastCallTracer | fastCallTracer is a Go-native version of callTracer. Since it is not executed on JavaScript VM, it shows more than 10x speedup compared to callTracer. Please use fastCallTracer instead of callTracer if the performance is the matter of the first importance. | | evmdisTracer | evmdisTracer returns sufficient information from a trace to perform evmdis-style disassembly. | | noopTracer | noopTracer is just the barebone boilerplate code required from a JavaScript object to be usable as a transaction tracer. | | opcountTracer | opcountTracer is a sample tracer that just counts the number of instructions executed by the KLVM before the transaction terminated. | | prestateTracer | prestateTracer outputs sufficient information to create a local execution of the transaction from a custom assembled genesis block. | | revertTracer | revertTracer outputs the error string of REVERT. If the execution is not reverted, it outputs an empty string. | | unigramTracer | unigramTracer returns the number of occurrences of each opcode. | | bigramTracer | bigramTracer returns the number of occurrences of two consecutive opcodes. | | trigramTracer | trigramTracer returns the number of occurrences of three consecutive opcodes. |

]

Responses

200

The structured logs created during the execution of KLVM.

application/json

Schema

Schema

jsonrpc stringrequired

Default value: 2.0

id int64required

error

object

code int64required

A Number that indicates the error type that occurred. This MUST be an integer.

| code | message | description | |-----|-----|-------| | -32700 | Parse error | invalid JSON was received by the server. An error occurred on the server while parsing the JSON text. | |-32602 | Invalid params | Invalid method parameter(s). |

message string

A String providing a short description of the error. The message SHOULD be limited to a concise single sentence.

data string

A Primitive or Structured value that contains additional information about the error. This may be omitted. The value of this member is defined by the Server (e.g. detailed error information, nested errors etc.).

result

object

The structured logs created during the execution of KLVM.

failed booleanrequired

gas integerrequired

returnValue stringrequired

structLogs

object[]

required

Array [

computation number

computationCost number

depth number

gas number

gasCost number

memory string[]

op string

pc number

stack string[]

The status of the response

storage object

The status of the response

]

Example (from schema)

{
  "jsonrpc": "2.0",
  "id": 0,
  "error": {
    "code": -32700,
    "message": "Parse error",
    "data": "string"
  },
  "result": {
    "failed": false,
    "gas": 28110,
    "returnValue": "",
    "structLogs": [
      {
        "computation": 149999880,
        "computationCost": 120,
        "depth": 1,
        "gas": 6710,
        "gasCost": 3,
        "memory": [],
        "op": "PUSH1",
        "pc": 0,
        "stack": [],
        "storage": {}
      },
      {
        "computation": 149999760,
        "computationCost": 120,
        "depth": 1,
        "gas": 6707,
        "gasCost": 3,
        "memory": [],
        "op": "PUSH1",
        "pc": 2,
        "stack": [
          "0000000000000000000000000000000000000000000000000000000000000080"
        ],
        "storage": {}
      },
      {
        "...": null
      },
      {
        "computation": 149965613,
        "computationCost": 0,
        "depth": 1,
        "gas": 0,
        "gasCost": 0,
        "memory": [
          "0000000000000000000000000000000000000000000000000000000000000000",
          "0000000000000000000000000000000000000000000000000000000000000000",
          "0000000000000000000000000000000000000000000000000000000000000080",
          "0000000000000000000000000000000000000000000000000000000000000000",
          "0000000000000000000000000000000000000000000000000000000000000002"
        ],
        "op": "STOP",
        "pc": 176,
        "stack": [
          "00000000000000000000000000000000000000000000000000000000d09de08a"
        ],
        "storage": {
          "0": "0000000000000000000000000000000000000000000000000000000000000002"
        }
      }
    ]
  }
}

Loading...