JSON-RPC方法

eth_estimateGas:参数、返回值与 CU

用 eth_estimateGas 估算一笔交易执行所需的 gas 上限,调用只做模拟,不改变链上状态也不消耗 gas;发送交易前可用它设置合理上限,若调用会回滚通常返回错误而非数值。

用途

估算一笔交易执行所需的 gas 上限。

计算单位(CU)与价格

单次调用 CU

20 CU

每百万次调用价格(USD)

$2.00

参数

参数名类型说明
transactionobject交易调用对象,可包含 from、to、gas、gasPrice、maxFeePerGas、maxPriorityFeePerGas、value、data/input 等字段;它只用于模拟,不会真正改变链上状态,也不消耗 gas。其中 value、gas、gasPrice、maxFeePerGas、maxPriorityFeePerGas 是 Quantity:以最短非负整数十六进制编码,0x0 表示零、0x1 表示一;0x、0x00、0x01 都不是合法 Quantity。data/input 是完整字节 Data:0x 为空、0x00 是一个零字节、0x0001 是两个字节,须保留 Data 的前导零。不要把 address、hash、signature 或任意 0x 字段当作 Quantity。
blockParameterQUANTITY|TAG可选,用于估算的区块高度或标签:latest 或 pending;safe、finalized、earliest 返回 -32011(不计费);默认按最新区块。

返回值

  • 类型: QUANTITY
  • 说明: 估算出的 gas 数量,0x 十六进制数量。

注意事项

估算依据指定区块的状态执行;若该调用会回滚,通常返回错误而不是数值。

请求示例

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_estimateGas",
    "params": [
      {
        "to": "0x0000000000000000000000000000000000000000",
        "data": "0x"
      },
      "latest"
    ],
    "id": 1
  }'

可用链

全部 29 条支持链均可用。

最后更新: