virtual-machine 0.0.1 → 0.0.3

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "riscv-vm"
-version = "0.1.0"
+version = "0.0.2"
 edition = "2024"
 
 [lib]
@@ -21,6 +21,7 @@ wasm-bindgen = "0.2"
 
 [target.'cfg(not(target_arch = "wasm32"))'.dependencies]
 tun-tap = "0.1"
+reqwest = { version = "0.12", features = ["blocking", "rustls-tls"] }
 tungstenite = "0.21"
 # WebTransport for connecting to the relay
 wtransport = { version = "0.6", features = ["dangerous-configuration"] }

package/README.md

@@ -0,0 +1,76 @@
+# RISC-V Virtual Machine
+
+A complete RISC-V 64-bit (RV64GC) virtual machine implementation in Rust, capable of running modern operating systems like Linux (xv6) and custom bare-metal kernels. It is designed to run both natively and in the browser via WebAssembly.
+
+## Features
+
+- **Core**: Full RV64GC instruction set implementation (IMAFDC + Zicsr + Zifencei).
+- **Memory**: Sv39 Virtual Memory Management Unit (MMU) with TLB.
+- **Peripherals**:
+  - **UART**: 16550-compatible serial console.
+  - **PLIC**: Platform-Level Interrupt Controller.
+  - **CLINT**: Core Local Interruptor (Timer).
+  - **VirtIO**: Block Device (Disk) and Network Device (Net).
+- **Networking**:
+  - Native TAP interface support (Linux).
+  - WebSocket backend for browser/cross-platform networking.
+  - WebTransport backend for P2P connectivity.
+- **Platform**:
+  - **WASM**: Compiles to WebAssembly for browser execution.
+  - **Native**: Runs as a CLI application on Host OS.
+
+## Usage
+
+### CLI (Native)
+
+Run the emulator from the command line:
+
+```bash
+# Run a kernel image
+cargo run --release -- --kernel path/to/kernel
+
+# Run with networking (WebSocket backend)
+cargo run --release -- --kernel path/to/kernel --net-ws ws://localhost:8765
+
+# Run with block device
+cargo run --release -- --kernel path/to/kernel --disk path/to/fs.img
+```
+
+### WebAssembly
+
+The VM exposes a simple API for JavaScript integration:
+
+```typescript
+import { WasmVm } from "virtual-machine";
+
+// Initialize VM with kernel binary
+const vm = new WasmVm(kernelBytes);
+
+// Connect networking
+vm.connect_network("ws://localhost:8765");
+
+// Step execution
+while (running) {
+  vm.step();
+}
+```
+
+## Architecture
+
+The VM follows a modular design:
+- `cpu.rs`: Instruction decoder and execution pipeline.
+- `mmu.rs`: Virtual address translation.
+- `bus.rs`: Memory mapping and device routing.
+- `virtio.rs`: VirtIO device implementations.
+- `net.rs`: Network backend abstraction.
+
+## Build
+
+```bash
+# Build native CLI
+cargo build --release
+
+# Build WASM package
+wasm-pack build --target web
+```
+

package/build/{riscv_vm-FIEDMHCY.mjs → chunk-GZ343GYI.mjs}

@@ -186,15 +186,15 @@ function passArray8ToWasm0(arg, malloc) {
   WASM_VECTOR_LEN = arg.length;
   return ptr;
 }
-function wasm_bindgen__convert__closures_____invoke__h5116ef40c5ca7cd6(arg0, arg1, arg2) {
-  wasm.wasm_bindgen__convert__closures_____invoke__h5116ef40c5ca7cd6(arg0, arg1, arg2);
+function wasm_bindgen__convert__closures_____invoke__h74b0833075704714(arg0, arg1, arg2) {
+  wasm.wasm_bindgen__convert__closures_____invoke__h74b0833075704714(arg0, arg1, arg2);
+}
+function wasm_bindgen__convert__closures_____invoke__hb59cd9fe41fe42e5(arg0, arg1) {
+  wasm.wasm_bindgen__convert__closures_____invoke__hb59cd9fe41fe42e5(arg0, arg1);
 }
 function wasm_bindgen__convert__closures_____invoke__h6fd3101b14d9814b(arg0, arg1, arg2) {
   wasm.wasm_bindgen__convert__closures_____invoke__h6fd3101b14d9814b(arg0, arg1, arg2);
 }
-function wasm_bindgen__convert__closures_____invoke__hcf26143a2d2b8df4(arg0, arg1) {
-  wasm.wasm_bindgen__convert__closures_____invoke__hcf26143a2d2b8df4(arg0, arg1);
-}
 var NetworkStatus = Object.freeze({
   Disconnected: 0,
   "0": "Disconnected",
@@ -584,28 +584,28 @@ function __wbg_get_imports() {
     const ret = arg0.write(arg1);
     return ret;
   };
-  imports.wbg.__wbindgen_cast_188ff5bafa3120b4 = function(arg0, arg1) {
-    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h158587509e69fed9, wasm_bindgen__convert__closures_____invoke__hcf26143a2d2b8df4);
-    return ret;
-  };
   imports.wbg.__wbindgen_cast_2241b6af4c4b2941 = function(arg0, arg1) {
     const ret = getStringFromWasm0(arg0, arg1);
     return ret;
   };
-  imports.wbg.__wbindgen_cast_5b09fbeec74be75e = function(arg0, arg1) {
-    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__hb2f3fe1158f30bc9, wasm_bindgen__convert__closures_____invoke__h6fd3101b14d9814b);
+  imports.wbg.__wbindgen_cast_3aa963a08b1e1d3f = function(arg0, arg1) {
+    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h0c7e8767edb7b811, wasm_bindgen__convert__closures_____invoke__h74b0833075704714);
     return ret;
   };
-  imports.wbg.__wbindgen_cast_7a6407ddad05d376 = function(arg0, arg1) {
-    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h158587509e69fed9, wasm_bindgen__convert__closures_____invoke__h5116ef40c5ca7cd6);
+  imports.wbg.__wbindgen_cast_3fd26d226c2b9642 = function(arg0, arg1) {
+    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h0c7e8767edb7b811, wasm_bindgen__convert__closures_____invoke__h74b0833075704714);
     return ret;
   };
-  imports.wbg.__wbindgen_cast_93ac3bab887248d1 = function(arg0, arg1) {
-    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h158587509e69fed9, wasm_bindgen__convert__closures_____invoke__h5116ef40c5ca7cd6);
+  imports.wbg.__wbindgen_cast_5b09fbeec74be75e = function(arg0, arg1) {
+    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__hb2f3fe1158f30bc9, wasm_bindgen__convert__closures_____invoke__h6fd3101b14d9814b);
     return ret;
   };
-  imports.wbg.__wbindgen_cast_c68dd2eba48505aa = function(arg0, arg1) {
-    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h158587509e69fed9, wasm_bindgen__convert__closures_____invoke__h5116ef40c5ca7cd6);
+  imports.wbg.__wbindgen_cast_77a91827c917be15 = function(arg0, arg1) {
+    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h0c7e8767edb7b811, wasm_bindgen__convert__closures_____invoke__hb59cd9fe41fe42e5);
+    return ret;
+  };
+  imports.wbg.__wbindgen_cast_e6666d41823ad376 = function(arg0, arg1) {
+    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h0c7e8767edb7b811, wasm_bindgen__convert__closures_____invoke__h74b0833075704714);
     return ret;
   };
   imports.wbg.__wbindgen_init_externref_table = function() {
@@ -653,9 +653,6 @@ async function __wbg_init(module_or_path) {
       console.warn("using deprecated parameters for the initialization function; pass a single object instead");
     }
   }
-  if (typeof module_or_path === "undefined") {
-    module_or_path = new URL("riscv_vm_bg.wasm", import.meta.url);
-  }
   const imports = __wbg_get_imports();
   if (typeof module_or_path === "string" || typeof Request === "function" && module_or_path instanceof Request || typeof URL === "function" && module_or_path instanceof URL) {
     module_or_path = fetch(module_or_path);
@@ -664,9 +661,10 @@ async function __wbg_init(module_or_path) {
   return __wbg_finalize_init(instance, module);
 }
 var riscv_vm_default = __wbg_init;
+
 export {
   NetworkStatus,
   WasmVm,
-  riscv_vm_default as default,
-  initSync
+  initSync,
+  riscv_vm_default
 };