The sum of the gas usable by the transactions is greater tha

Error message

The sum of the gas usable by the transactions is greater than the block gas limit

What it means

Error "The sum of the gas usable by the transactions is greater than the block gas limit" thrown in FuelLabs/fuel-core.

Source

Thrown at crates/fuel-core/src/schema/tx.rs:161

            .current_consensus_params();
        let block_gas_limit = consensus_params.block_gas_limit();

        if block_height.is_some() && !config.historical_execution {
            return Err(anyhow::anyhow!(
                "The `blockHeight` parameter requires the `--historical-execution` option"
            )
            .into());
        }

        let mut transactions = txs
            .iter()
            .map(|tx| FuelTx::from_bytes(&tx.0))
            .collect::<Result<Vec<FuelTx>, _>>()?;
        transactions.iter_mut().try_fold::<_, _, async_graphql::Result<u64>>(0u64, |acc, tx| {
            let gas = tx.max_gas(&consensus_params)?;
            let gas = gas.saturating_add(acc);
            if gas > block_gas_limit {
                return Err(anyhow::anyhow!("The sum of the gas usable by the transactions is greater than the block gas limit").into());
            }
            tx.precompute(&consensus_params.chain_id())?;
            Ok(gas)
        })?;

        let DryRunResult {
            transactions,
            storage_reads,
        } = block_producer
            .dry_run_txs(
                transactions,
                block_height.map(|x| x.into()),
                None, // TODO(#1749): Pass parameter from API
                utxo_validation,
                gas_price.map(|x| x.into()),
                record_storage_reads,
            )
            .await?;

View on GitHub (pinned to b9d4d170da)

When it happens

Trigger: Thrown at crates/fuel-core/src/schema/tx.rs:161 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of FuelLabs/fuel-core@b9d4d170da (2026-08-16). Data as JSON: /api/errors/cca625d90e4f4325. Report an issue: GitHub.