feat(apollo_starknet_os_program): define and implement static Program

Author: dorimedini-starkware

Cargo.lock

@@ -8,3 +8,10 @@ description = "The source (Cairo) code of the Starknet OS."
 
 [lints]
 workspace = true
+
+[dependencies]
+cairo-vm.workspace = true
+
+[build-dependencies]
+apollo_infra_utils.workspace = true
+cairo-vm.workspace = true

crates/apollo_starknet_os_program/Cargo.toml

@@ -0,0 +1,43 @@
+use std::path::PathBuf;
+use std::process::Command;
+
+use apollo_infra_utils::cairo0_compiler::verify_cairo0_compiler_deps;
+use apollo_infra_utils::compile_time_cargo_manifest_dir;
+
+/// Build script for the `apollo_starknet_os_program` crate.
+/// Recompiles the OS program if the source files change.
+fn main() {
+    let out_dir = std::env::var("OUT_DIR").expect("OUT_DIR not set.");
+    println!("cargo::warning=Compiling Starknet OS program...");
+    let starknet_os_bytes = compile_starknet_os();
+    println!("cargo::warning=Done. Writing compiled bytes to output directory.");
+    let starknet_os_bytes_path = PathBuf::from(out_dir).join("starknet_os_bytes");
+    std::fs::write(&starknet_os_bytes_path, &starknet_os_bytes)
+        .expect("Failed to write the compiled OS bytes to the output directory.");
+}
+
+/// Compile the StarkNet OS program.
+fn compile_starknet_os() -> Vec<u8> {
+    verify_cairo0_compiler_deps();
+    let cairo_root_path = PathBuf::from(compile_time_cargo_manifest_dir!()).join("src/cairo");
+    let os_main_path = cairo_root_path.join("starkware/starknet/core/os/os.cairo");
+    assert!(os_main_path.exists(), "OS main file does not exist at {os_main_path:?}.");
+    let mut compile_os_command = Command::new("cairo-compile");
+    compile_os_command.args([
+        os_main_path.to_str().expect("Path is valid unicode."),
+        "--debug_info_with_source",
+        "--cairo_path",
+        cairo_root_path.to_str().expect("Path to cairo is valid unicode."),
+    ]);
+    println!("cargo::warning=Running command {compile_os_command:?}.");
+    let compile_os_output =
+        compile_os_command.output().expect("Failed to run the OS compile command.");
+
+    // Verify output.
+    if !compile_os_output.status.success() {
+        let stderr = String::from_utf8_lossy(&compile_os_output.stderr);
+        panic!("Failed to compile the OS. Error: {}", stderr.trim());
+    }
+
+    compile_os_output.stdout
+}

crates/apollo_starknet_os_program/build.rs

@@ -1 +1,11 @@
+use std::sync::LazyLock;
 
+use cairo_vm::types::program::Program;
+
+pub const 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.")
+});