Get the opcode traces for a historical transaction on the network with the given transaction ID or hash

Re-executes a transaction and returns a result containing detailed information for the execution, including all values from the {@code stack}, {@code memory} and {@code storage} and the entire trace of opcodes that were executed during the replay. Note that to provide the output, the transaction needs to be re-executed on the EVM, which may take a significant amount of time to complete if stack and memory information is requested.

GET /api/v1/contracts/results/{transactionIdOrHash}/opcodes

Get the opcode traces for a historical transaction on the network with the given transaction ID or hash

cURL

curl --request GET \
  --url https://mainnet.mirrornode.hedera.com/api/v1/contracts/results/{transactionIdOrHash}/opcodes

200

{
  "address": "<string>",
  "contract_id": "0.0.2",
  "failed": true,
  "gas": 123,
  "opcodes": [
    {
      "depth": 123,
      "gas": 123,
      "gas_cost": 123,
      "memory": [
        "<string>"
      ],
      "op": "<string>",
      "pc": 123,
      "stack": [
        "<string>"
      ],
      "storage": {},
      "reason": "<string>"
    }
  ],
  "return_value": "<string>"
}

Path Parameters

transactionIdOrHash · string · required

Transaction Id or a 32 byte hash with optional 0x prefix

Pattern: ^(0x)?[A-Fa-f0-9]{64}|(\d{1,10})\.(\d{1,10})\.(\d{1,10})-(\d{1,19})-(\d{1,9})$

Query Parameters

stack · boolean · default: true

If provided and set to false, stack information will not be included in the response

memory · boolean · default: false

If provided and set to true, memory information will be included in the response

storage · boolean · default: false

If provided and set to true, storage information will be included in the response

Response

200

application/json

OK

address · file · required

The address of the transaction recipient in hex. Zero address is set for transactions without a recipient (e.g., contract create)

contract_id · string | null · required

Network entity ID in the format of shard.realm.num

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

Example:

"0.0.2"

failed · boolean · required

Whether the transaction failed to be completely processed.

gas · integer<int64> · required

The gas used in tinybars

opcodes · object[] · required

The logs produced by the opcode logger

Show child attributes

return_value · file · required

The returned data from the transaction in hex