API ReferenceBundlerBundler API Endpoints

eth_getUserOperationReceipt

Get the `UserOperationReceipt` based on the `userOpHash`. <Note title="Limitations"> This method retrieves and decodes userOperations from the logs of mined transactions by querying the node. If you attempt to fetch a receipt for a transaction from a distant past block, the request may be rejected by the node due to limitations on the block range size it can process. The default range we support is 150 blocks, however the following networks have an unlimited range. - Ethereum - Polygon - Base - Optimism - Worldchain - Arbitrum </Note> <Note title="Want to get push notifications for mined userOperations?"> Follow [this guide](/docs/how-to-use-custom-webhooks-to-get-push-notifications-for-mined-user-operations) to learn how to use Custom Webhooks and get real time alerts and receipts for mined userOperations. </Note>

Path parameters

apiKeystringRequiredDefaults to docs-demo

Request

This endpoint expects an object.
userOpHashstringRequiredformat: "^0x[0-9a-f]{64}$"

The userOpHash of the UserOperation to get the receipt for (as returned by eth_sendUserOperation).

tagenumOptional

The blocktag for checking the UO status. “pending” or “latest”. Defaults to “latest”.”.

Allowed values:

Response

UserOperationReceipt object representing the outcome of a UserOperation.

userOpHashstring

The hash of the UserOperation.

entryPointstring

The EntryPoint address the request should be sent through. This MUST be one of the EntryPoints returned by the supportedEntryPoints RPC call.

senderstring

The account initiating the UserOperation.

noncestring

The nonce used in the UserOperation.

paymasterstring

The paymaster used for this UserOperation (or empty if self-sponsored).

actualGasCoststring

The actual amount paid (by account or paymaster) for this UserOperation.

actualGasUsedstring

The total gas used by this UserOperation (including preVerification, creation, validation, and execution).

successboolean
Indicates whether the execution completed without reverting.
reasonstring
In case of revert, this is the revert reason.
logslist of strings

The logs generated by this UserOperation (not including logs of other UserOperations in the same bundle).

receiptobject

The TransactionReceipt object for the entire bundle, not only for this UserOperation.

statusstring

The status of the UserOperation. Could be “Mined” or “Preconfirmed”.”