debug_traceBlockByNumber RPC Method

This RPC method is included in the Free Trial with limited usage. Upgrade your plan to get full access and higher limits. Learn more on our pricing page.

Parameters

blockNumber

string

REQUIRED

Loading...

object

object

REQUIRED

Loading...

tracer

string

Loading...

callTracer

string

Loading...

prestateTracer

string

Loading...

tracerConfig

object

Loading...

onlyTopCall

boolean

Loading...

Returns

result

object

Loading...

txHash

string

Loading...

result

object

Loading...

from

string

Loading...

gas

string

Loading...

gasUsed

string

Loading...

to

string

Loading...

input

string

Loading...

calls

array

Loading...

from

string

Loading...

gas

string

Loading...

gasUsed

string

Loading...

to

string

Loading...

input

string

Loading...

output

string

Loading...

value

string

Loading...

type

string

Loading...

value

string

Loading...

type

string

Loading...

Request

1
curl -X POST "https://docs-demo.sahara-testnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "debug_traceBlockByNumber",
6
  "params": [
7
    "0x2dc5da",
8
    {
9
      "tracer": "callTracer",
10
      "tracerConfig": {
11
        "onlyTopCall": false
12
      }
13
    }
14
  ],
15
  "id": 1
16
}'

1
curl -X POST "https://docs-demo.sahara-testnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "debug_traceBlockByNumber",
6
  "params": [
7
    "0x2dc5da",
8
    {
9
      "tracer": "callTracer",
10
      "tracerConfig": {
11
        "onlyTopCall": false
12
      }
13
    }
14
  ],
15
  "id": 1
16
}'

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.sahara-testnet.quiknode.pro/");
5
    const response = await provider.send("debug_traceBlockByNumber", [
6
    "0x2dc5da",
7
    {
8
        "tracer": "callTracer",
9
        "tracerConfig": {
10
            "onlyTopCall": false
11
        }
12
    }
13
]);
14
    console.log(response);
15
}
16

17
main();

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.sahara-testnet.quiknode.pro/");
5
    const response = await provider.send("debug_traceBlockByNumber", [
6
    "0x2dc5da",
7
    {
8
        "tracer": "callTracer",
9
        "tracerConfig": {
10
            "onlyTopCall": false
11
        }
12
    }
13
]);
14
    console.log(response);
15
}
16

17
main();

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.sahara-testnet.quiknode.pro/'))
3
response = w3.provider.make_request("debug_traceBlockByNumber", ["0x2dc5da",{"tracer":"callTracer","tracerConfig":{"onlyTopCall":False}}])
4
print(response)

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.sahara-testnet.quiknode.pro/'))
3
response = w3.provider.make_request("debug_traceBlockByNumber", ["0x2dc5da",{"tracer":"callTracer","tracerConfig":{"onlyTopCall":False}}])
4
print(response)

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.sahara-testnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'debug_traceBlockByNumber',
10
        params: [
11
          "0x2dc5da",
12
          {
13
            "tracer": "callTracer",
14
            "tracerConfig": {
15
              "onlyTopCall": false
16
            }
17
          }
18
        ]
19
    })
20

21
    console.log(result)
22
}
23

24
main()

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.sahara-testnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'debug_traceBlockByNumber',
10
        params: [
11
          "0x2dc5da",
12
          {
13
            "tracer": "callTracer",
14
            "tracerConfig": {
15
              "onlyTopCall": false
16
            }
17
          }
18
        ]
19
    })
20

21
    console.log(result)
22
}
23

24
main()

1
import { Core } from '@quicknode/sdk'
2

3
const core = new Core({
4
  endpointUrl: "https://docs-demo.sahara-testnet.quiknode.pro/",
5
})
6

7
core.client
8
  .request({
9
    method: 'debug_traceBlockByNumber',
10
    params: ["0x2dc5da",{"tracer":"callTracer","tracerConfig":{"onlyTopCall":false}}]
11
  })
12
  .then(res => console.log(res))

1
import { Core } from '@quicknode/sdk'
2

3
const core = new Core({
4
  endpointUrl: "https://docs-demo.sahara-testnet.quiknode.pro/",
5
})
6

7
core.client
8
  .request({
9
    method: 'debug_traceBlockByNumber',
10
    params: ["0x2dc5da",{"tracer":"callTracer","tracerConfig":{"onlyTopCall":false}}]
11
  })
12
  .then(res => console.log(res))

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'debug_traceBlockByNumber',
4
    params: ["0x2dc5da",{"tracer":"callTracer","tracerConfig":{"onlyTopCall":false}}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.sahara-testnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'debug_traceBlockByNumber',
4
    params: ["0x2dc5da",{"tracer":"callTracer","tracerConfig":{"onlyTopCall":false}}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.sahara-testnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.sahara-testnet.quiknode.pro/"
5

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

24
response = requests.request("POST", url, headers=headers, data=payload)
25

26
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.sahara-testnet.quiknode.pro/"
5

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

24
response = requests.request("POST", url, headers=headers, data=payload)
25

26
print(response.text)

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

5
uri = URI("https://docs-demo.sahara-testnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "debug_traceBlockByNumber",
11
  params: ["0x2dc5da",{"tracer":"callTracer","tracerConfig":{"onlyTopCall":false}}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

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

5
uri = URI("https://docs-demo.sahara-testnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "debug_traceBlockByNumber",
11
  params: ["0x2dc5da",{"tracer":"callTracer","tracerConfig":{"onlyTopCall":false}}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": [
5
    {
6
      "txHash": "0x6cc56a0fd329eb2334aab05b4ddea02c3eee0ffca86477c6eca15f5c09b4dade",
7
      "result": {
8
        "from": "0xdd9e752d8cd7864c8b67bf22be9bfc760a038630",
9
        "gas": "0x13622",
10
        "gasUsed": "0x132a4",
11
        "to": "0x0a05d8c72bb1991e526b0357491043fadeb40ef9",
12
        "input": "0x77f64b8200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000095000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000c3e3d57206b851c7485dbee092d77a759658321dbb2f2a88c6fff31c70f54596257130bcca4895fe0e0454f2f71fee0ed5ca060fb230bfae581a4d8dcecda682f61cf4aed36727cb0f26ae4c7d544be31b62f3772f435bd9cbe03bacbc881453de612ad1ac0a0e41ad4d766d9ac95497740a6df43516095617b01184dd3429ba0d701c92d8813cd0bdb788b333516f7e238aa06ce5534bd0f7f0f7de5366cc51317f9172407f12d418136f28b44627e5286ddd8d9a67eb72e46a1dfee10f1153e4136e1c0000000000000000000000000000000000000000000000000000000000",
13
        "calls": [
14
          {
15
            "from": "0x0a05d8c72bb1991e526b0357491043fadeb40ef9",
16
            "gas": "0xbee4",
17
            "gasUsed": "0xbe4a",
18
            "to": "0xadd29dd9c7e81ca18e82be4546661be0edaa3596",
19
            "input": "0x77f64b8200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000095000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000c3e3d57206b851c7485dbee092d77a759658321dbb2f2a88c6fff31c70f54596257130bcca4895fe0e0454f2f71fee0ed5ca060fb230bfae581a4d8dcecda682f61cf4aed36727cb0f26ae4c7d544be31b62f3772f435bd9cbe03bacbc881453de612ad1ac0a0e41ad4d766d9ac95497740a6df43516095617b01184dd3429ba0d701c92d8813cd0bdb788b333516f7e238aa06ce5534bd0f7f0f7de5366cc51317f9172407f12d418136f28b44627e5286ddd8d9a67eb72e46a1dfee10f1153e4136e1c0000000000000000000000000000000000000000000000000000000000",
20
            "calls": [
21
              {
22
                "from": "0x0a05d8c72bb1991e526b0357491043fadeb40ef9",
23
                "gas": "0x897f",
24
                "gasUsed": "0xbb8",
25
                "to": "0x0000000000000000000000000000000000000001",
26
                "input": "0xac7095c292a344d11ab0ceb229decf61137c059801f12b553f2ed31a4313d9d0000000000000000000000000000000000000000000000000000000000000001ce3d57206b851c7485dbee092d77a759658321dbb2f2a88c6fff31c70f54596257130bcca4895fe0e0454f2f71fee0ed5ca060fb230bfae581a4d8dcecda682f6",
27
                "output": "0x000000000000000000000000e6909876804194aea034b0f7217ac10bd2a54032",
28
                "type": "STATICCALL"
29
              },
30
              {
31
                "from": "0x0a05d8c72bb1991e526b0357491043fadeb40ef9",
32
                "gas": "0x6f48",
33
                "gasUsed": "0xbb8",
34
                "to": "0x0000000000000000000000000000000000000001",
35
                "input": "0xac7095c292a344d11ab0ceb229decf61137c059801f12b553f2ed31a4313d9d0000000000000000000000000000000000000000000000000000000000000001cf4aed36727cb0f26ae4c7d544be31b62f3772f435bd9cbe03bacbc881453de612ad1ac0a0e41ad4d766d9ac95497740a6df43516095617b01184dd3429ba0d70",
36
                "output": "0x00000000000000000000000062d5b0d79b6c72fc6ad92252c1e5fb5a2f81d1fb",
37
                "type": "STATICCALL"
38
              },
39
              {
40
                "from": "0x0a05d8c72bb1991e526b0357491043fadeb40ef9",
41
                "gas": "0x5513",
42
                "gasUsed": "0xbb8",
43
                "to": "0x0000000000000000000000000000000000000001",
44
                "input": "0xac7095c292a344d11ab0ceb229decf61137c059801f12b553f2ed31a4313d9d0000000000000000000000000000000000000000000000000000000000000001c92d8813cd0bdb788b333516f7e238aa06ce5534bd0f7f0f7de5366cc51317f9172407f12d418136f28b44627e5286ddd8d9a67eb72e46a1dfee10f1153e4136e",
45
                "output": "0x000000000000000000000000ed2ff3d1c231565c8348acf10cde5fcd440e3f08",
46
                "type": "STATICCALL"
47
              },
48
              {
49
                "from": "0x0a05d8c72bb1991e526b0357491043fadeb40ef9",
50
                "gas": "0x3478",
51
                "gasUsed": "0x2dcb",
52
                "to": "0x6eaf8762bb858a9c432614a354751d4269c51831",
53
                "input": "0xd345216c000000000000000000000000dd9e752d8cd7864c8b67bf22be9bfc760a03863000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000095",
54
                "value": "0x0",
55
                "type": "CALL"
56
              }
57
            ],
58
            "value": "0x0",
59
            "type": "DELEGATECALL"
60
          }
61
        ],
62
        "value": "0x0",
63
        "type": "CALL"
64
      }
65
    },
66
    {
67
      "txHash": "0x1f5526a34f7864495bb7bd6e124773755b742b9ebd1284c48b9cd59e3b8a7f35",
68
      "result": {
69
        "from": "0x051420781850c9749e11c16c78175fa36df56586",
70
        "gas": "0x5208",
71
        "gasUsed": "0x5208",
72
        "to": "0x051420781850c9749e11c16c78175fa36df56586",
73
        "input": "0x",
74
        "value": "0x7a7b4d830c00",
75
        "type": "CALL"
76
      }
77
    },
78
    {
79
      "txHash": "0x130d1b9d8f1898a2357239a2da41a54d8ed5416f03ac0a9a8125a46bf37ed4c7",
80
      "result": {
81
        "from": "0xb492f52dab0487861494d4f53fcfeedc1c962492",
82
        "gas": "0x5208",
83
        "gasUsed": "0x5208",
84
        "to": "0xb492f52dab0487861494d4f53fcfeedc1c962492",
85
        "input": "0x",
86
        "value": "0x0",
87
        "type": "CALL"
88
      }
89
    }
90
  ]
91
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": [
5
    {
6
      "txHash": "0x6cc56a0fd329eb2334aab05b4ddea02c3eee0ffca86477c6eca15f5c09b4dade",
7
      "result": {
8
        "from": "0xdd9e752d8cd7864c8b67bf22be9bfc760a038630",
9
        "gas": "0x13622",
10
        "gasUsed": "0x132a4",
11
        "to": "0x0a05d8c72bb1991e526b0357491043fadeb40ef9",
12
        "input": "0x77f64b8200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000095000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000c3e3d57206b851c7485dbee092d77a759658321dbb2f2a88c6fff31c70f54596257130bcca4895fe0e0454f2f71fee0ed5ca060fb230bfae581a4d8dcecda682f61cf4aed36727cb0f26ae4c7d544be31b62f3772f435bd9cbe03bacbc881453de612ad1ac0a0e41ad4d766d9ac95497740a6df43516095617b01184dd3429ba0d701c92d8813cd0bdb788b333516f7e238aa06ce5534bd0f7f0f7de5366cc51317f9172407f12d418136f28b44627e5286ddd8d9a67eb72e46a1dfee10f1153e4136e1c0000000000000000000000000000000000000000000000000000000000",
13
        "calls": [
14
          {
15
            "from": "0x0a05d8c72bb1991e526b0357491043fadeb40ef9",
16
            "gas": "0xbee4",
17
            "gasUsed": "0xbe4a",
18
            "to": "0xadd29dd9c7e81ca18e82be4546661be0edaa3596",
19
            "input": "0x77f64b8200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000095000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000c3e3d57206b851c7485dbee092d77a759658321dbb2f2a88c6fff31c70f54596257130bcca4895fe0e0454f2f71fee0ed5ca060fb230bfae581a4d8dcecda682f61cf4aed36727cb0f26ae4c7d544be31b62f3772f435bd9cbe03bacbc881453de612ad1ac0a0e41ad4d766d9ac95497740a6df43516095617b01184dd3429ba0d701c92d8813cd0bdb788b333516f7e238aa06ce5534bd0f7f0f7de5366cc51317f9172407f12d418136f28b44627e5286ddd8d9a67eb72e46a1dfee10f1153e4136e1c0000000000000000000000000000000000000000000000000000000000",
20
            "calls": [
21
              {
22
                "from": "0x0a05d8c72bb1991e526b0357491043fadeb40ef9",
23
                "gas": "0x897f",
24
                "gasUsed": "0xbb8",
25
                "to": "0x0000000000000000000000000000000000000001",
26
                "input": "0xac7095c292a344d11ab0ceb229decf61137c059801f12b553f2ed31a4313d9d0000000000000000000000000000000000000000000000000000000000000001ce3d57206b851c7485dbee092d77a759658321dbb2f2a88c6fff31c70f54596257130bcca4895fe0e0454f2f71fee0ed5ca060fb230bfae581a4d8dcecda682f6",
27
                "output": "0x000000000000000000000000e6909876804194aea034b0f7217ac10bd2a54032",
28
                "type": "STATICCALL"
29
              },
30
              {
31
                "from": "0x0a05d8c72bb1991e526b0357491043fadeb40ef9",
32
                "gas": "0x6f48",
33
                "gasUsed": "0xbb8",
34
                "to": "0x0000000000000000000000000000000000000001",
35
                "input": "0xac7095c292a344d11ab0ceb229decf61137c059801f12b553f2ed31a4313d9d0000000000000000000000000000000000000000000000000000000000000001cf4aed36727cb0f26ae4c7d544be31b62f3772f435bd9cbe03bacbc881453de612ad1ac0a0e41ad4d766d9ac95497740a6df43516095617b01184dd3429ba0d70",
36
                "output": "0x00000000000000000000000062d5b0d79b6c72fc6ad92252c1e5fb5a2f81d1fb",
37
                "type": "STATICCALL"
38
              },
39
              {
40
                "from": "0x0a05d8c72bb1991e526b0357491043fadeb40ef9",
41
                "gas": "0x5513",
42
                "gasUsed": "0xbb8",
43
                "to": "0x0000000000000000000000000000000000000001",
44
                "input": "0xac7095c292a344d11ab0ceb229decf61137c059801f12b553f2ed31a4313d9d0000000000000000000000000000000000000000000000000000000000000001c92d8813cd0bdb788b333516f7e238aa06ce5534bd0f7f0f7de5366cc51317f9172407f12d418136f28b44627e5286ddd8d9a67eb72e46a1dfee10f1153e4136e",
45
                "output": "0x000000000000000000000000ed2ff3d1c231565c8348acf10cde5fcd440e3f08",
46
                "type": "STATICCALL"
47
              },
48
              {
49
                "from": "0x0a05d8c72bb1991e526b0357491043fadeb40ef9",
50
                "gas": "0x3478",
51
                "gasUsed": "0x2dcb",
52
                "to": "0x6eaf8762bb858a9c432614a354751d4269c51831",
53
                "input": "0xd345216c000000000000000000000000dd9e752d8cd7864c8b67bf22be9bfc760a03863000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000095",
54
                "value": "0x0",
55
                "type": "CALL"
56
              }
57
            ],
58
            "value": "0x0",
59
            "type": "DELEGATECALL"
60
          }
61
        ],
62
        "value": "0x0",
63
        "type": "CALL"
64
      }
65
    },
66
    {
67
      "txHash": "0x1f5526a34f7864495bb7bd6e124773755b742b9ebd1284c48b9cd59e3b8a7f35",
68
      "result": {
69
        "from": "0x051420781850c9749e11c16c78175fa36df56586",
70
        "gas": "0x5208",
71
        "gasUsed": "0x5208",
72
        "to": "0x051420781850c9749e11c16c78175fa36df56586",
73
        "input": "0x",
74
        "value": "0x7a7b4d830c00",
75
        "type": "CALL"
76
      }
77
    },
78
    {
79
      "txHash": "0x130d1b9d8f1898a2357239a2da41a54d8ed5416f03ac0a9a8125a46bf37ed4c7",
80
      "result": {
81
        "from": "0xb492f52dab0487861494d4f53fcfeedc1c962492",
82
        "gas": "0x5208",
83
        "gasUsed": "0x5208",
84
        "to": "0xb492f52dab0487861494d4f53fcfeedc1c962492",
85
        "input": "0x",
86
        "value": "0x0",
87
        "type": "CALL"
88
      }
89
    }
90
  ]
91
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free