Skip to content

fix(base-chain): update per-tx gas cap to 16,777,216 after Azul (EIP-7825) #1582

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

Closed
crazywriter1 wants to merge 1 commit into from
+6 −4
Closed

fix(base-chain): update per-tx gas cap to 16,777,216 after Azul (EIP-7825) #1582

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
6 changes: 4 additions & 2 deletions docs/base-chain/network-information/block-building.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Base enforces a per-transaction gas maximum of **16,777,216 gas (2^24)** via [EIP-7825](https://eips.ethereum.org/EIPS/eip-7825), activated on mainnet in the [Azul](/base-chain/specs/upgrades/azul/overview) hardfork. 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.

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.
<Note>
Deposit transactions are exempt from the per-transaction gas cap. See [Azul: Transaction Gas Limit Cap](/base-chain/specs/upgrades/azul/exec-engine#transaction-gas-limit-cap) for details.
</Note>

Bundler operators for smart contract wallets must configure their systems to limit the bundle size to fit within this cap.

Expand Down
4 changes: 2 additions & 2 deletions docs/base-chain/network-information/troubleshooting-transactions.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)** via EIP-7825 (Azul). Transactions specifying a higher gas limit are rejected by the mempool before inclusion.

**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 or below. If your transaction genuinely requires more gas, break it into multiple transactions.

## Transaction Included But Failed

Expand Down