39 stable releases (15 major)

new 33.0.0 May 20, 2025
32.0.0 Apr 21, 2025
31.0.0 Mar 20, 2025
30.0.2 Feb 25, 2025
18.0.3 Mar 12, 2024

#295 in WebAssembly

Download history 3813/week @ 2025-01-30 4983/week @ 2025-02-06 6164/week @ 2025-02-13 5847/week @ 2025-02-20 5303/week @ 2025-02-27 4672/week @ 2025-03-06 5104/week @ 2025-03-13 4504/week @ 2025-03-20 4424/week @ 2025-03-27 4865/week @ 2025-04-03 4826/week @ 2025-04-10 5041/week @ 2025-04-17 5334/week @ 2025-04-24 6239/week @ 2025-05-01 7585/week @ 2025-05-08 5016/week @ 2025-05-15

25,009 downloads per month
Used in 4 crates (2 directly)

Apache-2.0 WITH LLVM-exception

3.5MB
57K SLoC

Wasmtime's C/C++ API

API Documentation

The API documentation for the Wasmtime C library is hosted here..

Using in a C/C++ Project

Using a Pre-Built Static or Dynamic Library

Each release on Wasmtime's GitHub Releases page has pre-built binaries for both static and dynamic libraries for a variety of architectures and operating systems attached, as well as header files you can include.

Building Wasmtime's C/C++ API from Source

To use Wasmtime from a C or C++ project, you must have CMake and a Rust toolchain installed.

From the root of the Wasmtime repository, run the following commands:

$ cmake -S crates/c-api -B target/c-api --install-prefix "$(pwd)/artifacts"
$ cmake --build target/c-api
$ cmake --install target/c-api

These commands will produce the following files:

  • artifacts/lib/libwasmtime.{a,lib}: Static Wasmtime library. Exact extension depends on your operating system.

  • artifacts/lib/libwasmtime.{so,dylib,dll}: Dynamic Wasmtime library. Exact extension depends on your operating system.

  • artifacts/include/**.{h,hh}: Header files for working with Wasmtime.

Using in a C++ Project

A header only C++ API is also offered as wasmtime.hh, which is built on top of the C API. Its located next to the C headers when you download a pre-built library, or when building from source. C++17 is required.

Using in a Rust Project

If you have a Rust crate that contains bindings to a C or C++ library that uses Wasmtime, you can link the Wasmtime C API using Cargo.

  1. Add a dependency on the wasmtime-c-api-impl crate to your Cargo.toml. Note that package name differs from the library name.
[dependencies]
wasmtime-c-api = { version = "16.0.0", package = "wasmtime-c-api-impl" }
  1. In your build.rs file, when compiling your C/C++ source code, add the C wasmtime-c-api headers to the include path:
fn main() {
    let mut cfg = cc::Build::new();

    // Add to the include path the wasmtime headers and the standard
    // Wasm C API headers.
    cfg
        .include(std::env::var("DEP_WASMTIME_C_API_INCLUDE").unwrap());

    // Compile your C code.
    cfg
        .file("src/your_c_code.c")
        .compile("your_library");
}

Dependencies

~18–33MB
~590K SLoC