Bundler API Quickstart

What is a Bundler?

The concept of a Bundler is introduced by ERC-4337, which aims to bring Account Abstraction to EVM chains. With the expectation of an increased adoption of Smart Contract Wallets (SCWs) for their user-friendly experience and flexibility, the Bundler plays a vital role. Essentially, it forwards the user operations to the Entrypoint which are then further forwarded to the smart contract accounts for execution. Our custom built Bundler called Rundler provides high performance and reliability, it's written in Rust and is completely open source.

To gain deeper insights into this topic, explore our blog post on Account Abstraction.

What is the Bundler API?

The Bundler APIs are a collection of ERC-4337 compliant JSON-RPC endpoints which makes it possible for users to work with user operations.

📘

NOTE

Please note that using aa-sdk to send UserOperations is the easiest way to access our Bundler without directly dealing with the raw APIs.

Bundler API Endpoints

All of the Bundler API endpoints are listed below along with links to their individual pages and brief descriptions.

• eth_sendUserOperation

  Submits a user operation to a Bundler. If the request is successfull, the endpoint will return a user operation hash that the caller can use to look up the status of the user operation. If it fails, or another error occurs, an error code and description will be returned.

• eth_estimateUserOperationGas

  Estimates the gas values for a user operation. It returns the preVerificationGas, verificationGasLimit, and callGasLimit values associated with the provided user operation.

• eth_getUserOperationByHash

  Returns a user operation based on the given user operation hash. It returns the user operation along with extra information including what block/transaction it was included in. If the operation has not yet been included, it will return null.

• eth_getUserOperationReceipt

  Returns a user operation receipt ( metadata associated with the given user operation ) based on the given user operation hash. It returns null if the user operation has not yet been included.

• rundler_maxPriorityFeePerGas

  Returns a fee per gas that is an estimate of how much users should set as a priority fee in UOs for Rundler endpoints.

• eth_supportedEntryPoints

  Returns a list of Entrypoint contract addresses supported by the bunder endpoints. Currently, Rundler ( Alchemy's custom built Bundler ) only supports EntryPoint v0.6.0 at 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789

Request Limits

📘

Note:

These are hourly request limits.