# Bundler API

The Bundler exposes the standard ERC-4337 JSON-RPC API.

## EntryPoint v0.9[​](#entrypoint-v09 "Direct link to EntryPoint v0.9")

EntryPoint v0.9 maintains ABI compatibility with v0.8, requiring no changes to existing Accounts and Paymasters unless adopting new features. Key additions include:

* **Parallelizable Paymaster Signing**: A new `paymasterSignature` field allows passing data to Paymasters after UserOperation signing, eliminating delays between user action and confirmation.
* **Block Number-Based Validity Ranges**: The highest bit of `validAfter` and `validUntil` now indicates block number-based validity instead of timestamps.
* **Flexible InitCode Handling**: `initCode` is silently ignored if the Account already exists, enabling two-dimensional nonce usage.
* **UserOp Hash Query**: New `getCurrentUserOpHash` function exposes the current UserOperation hash during execution for third-party contracts.

### eth\_sendUserOperation[​](#eth_senduseroperation "Direct link to eth_sendUserOperation")

`eth_sendUserOperation` asks the bundler to sign and submit a UserOperation.

#### Example Request[​](#example-request "Direct link to Example Request")

```
{
    jsonrpc: "2.0",
    id: 1,
    method: "eth_sendUserOperation",
    "params": [
      {
        'sender': '0xBdbc5FBC9cA8C3F514D073eC3de840Ac84FC6D31',
        'nonce': '0x13',
        'callData': '0x34fcd5be...',
        'callGasLimit': '0x2c3d',
        'verificationGasLimit': '0x15881',
        'preVerificationGas': '0xb7f8',
        'maxFeePerGas': '0x2c05b3',
        'maxPriorityFeePerGas': '0x2c05a2',
        'signature': '0x62f505...',
        'factory': None,
        'factoryData': None,
        'paymaster': None,
        'paymasterVerificationGasLimit': None,
        'paymasterPostOpGasLimit': None,
        'paymasterData': None,
        'paymasterSignature': None, // new in v0.9: allows parallelizable paymaster signing
        'eip7702auth': {
          'chainId': '0x4268',
          'address': '0xa46cc63eBF4Bd77888AA327837d20b23A63a56B5',
          'nonce': '0x0f',
          'yParity': '0x00',
          'r': '0xf37fca7f67bc0b336adfeefe42a8856ca1e6dee48b1ce7748a4044acfe283b01',
          's': '0x60ab7d22e278dc43b0b37afada54666c0bf9e0beb9f0cd0159de007d127f3406'
        }
      },
      '0x433709009B8330FDa32311DF1C2AFA402eD8D009',
    ]
}
```

#### Response[​](#response "Direct link to Response")

It returns the hash of the User Operation. In case of an error, it returns the error message.

* success
* example error

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "result": "0x1234...5678" // UserOpHash
}
```

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "message": "AA21 didn't pay prefund",
    "code": -32500
  }
}
```

### eth\_estimateUserOperationGas[​](#eth_estimateuseroperationgas "Direct link to eth_estimateUserOperationGas")

`eth_estimateUserOperationGas` generates and returns an estimate of how much gas is necessary to allow the transaction to complete, given a `UserOperation`.

The signature field is ignored by the wallet, so that the operation will not require the user's approval. Still, it might require putting a "semi-valid" signature (e.g. a signature in the right length)

#### Example Request[​](#example-request-1 "Direct link to Example Request")

```
{
  jsonrpc: "2.0",
  id: 1,
  method: "eth_estimateUserOperationGas",
  "params": [
  [
   {
      sender, // address
      nonce, // uint256
      factory, // address
      factoryData, // bytes
      callData, // bytes
      callGasLimit, // uint256
      verificationGasLimit, // uint256
      preVerificationGas, // uint256
      maxFeePerGas, // uint256
      maxPriorityFeePerGas, // uint256
      paymaster, // address
      paymasterVerificationGasLimit, // uint256
      paymasterPostOpGasLimit, // uint256
      paymasterData, // bytes
      paymasterSignature, // bytes (new in v0.9: parallelizable paymaster signing)
      signature // bytes
      'eip7702auth': {
        'chainId': '0x4268',
        'address': '0xa46cc63eBF4Bd77888AA327837d20b23A63a56B5', // must be valid delegation address for simulation
        'nonce': '0x0f',
        'yParity': '0x00',
        'r': '0xf37fca7f67bc0b336adfeefe42a8856ca1e6dee48b1ce7748a4044acfe283b01', // can pass a dummy signature during estimates
        's': '0x60ab7d22e278dc43b0b37afada54666c0bf9e0beb9f0cd0159de007d127f3406' // can pass a dummy signature during estimates
      }
    }
    '0x433709009B8330FDa32311DF1C2AFA402eD8D009'
  ]
}
```

#### Response[​](#response-1 "Direct link to Response")

It returns estimates for a UserOperation Gas parameters for:

* `preVerificationGas`
* `verificationGasLimit`
* `paymasterVerificationGasLimit` (if the UserOperation defines a Paymaster address)
* `callGasLimit`

```
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": {
        callGasLimit, // uint256
        preVerificationGas, // uint256
        paymasterVerificationGasLimit, // uint256
        verificationGas, // uint256
    },
}
```

### eth\_getUserOperationByHash[​](#eth_getuseroperationbyhash "Direct link to eth_getUserOperationByHash")

`eth_getUserOperationByHash` returns a UserOperation by its hash returned from `eth_sendUserOperation`

#### Request[​](#request "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_getUserOperationByHash",
  "params": ["0x123..456"] // userop hash
}
```

#### Response[​](#response-2 "Direct link to Response")

If the userOp is included in a block: returns a full userOp, with the addition of `entryPoint`, `blockNumber`, `blockHash` and `transactionHash`.

Other status can be one of the following:

| **UserOp Status**  | **Response**                                                                     |
| ------------------ | -------------------------------------------------------------------------------- |
| Pending in mempool | Returns only the `userOp` + `entrypoint`                                         |
| Submitted          | Returns the `userop` + `entrypoint` + `transactionHash`                          |
| Included           | Returns `userOp`+ `entrypoint` + `transactionHash` + `blockNumber` + `blockHash` |
| Error              | Returns standard error code and message                                          |
| Other              | Returns `null`                                                                   |

### eth\_getUserOperationReceipt[​](#eth_getuseroperationreceipt "Direct link to eth_getUserOperationReceipt")

`eth_getUserOperationReceipt` returns the receipt of a UserOperation by its hash returned from `eth_sendUserOperation`. Returns `null` in case the UserOperation is not yet included in a block.

#### Request[​](#request-1 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_getUserOperationReceipt",
  "params": [userOpHash]
}
```

#### Response[​](#response-3 "Direct link to Response")

* success
* error

```
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": {
        userOpHash,
        sender,
        nonce,
        paymaster,
        actualGasCost, // actual (gas price * gas used) of the user operation
        actualGasUsed, // actual gas used of the user operation
        success, // user operation revert status
        reason, // If reverted, user operation revert reason
        logs,
        receipt, // The TransactionReceipt object. Note that the returned TransactionReceipt is for the entire bundle, not only for this UserOperation
    }
}
```

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "error": {
      "code": -000000,
      "message": "AAxx error message"
  }
}
```

### eth\_chainId[​](#eth_chainid "Direct link to eth_chainId")

`eth_chainId` returns the chain ID of the current network

#### Request[​](#request-2 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_chainId",
  "params": []
}
```

#### Response[​](#response-4 "Direct link to Response")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "result": "0x1", // Chain ID
}
```

### eth\_supportedEntryPoints[​](#eth_supportedentrypoints "Direct link to eth_supportedEntryPoints")

`eth_supportedEntryPoints` returns an array of the entryPoint addresses supported by the bundler. A Bundler can support multiple entrypoints.

#### Request[​](#request-3 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_supportedEntryPoints",
  "params": []
}
```

#### Response[​](#response-5 "Direct link to Response")

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    "0x433709009B8330FDa32311DF1C2AFA402eD8D009",
    "0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108",
    "0x0000000071727De22E5E9d8BAf0edAc6f37da032"
  ]
}
```

## EntryPoint v0.8[​](#entrypoint-v08 "Direct link to EntryPoint v0.8")

EIP-7702 support is added with EntryPoint v0.8. The main ERC-4337 RPC calls are `eth_estimateUserOperationGas` and `eth_sendUserOperation`, which take a UserOperation structure. In order to support EIP-7702, a new JSON element named `eip7702Auth` is added to hold the EIP-7702 auth tuple items.

The Bundler API for EntryPoint v0.8 is fully backward compatible and has no breaking changes from EntryPoint v0.7.

### eth\_sendUserOperation[​](#eth_senduseroperation-1 "Direct link to eth_sendUserOperation")

`eth_sendUserOperation` asks the bundler to sign and submit a UserOperation.

Highlighted code is relevant to wallets upgrading EOAs to Smart Accounts using EIP-7702. This is an optional field, and teams building smart wallets without EIP-7702 can ignore this field.

#### Example Request[​](#example-request-2 "Direct link to Example Request")

```
{
    jsonrpc: "2.0",
    id: 1,
    method: "eth_sendUserOperation",
    "params": [
      {
        'sender': '0xBdbc5FBC9cA8C3F514D073eC3de840Ac84FC6D31',
        'nonce': '0x13',
        'callData': '0x34fcd5be00000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000001000000000000000000000000009a7af758ae5d7b6aae84fe4c5ba67c041dfe53360000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000246a627842000000000000000000000000bdbc5fbc9ca8c3f514d073ec3de840ac84fc6d31000000000000000000000000000000000000000000000000000000000000000000000000000000009a7af758ae5d7b6aae84fe4c5ba67c041dfe53360000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000246a627842000000000000000000000000bdbc5fbc9ca8c3f514d073ec3de840ac84fc6d3100000000000000000000000000000000000000000000000000000000',
        'callGasLimit': '0x2c3d',
        'verificationGasLimit': '0x15881',
        'preVerificationGas': '0xb7f8',
        'maxFeePerGas': '0x2c05b3',
        'maxPriorityFeePerGas': '0x2c05a2',
        'signature': '0x62f5051e378470492a7598d33de0b89e51bbf938ac51a863d0444b926df69d872d0a1ef3ee586bba984e6f290b34ab60b6eda7fb21a99aa84248eb4cfa979c891b',
        'factory': None,
        'factoryData': None,
        'paymaster': None,
        'paymasterVerificationGasLimit': None,
        'paymasterPostOpGasLimit': None,
        'paymasterData': None,
        'eip7702auth': {
          'chainId': '0x4268',
          'address': '0x6C193e88c2C6ACB0897d162E9496156BfFF73C0F',
          'nonce': '0x0f',
          'yParity': '0x00',
          'r': '0xf37fca7f67bc0b336adfeefe42a8856ca1e6dee48b1ce7748a4044acfe283b01',
          's': '0x60ab7d22e278dc43b0b37afada54666c0bf9e0beb9f0cd0159de007d127f3406'
        }
      },
      '0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108',
    ]
}
```

#### Response[​](#response-6 "Direct link to Response")

It returns the hash of the User Operation. In case of an error, it returns the error message.

* success
* example error

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "result": "0x1234...5678" // UserOpHash
}
```

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "message": "AA21 didn't pay prefund",
    "code": -32500
  }
}
```

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "message": "paymaster stake too low",
    "data": {
      "paymaster": "0x123456789012345678901234567890123456790",
      "minimumStake": "0xde0b6b3a7640000",
      "minimumUnstakeDelay": "0x15180"
    },
    "code": -32504
  }
}
```

### eth\_estimateUserOperationGas[​](#eth_estimateuseroperationgas-1 "Direct link to eth_estimateUserOperationGas")

`eth_estimateUserOperationGas` generates and returns an estimate of how much gas is necessary to allow the transaction to complete, given a `UserOperation`.

The signature field is ignored by the wallet, so that the operation will not require the user’s approval. Still, it might require putting a “semi-valid” signature (e.g. a signature in the right length)

#### Example Request[​](#example-request-3 "Direct link to Example Request")

```
{
  jsonrpc: "2.0",
  id: 1,
  method: "eth_estimateUserOperationGas",
  "params": [
  [
   {
      sender, // address
      nonce, // uint256
      factory, // address
      factoryData, // bytes
      callData, // bytes
      callGasLimit, // uint256
      verificationGasLimit, // uint256
      preVerificationGas, // uint256
      maxFeePerGas, // uint256
      maxPriorityFeePerGas, // uint256
      paymaster, // address
      paymasterVerificationGasLimit, // uint256
      paymasterPostOpGasLimit, // uint256
      paymasterData, // bytes
      signature // bytes
      'eip7702auth': {
        'chainId': '0x4268',
        'address': '0x6C193e88c2C6ACB0897d162E9496156BfFF73C0F', // must be valid delegation address for simulation
        'nonce': '0x0f', 
        'yParity': '0x00',
        'r': '0xf37fca7f67bc0b336adfeefe42a8856ca1e6dee48b1ce7748a4044acfe283b01', // can pass a dummy signature during estimates
        's': '0x60ab7d22e278dc43b0b37afada54666c0bf9e0beb9f0cd0159de007d127f3406' // can pass a dummy signature during estimates
      }
    }
    '0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108'
  ]
}
```

#### Response[​](#response-7 "Direct link to Response")

It returns estimates for a UserOperation Gas parameters for:

* `preVerificationGas`
* `verificationGasLimit`
* `paymasterVerificationGasLimit` (if the UserOperation defines a Paymaster address)
* `callGasLimit`

```
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": {
        callGasLimit, // uint256
        preVerificationGas, // uint256
        paymasterVerificationGasLimit, // uint256
        verificationGas, // uint256
    },
}
```

### eth\_getUserOperationByHash[​](#eth_getuseroperationbyhash-1 "Direct link to eth_getUserOperationByHash")

`eth_getUserOperationByHash` returns a UserOperation by its hash returned from `eth_sendUserOperation`

#### Request[​](#request-4 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_getUserOperationByHash",
  "params": ["0x123..456"] // userop hash
}
```

#### Response[​](#response-8 "Direct link to Response")

If the userOp is included in a block: returns a full userOp, with the addition of `entryPoint`, `blockNumber`, `blockHash` and `transactionHash`.

Other status can be one of the following:

| **UserOp Status**  | **Response**                                                                     |
| ------------------ | -------------------------------------------------------------------------------- |
| Pending in mempool | Returns only the `userOp` + `entrypoint`                                         |
| Submitted          | Returns the `userop` + `entrypoint` + `transactionHash`                          |
| Included           | Returns `userOp`+ `entrypoint` + `transactionHash` + `blockNumber` + `blockHash` |
| Error              | Returns standard error code and message                                          |
| Other              | Returns `null`                                                                   |

* success
* error

Example response for an Included status

```
{
  userOpHash: '0x1acede61123ab7116eb29c797aeaec3c03615c37732ba66428524aebdb4b4514',
  entryPoint: '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789',
  sender: '0xb8741a449d50ed0dcfe395287f85be152884c8d9',
  nonce: 0n,
  paymaster: '0x3fe285dcd76bcce4ac92d38a6f2f8e964041e020',
  actualGasCost: 8078496n,
  actualGasUsed: 504906n,
  success: true,
  logs: '[{"address":"0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000007b44a0000000000000000000000000000000000000000000000000000000000007b44a","logIndex":"0x9a","removed":false,"topics":["0x49628fd1471006c1482da88028e9ce4dbb080b815c9b0344d39e5a8e6ec1419f","0x1acede61123ab7116eb29c797aeaec3c03615c37732ba66428524aebdb4b4514","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9","0x0000000000000000000000003fe285dcd76bcce4ac92d38a6f2f8e964041e020"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"}]',
  receipt: {
    blockHash: '0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c',
    blockNumber: 10419807n,
    from: '0x3cfdc212769c890907bce93d3d8c2c53de6a7a89',
    cumulativeGasUsed: 6978990n,
    gasUsed: 507053n,
    logs: '[{"address":"0xb8741a449d50ed0dcfe395287f85be152884c8d9","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x","logIndex":"0x90","removed":false,"topics":["0xecdf3a3effea5783a3c4c2140e677577666428d44ed9d474a0b3a4c9943f8440","0x000000000000000000000000a581c4a4db7175302464ff3c06380bc3270b4037"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0xb8741a449d50ed0dcfe395287f85be152884c8d9","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000010000000000000000000000008ecd4ec46d4d2a6b64fe960b3d64e8b94b2234eb000000000000000000000000a581c4a4db7175302464ff3c06380bc3270b40370000000000000000000000000000000000000000000000000000000000000001000000000000000000000000bdbc5fbc9ca8c3f514d073ec3de840ac84fc6d31","logIndex":"0x91","removed":false,"topics":["0x141df868a6331af528e38c83b7aa03edc19be66e37ae67f9285bf4f8e3c6a1a8","0x0000000000000000000000004e1dcf7ad4e460cfd30791ccc4f9c8a4f820ec67"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0x4e1dcf7ad4e460cfd30791ccc4f9c8a4f820ec67","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x00000000000000000000000029fcb43b46531bca003ddc8fcb67ffe91900c762","logIndex":"0x92","removed":false,"topics":["0x4f51faf6c4561ff95f067657e43439f0f856d97c04d9ec9070a6199ad418e235","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x0000000000000000000000004e1dcf7ad4e460cfd30791ccc4f9c8a4f820ec670000000000000000000000003fe285dcd76bcce4ac92d38a6f2f8e964041e020","logIndex":"0x93","removed":false,"topics":["0xd51a9c61267aa6196961883ecf5ff2da6619c37dac0fa92122513fb32c032d2d","0x1acede61123ab7116eb29c797aeaec3c03615c37732ba66428524aebdb4b4514","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x","logIndex":"0x94","removed":false,"topics":["0xbb47ee3e183a558b1a2ff0874b079f3fc5478b7454eacf2bfc5af2ff5878f972"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0xb8741a449d50ed0dcfe395287f85be152884c8d9","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x000000000000000000000000a581c4a4db7175302464ff3c06380bc3270b403700000000000000000000000038869bf66a61cf6bdb996a6ae40d5853fd43b526000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000001048d80ff0a000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000b200d9de104e3386d9a45a61bce269c43e48b534e4e7000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000041249c58b00d9de104e3386d9a45a61bce269c43e48b534e4e7000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000041249c58b000000000000000000000000000000000000000000000000000000000000000000000000000000000000","logIndex":"0x95","removed":false,"topics":["0xb648d3644f584ed1c2232d53c46d87e693586486ad0d1175f8656013110b714e"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0xd9de104e3386d9a45a61bce269c43e48b534e4e7","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x","logIndex":"0x96","removed":false,"topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x0000000000000000000000000000000000000000000000000000000000000000","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9","0x0000000000000000000000000000000000000000000000000000000000000056"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0xd9de104e3386d9a45a61bce269c43e48b534e4e7","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x","logIndex":"0x97","removed":false,"topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x0000000000000000000000000000000000000000000000000000000000000000","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9","0x0000000000000000000000000000000000000000000000000000000000000057"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0xb8741a449d50ed0dcfe395287f85be152884c8d9","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x","logIndex":"0x98","removed":false,"topics":["0x6895c13664aa4f67288b25d7a21d7aaa34916e355fb9b6fae0a139a9085becb8","0x000000000000000000000000a581c4a4db7175302464ff3c06380bc3270b4037"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0x3fe285dcd76bcce4ac92d38a6f2f8e964041e020","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x0000000000000000000000000000000000000000000000000000000000000000","logIndex":"0x99","removed":false,"topics":["0xa050a122b4c0e369e3385eb6b7cccd8019638b2764de67bec0af99130ddf8471","0x1acede61123ab7116eb29c797aeaec3c03615c37732ba66428524aebdb4b4514","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9","0x0000000000000000000000000000000000000000000000000000000000000000"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000007b44a0000000000000000000000000000000000000000000000000000000000007b44a","logIndex":"0x9a","removed":false,"topics":["0x49628fd1471006c1482da88028e9ce4dbb080b815c9b0344d39e5a8e6ec1419f","0x1acede61123ab7116eb29c797aeaec3c03615c37732ba66428524aebdb4b4514","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9","0x0000000000000000000000003fe285dcd76bcce4ac92d38a6f2f8e964041e020"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"}]',
    logsBloom: '0x0000040000009000000000000000010080000000000000000000000000000000000800000000000000020001000004040010000000000000800002000000000000001000000000000000000c0002000000000000010000080040000000000000020000000a0000000500002000000800008000000100000000000014000000000800010020000200008000000040000000000200000400000000000000000000000004000000000000500000000004000210000000000000000002001000000020200082000000000001000008000000000000002060000000100000000026000000082000010000000000000008100220000000000000000000000010000200',
    transactionHash: '0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa',
    transactionIndex: 29n,
    effectiveGasPrice: 16n
  }
}
```

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "error": {
      "code": -000000,
      "message": "AAxx error message"
  }
}
```

### eth\_getUserOperationReceipt[​](#eth_getuseroperationreceipt-1 "Direct link to eth_getUserOperationReceipt")

`eth_getUserOperationReceipt` returns the receipt of a UserOperation by its hash returned from `eth_sendUserOperation`. Returns `null` in case the UserOperation is not yet included in a block.

#### Request[​](#request-5 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_getUserOperationReceipt",
  "params": [userOpHash]
}
```

#### Response[​](#response-9 "Direct link to Response")

* success
* error

```
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": {
        userOpHash,
        sender,
        nonce,
        paymaster,
        actualGasCost, // actual (gas price * gas used) of the user operation
        actualGasUsed, // actual gas used of the user operation
        success, // user operation revert status
        reason, // If reverted, user operation revert reason
        logs,
        receipt, // The TransactionReceipt object. Note that the returned TransactionReceipt is for the entire bundle, not only for this UserOperation
    }
}
```

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "error": {
      "code": -000000,
      "message": "AAxx error message"
  }
}
```

### eth\_chainId[​](#eth_chainid-1 "Direct link to eth_chainId")

`eth_chainId` returns the chain ID of the current network

#### Request[​](#request-6 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_chainId",
  "params": []
}
```

#### Response[​](#response-10 "Direct link to Response")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "result": "0x1", // Chain ID
}
```

### eth\_supportedEntryPoints[​](#eth_supportedentrypoints-1 "Direct link to eth_supportedEntryPoints")

`eth_supportedEntryPoints` returns an array of the entryPoint addresses supported by the bundler. A Bundler can support multiple entrypoints.

#### Request[​](#request-7 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_supportedEntryPoints",
  "params": []
}
```

#### Response[​](#response-11 "Direct link to Response")

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    "0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108",
    "0x0000000071727De22E5E9d8BAf0edAc6f37da032"
  ]
}
```

## EntryPoint v0.7[​](#entrypoint-v07 "Direct link to EntryPoint v0.7")

### eth\_sendUserOperation[​](#eth_senduseroperation-2 "Direct link to eth_sendUserOperation")

`eth_sendUserOperation` asks the bundler to sign and submit a User Operation

#### Request[​](#request-8 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_sendUserOperation",
  "params": [
    {
      sender, // address
      nonce, // uint256
      factory, // address
      factoryData, // bytes
      callData, // bytes
      callGasLimit, // uint256
      verificationGasLimit, // uint256
      preVerificationGas, // uint256
      maxFeePerGas, // uint256
      maxPriorityFeePerGas, // uint256
      paymaster, // address
      paymasterVerificationGasLimit, // uint256
      paymasterPostOpGasLimit, // uint256
      paymasterData, // bytes
      signature // bytes
    },
    entryPoint // address
  ]
}
```

#### Response[​](#response-12 "Direct link to Response")

It returns the hash of the User Operation. In case of an error, it returns the error message.

* success
* example error

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "result": "0x1234...5678" // UserOpHash
}
```

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "message": "AA21 didn't pay prefund",
    "code": -32500
  }
}
```

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "message": "paymaster stake too low",
    "data": {
      "paymaster": "0x123456789012345678901234567890123456790",
      "minimumStake": "0xde0b6b3a7640000",
      "minimumUnstakeDelay": "0x15180"
    },
    "code": -32504
  }
}
```

### eth\_estimateUserOperationGas[​](#eth_estimateuseroperationgas-2 "Direct link to eth_estimateUserOperationGas")

`eth_estimateUserOperationGas` generates and returns an estimate of how much gas is necessary to allow the transaction to complete, given a `UserOperation`. The signature field is ignored by the wallet, so that the operation will not require the user’s approval. Still, it might require putting a “semi-valid” signature (e.g. a signature in the right length)

#### Request[​](#request-9 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_estimateUserOperationGas",
  "params": [
    {
      sender, // address
      nonce, // uint256
      factory, // address
      factoryData, // bytes
      callData, // bytes
      callGasLimit, // uint256
      verificationGasLimit, // uint256
      preVerificationGas, // uint256
      maxFeePerGas, // uint256
      maxPriorityFeePerGas, // uint256
      paymaster, // address
      paymasterVerificationGasLimit, // uint256
      paymasterPostOpGasLimit, // uint256
      paymasterData, // bytes
      signature // bytes
    },
    entryPoint // address
  ]
}
```

#### Response[​](#response-13 "Direct link to Response")

It returns estimates for a UserOperation Gas parameters for:

* `preVerificationGas`
* `verificationGasLimit`
* `paymasterVerificationGasLimit` (if the UserOperation defines a Paymaster address)
* `callGasLimit`

```
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": {
        callGasLimit, // uint256
        preVerificationGas, // uint256
        paymasterVerificationGasLimit, // uint256
        verificationGas, // uint256
    },
}
```

### eth\_getUserOperationByHash[​](#eth_getuseroperationbyhash-2 "Direct link to eth_getUserOperationByHash")

`eth_getUserOperationByHash` returns a UserOperation by its hash returned from `eth_sendUserOperation`

#### Request[​](#request-10 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_getUserOperationByHash",
  "params": ["0x123..456"] // userop hash
}
```

#### Response[​](#response-14 "Direct link to Response")

If the userOp is included in a block: returns a full userOp, with the addition of `entryPoint`, `blockNumber`, `blockHash` and `transactionHash`.

Other status can be one of the following:

| **UserOp Status**  | **Response**                                                                     |
| ------------------ | -------------------------------------------------------------------------------- |
| Pending in mempool | Returns only the `userOp` + `entrypoint`                                         |
| Submitted          | Returns the `userop` + `entrypoint` + `transactionHash`                          |
| Included           | Returns `userOp`+ `entrypoint` + `transactionHash` + `blockNumber` + `blockHash` |
| Error              | Returns standard error code and message                                          |
| Other              | Returns `null`                                                                   |

* success
* error

Example response for an Included status

```
{
  userOpHash: '0x1acede61123ab7116eb29c797aeaec3c03615c37732ba66428524aebdb4b4514',
  entryPoint: '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789',
  sender: '0xb8741a449d50ed0dcfe395287f85be152884c8d9',
  nonce: 0n,
  paymaster: '0x3fe285dcd76bcce4ac92d38a6f2f8e964041e020',
  actualGasCost: 8078496n,
  actualGasUsed: 504906n,
  success: true,
  logs: '[{"address":"0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000007b44a0000000000000000000000000000000000000000000000000000000000007b44a","logIndex":"0x9a","removed":false,"topics":["0x49628fd1471006c1482da88028e9ce4dbb080b815c9b0344d39e5a8e6ec1419f","0x1acede61123ab7116eb29c797aeaec3c03615c37732ba66428524aebdb4b4514","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9","0x0000000000000000000000003fe285dcd76bcce4ac92d38a6f2f8e964041e020"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"}]',
  receipt: {
    blockHash: '0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c',
    blockNumber: 10419807n,
    from: '0x3cfdc212769c890907bce93d3d8c2c53de6a7a89',
    cumulativeGasUsed: 6978990n,
    gasUsed: 507053n,
    logs: '[{"address":"0xb8741a449d50ed0dcfe395287f85be152884c8d9","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x","logIndex":"0x90","removed":false,"topics":["0xecdf3a3effea5783a3c4c2140e677577666428d44ed9d474a0b3a4c9943f8440","0x000000000000000000000000a581c4a4db7175302464ff3c06380bc3270b4037"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0xb8741a449d50ed0dcfe395287f85be152884c8d9","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000010000000000000000000000008ecd4ec46d4d2a6b64fe960b3d64e8b94b2234eb000000000000000000000000a581c4a4db7175302464ff3c06380bc3270b40370000000000000000000000000000000000000000000000000000000000000001000000000000000000000000bdbc5fbc9ca8c3f514d073ec3de840ac84fc6d31","logIndex":"0x91","removed":false,"topics":["0x141df868a6331af528e38c83b7aa03edc19be66e37ae67f9285bf4f8e3c6a1a8","0x0000000000000000000000004e1dcf7ad4e460cfd30791ccc4f9c8a4f820ec67"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0x4e1dcf7ad4e460cfd30791ccc4f9c8a4f820ec67","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x00000000000000000000000029fcb43b46531bca003ddc8fcb67ffe91900c762","logIndex":"0x92","removed":false,"topics":["0x4f51faf6c4561ff95f067657e43439f0f856d97c04d9ec9070a6199ad418e235","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x0000000000000000000000004e1dcf7ad4e460cfd30791ccc4f9c8a4f820ec670000000000000000000000003fe285dcd76bcce4ac92d38a6f2f8e964041e020","logIndex":"0x93","removed":false,"topics":["0xd51a9c61267aa6196961883ecf5ff2da6619c37dac0fa92122513fb32c032d2d","0x1acede61123ab7116eb29c797aeaec3c03615c37732ba66428524aebdb4b4514","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x","logIndex":"0x94","removed":false,"topics":["0xbb47ee3e183a558b1a2ff0874b079f3fc5478b7454eacf2bfc5af2ff5878f972"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0xb8741a449d50ed0dcfe395287f85be152884c8d9","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x000000000000000000000000a581c4a4db7175302464ff3c06380bc3270b403700000000000000000000000038869bf66a61cf6bdb996a6ae40d5853fd43b526000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000001048d80ff0a000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000b200d9de104e3386d9a45a61bce269c43e48b534e4e7000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000041249c58b00d9de104e3386d9a45a61bce269c43e48b534e4e7000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000041249c58b000000000000000000000000000000000000000000000000000000000000000000000000000000000000","logIndex":"0x95","removed":false,"topics":["0xb648d3644f584ed1c2232d53c46d87e693586486ad0d1175f8656013110b714e"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0xd9de104e3386d9a45a61bce269c43e48b534e4e7","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x","logIndex":"0x96","removed":false,"topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x0000000000000000000000000000000000000000000000000000000000000000","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9","0x0000000000000000000000000000000000000000000000000000000000000056"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0xd9de104e3386d9a45a61bce269c43e48b534e4e7","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x","logIndex":"0x97","removed":false,"topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x0000000000000000000000000000000000000000000000000000000000000000","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9","0x0000000000000000000000000000000000000000000000000000000000000057"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0xb8741a449d50ed0dcfe395287f85be152884c8d9","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x","logIndex":"0x98","removed":false,"topics":["0x6895c13664aa4f67288b25d7a21d7aaa34916e355fb9b6fae0a139a9085becb8","0x000000000000000000000000a581c4a4db7175302464ff3c06380bc3270b4037"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0x3fe285dcd76bcce4ac92d38a6f2f8e964041e020","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x0000000000000000000000000000000000000000000000000000000000000000","logIndex":"0x99","removed":false,"topics":["0xa050a122b4c0e369e3385eb6b7cccd8019638b2764de67bec0af99130ddf8471","0x1acede61123ab7116eb29c797aeaec3c03615c37732ba66428524aebdb4b4514","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9","0x0000000000000000000000000000000000000000000000000000000000000000"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"},{"address":"0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789","blockHash":"0xe19e52b4c222c1cdbc765f1a4e196ff4bf40c5550926e02974570e1845e88e2c","blockNumber":"0x9efe5f","data":"0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000007b44a0000000000000000000000000000000000000000000000000000000000007b44a","logIndex":"0x9a","removed":false,"topics":["0x49628fd1471006c1482da88028e9ce4dbb080b815c9b0344d39e5a8e6ec1419f","0x1acede61123ab7116eb29c797aeaec3c03615c37732ba66428524aebdb4b4514","0x000000000000000000000000b8741a449d50ed0dcfe395287f85be152884c8d9","0x0000000000000000000000003fe285dcd76bcce4ac92d38a6f2f8e964041e020"],"transactionHash":"0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa","transactionIndex":"0x1d"}]',
    logsBloom: '0x0000040000009000000000000000010080000000000000000000000000000000000800000000000000020001000004040010000000000000800002000000000000001000000000000000000c0002000000000000010000080040000000000000020000000a0000000500002000000800008000000100000000000014000000000800010020000200008000000040000000000200000400000000000000000000000004000000000000500000000004000210000000000000000002001000000020200082000000000001000008000000000000002060000000100000000026000000082000010000000000000008100220000000000000000000000010000200',
    transactionHash: '0xf43576a07f39660737a342c99a187eb70ac59d89bc0df92ff3c1bb8a8da370aa',
    transactionIndex: 29n,
    effectiveGasPrice: 16n
  }
}
```

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "error": {
      "code": -000000,
      "message": "AAxx error message"
  }
}
```

### eth\_getUserOperationReceipt[​](#eth_getuseroperationreceipt-2 "Direct link to eth_getUserOperationReceipt")

`eth_getUserOperationReceipt` returns the receipt of a UserOperation by its hash returned from `eth_sendUserOperation`. Returns `null` in case the UserOperation is not yet included in a block.

#### Request[​](#request-11 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_getUserOperationReceipt",
  "params": [userOpHash]
}
```

#### Response[​](#response-15 "Direct link to Response")

* success
* error

```
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": {
        userOpHash,
        sender,
        nonce,
        paymaster,
        actualGasCost, // actual (gas price * gas used) of the user operation
        actualGasUsed, // actual gas used of the user operation
        success, // user operation revert status
        reason, // If reverted, user operation revert reason
        logs,
        receipt, // The TransactionReceipt object. Note that the returned TransactionReceipt is for the entire bundle, not only for this UserOperation
    }
}
```

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "error": {
      "code": -000000,
      "message": "AAxx error message"
  }
}
```

### eth\_chainId[​](#eth_chainid-2 "Direct link to eth_chainId")

`eth_chainId` returns the chain ID of the current network

#### Request[​](#request-12 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_chainId",
  "params": []
}
```

#### Response[​](#response-16 "Direct link to Response")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "result": "0x1", // Chain ID
}
```

### eth\_supportedEntryPoints[​](#eth_supportedentrypoints-2 "Direct link to eth_supportedEntryPoints")

`eth_supportedEntryPoints` returns an array of the entryPoint addresses supported by the bundler. A Bundler can support multiple entrypoints.

#### Request[​](#request-13 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_supportedEntryPoints",
  "params": []
}
```

#### Response[​](#response-17 "Direct link to Response")

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789",
    "0x0000000071727De22E5E9d8BAf0edAc6f37da032"
  ]
}
```

## EntryPoint v0.6[​](#entrypoint-v06 "Direct link to EntryPoint v0.6")

### eth\_sendUserOperation[​](#eth_senduseroperation-3 "Direct link to eth_sendUserOperation")

`eth_sendUserOperation` asks the bundler to sign and submit a User Operation

#### Request[​](#request-14 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_sendUserOperation",
  "params": [
    {
      sender,
      nonce,
      initCode,
      callData,
      callGasLimit,
      verificationGasLimit,
      preVerificationGas,
      maxFeePerGas,
      maxPriorityFeePerGas,
      paymasterAndData,
      signature,
    },
    entrypointAddress,
  ]
}
```

#### Response[​](#response-18 "Direct link to Response")

It returns the hash of the User Operation. In case of an error, it returns the error message.

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "result": "0x..." // UserOpHash
}
```

### eth\_estimateUserOperationGas[​](#eth_estimateuseroperationgas-3 "Direct link to eth_estimateUserOperationGas")

`eth_estimateUserOperationGas` generates and returns an estimate of how much gas is necessary to allow the transaction to complete, given a `UserOperation`.

#### Request[​](#request-15 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_estimateUserOperationGas",
  "params": [
    {
      sender,
      nonce,
      initCode,
      callData,
      callGasLimit,
      verificationGasLimit,
      preVerificationGas,
      maxFeePerGas,
      maxPriorityFeePerGas,
      paymasterAndData,
      signature,
    },
    entrypointAddress,
  ]
}
```

#### Response[​](#response-19 "Direct link to Response")

It returns estimates for a UserOperation Gas parameters for `preVerificationGas`, `verificationGas`, and `callGasLimit`

```
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": {
        callGasLimit
        preVerificationGas,
        verificationGas,
    },
}
```

### eth\_getUserOperationByHash[​](#eth_getuseroperationbyhash-3 "Direct link to eth_getUserOperationByHash")

`eth_getUserOperationByHash` returns a UserOperation by its hash returned from `eth_sendUserOperation`

#### Request[​](#request-16 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_getUserOperationByHash",
  "params": [userOpHash]
}
```

#### Response[​](#response-20 "Direct link to Response")

If the userOp is included in a block: returns a full userOp, with the addition of `entryPoint`, `blockNumber`, `blockHash` and `transactionHash`.

Other status can be one of the following:

| **UserOp Status**  | **Response**                                                                     |
| ------------------ | -------------------------------------------------------------------------------- |
| Pending in mempool | Returns only the `userOp` + `entrypoint`                                         |
| Submitted          | Returns the `userop` + `entrypoint` + `transactionHash`                          |
| Included           | Returns `userOp`+ `entrypoint` + `transactionHash` + `blockNumber` + `blockHash` |
| Error              | Returns standard error code and message                                          |
| Other              | Returns `null`                                                                   |

* success
* error

Example response for an `Included` status

```
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": {
        "userOperation": {
            "sender": "0x543d6683eCB476a599cE3F084Bdf3F8A04AEDc8f",
            "nonce": "0x55",
            "initCode": "0x",
            "callData": "0x541d63c800000000000000000000000012c20bcee31bd34064caa6ec0fd5c4c2fce179c70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044a9059cbb000000000000000000000000e32359892d6c5b0a4a4ad64b4326cae0fda15a8b000000000000000000000000000000000000000000000002b5e3af16b188000000000000000000000000000000000000000000000000000000000000",
            "callGasLimit": "0x186a0",
            "verificationGasLimit": "0x35c5e",
            "preVerificationGas": "0x18704",
            "maxFeePerGas": "0x1a7c9fd800",
            "maxPriorityFeePerGas": "0x1a7c9fd800",
            "paymasterAndData": "0x3fe285dcd76bcce4ac92d38a6f2f8e964041e02000000000000000000000000000000000000000000300006759820600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000b7940ef6cdc9cca0ea65e49f37684914b962b36ea4cbb381dad14b291ddadb35399cddcf519dd89608866bf71abbb1cbcae83a2c022bf7fe01e0848f49b298951c",
            "signature": "0x000000000000000000000000032e9877498140afb58bb4c177850389c1a275ee850b24d96e881c7e48e8be6f003602a23eee383a5059f874688d179fd4e18d44261c10b1ae64193bc82a2b251bff502282aa2053b898b0544009e7a56e3ec19334781a9a366cbda40075fd5d9e667bafce929eff2829acd4134abd41e2e736d1f3cf0b858a4e16c86365a9c5751c"
        },
        "entryPoint": "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789",
        "blockNumber": "0x3e52d61",
        "blockHash": "0xef3eba62563303e4add41aa107e67a9a98b0cac82c0b35c4c9f1161bf99b573d",
        "transactionHash": "0x682ddd23c100631127a945f2a2ba4edeff04911af7491148a662253cb91aaae7"
    }
}
```

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "error": {
      "code": -000000,
      "message": "AAxx error message"
  }
}
```

### eth\_getUserOperationReceipt[​](#eth_getuseroperationreceipt-3 "Direct link to eth_getUserOperationReceipt")

`eth_getUserOperationReceipt` returns the receipt of a UserOperation by its hash returned from `eth_sendUserOperation`

#### Request[​](#request-17 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_getUserOperationReceipt",
  "params": [userOpHash]
}
```

#### Response[​](#response-21 "Direct link to Response")

```
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": {
        userOpHash,
        sender,
        nonce,
        paymaster,
        actualGasCost, // actual (gas price * gas used) of the user operation
        actualGasUsed, // actual gas used of the user operation
        success, // user operation revert status
        reason, // If reverted, user operation revert reason
        logs,
        receipt, // The TransactionReceipt object. Note that the returned TransactionReceipt is for the entire bundle, not only for this UserOperation
    }
}
```

### eth\_chainId[​](#eth_chainid-3 "Direct link to eth_chainId")

`eth_chainId` returns the chain ID of the current network

#### Request[​](#request-18 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_chainId",
  "params": []
}
```

#### Response[​](#response-22 "Direct link to Response")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "result": "0x1", // Chain ID
}
```

### eth\_supportedEntryPoints[​](#eth_supportedentrypoints-3 "Direct link to eth_supportedEntryPoints")

`eth_supportedEntryPoints` returns an array of the entryPoint addresses supported by the bundler

#### Request[​](#request-19 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "eth_supportedEntryPoints",
  "params": []
}
```

#### Response[​](#response-23 "Direct link to Response")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "result": ["0x00...", "0x01..."],
}
```

## Gas Prices[​](#gas-prices "Direct link to Gas Prices")

### voltaire\_feesPerGas[​](#voltaire_feespergas "Direct link to voltaire_feesPerGas")

The `voltaire_feesPerGas` method provides the recommended gas fees, `maxFeePerGas` and `maxPriorityFeePerGas`. This method simplifies gas price estimation by offering a reliable price for the various EVM networks that Candide's Bundler Voltaire supports. This allows you to set appropriate gas fees for your UserOperations without needing to implement complex gas price prediction logic for each chain.

#### Request[​](#request-20 "Direct link to Request")

```
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "voltaire_feesPerGas",
  "params": []
}
```

#### Response[​](#response-24 "Direct link to Response")

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "maxFeePerGas": "0x6fc35fb80",
    "maxPriorityFeePerGas": "0x124f80"
  }
}
```

Gas Fee Concepts

* `maxFeePerGas`: This represents the absolute maximum price per unit of gas you are willing to pay for a UserOperation. This fee is the sum of the baseFee and the maxPriorityFeePerGas.

* `maxPriorityFeePerGas`: Also known as the "tip", this is the fee that is paid directly to the bundler. A higher priority fee can incentivize the bundler to include your UserOperation in a block more quickly, especially during times of network congestion.