feat(starknet_committer_and_os_cli): add command to dump the OS compiled program to file

Author: dorimedini-starkware

crates/apollo_starknet_os_program/src/lib.rs

@@ -14,12 +14,10 @@ pub static CAIRO_FILES_MAP: LazyLock<HashMap<String, String>> = LazyLock::new(||
         .unwrap_or_else(|error| panic!("Failed to deserialize cairo_files_map.json: {error:?}."))
 });
 
+pub const OS_PROGRAM_BYTES: &[u8] = include_bytes!(concat!(env!("OUT_DIR"), "/starknet_os_bytes"));
+
 pub static OS_PROGRAM: LazyLock<Program> = LazyLock::new(|| {
-    Program::from_bytes(
-        include_bytes!(concat!(env!("OUT_DIR"), "/starknet_os_bytes")),
-        Some("main"),
-    )
-    .expect("Failed to load the OS bytes.")
+    Program::from_bytes(OS_PROGRAM_BYTES, Some("main")).expect("Failed to load the OS bytes.")
 });
 
 pub static PROGRAM_HASH: LazyLock<ProgramHash> = LazyLock::new(|| {

crates/starknet_committer_and_os_cli/src/os_cli/commands.rs

@@ -1,7 +1,7 @@
 use std::fs;
 use std::path::Path;
 
-use apollo_starknet_os_program::CAIRO_FILES_MAP;
+use apollo_starknet_os_program::{CAIRO_FILES_MAP, OS_PROGRAM_BYTES};
 use cairo_lang_starknet_classes::casm_contract_class::CasmContractClass;
 use cairo_vm::types::layout_name::LayoutName;
 use cairo_vm::vm::runners::cairo_pie::CairoPie;
@@ -106,3 +106,9 @@ pub(crate) fn serialize_os_runner_output(
 pub(crate) fn dump_source_files(output_path: String) {
     write_to_file(&output_path, &*CAIRO_FILES_MAP);
 }
+
+pub(crate) fn dump_os_program(output_path: String) {
+    let os_program_json = serde_json::from_slice::<serde_json::Value>(OS_PROGRAM_BYTES)
+        .expect("OS bytes are JSON-serializable.");
+    write_to_file(&output_path, &os_program_json);
+}

crates/starknet_committer_and_os_cli/src/os_cli/run_os_cli.rs

@@ -9,7 +9,7 @@ use tracing::level_filters::LevelFilter;
 use tracing_subscriber::reload::Handle;
 use tracing_subscriber::Registry;
 
-use crate::os_cli::commands::{dump_source_files, parse_and_run_os};
+use crate::os_cli::commands::{dump_os_program, dump_source_files, parse_and_run_os};
 use crate::os_cli::tests::python_tests::OsPythonTestRunner;
 use crate::shared_utils::types::{run_python_test, IoArgs, PythonTestArg};
 
@@ -21,6 +21,11 @@ pub struct OsCliCommand {
 
 #[derive(Debug, Subcommand)]
 enum Command {
+    DumpOsProgram {
+        /// File path to output.
+        #[clap(long, short = 'o', default_value = "stdout")]
+        output_path: String,
+    },
     DumpSourceFiles {
         /// File path to output.
         #[clap(long, short = 'o')]
@@ -39,6 +44,7 @@ pub async fn run_os_cli(
 ) {
     info!("Starting starknet-os-cli with command: \n{:?}", os_command);
     match os_command.command {
+        Command::DumpOsProgram { output_path } => dump_os_program(output_path),
         Command::DumpSourceFiles { output_path } => dump_source_files(output_path),
         Command::PythonTest(python_test_arg) => {
             run_python_test::<OsPythonTestRunner>(python_test_arg).await;