PVM Host Runtime

Host-neutral PolkaVM application runtime for native and browser Hosts.

The repository owns one implementation of the App Manifest v2 PolkaVM execution contract across native Rust, browser WebAssembly, framebuffer, Tri2D, and WebGPU Raster presentation. Runtime limits, GPU records, browser workers, and distributable assets are built and reviewed together.

Layout

• rust/crates/pvm-runtime: execution, hostcalls, lifecycle, bounds, and native/wasm backends.
• rust/crates/pvm-gpu-wire: bounded Tri2D and WebGPU Raster wire protocol.
• rust/crates/pvm-runtime-assets: source-identified browser assets exposed as static Rust data.
• rust/crates/pvm-assets-export: exports those assets for Android, iOS, and browser packaging.
• js/packages/pvm-browser-runtime: source-built @parity/pvm-browser-runtime package.
• docs/runtime/polkavm-app-abi-v1.md: application ABI contract.

Host boundary

Hosts integrate through the truapi-pvm-host bridge in paritytech/host-rust-core. The bridge pins one immutable release of this repository and exposes the supported Rust API plus browser asset identity. Host applications do not pin this repository independently.

Build and test

cargo +nightly fmt --check
cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test --workspace --all-features
npm ci
npm test

Build and export browser assets:

npm run build
cargo run -p pvm-assets-export -- --output ./out/pvm-runtime

Releases

A release is identified by one source commit and records:

• Rust workspace version.
• @parity/pvm-browser-runtime version.
• native and wasm PolkaVM revisions.
• SHA-256 digest of every browser artifact.

Release tags use v<version>. Moving branch references are not release inputs.

License

MPL-2.0. See LICENSE.