debug_traceBlockByNumber - Mantle

Example code for the debug_traceBlockByNumber JSON-RPC method. Complete guide on how to use debug_traceBlockByNumber JSON-RPC in GetBlock Web3 documentation.

This method traces the execution of all transactions within a block specified by block number on the Mantle network. This is a premium method available on Mantle Sepolia Testnet.

Parameters

Parameter

Type

Description

blockNumber

string

Block number in hex, or "latest", "earliest"

traceOptions

object

(optional) Tracing options

Trace Options:

Field

Type

Description

tracer

string

Tracer type: "callTracer", "prestateTracer"

timeout

string

Timeout for the trace

tracerConfig

object

Configuration for the tracer

Request examples

curl

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "debug_traceBlockByNumber",
    "params": ["0x3F6777", {"tracer": "callTracer", "timeout": "5s"}],
    "id": "getblock.io"
}'

index.js

import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "debug_traceBlockByNumber",
    "params": ["0x3F6777", {"tracer": "callTracer", "timeout": "5s"}],
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://go.getblock.io/<ACCESS-TOKEN>/',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data)))
    .catch(error => console.log(error));

trace_block.py

import requests
import json

url = "https://go.getblock.io/<ACCESS-TOKEN>/"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "debug_traceBlockByNumber",
    "params": ["0x3F6777", {"tracer": "callTracer", "timeout": "5s"}],
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

main.rs

use reqwest::header;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
    
    let response = client
        .post("https://go.getblock.io/<ACCESS-TOKEN>/")
        .header(header::CONTENT_TYPE, "application/json")
        .body(r#"{
            "jsonrpc": "2.0",
            "method": "debug_traceBlockByNumber",
            "params": ["0x3F6777", {"tracer": "callTracer", "timeout": "5s"}],
            "id": "getblock.io"
        }"#)
        .send()
        .await?;
    
    println!("{}", response.text().await?);
    Ok(())
}

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": [
        {
            "txHash": "0x...",
            "result": {
                "type": "CALL",
                "from": "0x...",
                "to": "0x...",
                "value": "0x0",
                "gas": "0x...",
                "gasUsed": "0x...",
                "input": "0x...",
                "output": "0x..."
            }
        }
    ]
}

Response Parameters

Field

Type

Description

txHash

string

Transaction hash

result

object

Trace result for the transaction

type

string

Call type (CALL, DELEGATECALL, etc.)

from

string

Sender address

string

Recipient address

gasUsed

string

Gas used

Use Case

The debug_traceBlockByNumber method is essential for:

Sequential block analysis
Historical block tracing
Gas profiling over block ranges
Chain state debugging
Protocol monitoring
Block indexing with traces

Error Handling

Status Code

Error Message

Cause

403

Forbidden

Missing or invalid ACCESS-TOKEN

-32602

Invalid params

Invalid block number

-32000

Block not found

Block does not exist

Web3 Integration

ethers.js

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://go.getblock.io/<ACCESS-TOKEN>/');

const trace = await provider.send('debug_traceBlockByNumber', [
    '0x3F6777',
    { tracer: 'callTracer', timeout: '5s' }
]);
console.log('Block trace:', trace);

viem.js

import { createPublicClient, http } from 'viem';
import { mantle } from 'viem/chains';

const client = createPublicClient({
    chain: mantle,
    transport: http('https://go.getblock.io/<ACCESS-TOKEN>/')
});

const trace = await client.request({
    method: 'debug_traceBlockByNumber',
    params: [
        '0x3F6777',
        { tracer: 'callTracer', timeout: '5s' }
    ]
});
console.log('Block trace:', trace);

Previousweb3_sha3 - Mantle Nextdebug_traceTransaction - Mantle

Last updated 4 days ago

Was this helpful?