Quick Start

After reading this page:

• You'll go through a decision process to understand the best way to integrate with ERC4337 methods with Gelato Bundler using Bundler API Endpoints and Zerodev SDK.

• You'll know exactly which SDK/API method is for you.

Depending on your final destination, please click the corresponding link to find about your chosen SDK method:

• Sponsor UserOps Using 1Balance

• Sponsor UserOps Using Zerodev Paymaster

• Pay Gas for UserOps Using Native Tokens

• Pay Gas for UserOps Using ERC20 Tokens

Getting Started

1. Using Bundler API Endpoints

Users can directly interact with our bundler via API endpoints—enabling actions like sending UserOperations, estimating gas, and more. Learn more about how to use the bundler endpoints here.

Example Code

1. Clone the repository

git clone https://github.com/gelatodigital/erc4337-counter-example.git
cd erc4337-counter-example

2. Install dependencies and navigate to the appropriate directory.

yarn install
cd src/gelato

3. Copy environment variables

cp .env.sample .env

or

2. Using Zerodev SDK

Users can also interact with our bundler through the Zerodev SDK, enabling them to pay gas fees using ERC-20 tokens or native tokens, in addition to leveraging the bundler's sponsorship features.

Example Code

1. Clone the repository

git clone https://github.com/gelatodigital/how-tos-19-master-gelato-erc4337.git
cd how-tos-19-master-gelato-erc4337

2. Install dependencies

npm install

3. Copy environment variables

cp .env.example .env

Option 1. Sponsoring all of your users' gas

• Gas Fee Coverage A third-party sponsor (or paymaster) covers the gas fees, allowing users to transact without holding any native tokens.

• Frictionless Experience Users benefit from a seamless on-chain interaction, since they don’t directly manage or pay for transaction fees.

Option 2. Your users pay for for their own gas

• User-Paid Fees Users themselves cover the gas costs—either with the network’s native token (no paymaster needed) or through an ERC20 paymaster (when paying in ERC20 tokens).

• Greater Control Since users handle their own fees, they maintain direct control over cost management and transactions.