wasm-sandbox 0.1.0

A secure WebAssembly sandbox for running untrusted code with flexible host-guest communication
Documentation 
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

use std::path::PathBuf;
use thiserror::Error;

/// Error types for the wasm-sandbox crate
#[derive(Error, Debug)]
pub enum Error {
    /// Error initializing the runtime
    #[error("Failed to initialize WebAssembly runtime: {0}")]
    RuntimeInitialization(String),

    /// Error loading a WASM module
    #[error("Failed to load WASM module: {0}")]
    ModuleLoad(String),

    /// Error creating a WASM instance
    #[error("Failed to create WASM instance: {0}")]
    InstanceCreation(String),

    /// Error calling a WASM function
    #[error("Failed to call function '{function_name}': {reason}")]
    FunctionCall {
        function_name: String,
        reason: String,
    },

    /// Error with runtime capabilities
    #[error("Capability error: {0}")]
    Capability(String),

    /// Error with resource limits
    #[error("Resource limit error: {0}")]
    ResourceLimit(String),

    /// Error with host-guest communication
    #[error("Communication error: {0}")]
    Communication(String),

    /// Error with wrapper generation
    #[error("Wrapper generation error: {0}")]
    WrapperGeneration(String),

    /// Error with template processing
    #[error("Template error: {0}")]
    Template(String),

    /// Error with WASI configuration
    #[error("WASI configuration error: {0}")]
    WasiConfig(String),

    /// Error compiling code
    #[error("Compilation error: {0}")]
    Compilation(String),

    /// File system error
    #[error("File system error: {0}")]
    FileSystem(String),

    /// IO error
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    /// JSON serialization/deserialization error
    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),

    /// MessagePack serialization/deserialization error
    #[error("MessagePack error: {0}")]
    MessagePack(#[from] rmp_serde::encode::Error),

    /// MessagePack deserialization error
    #[error("MessagePack decode error: {0}")]
    MessagePackDecode(#[from] rmp_serde::decode::Error),

    /// Invalid configuration
    #[error("Invalid configuration: {0}")]
    InvalidConfig(String),

    /// Invalid path
    #[error("Invalid path: {0:?}")]
    InvalidPath(PathBuf),

    /// Unsupported operation
    #[error("Unsupported operation: {0}")]
    UnsupportedOperation(String),

    /// Security violation
    #[error("Security violation: {0}")]
    SecurityViolation(String),

    /// Instance not found
    #[error("Instance not found: {0}")]
    InstanceNotFound(String),

    /// Module not found
    #[error("Module not found: {0}")]
    ModuleNotFound(String),

    /// Timeout
    #[error("Operation timed out after {0} ms")]
    Timeout(u64),

    /// Generic error
    #[error("{0}")]
    Generic(String),

    /// Wrapped errors from other sources
    #[error(transparent)]
    Other(#[from] anyhow::Error),
}

/// Result type for the wasm-sandbox crate
pub type Result<T> = std::result::Result<T, Error>;