eth_simulateV1: parâmetros, retornos e CU

Simule um lote de chamadas ou transações em relação ao estado do bloco sem transmissão.

Visão geral

Simule uma sequência de chamadas ou transações no estado de um bloco sem transmiti-las à rede. Documentação oficial

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

CU por chamada

20 CU

Preço por 1M de chamadas (USD)

$2.00

Parâmetros

Parâmetro	Tipo	Descrição
`payload`	`object`	Objeto de payload da simulação: blockStateCalls (obrigatório) é um array de blocos simulados, cada um com blockOverrides opcionais (substituições de cabeçalho de bloco), stateOverrides (substituições de estado de conta) e calls (as chamadas ou transações a executar nesse bloco); validation (booleano, padrão false) executa a maioria das validações padrão da EVM quando true e comporta-se como eth_call quando false; traceTransfers (booleano, padrão false) adiciona transferências de ETH aos logs como eventos Transfer ERC-20; returnFullTransactions (booleano) retorna objetos completos de transação quando true, ou apenas hashes caso contrário.
`block`	`QUANTITY\|TAG\|HASH`	Número de bloco opcional (quantidade hexadecimal com prefixo 0x), hash de bloco ou tag de bloco contra o qual a simulação é executada; o padrão é 'latest'.

Retornos

Tipo: ARRAY
Descrição: EthSimulateResult: um array de objetos de bloco simulados, cada um contendo campos de cabeçalho como number, hash, parentHash, timestamp, gasLimit, gasUsed, baseFeePerGas e feeRecipient, além de um array calls; cada chamada possui status (0x1 sucesso, 0x0 falha), returnData, gasUsed e maxUsedGas, com logs em caso de sucesso ou error em caso de falha.

Observações

A disponibilidade depende da política de métodos da rede (methods.allow). Redes onde este método não está ativado retornam -32601 method not available (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": "eth_simulateV1",
    "params": [
      {
        "blockStateCalls": [
          {
            "calls": [
              {
                "to": "<toAddress>",
                "data": "<callData>"
              }
            ]
          }
        ]
      },
      "latest"
    ],
    "id": 1
  }'

Redes suportadas

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