@wireapp/core-crypto NPM

Wire CoreCrypto

This repository is part of the source code of Wire. You can find more information at wire.com or by contacting opensource@wire.com.

You can find the published source code at github.com/wireapp/wire.

For licensing information, see the attached LICENSE file and the list of third-party licenses at wire.com/legal/licenses/.

No license is granted to the Wire trademark and its associated logos, all of which will continue to be owned exclusively by Wire Swiss GmbH. Any use of the Wire trademark and/or its associated logos is expressly prohibited without the express prior written consent of Wire Swiss GmbH.

Parts

CoreCrypto: Abstracts MLS & Proteus in a unified API
CoreCryptoFFI: FFI bindings for iOS, Android and WASM
Keystore: Encrypted Keystore powered by SQLCipher on all platforms except WASM. WASM uses an IndexedDB-backed, encrypted store with AES256-GCM
MlsProvider: RustCrypto + Keystore MLS provider

See ARCHITECTURE.md

Usage

API Docs

Building

General Requirements

rust: https://www.rust-lang.org/tools/install
cargo-make: https://sagiegurari.github.io/cargo-make/

Android

Install Android SDK and Build-Tools for API level 30+

NOTE: If you are building on macOS you'll need to setup $ANDROID_SDK_ROOT path variable manually:

export ANDROID_SDK_ROOT=~/Android/Sdk

Install android rust targets

rustup target add x86_64-linux-android aarch64-linux-android armv7-linux-androideabi i686-linux-android

iOS

Install Xcode & it's commandline tools: https://developer.apple.com/xcode/

Install iOS rust targets

rustup target add aarch64-apple-ios x86_64-apple-ios aarch64-apple-ios-sim

MacOS

Install macOS rust targets

rustup target add x86_64-apple-darwin
rustup target add aarch64-apple-darwin

Linux

If cross-compiling from macOS you'll need install: https://github.com/messense/homebrew-macos-cross-toolchains

Install linux targets

rustup target add x86_64-unknown-linux-gnu

WASM

Install wasm-pack
Install the wasm32-unknown-unknown toolchain rustup target add wasm32-unknown-unknown
Install node.js (recommended way is via Volta)
Install Bun (follow the instructions on Bun's website)

Bindings

Build bindings for Android, JVM, iOS and WASM

cd crypto-ffi 

# builds bindings and targets for the JVM (macOS / Linux)
cargo make "copy-jvm-resources"

# builds bindings and targets for Android
cargo make "copy-android-resources"

# builds iOS framework
cargo make "ios-create-xcframework"

# builds wasm binary & TS bindings
cargo make wasm

Publishing

Versioning

Run cargo xtask release bump [major|minor|patch|rc|pre]
Update the internal dependencies of the updated crates to use the new version
Update the version in the package.json
Update the version in the build.gradle.kts inside ./kotlin/android and ./kotlin/jvm

Changelog

Update <CHANGELOG.tpl> accordingly
Fetch the latest tags from the remote
run cargo xtask documentation changelog to update <CHANGELOG.md> with the git-conventional history

Android / JVM

You can publish the JVM and Android bindings to maven using gradle after you've built the corresponding target.

cd kotlin
./gradlew :jvm:publishToMavenLocal
./gradlew :android:publishToMavenLocal

JS / WASM

Given that you are logged in NPM and can publish to @wireapp/core-crypto, you can just npm publish to push a new version But this is not needed as releases are auto-published to the @wireapp organization