# eth_estimateGas：參數、傳回值與 CU

> Source: https://docs.blockvectra.com/zh-hant/api/json-rpc/methods/eth_estimateGas/

## 用途

估算一筆交易執行所需的 gas 上限。

## 計算單位（CU）與價格

- 單次呼叫 CU: 20 CU
- 每百萬次呼叫價格（USD）: $2.00

## 參數

| 參數名 | 類型 | 說明 |
| --- | --- | --- |
| `transaction` | `object` | 交易呼叫物件，可包含 from、to、gas、gasPrice、maxFeePerGas、maxPriorityFeePerGas、value、data/input 等欄位；它只用於模擬，不會真正改變鏈上狀態，也不消耗 gas。 |
| `blockParameter` | `QUANTITY\|TAG` | 可選，用於估算的區塊高度或標籤：latest 或 pending；safe、finalized、earliest 回傳 -32011（不計費）；預設按最新區塊。 |

## 傳回值

- **類型**: `QUANTITY`
- **說明**: 估算出的 gas 數量，0x 十六進位數量。

## 注意事項

估算依據指定區塊的狀態執行；若該呼叫會回滾，通常回傳錯誤而不是數值。

## 請求範例

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

## 可用鏈

全部 9 條支援鏈均可用。
