hyperlight-wasm 0.14.0

Library that enables wasm modules and components to be run inside lightweight Virtual Machine backed Sandbox. It is built on top of Hyperlight. 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

/*
Copyright 2024 The Hyperlight Authors.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

use examples_common::get_wasm_module_path;
use hyperlight_wasm::{HyperlightError, Result, SandboxBuilder};

fn get_time_since_boot_microsecond() -> Result<i64> {
    let res = std::time::SystemTime::now()
        .duration_since(std::time::SystemTime::UNIX_EPOCH)?
        .as_micros();
    i64::try_from(res).map_err(HyperlightError::IntConversionFailure)
}

fn main() -> Result<()> {
    let tests = [
        (
            "HelloWorld.aot",
            "HelloWorld",
            "Message from Rust Example to Wasm Function".to_string(),
        ),
        (
            "RunWasm.aot",
            "Echo",
            "Message from Rust Example to Wasm Function".to_string(),
        ),
    ];
    for (idx, case) in tests.iter().enumerate() {
        let (mod_path, fn_name, params_opt) = case;

        let mut sandbox = SandboxBuilder::new().build()?;

        let wasm_sandbox = match mod_path.starts_with("RunWasm") {
            true => {
                sandbox
                    .register(
                        "GetTimeSinceBootMicrosecond",
                        get_time_since_boot_microsecond,
                    )
                    .unwrap();

                sandbox.load_runtime()?
            }
            false => sandbox.load_runtime()?,
        };

        let mod_path = get_wasm_module_path(mod_path)?;

        // Load a Wasm module into the sandbox
        let mut loaded_wasm_sandbox = wasm_sandbox.load_module(mod_path)?;

        if *fn_name == "Echo" {
            // Call a function in the Wasm module
            let result: String =
                loaded_wasm_sandbox.call_guest_function(fn_name, params_opt.clone())?;
            println!(
                "Result from calling Echo Function in Wasm Module \
                test case {idx}) is: {}",
                result
            );
        } else if *fn_name == "HelloWorld" {
            // Call a function in the Wasm module
            let result: i32 =
                loaded_wasm_sandbox.call_guest_function(fn_name, params_opt.clone())?;

            println!(
                "Result from calling HelloWorld Function in Wasm Module \
            test case {idx}) is: {}",
                result
            );
        }
    }

    let tests = [
        (1.331, 24.0, 32),
        (std::f32::consts::PI, std::f32::consts::E, 9),
        (-5.7, 10.3, -59),
        (0.0, 0.0, 0),
        (99.999, 0.001, 0),
        (-std::f32::consts::PI, -2.86, 9),
        (1.5, 1.5, 2),
    ];
    let mut sandbox = SandboxBuilder::new().build()?;
    sandbox
        .register(
            "GetTimeSinceBootMicrosecond",
            get_time_since_boot_microsecond,
        )
        .unwrap();
    let wasm_sandbox = sandbox.load_runtime()?;
    let mod_path = get_wasm_module_path("RunWasm.aot")?;
    let mut loaded_wasm_sandbox = wasm_sandbox.load_module(mod_path)?;
    let snapshot = loaded_wasm_sandbox.snapshot()?;

    for (idx, case) in tests.iter().enumerate() {
        let (a, b, expected_result): (f32, f32, i32) = *case;
        let result: i32 = loaded_wasm_sandbox.call_guest_function("RoundToNearestInt", (a, b))?;
        assert_eq!(
            result, expected_result,
            "RoundToInt test case {idx} failed: got {}, expected {}",
            result, expected_result
        );
        loaded_wasm_sandbox.restore(snapshot.clone())?
    }
    Ok(())
}