JSON-RPC總覽

eth_simulateV1:參數、傳回值與 CU

在指定區塊狀態上批次模擬執行呼叫或交易序列,無需廣播上鏈。

用途

在指定區塊狀態上批次模擬執行呼叫或交易序列,無需廣播上鏈。 官方文件

計算單位(CU)與價格

單次呼叫 CU

20 CU

每百萬次呼叫價格(USD)

$2.00

參數

參數名類型說明
payloadobject模擬載荷物件:blockStateCalls(必填)為模擬區塊陣列,每個區塊可含 blockOverrides(區塊頭欄位覆蓋)、stateOverrides(帳戶狀態覆蓋)與 calls(該區塊要執行的呼叫或交易陣列);validation(布林值,預設 false)為 true 時執行與普通 EVM 相同的大部分校驗,為 false 時按 eth_call 處理;traceTransfers(布林值,預設 false)為 true 時把 ETH 轉帳作為 ERC-20 Transfer 事件加入日誌;returnFullTransactions(布林值)為 true 時傳回完整交易物件,否則只傳回雜湊。
blockQUANTITY|TAG|HASH可選,模擬所依據的區塊號(0x 十六進位數量)、區塊雜湊或區塊標籤;預設 'latest'。

傳回值

  • 類型: ARRAY
  • 說明: EthSimulateResult:模擬區塊物件陣列,每個區塊包含 number、hash、parentHash、timestamp、gasLimit、gasUsed、baseFeePerGas、feeRecipient 等區塊頭欄位以及 calls 陣列;每個呼叫含 status(0x1 成功、0x0 失敗)、returnData、gasUsed、maxUsedGas,成功時含 logs,失敗時含 error。

注意事項

開放情況取決於鏈的方法策略(methods.allow)。未開啟該方法的鏈將回傳 -32601 方法未開放(不計費)。

請求範例

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
  }'

可用鏈

除以下鏈外,其餘支援鏈均可用:BNB Smart Chain (bsc_mainnet)、以太坊 (eth_mainnet)、Ethereum Sepolia (eth_sepolia)、HyperEVM (hyperevm_mainnet)。

最後更新: