From 21b324394c5fa25444748286a68d19a41c126ae6 Mon Sep 17 00:00:00 2001 From: alchemy-bot <80712764+alchemy-bot@users.noreply.github.com> Date: Wed, 16 Sep 2026 16:25:38 +0000 Subject: [PATCH 1/2] [docs-agent] Note paid-tier 1,000-per-sender parallel nonce limit on bundler FAQs Add a sentence to the "What is the maximum number of supported parallel nonces?" answer on content/wallets/pages/bundler-api/bundler-faqs.mdx clarifying that paid Alchemy plans (pay-as-you-go, enterprise) enforce a per-sender parallel nonce limit of 1,000. Preserves the existing ERC-7562 default explanation (4 for unstaked senders, unlimited for staked senders). Refs DOCS-230 Requested-by: @caleighc --- content/wallets/pages/bundler-api/bundler-faqs.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/wallets/pages/bundler-api/bundler-faqs.mdx b/content/wallets/pages/bundler-api/bundler-faqs.mdx index ae8dc9f2c..82d4257f6 100644 --- a/content/wallets/pages/bundler-api/bundler-faqs.mdx +++ b/content/wallets/pages/bundler-api/bundler-faqs.mdx @@ -95,6 +95,8 @@ To debug these errors, you should: 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. +For teams on a paid Alchemy plan (pay-as-you-go, enterprise), the per-sender parallel nonce limit is **1,000**. + 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. 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. From 1b505635be4dc905fe691ece2e17aa5ed645fc6a Mon Sep 17 00:00:00 2001 From: alchemy-bot <80712764+alchemy-bot@users.noreply.github.com> Date: Thu, 17 Sep 2026 20:03:48 +0000 Subject: [PATCH 2/2] [docs-agent] Rewrite parallel-nonces answer with 3-tier rule + fix stake-section wording Follow-up on codex P2 (https://github.com/alchemyplatform/docs/pull/1626#discussion_r4028326976) after Caleigh confirmed the per-sender parallel nonce limits in Slack: 4 for free-tier unstaked, 1,000 for paid-tier unstaked, effectively unlimited for staked senders (any tier). Rewrites the "What is the maximum number of supported parallel nonces?" answer as a 3-bullet rule so unstaked/staked and free/paid interactions are unambiguous. Also updates the "Minimum EntryPoint stake amount" section wording that hardcoded "exceed 4 parallel nonces" to reflect the paid-tier 1,000 cap. Refs DOCS-230 Requested-by: @caleighc --- content/wallets/pages/bundler-api/bundler-faqs.mdx | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/content/wallets/pages/bundler-api/bundler-faqs.mdx b/content/wallets/pages/bundler-api/bundler-faqs.mdx index 82d4257f6..334cc36cb 100644 --- a/content/wallets/pages/bundler-api/bundler-faqs.mdx +++ b/content/wallets/pages/bundler-api/bundler-faqs.mdx @@ -93,11 +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: -For teams on a paid Alchemy plan (pay-as-you-go, enterprise), the per-sender parallel nonce limit is **1,000**. +* **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. -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. +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. @@ -258,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?