debug_traceTransaction: parâmetros, retornos e CU

Reproduza a execução de uma transação e inspecione sua árvore de chamadas ou trace de execução.

Visão geral

Reconstrua e execute novamente a transação para gerar um trace de execução. Documentação oficial

Unidades de computação (CU) e preços

CU por chamada

100 CU

Preço por 1M de chamadas (USD)

$10.00

Parâmetros

Parâmetro	Tipo	Descrição
`transactionHash`	`HASH`	Hash de transação de 32 bytes a rastrear em hexadecimal com prefixo 0x.
`options`	`object`	Objeto de opções de trace (opcional): tracer pode ser callTracer, flatCallTracer, prestateTracer, 4byteTracer ou noopTracer; quando omitido, usa o registrador struct padrão, e qualquer outro valor retorna -32602 tracer not allowed; tracerConfig define opções específicas do tracer (como onlyTopCall e withLog para callTracer, diffMode para prestateTracer); timeout é no máximo 30s; reexec define o número do bloco para reexecutar a transação.

Retornos

Tipo: OBJECT
Descrição: Objeto de resultado do trace de execução correspondente ao tracer solicitado (árvore de CallFrame para callTracer ou struct logs por padrão).

Observações

O bloco da transação alvo deve estar dentro da janela de estado da rede (state_window_blocks); requisições fora da janela retornam -32011 (não cobrado).

Exemplo de requisição

export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST "https://api.blockvectra.com/v1/robinhood_mainnet" \
  -H 'Content-Type: application/json' \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "debug_traceTransaction",
    "params": [
      "<transactionHash>",
      {
        "tracer": "callTracer"
      }
    ],
    "id": 1
  }'

Redes suportadas

Disponível em todas as redes compatíveis, exceto: Base (base_mainnet), BNB Smart Chain (bsc_mainnet), Ethereum Sepolia (eth_sepolia), HyperEVM (hyperevm_mainnet).