This method requires appending /nanoreth to your HyperLiquid endpoint URL. Debug and Trace methods are not supported on /evm endpoints. Use /nanoreth instead of /evm to access debugging functionality.

Parameters

blockNumber

string

REQUIRED

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, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators

object

object

REQUIRED

The tracer object with the following fields:

tracer

string

The type of tracer. It could be callTracer or prestateTracer

callTracer

string

The calltracer keeps track of all call frames, including depth 0 calls, that are made during a transaction

prestateTracer

string

The prestateTracer replays the transaction and tracks every part of state that occured during the transaction

tracerConfig

object

The object to specify the configurations of the tracer

onlyTopCall

boolean

When set to true, this will only trace the primary (top-level) call and not any sub-calls. It eliminates the additional processing for each call frame

Returns

result

array

An array with one entry per transaction in the block

txHash

string

The transaction hash

result

object

The callTracer output for this transaction (same shape as debug_traceTransaction)

calls

array

(Optional) A list of sub-calls made during transaction execution

calls

array

Nested sub-calls

from

string

The address the call is sent from

gas

string

The gas provided for the call execution

gasUsed

string

The gas used by the call

input

string

The call data

output

string

(Optional) The call output data

to

string

The address the call is directed to

type

string

The type of call (CALL, STATICCALL, DELEGATECALL)

value

string

The value transferred in the call

error

string

(Optional) Error message if the call failed

revertReason

string

(Optional) Human-readable revert reason if the call failed

from

string

The address the transaction is sent from

gas

string

The integer of the gas provided for the transaction execution

gasUsed

string

The integer of the gas used

input

string

The data given at the time of input

to

string

The address the transaction is directed to

type

string

The type of transaction call

value

string

The value transferred in the transaction

output

string

(Optional) The data which is returned as an output

error

string

(Optional) Error message if the transaction execution failed

revertReason

string

(Optional) Human-readable revert reason when transaction execution failed

Request

1
curl https://docs-demo.hype-mainnet.quiknode.pro/evm \
2
-X POST \
3
-H "Content-Type: application/json" \
4
--data '{"method":"debug_traceBlockByNumber","params":["0xbdd86d", {"tracer": "callTracer"}],"id":1,"jsonrpc":"2.0"}'
5

1
curl https://docs-demo.hype-mainnet.quiknode.pro/evm \
2
-X POST \
3
-H "Content-Type: application/json" \
4
--data '{"method":"debug_traceBlockByNumber","params":["0xbdd86d", {"tracer": "callTracer"}],"id":1,"jsonrpc":"2.0"}'
5

1
require 'eth'
2

3
client = Eth::Client.create 'https://docs-demo.hype-mainnet.quiknode.pro/evm'
4
payload = {
5
    "jsonrpc": "2.0",
6
    "method": "debug_traceBlockByNumber",
7
    "params": ["0xbdd86d", {"tracer": "callTracer"}],
8
    "id": "1"
9
}
10

11
response = client.send(payload.to_json)
12
puts response
13

1
require 'eth'
2

3
client = Eth::Client.create 'https://docs-demo.hype-mainnet.quiknode.pro/evm'
4
payload = {
5
    "jsonrpc": "2.0",
6
    "method": "debug_traceBlockByNumber",
7
    "params": ["0xbdd86d", {"tracer": "callTracer"}],
8
    "id": "1"
9
}
10

11
response = client.send(payload.to_json)
12
puts response
13

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.hype-mainnet.quiknode.pro/evm");
4
  const response = await provider.send("debug_traceBlockByNumber", [
5
    "0xbdd86d",
6
    { "tracer": "callTracer" },
7
  ]);
8
  console.log(response);
9
})();

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.hype-mainnet.quiknode.pro/evm");
4
  const response = await provider.send("debug_traceBlockByNumber", [
5
    "0xbdd86d",
6
    { "tracer": "callTracer" },
7
  ]);
8
  console.log(response);
9
})();

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "debug_traceBlockByNumber",
6
  "params": [
7
    "0xbdd86d",
8
    {
9
      "tracer": "callTracer"
10
    }
11
  ],
12
  "id": 1,
13
  "jsonrpc": "2.0"
14
});
15

16
var requestOptions = {
17
  method: 'POST',
18
  headers: myHeaders,
19
  body: raw,
20
  redirect: 'follow'
21
};
22

23
fetch("https://docs-demo.hype-mainnet.quiknode.pro/evm", requestOptions)
24
  .then(response => response.text())
25
  .then(result => console.log(result))
26
  .catch(error => console.log('error', error));

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "debug_traceBlockByNumber",
6
  "params": [
7
    "0xbdd86d",
8
    {
9
      "tracer": "callTracer"
10
    }
11
  ],
12
  "id": 1,
13
  "jsonrpc": "2.0"
14
});
15

16
var requestOptions = {
17
  method: 'POST',
18
  headers: myHeaders,
19
  body: raw,
20
  redirect: 'follow'
21
};
22

23
fetch("https://docs-demo.hype-mainnet.quiknode.pro/evm", requestOptions)
24
  .then(response => response.text())
25
  .then(result => console.log(result))
26
  .catch(error => console.log('error', error));

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/evm"
5

6
payload = json.dumps({
7
  "method": "debug_traceBlockByNumber",
8
  "params": [
9
    "0xbdd86d",
10
    {
11
      "tracer": "callTracer"
12
    }
13
  ],
14
  "id": 1,
15
  "jsonrpc": "2.0"
16
})
17
headers = {
18
  'Content-Type': 'application/json'
19
}
20

21
response = requests.request("POST", url, headers=headers, data=payload)
22

23
print(response.text)
24

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/evm"
5

6
payload = json.dumps({
7
  "method": "debug_traceBlockByNumber",
8
  "params": [
9
    "0xbdd86d",
10
    {
11
      "tracer": "callTracer"
12
    }
13
  ],
14
  "id": 1,
15
  "jsonrpc": "2.0"
16
})
17
headers = {
18
  'Content-Type': 'application/json'
19
}
20

21
response = requests.request("POST", url, headers=headers, data=payload)
22

23
print(response.text)
24

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/evm")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "debug_traceBlockByNumber",
14
  "params": [
15
    "0xbdd86d",
16
    {
17
      "tracer": "callTracer"
18
    }
19
  ],
20
  "id": 1,
21
  "jsonrpc": "2.0"
22
})
23

24
response = https.request(request)
25
puts response.read_body
26

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/evm")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "debug_traceBlockByNumber",
14
  "params": [
15
    "0xbdd86d",
16
    {
17
      "tracer": "callTracer"
18
    }
19
  ],
20
  "id": 1,
21
  "jsonrpc": "2.0"
22
})
23

24
response = https.request(request)
25
puts response.read_body
26

1
from web3 import HTTPProvider
2
client = HTTPProvider('https://docs-demo.hype-mainnet.quiknode.pro/evm')
3
params = ['0xbdd86d', {'tracer': 'callTracer'}]
4
response = client.make_request('debug_traceBlockByNumber', params)
5
print(response)
6

1
from web3 import HTTPProvider
2
client = HTTPProvider('https://docs-demo.hype-mainnet.quiknode.pro/evm')
3
params = ['0xbdd86d', {'tracer': 'callTracer'}]
4
response = client.make_request('debug_traceBlockByNumber', params)
5
print(response)
6

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free