For the complete documentation index, see llms.txt. This page is also available as Markdown.

debug_traceTransaction - Celo

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

This method returns a detailed trace of a transaction's execution on the Celo network. This is essential for debugging failed transactions, analyzing gas usage, and understanding contract interactions.

Parameters

Parameter
Type
Required
Description

transactionHash

string

Yes

32-byte transaction hash

options

object

No

Tracer configuration options

Options Object

Field
Type
Description

tracer

string

Tracer type: "callTracer", "prestateTracer"

tracerConfig

object

Tracer-specific configuration

timeout

string

Maximum trace duration

Request Example

cURL
curl -X POST https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/ \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": "getblock.io",
  "method": "debug_traceTransaction",
  "params": [
    "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b",
    {"tracer": "callTracer"}
  ]
}'
request.js
const axios = require('axios');

const url = 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/';

const payload = {
  jsonrpc: '2.0',
  id: 'getblock.io',
  method: 'debug_traceTransaction',
  params: [
    '0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b',
    { tracer: 'callTracer' }
  ]
};

axios.post(url, payload, {
  headers: { 'Content-Type': 'application/json' }
})
.then(response => console.log(JSON.stringify(response.data, null, 2)))
.catch(error => console.error(error));

Response Example (callTracer)

Response Definition

Field
Type
Description

result

object

Detailed execution trace

Use Cases

  • Debug failed transactions

  • Analyze internal calls

  • Track gas consumption

  • Understand contract interactions

  • Debug cUSD/cEUR transfers

Error Handling

Error Code
Description

-32602

Invalid params - malformed hash

-32603

Internal error

-32000

Transaction not found

SDK Integration

Last updated

Was this helpful?