Add OCI snapshot persistence

Signed-off-by: Ludvig Liljenberg <4257730+ludfjig@users.noreply.github.com>

Author: ludfjig

Cargo.lock

@@ -49,9 +49,13 @@ thiserror = "2.0.18"
 chrono = { version = "0.4", optional = true }
 anyhow = "1.0"
 metrics = "0.24.6"
+serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
 elfcore = { version = "2.0", optional = true }
 uuid = { version = "1.23.1", features = ["v4"] }
+oci-spec = { version = "0.8", default-features = false, features = ["image"] }
+sha2 = "0.10"
+hex = "0.4"
 
 [target.'cfg(windows)'.dependencies]
 windows = { version = "0.62", features = [
@@ -83,7 +87,6 @@ mshv-ioctls = { version = "0.6", optional = true}
 [dev-dependencies]
 uuid = { version = "1.23.1", features = ["v4"] }
 signal-hook-registry = "1.4.8"
-serde = "1.0"
 iced-x86 = { version = "1.21", default-features = false, features = ["std", "code_asm"] }
 proptest = "1.11.0"
 tempfile = "3.27.0"

src/hyperlight_host/Cargo.toml

@@ -188,6 +188,20 @@ impl MultiUseSandbox {
     /// # Ok(())
     /// # }
     /// ```
+    ///
+    /// From a snapshot loaded from disk:
+    ///
+    /// ```no_run
+    /// # use std::sync::Arc;
+    /// # use hyperlight_host::{HostFunctions, MultiUseSandbox};
+    /// # use hyperlight_host::sandbox::snapshot::Snapshot;
+    /// # fn example() -> Result<(), Box<dyn std::error::Error>> {
+    /// let snapshot = Arc::new(Snapshot::from_oci("./guest_snapshot", "latest")?);
+    /// let mut sandbox = MultiUseSandbox::from_snapshot(snapshot, HostFunctions::default(), None)?;
+    /// let result: String = sandbox.call("Echo", "hello".to_string())?;
+    /// # Ok(())
+    /// # }
+    /// ```
     #[instrument(err(Debug), skip_all, parent = Span::current(), level = "Trace")]
     pub fn from_snapshot(
         snapshot: Arc<Snapshot>,