WRT - WebAssembly Runtime

A pure Rust implementation of a WebAssembly runtime supporting both the core WebAssembly specification and the WebAssembly Component Model.

Features

• Core WebAssembly Support: Full WebAssembly 1.0 specification implementation
• Component Model: WebAssembly Component Model for language-agnostic interoperability
• no_std Compatible: Works in embedded and bare-metal environments
• Memory Safety: Safe memory management with ASIL-B compliance features
• Stackless Execution: Configurable execution engine for constrained environments
• Control Flow Integrity: Hardware and software CFI protection

Quick Start

Prerequisites

• Rust 1.86.0 or newer
• just command runner

Building

# Build everything
just build
# Or directly: cargo build --workspace

# Run tests
cargo xtask run-tests
# Or via just: just ci-test

# Run example
just test-wrtd-example

Usage

Add WRT to your Cargo.toml:

[dependencies]
wrt = { path = "wrt" }  # Use appropriate version/path

Basic usage:

use wrt::prelude::*;

// Load and run a WebAssembly module
let module = Module::from_bytes(&wasm_bytes)?;
let mut instance = ModuleInstance::new(module, imports)?;
let result = instance.invoke("function_name", &args)?;

Project Structure

This is a multi-crate workspace:

• wrt/ - Main library facade
• wrt-foundation/ - Core types and bounded collections
• wrt-runtime/ - Execution engine
• wrt-component/ - Component Model implementation
• wrt-decoder/ - Binary format parsing
• wrtd/ - Standalone runtime daemon
• example/ - Example WebAssembly component

Documentation

• API Documentation - Complete API reference and specifications
• Architecture Guide - System design and components
• Developer Guide - Contributing and development setup

Generate documentation:

# Build comprehensive documentation
cargo xtask publish-docs-dagger --output-dir docs_output

# Preview documentation locally
cargo xtask preview-docs --open-browser

# API documentation only  
cargo doc --workspace --open

# Generate changelog (requires git-cliff)
cargo xtask generate-changelog

# Deploy to SFTP hosting (shared hosting, VPS, etc.)
cargo xtask deploy-docs-sftp --build-docs

# Validate documentation structure
cargo xtask validate-docs-comprehensive

Development

See the Developer Guide for detailed development instructions.

Common commands:

just --list          # Show all available commands
just fmt            # Format code
just ci-main        # Run main CI checks
just ci-full        # Run complete CI suite

# Xtask commands for development
cargo xtask --help                # Show all xtask commands
cargo xtask verify-no-std         # Verify no_std compatibility
cargo xtask fmt-check             # Check code formatting
cargo xtask coverage              # Generate code coverage

License

MIT License - see LICENSE file for details.