From 52f48ea897375b4062bc2f03a1080f0ed4fc1322 Mon Sep 17 00:00:00 2001 From: roethke Date: Wed, 3 Jun 2026 14:24:29 -0700 Subject: [PATCH] clarity gas limit from spec --- docs/base-chain/network-information/block-building.mdx | 6 ++++-- .../network-information/configuration-changelog.mdx | 2 ++ .../network-information/troubleshooting-transactions.mdx | 4 ++-- 3 files changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/base-chain/network-information/block-building.mdx b/docs/base-chain/network-information/block-building.mdx index 12eb9d12f..aca1f259f 100644 --- a/docs/base-chain/network-information/block-building.mdx +++ b/docs/base-chain/network-information/block-building.mdx @@ -54,9 +54,11 @@ For a comprehensive technical deep dive into Flashblocks architecture, see the [ ### Per-Transaction Gas Maximum -Base enforces a per-transaction gas maximum of **25,000,000 gas**. Transactions that specify a gas limit above this value are **rejected by the mempool before inclusion**. `eth_sendTransaction` or `eth_sendRawTransaction` will return a JSON-RPC error (for example: `exceeds maximum per-transaction gas limit`). This cap does **not** change the block gas limit or the block validity conditions. +As of the [Azul hardfork](/base-chain/specs/upgrades/azul/exec-engine#transaction-gas-limit-cap), Base enforces a protocol-level per-transaction gas maximum of **16,777,216 gas (2^24)** via [EIP-7825](https://eips.ethereum.org/EIPS/eip-7825). Transactions that specify a gas limit above this value are **rejected during block validation**. `eth_sendTransaction` or `eth_sendRawTransaction` will return a JSON-RPC error (for example: `exceeds maximum per-transaction gas limit`). -Fusaka's [EIP 7825](https://eips.ethereum.org/EIPS/eip-7825) **will** change the block validity conditions and enforce a lower per-transaction gas maximum of 16,777,216 gas (2^24). We expect this protocol change to be adopted in all OP Stack chains around January 2026. + +Deposit transactions are exempt from this cap. They are limited by the maximum gas includable in an L1 block (20,000,000 gas). + Bundler operators for smart contract wallets must configure their systems to limit the bundle size to fit within this cap. diff --git a/docs/base-chain/network-information/configuration-changelog.mdx b/docs/base-chain/network-information/configuration-changelog.mdx index 905bc3253..abde76c1b 100644 --- a/docs/base-chain/network-information/configuration-changelog.mdx +++ b/docs/base-chain/network-information/configuration-changelog.mdx @@ -10,6 +10,7 @@ This page tracks configuration changes to the Base networks, including updates t | Date | Change | Documentation | |------|--------|---------------| +| May 28, 2026 | Azul: Reduced per-transaction gas maximum to 16,777,216 (2^24) via EIP-7825 | [Per-Transaction Gas Maximum](/base-chain/network-information/block-building#per-transaction-gas-maximum) | | February 19, 2026 | Increased Minimum Base Fee to 5,000,000 wei | [Minimum Base Fee](/base-chain/network-information/network-fees#minimum-base-fee) | | February 4, 2026 | Increased EIP-1559 Denominator to 125 | [EIP-1559 Fee Parameters](/base-chain/network-information/network-fees#eip-1559-fee-parameters) | | February 2, 2026 | Increased Minimum Base Fee to 2,000,000 wei | [Minimum Base Fee](/base-chain/network-information/network-fees#minimum-base-fee) | @@ -27,6 +28,7 @@ This page tracks configuration changes to the Base networks, including updates t | Date | Change | Documentation | |------|--------|---------------| +| April 20, 2026 | Azul: Reduced per-transaction gas maximum to 16,777,216 (2^24) via EIP-7825 | [Per-Transaction Gas Maximum](/base-chain/network-information/block-building#per-transaction-gas-maximum) | | February 19, 2026 | Increased Minimum Base Fee to 5,000,000 wei | [Minimum Base Fee](/base-chain/network-information/network-fees#minimum-base-fee) | | February 10, 2026 | Increased EIP-1559 Denominator to 125 | [EIP-1559 Fee Parameters](/base-chain/network-information/network-fees#eip-1559-fee-parameters) | | February 10, 2026 | Increased Minimum Base Fee to 2,000,000 wei | [Minimum Base Fee](/base-chain/network-information/network-fees#minimum-base-fee) | diff --git a/docs/base-chain/network-information/troubleshooting-transactions.mdx b/docs/base-chain/network-information/troubleshooting-transactions.mdx index 01866191b..6e38a9961 100644 --- a/docs/base-chain/network-information/troubleshooting-transactions.mdx +++ b/docs/base-chain/network-information/troubleshooting-transactions.mdx @@ -50,11 +50,11 @@ If you submit a transaction with a nonce that has already been used, it will be ### Gas Limit Exceeds Maximum -Base enforces a [per-transaction gas maximum](/base-chain/network-information/block-building#per-transaction-gas-maximum) of **25,000,000 gas**. Transactions specifying a higher gas limit are rejected by the mempool before inclusion. +Base enforces a [per-transaction gas maximum](/base-chain/network-information/block-building#per-transaction-gas-maximum) of **16,777,216 gas (2^24)**. Transactions specifying a higher gas limit are rejected during block validation. **Error**: `exceeds maximum per-transaction gas limit` -**Solution**: Reduce the gas limit to 25,000,000 or below. If your transaction genuinely requires more gas, you'll need to break it into multiple transactions. +**Solution**: Reduce the gas limit to 16,777,216 (2^24) or below. If your transaction genuinely requires more gas, you'll need to break it into multiple transactions. ## Transaction Included But Failed