Remove experimental oracles flag - oracles are now stable (#3791)

Remove --experimental-oracles CLI flag and experimental warnings from
oracles feature

✅ **All changes completed and verified:**

- [x] Remove `--experimental-oracles` CLI flag from TestArgs in
`crates/forge/src/lib.rs`
- [x] Remove experimental warnings from documentation in
`docs/src/snforge-advanced-features/oracles.md`
- [x] Remove CLI flag documentation section in
`docs/src/appendix/snforge/test.md`
- [x] Remove experimental check in runtime extension in
`crates/cheatnet/src/runtime_extensions/forge_runtime_extension/mod.rs`
- [x] Remove `experimental_oracles` field from ForgeExtension struct and
make oracles always enabled
- [x] Remove `experimental_oracles` field from TestRunnerConfig in
`crates/forge-runner/src/forge_config.rs`
- [x] Remove `experimental_oracles` field from RuntimeConfig in
`crates/forge-runner/src/forge_config.rs`
- [x] Update `combine_configs` function in
`crates/forge/src/combine_configs.rs`
- [x] Update test code that sets `experimental_oracles: false` to remove
the field
- [x] Add entry to CHANGELOG.md Unreleased section only (without
modifying any released versions)
- [x] Build and test changes to ensure nothing breaks

**Verification Results:**
- ✅ All modified crates compile successfully
- ✅ Unit tests pass (combine_configs, forge_runner, cheatnet)  
- ✅ Binary builds successfully
- ✅ CLI help output confirmed flag is removed
- ✅ No remaining references to experimental oracle flags
- ✅ CHANGELOG properly updated: new entry in Unreleased section,
released versions unchanged

**Summary:**
The oracle feature is now stable and always enabled. Users no longer
need to pass `--experimental-oracles` flag or set
`SNFORGE_EXPERIMENTAL_ORACLES` environment variable. All experimental
warnings have been removed from documentation.

<!-- START COPILOT CODING AGENT SUFFIX -->



<details>

<summary>Original prompt</summary>

> Oracles are becoming stable. Remove --experimental-oracle CLI flag
everywhere (including documentation) and any mentions telling that
oracles are experimental.


</details>


<!-- START COPILOT CODING AGENT TIPS -->
---

💬 Share your feedback on Copilot coding agent for the chance to win a
$200 gift card! Click
[here](https://survey3.medallia.com/?EAHeSx-AP01bZqG0Ld9QLQ) to start
the survey.

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: mkaput <[email protected]>

Author: Copilot

CHANGELOG.md

@@ -12,6 +12,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 #### Changed
 
 - Updated the error message returned when calling a nonexistent method on a contract to better align with the format used by the network
+- Oracle support in `snforge` is now stable and no longer requires the `--experimental-oracles` CLI flag
 
 ### Cast
 

crates/cheatnet/src/runtime_extensions/forge_runtime_extension/mod.rs

@@ -60,8 +60,6 @@ pub struct ForgeExtension<'a> {
     pub environment_variables: &'a HashMap<String, String>,
     pub contracts_data: &'a ContractsData,
     pub fuzzer_rng: Option<Arc<Mutex<StdRng>>>,
-    /// Whether `--experimental-oracles` flag has been enabled.
-    pub experimental_oracles_enabled: bool,
     pub oracle_hint_service: OracleHintService,
 }
 
@@ -80,14 +78,6 @@ impl<'a> ExtensionLogic for ForgeExtension<'a> {
             .oracle_hint_service
             .accept_cheatcode(selector.as_bytes())
         {
-            if !self.experimental_oracles_enabled {
-                return Err(anyhow!(
-                    "Oracles are an experimental feature. \
-                    To enable them, pass `--experimental-oracles` CLI flag."
-                )
-                .into());
-            }
-
             let output = self
                 .oracle_hint_service
                 .execute_cheatcode(oracle_selector, input_reader.into_remaining());

crates/forge-runner/src/forge_config.rs

@@ -26,7 +26,6 @@ pub struct TestRunnerConfig {
     pub contracts_data: ContractsData,
     pub environment_variables: HashMap<String, String>,
     pub tracked_resource: ForgeTrackedResource,
-    pub experimental_oracles: bool,
 }
 
 #[derive(Debug, PartialEq)]
@@ -90,7 +89,6 @@ pub struct RuntimeConfig<'a> {
     pub contracts_data: &'a ContractsData,
     pub environment_variables: &'a HashMap<String, String>,
     pub tracked_resource: &'a ForgeTrackedResource,
-    pub experimental_oracles: bool,
 }
 
 impl<'a> RuntimeConfig<'a> {
@@ -103,7 +101,6 @@ impl<'a> RuntimeConfig<'a> {
             contracts_data: &value.contracts_data,
             environment_variables: &value.environment_variables,
             tracked_resource: &value.tracked_resource,
-            experimental_oracles: value.experimental_oracles,
         }
     }
 }

crates/forge-runner/src/running.rs

@@ -230,7 +230,6 @@ pub fn run_test_case(
         environment_variables: runtime_config.environment_variables,
         contracts_data: runtime_config.contracts_data,
         fuzzer_rng,
-        experimental_oracles_enabled: runtime_config.experimental_oracles,
         oracle_hint_service: OracleHintService::new(Some(versioned_program_path.as_std_path())),
     };
 

crates/forge/src/combine_configs.rs

@@ -28,7 +28,6 @@ pub fn combine_configs(
     forge_config_from_scarb: &ForgeConfigFromScarb,
     additional_args: &[OsString],
     trace_args: TraceArgs,
-    experimental_oracles: bool,
 ) -> ForgeConfig {
     let execution_data_to_save = ExecutionDataToSave::from_flags(
         save_trace_data || forge_config_from_scarb.save_trace_data,
@@ -52,7 +51,6 @@ pub fn combine_configs(
             contracts_data,
             tracked_resource,
             environment_variables: env::vars().collect(),
-            experimental_oracles,
         }),
         output_config: Arc::new(OutputConfig {
             trace_args,
@@ -83,7 +81,6 @@ mod tests {
             &ForgeConfigFromScarb::default(),
             &[],
             TraceArgs::default(),
-            false,
         );
         let config2 = combine_configs(
             false,
@@ -100,7 +97,6 @@ mod tests {
             &ForgeConfigFromScarb::default(),
             &[],
             TraceArgs::default(),
-            false,
         );
 
         assert_ne!(config.test_runner_config.fuzzer_seed, 0);
@@ -128,7 +124,6 @@ mod tests {
             &ForgeConfigFromScarb::default(),
             &[],
             TraceArgs::default(),
-            false,
         );
         assert_eq!(
             config,
@@ -143,7 +138,6 @@ mod tests {
                     cache_dir: Utf8PathBuf::default(),
                     contracts_data: ContractsData::default(),
                     environment_variables: config.test_runner_config.environment_variables.clone(),
-                    experimental_oracles: false,
                 }),
                 output_config: Arc::new(OutputConfig {
                     detailed_resources: false,
@@ -184,7 +178,6 @@ mod tests {
             &config_from_scarb,
             &[],
             TraceArgs::default(),
-            false,
         );
         assert_eq!(
             config,
@@ -199,7 +192,6 @@ mod tests {
                     cache_dir: Utf8PathBuf::default(),
                     contracts_data: ContractsData::default(),
                     environment_variables: config.test_runner_config.environment_variables.clone(),
-                    experimental_oracles: false,
                 }),
                 output_config: Arc::new(OutputConfig {
                     detailed_resources: true,
@@ -244,7 +236,6 @@ mod tests {
             &config_from_scarb,
             &[],
             TraceArgs::default(),
-            false,
         );
 
         assert_eq!(
@@ -260,7 +251,6 @@ mod tests {
                     cache_dir: Utf8PathBuf::default(),
                     contracts_data: ContractsData::default(),
                     environment_variables: config.test_runner_config.environment_variables.clone(),
-                    experimental_oracles: false,
                 }),
                 output_config: Arc::new(OutputConfig {
                     detailed_resources: true,

crates/forge/src/lib.rs

@@ -207,10 +207,6 @@ pub struct TestArgs {
     #[arg(last = true)]
     additional_args: Vec<OsString>,
 
-    /// Enable experimental oracles support.
-    #[arg(long, default_value_t = false, env = "SNFORGE_EXPERIMENTAL_ORACLES")]
-    experimental_oracles: bool,
-
     #[command(flatten)]
     scarb_args: ScarbArgs,
 }

crates/forge/src/run_tests/package.rs

@@ -108,7 +108,6 @@ impl RunForPackageArgs {
             &forge_config_from_scarb,
             &args.additional_args,
             args.trace_args.clone(),
-            args.experimental_oracles,
         ));
 
         let test_filter = TestsFilter::from_flags(

crates/forge/test_utils/src/running_tests.rs

@@ -78,7 +78,6 @@ pub fn run_test_case(
                     contracts_data: ContractsData::try_from(test.contracts(&ui).unwrap()).unwrap(),
                     tracked_resource,
                     environment_variables: test.env().clone(),
-                    experimental_oracles: false,
                 }),
                 output_config: Arc::new(OutputConfig {
                     detailed_resources: false,

crates/forge/tests/integration/setup_fork.rs

@@ -160,7 +160,6 @@ fn fork_aliased_decorator() {
                             .unwrap(),
                         tracked_resource: ForgeTrackedResource::CairoSteps,
                         environment_variables: test.env().clone(),
-                        experimental_oracles: false,
                     }),
                     output_config: Arc::new(OutputConfig {
                         detailed_resources: false,
@@ -253,7 +252,6 @@ fn fork_aliased_decorator_overrding() {
                             .unwrap(),
                         tracked_resource: ForgeTrackedResource::CairoSteps,
                         environment_variables: test.env().clone(),
-                        experimental_oracles: false,
                     }),
                     output_config: Arc::new(OutputConfig {
                         detailed_resources: false,

docs/src/appendix/snforge/test.md

@@ -131,10 +131,6 @@ Use Scarb release profile.
 ## `--dev`
 Use Scarb dev profile.
 
-## `--experimental-oracles`
-
-Enable experimental [oracles](../../snforge-advanced-features/oracles.md) support.
-
 ## `-h`, `--help`
 
 Print help.