Skip to content

[docs-agent] Note paid-tier 1,000-per-sender parallel nonce limit on bundler FAQs #1626

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
alchemy-bot wants to merge 2 commits into
base: main
Choose a base branch
from
Open

[docs-agent] Note paid-tier 1,000-per-sender parallel nonce limit on bundler FAQs #1626

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
21b3243
[docs-agent] Note paid-tier 1,000-per-sender parallel nonce limit on …
alchemy-bot Sep 16, 2026
1b50563
[docs-agent] Rewrite parallel-nonces answer with 3-tier rule + fix st…
alchemy-bot Sep 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions content/wallets/pages/bundler-api/bundler-faqs.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -93,9 +93,15 @@ To debug these errors, you should:

### What is the maximum number of supported parallel nonces?

The bundler supports up to 4 parallel nonces (default value from ERC-7562) for unstaked senders and unlimited parallel nonces for staked senders. See [below](/docs/reference/bundler-faqs#minimum-entrypoint-stake-amount) for stake requirements.
The per-sender parallel nonce limit depends on your Alchemy plan and whether the sender is staked with the EntryPoint:

Unstaked accounts that attempt to exceed this limit will receive the error `Max operations (4) reached for account`. Staking the account removes the restriction. Accounts can be staked by calling `addStake(uint32 unstakeDelaySec)` on the EntryPoint contract, and later `unlockStake()` followed by `withdrawStake(address payable)` to recover the stake.
* **Free tier, unstaked**: up to **4** parallel nonces (default value from ERC-7562).
* **Paid tier (pay-as-you-go, enterprise), unstaked**: up to **1,000** parallel nonces.
* **Staked senders (any tier)**: effectively unlimited.

See [below](/docs/reference/bundler-faqs#minimum-entrypoint-stake-amount) for stake requirements.

Unstaked accounts that exceed their limit will receive a `Max operations reached for account` error. Staking the account removes the restriction. Accounts can be staked by calling `addStake(uint32 unstakeDelaySec)` on the EntryPoint contract, and later `unlockStake()` followed by `withdrawStake(address payable)` to recover the stake.

Staked senders are subject to ERC-7562 reputation rules. If a sender submits a large number of userOps and subsequently invalidates them all, they may be throttled or banned.

Expand Down Expand Up @@ -256,7 +262,7 @@ Testnets:
| Educhain Testnet | 0.1 ETH |
| OpBNB Testnet | 0.4 BNB |

Paymasters and factories must have at least the above stake or their userOps will be rejected. Accounts only need to stake if they wish to exceed 4 parallel nonces in the Bundler's mempool; otherwise, userOps beyond this limit will be rejected. The same stake amounts apply to accounts.
Paymasters and factories must have at least the above stake or their userOps will be rejected. Accounts only need to stake if they wish to exceed their unstaked parallel-nonce limit in the Bundler's mempool (4 on free tier, 1,000 on paid tiers); otherwise, userOps beyond this limit will be rejected. The same stake amounts apply to accounts.

### What is the minimum delay value?

Expand Down
Loading