> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gelato.cloud/llms.txt
> Use this file to discover all available pages before exploring further.
# eth_sendUserOperation
> Sends a `UserOperation` to the specified network.
Before using the API Endpoints, make sure to check out the [How-To Guides](/paymaster-&-bundler/how-to-guides/create-a-api-key) to understand the required parameters for different payment methods with the Gelato Bundler.
The API Playground below defaults to `EntryPoint v0.7` & `EntryPoint v0.8` 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.
## OpenAPI
````yaml /paymaster-&-bundler/bundler-api-endpoints/erc4337/eth_sendUserOperation.json post /rpc/{chainId}
openapi: 3.1.0
info:
title: eth_sendUserOperation
version: 1.0.0
servers:
- url: https://api.gelato.cloud
security: []
paths:
/rpc/{chainId}:
post:
summary: eth_sendUserOperation
description: Sends a `UserOperation` to the specified network.
parameters:
- name: chainId
in: path
required: true
schema:
type: number
description: Target network chain identifier.
- name: payment
in: query
required: false
schema:
type: string
enum:
- sponsored
- native
- erc20
description: >-
Payment method for gas fees. Use 'sponsored' for Gas Tank
sponsorship.
- name: X-API-Key
in: header
required: true
schema:
type: string
description: >-
Gelato API key for higher rate limits. This must be provided if
sponsoring off-chain via Gas Tank.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Request'
example:
id: 1
jsonrpc: '2.0'
method: eth_sendUserOperation
params:
- sender: 0x....
nonce: 0x....
factory: 0x....
factoryData: 0x....
callData: 0x....
signature: 0x....
maxFeePerGas: 0x....
maxPriorityFeePerGas: 0x....
callGasLimit: 0x....
verificationGasLimit: 0x....
preVerificationGas: 0x....
paymaster: 0x....
paymasterData: 0x....
paymasterPostOpGasLimit: 0x....
paymasterVerificationGasLimit: 0x....
eip7702Auth:
address: 0x....
chainId: 0x....
nonce: 0x....
r: 0x....
s: 0x....
yParity: 0x....
- '0x0000000071727De22E5E9d8BAf0edAc6f37da032'
required: true
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'400':
description: Validation error
content:
application/json:
schema:
type: object
properties:
message:
type: string
components:
schemas:
Request:
type: object
properties:
id:
type: number
default: 1
jsonrpc:
type: string
default: '2.0'
method:
type: string
default: eth_sendUserOperation
params:
type: array
description: >
1. Object - The `UserOperation` object
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.
minItems: 2
maxItems: 2
items:
oneOf:
- $ref: '#/components/schemas/UserOperationEntryPoint0.7'
- $ref: '#/components/schemas/UserOperationEntryPoint0.6'
- $ref: '#/components/schemas/EntryPointAddress'
Response:
type: object
properties:
id:
type: number
default: 1
jsonrpc:
type: string
default: '2.0'
result:
type: string
description: Resulting `userOpHash` for the valid `UserOperation`
default: '0x13574b2256b73bdc33fb121052f64b3803161e5ec602a6dc9e56177ba387e700'
UserOperationEntryPoint0.7:
type: object
title: '`UserOperationEntryPoint0.7`'
properties:
sender:
type: string
description: >-
The address of the account initiating the UserOperation. Can be a
counterfactual address if the account is yet to be deployed.
nonce:
type: string
description: >-
A unique sequential number used to prevent replay attacks and ensure
correct execution ordering.
factory:
type: string
description: >-
The address of the contract responsible for deploying the smart
account, if the account is not yet deployed.
factoryData:
type: string
description: >-
Encoded constructor or init data to be passed to the factory
contract for creating the smart account.
eip7702Auth:
$ref: '#/components/schemas/eip7702Auth'
callData:
type: string
description: >-
Encoded data specifying one or more function calls the smart account
will execute during the operation.
signature:
type: string
description: >-
Cryptographic signature (or authorization data) from the account,
used to prove that the operation is valid and authorized.
callGasLimit:
type: string
description: >-
The maximum gas allocated for executing the account's internal calls
(i.e., the actual transaction logic).
verificationGasLimit:
type: string
description: >-
The maximum gas allocated for validating the operation (e.g.,
account creation, signature verification, etc.).
preVerificationGas:
type: string
description: >-
Estimated gas consumed before UserOperation execution (e.g.,
calldata decoding, signature validation). Bundler is compensated for
this gas (0x0 for sponsored payments)
maxFeePerGas:
type: string
description: >-
Maximum total gas price (base fee + priority fee) the user is
willing to pay per unit of gas (0x0 for sponsored payments)
maxPriorityFeePerGas:
type: string
description: >-
Maximum tip (priority fee) per unit of gas to incentivize bundlers
(0x0 for sponsored payments)
paymaster:
type: string
description: Paymaster address (Empty for sponsored and native payments)
paymasterData:
type: string
description: Paymaster data (Empty for sponsored and native payments)
paymasterPostOpGasLimit:
type: string
description: >-
Paymaster post-operation gas limit (Empty for sponsored and native
payments)
paymasterVerificationGasLimit:
type: string
description: >-
Paymaster verification gas limit (Empty for sponsored and native
payments)
required:
- sender
- nonce
- callData
- signature
- callGasLimit
- verificationGasLimit
- preVerificationGas
- maxFeePerGas
- maxPriorityFeePerGas
UserOperationEntryPoint0.6:
type: object
title: '`UserOperationEntryPoint0.6`'
properties:
sender:
type: string
description: >-
The address of the account initiating the UserOperation. Can be a
counterfactual address if the account is yet to be deployed.
nonce:
type: string
description: >-
A unique sequential number used to prevent replay attacks and ensure
correct execution ordering.
initCode:
type: string
description: Applicable when account is not deployed
eip7702Auth:
$ref: '#/components/schemas/eip7702Auth'
callData:
type: string
description: >-
Encoded data specifying one or more function calls the smart account
will execute during the operation.
signature:
type: string
description: >-
Cryptographic signature (or authorization data) from the account,
used to prove that the operation is valid and authorized.
callGasLimit:
type: string
description: >-
The maximum gas allocated for executing the account's internal calls
(i.e., the actual transaction logic).
verificationGasLimit:
type: string
description: >-
The maximum gas allocated for validating the operation (e.g.,
account creation, signature verification, etc.).
preVerificationGas:
type: string
description: >-
Estimated gas consumed before UserOperation execution (e.g.,
calldata decoding, signature validation). Bundler is compensated for
this gas (0x0 for sponsored payments)
maxFeePerGas:
type: string
description: >-
Maximum total gas price (base fee + priority fee) the user is
willing to pay per unit of gas (0x0 for sponsored payments)
maxPriorityFeePerGas:
type: string
description: >-
Maximum tip (priority fee) per unit of gas to incentivize bundlers
(0x0 for sponsored payments)
paymasterData:
type: string
description: Paymaster data (Empty for sponsored and native payments)
required:
- sender
- nonce
- callData
- signature
- callGasLimit
- verificationGasLimit
- preVerificationGas
- maxFeePerGas
- maxPriorityFeePerGas
EntryPointAddress:
type: string
title: '`EntryPointAddress`'
default: '0x0000000071727De22E5E9d8BAf0edAc6f37da032'
eip7702Auth:
type: object
title: eip7702Auth
description: The authorization object that an EOA account delegates to in EIP-7702
properties:
address:
type: string
description: The address of the authorization
chainId:
type: string
description: The chain Id of the authorization
nonce:
type: string
description: The nonce for the authorization
r:
type: string
description: R parameter of signed authorization
s:
type: string
description: S parameter of signed authorization
yParity:
type: string
description: Y parity parameter of signed authorization
````