Parameters
- arrayarrayREQUIRED
The type of trace, which can be one of the following:
- vmTracestring
To get a full trace of the virtual machine's state during the execution of the given transaction, including for any subcalls
- tracestring
To get the basic trace of the given transaction
- stateDiffstring
To get information on the state altered by the execution of the given transaction
- blockNumberstring
The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, and pending for the pending state/transactions
Returns
- arrayarray
The list of traced calls, one entry per requested call, which have the following fields (please note that all return types are hexadecimal representations of their data type unless otherwise stated):
- outputstring
The data which is returned as an output encoded in hexadecimal format
- stateDiffobject
The state altered by the execution of the call, keyed by account address, and it is null when the stateDiff tracer is not requested
- tracearray
The basic traces of the call:
- actionobject
The action to be performed on the receiver id:
- callTypestring
The type of method such as call or delegatecall
- fromstring
The address of the sender
- gasstring
The gas provided by the sender, encoded as hexadecimal
- inputstring
The data sent along with the call
- tostring
The address of the receiver
- valuestring
The integer of the value sent with this call, encoded as hexadecimal
- blockHashstring
The hash of the block in which the call was simulated
- blockNumberinteger
The number of the block in which the call was simulated (stated in decimal)
- resultobject
The result of the call:
- gasUsedstring
The amount of gas used by this call alone
- outputstring
The value returned by the contract call, and it only contains the actual value sent by the RETURN method. If the RETURN method was not executed, the output is empty bytes
- subtracesinteger
The number of contract calls made by this call
- traceAddressarray
The list of addresses where the call executed, the address of the parents and the order of the current sub call
- transactionHashstring
The hash of the simulated transaction the trace belongs to
- transactionPositioninteger
The position of the simulated transaction in the block (stated in decimal)
- typestring
The value of the method such as call or create
- vmTraceobject
The full trace of the virtual machine's state during the execution of the call, including for any sub-calls, and it is null when the vmTrace tracer is not requested
1{2"jsonrpc": "2.0",3"id": 1,4"result": [5{6"output": "0x",7"stateDiff": null,8"trace": [9{10"action": {11"callType": "call",12"from": "0x53b9ad09b82a313ec07040f6d8cb07bb6fd6e7ce",13"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",14"value": "0x186a0",15"gas": "0x23c2f3f8",16"input": "0x"17},18"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",19"blockNumber": 76639225,20"result": {21"gasUsed": "0x393f29d",22"output": "0x"23},24"subtraces": 1,25"traceAddress": [],26"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",27"transactionPosition": 0,28"type": "call"29},30{31"action": {32"callType": "call",33"from": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",34"to": "0x62b397afd9dfb2166c57323fa3bbeaaceecb3460",35"value": "0x186a0",36"gas": "0x2333c385",37"input": "0x"38},39"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",40"blockNumber": 76639225,41"result": {42"gasUsed": "0x0",43"output": "0x"44},45"subtraces": 0,46"traceAddress": [47048],49"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",50"transactionPosition": 0,51"type": "call"52}53],54"vmTrace": null55},56{57"output": "0x",58"stateDiff": null,59"trace": [60{61"action": {62"callType": "call",63"from": "0x53b9ad09b82a313ec07040f6d8cb07bb6fd6e7ce",64"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",65"value": "0x186a0",66"gas": "0x23c2f3f8",67"input": "0x"68},69"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",70"blockNumber": 76639225,71"result": {72"gasUsed": "0x393f29d",73"output": "0x"74},75"subtraces": 1,76"traceAddress": [],77"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",78"transactionPosition": 1,79"type": "call"80},81{82"action": {83"callType": "call",84"from": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",85"to": "0x62b397afd9dfb2166c57323fa3bbeaaceecb3460",86"value": "0x186a0",87"gas": "0x2333c385",88"input": "0x"89},90"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",91"blockNumber": 76639225,92"result": {93"gasUsed": "0x0",94"output": "0x"95},96"subtraces": 0,97"traceAddress": [98099],100"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",101"transactionPosition": 1,102"type": "call"103}104],105"vmTrace": null106}107]108}
1{2"jsonrpc": "2.0",3"id": 1,4"result": [5{6"output": "0x",7"stateDiff": null,8"trace": [9{10"action": {11"callType": "call",12"from": "0x53b9ad09b82a313ec07040f6d8cb07bb6fd6e7ce",13"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",14"value": "0x186a0",15"gas": "0x23c2f3f8",16"input": "0x"17},18"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",19"blockNumber": 76639225,20"result": {21"gasUsed": "0x393f29d",22"output": "0x"23},24"subtraces": 1,25"traceAddress": [],26"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",27"transactionPosition": 0,28"type": "call"29},30{31"action": {32"callType": "call",33"from": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",34"to": "0x62b397afd9dfb2166c57323fa3bbeaaceecb3460",35"value": "0x186a0",36"gas": "0x2333c385",37"input": "0x"38},39"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",40"blockNumber": 76639225,41"result": {42"gasUsed": "0x0",43"output": "0x"44},45"subtraces": 0,46"traceAddress": [47048],49"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",50"transactionPosition": 0,51"type": "call"52}53],54"vmTrace": null55},56{57"output": "0x",58"stateDiff": null,59"trace": [60{61"action": {62"callType": "call",63"from": "0x53b9ad09b82a313ec07040f6d8cb07bb6fd6e7ce",64"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",65"value": "0x186a0",66"gas": "0x23c2f3f8",67"input": "0x"68},69"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",70"blockNumber": 76639225,71"result": {72"gasUsed": "0x393f29d",73"output": "0x"74},75"subtraces": 1,76"traceAddress": [],77"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",78"transactionPosition": 1,79"type": "call"80},81{82"action": {83"callType": "call",84"from": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",85"to": "0x62b397afd9dfb2166c57323fa3bbeaaceecb3460",86"value": "0x186a0",87"gas": "0x2333c385",88"input": "0x"89},90"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",91"blockNumber": 76639225,92"result": {93"gasUsed": "0x0",94"output": "0x"95},96"subtraces": 0,97"traceAddress": [98099],100"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",101"transactionPosition": 1,102"type": "call"103}104],105"vmTrace": null106}107]108}