`--historical-execution` is required for this operation

Error message

`--historical-execution` is required for this operation

What it means

Error "`--historical-execution` is required for this operation" thrown in FuelLabs/fuel-core.

Source

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

        gas_price: Option<U64>,
        // This can be used to run the dry-run on top of a past block.
        // Requires `--historical-execution` flag to be enabled.
        block_height: Option<U32>,
    ) -> async_graphql::Result<DryRunStorageReads> {
        self.dry_run_inner(ctx, txs, utxo_validation, gas_price, block_height, true)
            .await
    }

    /// Get execution trace for an already-executed block.
    #[graphql(complexity = "query_costs().storage_read_replay + child_complexity")]
    async fn storage_read_replay(
        &self,
        ctx: &Context<'_>,
        height: U32,
    ) -> async_graphql::Result<Vec<StorageReadReplayEvent>> {
        let config = ctx.data_unchecked::<GraphQLConfig>();
        if !config.historical_execution {
            return Err(anyhow::anyhow!(
                "`--historical-execution` is required for this operation"
            )
            .into());
        }

        let block_height = height.into();
        let block_producer = ctx.data_unchecked::<BlockProducer>();
        Ok(block_producer
            .storage_read_replay(block_height)
            .await?
            .into_iter()
            .map(StorageReadReplayEvent::from)
            .collect())
    }
}

#[derive(Default)]
pub struct TxMutation;

View on GitHub (pinned to b9d4d170da)

When it happens

Trigger: Thrown at crates/fuel-core/src/schema/tx.rs:600 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/ddd1f808a7aa07e4. Report an issue: GitHub.