eth_estimateGas

Generates and returns an estimate of how much gas is necessary to allow the transaction to complete.

Params

(2)

1. Transaction (required)

type

string

Match pattern:

^0x([0-9a-fA-F]?){1,2}$

nonce

string

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

from

string

Match pattern:

^0x[0-9a-fA-F]{40}$

gas

string

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

value

string

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

input

string

Match pattern:

^0x[0-9a-f]*$

gasPrice

string

The gas price willing to be paid by the sender in wei

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

maxPriorityFeePerGas

string

Maximum fee per gas the sender is willing to pay to miners in wei

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

maxFeePerGas

string

The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

maxFeePerBlobGas

string

The maximum total fee per gas the sender is willing to pay for blob gas in wei

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

accessList

array[Access list entry]

EIP-2930 access list

address

string

required

Match pattern:

^0x[0-9a-fA-F]{40}$

storageKeys

array[string]

required

Match pattern:

^0x[0-9a-f]{64}$

blobVersionedHashes

array[string]

List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.

Match pattern:

^0x[0-9a-f]{64}$

blobs

array[string]

Raw blob data.

Match pattern:

^0x[0-9a-f]*$

chainId

string

Chain ID that this transaction is valid on.

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

authorizationList

array[object]

EIP-7702 authorization list

chainId

string

required

Chain ID on which this transaction is valid

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

nonce

string

required

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

address

string

required

Match pattern:

^0x[0-9a-fA-F]{40}$

yParity

string

required

The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature

Match pattern:

^0x([0-9a-fA-F]?){1,2}$

string

required

Match pattern:

^0x(0|[1-9a-f][0-9a-f]{0,63})$

string

required

Match pattern:

^0x(0|[1-9a-f][0-9a-f]{0,63})$

2. Block

Block number

(one of)

string

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

Result

(Gas used)

string

Match pattern:

^0x(0|[1-9a-f][0-9a-f]*)$

Example

Request

await window.ethereum.request({
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73",
      "to": "0x44aa93095d6749a706051658b970b941c72c1d53",
      "value": "0x1"
    }
  ]
});

Result

"0x5208"