matrix-rust-sdk/bindings/matrix-sdk-crypto-js
Valere 248b8db309
Extended verification states
Co-authored-by: Damir Jelić <poljar@termina.org.uk>
Co-authored-by: Denis Kasak <dkasak@termina.org.uk>
2023-03-15 18:16:31 +01:00
..
.cargo chore(bindings): Move `crypto-nodejs` and `crypto-js` into the `bindings/` directory. 2022-06-22 11:54:49 +02:00
scripts crypto-js: support `npm run build:dev` (#1510) 2023-02-16 10:51:37 +00:00
src Extended verification states 2023-03-15 18:16:31 +01:00
tests Extended verification states 2023-03-15 18:16:31 +01:00
.gitignore chore(bindings): Move `crypto-nodejs` and `crypto-js` into the `bindings/` directory. 2022-06-22 11:54:49 +02:00
.prettierignore crypto-js, crypto-nodejs: Run prettier in CI 2023-02-15 12:39:54 +00:00
.prettierrc.js crypto-js, crypto-nodejs: Run prettier in CI 2023-02-15 12:39:54 +00:00
.yarnrc chore(crypto-js): configuration for 'yarn version' 2023-01-20 17:37:40 +00:00
Cargo.toml refactor: Use workspace dependencies for more crates 2023-01-10 10:19:02 +01:00
README.md crypto-nodejs, crypto-js: Run `prettier` on source code 2023-02-15 12:39:54 +00:00
package.json crypto-js: support `npm run build:dev` (#1510) 2023-02-16 10:51:37 +00:00
tsconfig.json crypto-nodejs, crypto-js: Run `prettier` on source code 2023-02-15 12:39:54 +00:00

README.md

matrix-sdk-crypto-js

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) for Matrix clients.

Usage

These WebAssembly bindings are written in Rust. To build them, you need to install the Rust compiler, see the Install Rust Page. Then, the workflow is pretty classical by using npm, see the Downloading and installing Node.js and npm Page.

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

$ npm install
$ npm run build
$ npm run test

A matrix_sdk_crypto.js, matrix_sdk_crypto.d.ts and a matrix_sdk_crypto_bg.wasm files should be generated in the pkg/ directory.

TBD

Documentation

The documentation can be found online.

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

$ npm run doc

The documentation is generated in the ./docs directory.