POST
/
bundlers
/
{chainId}
/
rpc
eth_estimateUserOperationGas
curl --request POST \
  --url https://api.gelato.digital/bundlers/{chainId}/rpc \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_estimateUserOperationGas",
  "params": [
    {
      "sender": "0x....",
      "nonce": "0x....",
      "factory": "0x....",
      "factoryData": "0x....",
      "authorization": "0x....",
      "callData": "0x....",
      "signature": "0x....",
      "maxFeePerGas": "0x....",
      "maxPriorityFeePerGas": "0x....",
      "paymaster": "0x....",
      "paymasterData": "0x...."
    },
    "0x0000000071727De22E5E9d8BAf0edAc6f37da032",
    {
      "0xsender": {
        "balance": "0x....",
        "nonce": "0x....",
        "code": "0x...."
      }
    }
  ]
}'
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "preVerificationGas": "0x0",
    "verificationGasLimit": "0x148a6",
    "callGasLimit": "0x358e"
  }
}
Update: State overrides are now supported in this API endpoint. Checkout this example and Guide to understand how to use it.
  • In the Playground, click Add an Item to include the StateOverrideSet object.
  • Then, click Add a Property and add sender address there.
  • Now you can add the override values such as balance, nonce, code, state, stateDiff etc.
Before using the API Endpoints, make sure to check out the Quick Start guide to understand the required parameters for different payment methods with the Gelato Bundler.
The API Playground below defaults to EntryPoint v0.7 parameters, If you’re working with EntryPoint v0.6, please change the object parameter to UserOperationEntryPoint0.6.Important: After entering the userOperation parameters, make sure to click Add an Item to include the EntryPoint address.

Path Parameters

​
chainId
number
required

Target network chain identifier.

Query Parameters

​
apiKey
string

Gelato API key for higher rate limits. This must be provided if sponsoring off-chain via Gas Tank.

​
sponsored
boolean

Whether the request should be sponsored off-chain via Gas Tank

Body

application/json
​
id
number
default:1
​
jsonrpc
string
default:2.0
​
method
string
default:eth_estimateUserOperationGas
​
params
(`UserOperationEntryPoint0.7` · object | `UserOperationEntryPoint0.6` · object | string | `StateOverrideSet` · object)[]
  1. Object - The UserOperation object (gas limits and prices are optional)
  2. String - The EntryPoint address the request should be sent through. This MUST be one of the entry points returned by the eth_supportedEntryPoints rpc call.
  3. Object - Optional state override set that allows changes to the state of a contract before executing the call.
Required array length: 2 - 3 elements

Response

Successful response

​
id
number
default:1
​
jsonrpc
string
default:2.0
​
result
object