by pixxl | v0.2.0
A Libsignal-Protocol wrapper for NativeScript.
npm i --save nativescript-libsignal-protocol

NativeScript Libsignal-Protocol android-support

Developed for ODIN

npm version license


This plugin is a Libsiginal Protocol implementation for NativeScript and is based on libsignal-protocol-java. This plugin is currently a wrapper which implements functionality developed by The Open Whisper Systems organization, the active maintainers behind the encrypted messenger application Signal.

This plugin is currently in ALPHA stages and will require additional work to mature. This code has NOT been reviewed by an experienced cryptopgrapher so usage and support cannot be guarenteed at this time.


This plugin requires no additional permissions to work properly. The application implementing this plugin however, will likely require android.permission.INTERNET if you are using a central server to manage data.


$ tns plugin add nativescript-libsignal-protocol


Importing LibsignalProtocol from this plugin will allow you to use various classes and implementation wrappers that are currently available. Numerous type definitions have been created to your IDE to provide context to various pieces so far made available. The demo application provided with this plugin contains a couple different examples of using this plugin for a project.

This plugin follows the same implementation and usage standards which can be found from the sourcecode Github Repository. Listed below is simple snippet demonstrating usage.

import { LibsignalProtocol } from 'nativescript-libsignal-protocol';

const SignalKeyHelper = LibsignalProtocol.KeyHelper;
const Base64Encode = LibsignalProtocol.Util.base64Encode;

* Outputs a new session identity generated with the Libsignal Protocol.
* `identityKeyPair` is a raw reference to the JAVA object `IdentityKeyPair`
* as such, the exported values must be `serialized` before being usable.
* @returns The generated session identity as a JSON object.
public demo_generateNewSessionIdentity(): any {
let identityKeyPair: LibsignalProtocol.Type.IdentityKeyPair;
let preKeys: any[];
let signedPreKey: LibsignalProtocol.Type.SignedPreKeyRecord;
let signedPreKeyPair: LibsignalProtocol.Type.ECKeyPair;
let registrationId: number;

registrationId = SignalKeyHelper.generateRegistrationId();
identityKeyPair = SignalKeyHelper.generateIdentityKeyPair();
preKeys = SignalKeyHelper.generatePreKeysFormatted(0, 1);
signedPreKey = SignalKeyHelper.generateSignedPreKeyFormatted(identityKeyPair, 1);

let sessionIdentity = {
registrationId: `${registrationId}`,
deviceId: 123,
identity: {
pubKey: Base64Encode(identityKeyPair.getPublicKey().serialize()),
privKey: Base64Encode(identityKeyPair.getPrivateKey().serialize()),
serialized: Base64Encode(identityKeyPair.serialize()),
signedPreKey: signedPreKey,
preKeys: preKeys

return sessionIdentity;


This plugin is currently not available for iOS devices (Contributions for iOS support are welcomed and desired!). This plugin is also meant to be a simple wapper for using the Libsignal Protocol. While this plugin contains a Client class for storing a session/state, the actual use and management should be taken care of within the application using this plugin.


Licensed under the GPLv3:

  • Copyright 2015-2016 Open Whisper Systems
  • Copyright 2018-2019 @Pixxlated


This plugin contains source code based on the following:


Special thanks to the original contributors and authors of the works above!