# @matrix-org/matrix-sdk-crypto-wasm

> WebAssembly bindings of the matrix-sdk-crypto encryption library

Latest version **18.9.0** (published 2026-09-21) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @matrix-org/matrix-sdk-crypto-wasm
pnpm add @matrix-org/matrix-sdk-crypto-wasm
yarn add @matrix-org/matrix-sdk-crypto-wasm
bun add @matrix-org/matrix-sdk-crypto-wasm
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 18.9.0 |
| Published | 2026-09-21 |
| First published | 2023-07-13 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM |
| Node | >= 18 |
| Dependencies | 0 |
| Unpacked size | 8.5 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| Maintainers | matrixdotorg |
| Keywords | matrix, chat, messaging, ruma, nio |

## Links

- npm: https://www.npmjs.com/package/@matrix-org/matrix-sdk-crypto-wasm
- Repository: https://github.com/matrix-org/matrix-sdk-crypto-wasm
- Issues: https://github.com/matrix-org/matrix-sdk-crypto-wasm/issues
- npm.io page: https://npm.io/package/@matrix-org/matrix-sdk-crypto-wasm

## Recent versions

- 18.9.0 (latest) — 2026-09-21
- 18.8.0 — 2026-09-03
- 18.7.0 — 2026-08-28
- 18.6.0 — 2026-08-25
- 18.5.0 — 2026-08-10
- 18.4.0 — 2026-07-23
- 18.3.1 — 2026-06-02
- 18.3.0 — 2026-05-12
- 18.2.0 — 2026-04-22
- 18.1.0 — 2026-04-17
- 18.0.0 — 2026-03-11
- 17.1.0 — 2026-01-27
- 17.0.0 — 2026-01-07
- 16.0.0 — 2025-12-05
- 15.3.0 — 2025-09-11
- … 55 more at https://npm.io/package/@matrix-org/matrix-sdk-crypto-wasm/versions

## README

# `matrix-sdk-crypto-wasm`

Welcome to the [WebAssembly] + JavaScript binding for the Rust
[`matrix-sdk-crypto`] library! WebAssembly can run anywhere, but these
bindings are designed to run on a JavaScript host. These bindings are
part of the [`matrix-rust-sdk`] project, which is a library
implementation of a [Matrix] client-server.

`matrix-sdk-crypto` is a no-network-IO implementation of a state
machine, named `OlmMachine`, that handles E2EE ([End-to-End
Encryption](https://en.wikipedia.org/wiki/End-to-end_encryption)) for
[Matrix] clients.

## Usage

1. Install in your project:

    ```
    npm install --save @matrix-org/matrix-sdk-crypto-wasm
    ```

    or:

    ```
    pnpm add @matrix-org/matrix-sdk-crypto-wasm
    ```

2. Import the library into your project and initialise it.

    On Web platforms, the library must be initialised by calling `initAsync`
    before it can be used, else it will throw an error. This is also recommended
    on other platforms, as it allows the WebAssembly module to be loaded
    asynchronously.

    ```javascript
    import { initAsync, Tracing, LoggerLevel, OlmMachine, UserId, DeviceId } from "@matrix-org/matrix-sdk-crypto-wasm";

    async function loadCrypto(userId, deviceId) {
        // Do this before any other calls to the library
        await initAsync();

        // Optional: enable tracing in the rust-sdk
        new Tracing(LoggerLevel.Trace).turnOn();

        // Create a new OlmMachine
        //
        // The following will use an in-memory store. It is recommended to use
        // indexedDB where that is available.
        // See https://matrix-org.github.io/matrix-sdk-crypto-wasm/classes/OlmMachine.html#initialize
        const olmMachine = await OlmMachine.initialize(new UserId(userId), new DeviceId(deviceId));

        return olmMachine;
    }
    ```

    See the [API documentation](https://matrix-org.github.io/matrix-sdk-crypto-wasm/) for more information.

3. Build your project.

    The packaging of this library aims to "just work" the same as any plain-javascript project would: it includes
    separate entry points for Node.js-like environments (which read the WASM file via
    [`fs.readFile()`](https://nodejs.org/api/fs.html#fsreadfilepath-options-callback)) and web-like environments (which
    download the WASM file with [`fetch()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/fetch)). There are
    both CommonJS and ES Module entry points for each environment; an appropriate entrypoint should be selected
    automatically.

    If your environment supports the experimental [ES Module Integration Proposal for WebAssembly](https://github.com/WebAssembly/esm-integration),
    you can instead use that, by setting the `matrix-org:wasm-esm` custom [export condition](https://nodejs.org/api/packages.html#conditional-exports).
    This is only supported when the library is imported as an ES Module. For example:

    - In Webpack, set [`experiments.asyncWebAssembly`](https://webpack.js.org/configuration/experiments/#experiments)
      to `true` and [`resolve.conditionNames`](https://webpack.js.org/configuration/resolve/#resolveconditionnames)
      to `["matrix-org:wasm-esm", "..."]` (the `"..."` preserves default condition names).
    - In Node.js, invoke with commandline arguments [`--experimental-wasm-modules`](https://nodejs.org/api/esm.html#wasm-modules)
      [`--conditions=wasm-esm`](https://nodejs.org/api/cli.html#-c-condition---conditionscondition).

## Building matrix-sdk-crypto-wasm

These WebAssembly bindings are written in [Rust]. To build them, you
need to install the Rust compiler, see [the Install Rust
Page](https://www.rust-lang.org/tools/install). Then, the workflow is
pretty classical by using [pnpm](https://pnpm.io), see [the Downloading and installing
Node.js and npm
Page](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) and [installing pnpm](https://pnpm.io/installation).

Once the Rust compiler, Node.js and pnpm are installed, you can run the
following commands:

```sh
$ pnpm install
$ pnpm build  # or 'pnpm build:dev' to make an unoptimised build
$ pnpm test
```

The compiled output should be generated in the `pkg/` directory.

## Local development with matrix-rust-sdk

To build based on a local `matrix-rust-sdk`, add something like this to your
`.cargo/config` file:

```
[patch.'https://github.com/matrix-org/matrix-rust-sdk']
matrix-sdk-base = { path = "../matrix-rust-sdk/crates/matrix-sdk-base" }
matrix-sdk-common = { path = "../matrix-rust-sdk/crates/matrix-sdk-common" }
matrix-sdk-crypto = { path = "../matrix-rust-sdk/crates/matrix-sdk-crypto" }
matrix-sdk-indexeddb = { path = "../matrix-rust-sdk/crates/matrix-sdk-indexeddb" }
matrix-sdk-qrcode = { path = "../matrix-rust-sdk/crates/matrix-sdk-qrcode" }
```

## Documentation

[The documentation can be found
online](https://matrix-org.github.io/matrix-sdk-crypto-wasm/).

To generate the documentation locally, please run the following
command:

```sh
$ pnpm doc
```

The documentation is generated in the `./docs` directory.

[WebAssembly]: https://webassembly.org/
[`matrix-sdk-crypto`]: https://github.com/matrix-org/matrix-rust-sdk/tree/main/crates/matrix-sdk-crypto
[`matrix-rust-sdk`]: https://github.com/matrix-org/matrix-rust-sdk
[Matrix]: https://matrix.org/
[Rust]: https://www.rust-lang.org/
[npm]: https://www.npmjs.com/

## Contributing

Thank you! See the [contributing](CONTRIBUTING.md) doc for more info.

---
_Source: https://npm.io/package/@matrix-org/matrix-sdk-crypto-wasm · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._