Node.js addon for Curve25519 Scalarmult, written in Rust

Uses the Rust Dalek library to implement a performant scalarmult function.

Installing curve25519-scalarmult-rsjs

Installing curve25519-scalarmult-rsjs requires a supported version of Node and Rust such as Node.js 16.0.0 or higher and Rust 1.64 or higher.

You can install the project with npm. In the project directory, run:

$ npm install

This fully installs the project, including installing any dependencies and running the build.

Compiling curve25519-scalarmult-rsjs

This project is automatically compiled using Rust and node-bindgen (a.k.a nj-cli) when you run npm install. If you have cloned this project and want to compile it manually, you can run npm run build-debug or npm run build-release.

If you want to disable the automatic compilation during npm install, then set the environment variable DONT_COMPILE_NODE_ADDON=@railgun-community/curve25519-scalarmult-rsjs (this can be a comma-separated list of packages to skip compiling).

Developing curve25519-scalarmult-rsjs

In the project directory, you can run:

npm install

Installs the project, including running npm run build-release.

npm build-debug

npm build-release

Same as npm run build-debug but, builds the module with the release profile. Release builds will compile slower, but run faster.

npm test

Runs the unit tests.

Releasing new versions

You must first compile "prebuilds" for Android and iOS and this may require running on a macOS computer which has iOS specific CLI tools.

For Android

Make sure you have the cross-compilation targets supported:

rustup target add arm-linux-androideabi

rustup target add aarch64-linux-android

rustup target add x86_64-linux-android

Use Android NDK version 24 or higher by ensuring you have the env var ANDROID_NDK_HOME pointed at the NDK 24 directory. If you get a compilation error about -lgcc, you might have to apply this hack deep in your NDK.

npx prebuild-for-nodejs-mobile android-arm --sdk33 --verbose

npx prebuild-for-nodejs-mobile android-arm64 --sdk33 --verbose

npx prebuild-for-nodejs-mobile android-x64 --sdk33 --verbose

For iOS

Make sure you have the cross-compilation targets supported:

rustup target add x86_64-apple-ios

rustup target add aarch64-apple-ios

rustup target add aarch64-apple-ios-sim

Then compile the prebuilds:

npx prebuild-for-nodejs-mobile ios-arm64 --verbose

npx prebuild-for-nodejs-mobile ios-arm64-simulator --verbose

npx prebuild-for-nodejs-mobile ios-x64-simulator --verbose

Publishing on npm

When the prebuilds are ready, make sure you have rights to publish to the @railgun-community/curve25519-scalarmult-rsjs npm package, and then run

npm publish --access public