You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: add ERC-4337 EntryPoint v0.8 support (#1180)
* docs: add ERC-4337 EntryPoint v0.8 support to low-level infra APIs
Add v0.8 as a supported EntryPoint version across bundler docs, FAQs,
OpenRPC specs, shared component schemas, and revert codes reference.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* docs: add UserOperationV08 schema to _shared_wallets components
The bundler spec references _shared_wallets/components.yaml, not
_shared/components.yaml. Add the v0.8 schemas to the correct file
to fix OpenRPC spec generation.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* docs: set v0.8 EntryPoint address to 0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* docs: reuse v0.7 schemas and revert codes for v0.8
v0.7 and v0.8 share the same UserOperation shape and revert codes.
Instead of duplicating, rename v0.7 titles to "v0.7 / v0.8" and
remove the separate UserOperationV08 schemas and revert codes page.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: content/wallets/pages/bundler-api/bundler-faqs.mdx
+9-8Lines changed: 9 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -167,26 +167,27 @@ Recommended Actions for Calculating `maxFeePerGas`:
167
167
168
168
### Which EntryPoint versions are supported?
169
169
170
-
Versions v0.6and v0.7 of ERC-4337 are currently supported. If you need support for v0.8, contact [wallets@alchemy.com](mailto:wallets@alchemy.com).
170
+
Versions v0.6, v0.7, and v0.8 of ERC-4337 are currently supported.
171
171
172
-
### Which EntryPoint version should I use, v0.6 or v0.7?
172
+
### Which EntryPoint version should I use?
173
173
174
-
The latest version of ERC-4337 is v0.7, which introduces optimizations aimed at improving the experience for both developers and end users. These include gas savings for users, optimized data structures, better gas estimation, simplified postOp logic, and structured errors during validation.
174
+
The latest version of ERC-4337 is v0.8, which builds on v0.7 with additional improvements including native support for [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702) account delegation and further gas optimizations.
175
175
176
-
The appropriate version to use is determined by the smart account for which you are trying to send a userOp. Typically, a smart account is written to be compatible with either v0.6 or v0.7. To determine which version is compatible, look at the smart account’s source code and check the first parameter of the `validateUserOp` function. If it has type `UserOperation`, the account uses v0.6. If the parameter type is `PackedUserOperation`, the account uses v0.7.
176
+
The appropriate version to use is determined by the smart account for which you are trying to send a userOp. Typically, a smart account is written to be compatible with a specific EntryPoint version. To determine which version is compatible, look at the smart account’s source code and check the first parameter of the `validateUserOp` function. If it has type `UserOperation`, the account uses v0.6. If the parameter type is `PackedUserOperation`, the account uses v0.7 or v0.8.
177
177
178
-
For more information about the differences between the versions, refer to the specifications for [ERC-4337 v0.6.0](https://github.com/eth-infinitism/account-abstraction/blob/v0.6.0/eip/EIPS/eip-4337.md) and [ERC-4337 v0.7.0](https://github.com/eth-infinitism/account-abstraction/blob/v0.7.0/erc/ERCS/erc-4337.md), particularly the description of the user operation fields.
178
+
For more information about the differences between the versions, refer to the specifications for [ERC-4337 v0.6.0](https://github.com/eth-infinitism/account-abstraction/blob/v0.6.0/eip/EIPS/eip-4337.md), [ERC-4337 v0.7.0](https://github.com/eth-infinitism/account-abstraction/blob/v0.7.0/erc/ERCS/erc-4337.md), and [ERC-4337 v0.8.0](https://github.com/eth-infinitism/account-abstraction/blob/v0.8.0/erc/ERCS/erc-4337.md), particularly the description of the user operation fields.
There is not currently a date set to deprecate support for EntryPoint v0.6 but deprecation is planned sometime in 2026. Ensure that you have migrated to EntryPoint v0.7 by that time. If you have any questions or need assistance with the migration process, file a ticket via the [Discord server](https://discord.com/channels/735965332958871634/1115787488838033538).
190
+
There is not currently a date set to deprecate support for EntryPoint v0.6 but deprecation is planned sometime in 2026. Ensure that you have migrated to EntryPoint v0.7 or v0.8 by that time. If you have any questions or need assistance with the migration process, file a ticket via the [Discord server](https://discord.com/channels/735965332958871634/1115787488838033538).
The Bundler is a key component in the ERC-4337 stack, responsible for collecting, validating, and bundling UserOperations (UserOps) into transactions that are submitted to the EntryPoint contract on the blockchain. The Bundler APIs provide direct access to high-performance, scalable infrastructure (powered by Rundler), enabling developers to interact with a production-grade ERC-4337 bundler for reliable onchain submission of UserOps.
8
-
These APIs are part of the `@account-kit/infra` library, allowing advanced customization when building smart wallet applications. They follow the standard ERC-4337 JSON-RPC endpoints and support versions v0.6and v0.7 of the protocol, with optimizations for gas estimation, validation, and error handling to ensure UserOps land efficiently while protecting against attacks.
8
+
These APIs are part of the `@account-kit/infra` library, allowing advanced customization when building smart wallet applications. They follow the standard ERC-4337 JSON-RPC endpoints and support versions v0.6, v0.7, and v0.8 of the protocol, with optimizations for gas estimation, validation, and error handling to ensure UserOps land efficiently while protecting against attacks.
9
9
10
10
For full control, bring your own smart contracts or authentication providers while leveraging the bundler for scalability. If you prefer a higher-level abstraction, use the Wallet APIs or aa-sdk instead.
Copy file name to clipboardExpand all lines: src/openrpc/alchemy/bundler/bundler.yaml
+4-4Lines changed: 4 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -497,7 +497,7 @@ methods:
497
497
type: "string"
498
498
description: Transaction hash of the `UserOperation`.
499
499
entrypointV07Response:
500
-
title: "Entrypoint v0.7 Response"
500
+
title: "Entrypoint v0.7 / v0.8 Response"
501
501
type: "object"
502
502
properties:
503
503
sender:
@@ -588,7 +588,7 @@ methods:
588
588
params:
589
589
- name: UserOperation
590
590
required: true
591
-
description: The UserOperation object. This can be either a v0.6or v0.7 user operation, but MUST match the version of the entry point at the address of the second parameter.
591
+
description: The UserOperation object. This can be a v0.6, v0.7, or v0.8 user operation, but MUST match the version of the entry point at the address of the second parameter.
description: Contains gas limits and prices (optional). This can be either a v0.6or v0.7 userOperation but must match the version of the `EntryPoint` at the address of the second parameter.
629
+
description: Contains gas limits and prices (optional). This can be a v0.6, v0.7, or v0.8 userOperation but must match the version of the `EntryPoint` at the address of the second parameter.
0 commit comments